Network Setup

This guide describes how to set up the network between the host machine and the target device for webOS IoT.

Before You Begin

Make sure you have prepared the following:

• Target device with webOS IoT image

• USB to TTL serial cable

  Note
  In this guide, we use the 4-pin TTL serial cable. The commands and steps in the guide might be changed depending on your cable.

Setting Up Serial Connection

To set up the network on the target device, first you need to set up a serial connection between the host machine and the target device.

Connect with the Cable

Connect the host machine with the target device using the USB to TTL serial cable.

1. Connect pin sockets to RPi’s GPIO pins as follows:

   Type	TTL serial cable color	RPi pin number
   Ground	Black	6 - Ground
   Data	White	8 - GPIO 14 (TXD)
   Data	Green	10 - GPIO 15 (RXD)

   

2. Connect USB port of the cable to your host machine.

(Optional) Set Up the USB Driver

Basically, a driver for the cable is already included in Linux kernel. But if your host machine cannot recognize the cable, follow the steps below to set up the driver manually:

1. Check the USB device information.

   $ lsusb
   Bus 003 Device 051: ID <Vendor>:<Product> Prolific Technology, Inc. PL2303 Serial Port
   

2. Enable the device using <Vendor> and <Product> from step 1.

   $ sudo modprobe usbserial vendor=0x<Vendor> product=0×<Product>
   

Set Up a Serial Terminal

Follow the steps below to set up a serial terminal. Make sure that the target device is turned off beforehand.

1. Install PuTTY on the host machine.

   $ sudo apt update
   $ sudo apt install putty
   

2. Check the name of the USB device.

   $ dmesg | grep tty
   [ 6198.188883] usb 3-1: pl2303 converter now attached to ttyUSB<X>
   

   In the above code, typically, <X> is the integer number.

3. Check that tty device is set successfully.

   $ ls /dev/ttyUSB<X> # Use <X> from step 2
   /dev/ttyUSB<X>
   

4. Open PuTTY and enter the following information.

   $ sudo putty
   

   • Connection Type: Serial
   • Serial line: /dev/ttyUSB<X>
   • Speed: 115200

   

5. Click Open. An empty PuTTY terminal will be opened.

6. Turn on the target device, then a bunch of debug logs are generated on the PuTTY terminal. After some time, no more logs will be generated. Press Enter.

   # After some logs...
   [   15.611414] Bluetooth: RFCOMM TTY layer initialized
   [   15.616662] Bluetooth: RFCOMM socket layer initialized
   [   15.622145] Bluetooth: RFCOMM ver 1.11                   # Loading complete! Press Enter
   

7. Enter the account information to log in. The default account information is as follows. (ID: root, password: none)

   # After pressing the enter key in step 6
   webOS OSE 1.0.g raspberrypi4 ttyS0
   
   raspberrypi4 login: root
   

   Then the terminal of your target device will show up. Now you are ready to access the target device using the serial terminal.

   root@raspberrypi4:/sysroot/home/root#
   

Configuring the Target Device

If you finished setting up the serial connection, it’s time to configure the network information on the target device.

Follow the steps below to configure the network information on the target device. Make sure that the Ethernet cable is connected beforehand.

To set the manual network, type the following command on the serial terminal:

# Set IPv4 connection
root@raspberrypi4:/sysroot/home/root# luna-send -n 1 -f luna://com.webos.service.connectionmanager/setipv4 '{
    "method":"manual",
    "address":"<Your IP address>",
    "netmask":"<Your netmask>",
    "gateway":"<Your gateway address>"
}'

{
  "returnValue": true
}

# Set DNS Server
root@raspberrypi4:/sysroot/home/root# luna-send -n 1 -f luna://com.webos.service.connectionmanager/setdns '{"dns":["<Your DNS server IP address>"]}'

{
    "returnValue": true
}

You can check the network information using the following command:

root@raspberrypi4:/sysroot/home/root# luna-send -n 1 -f luna://com.webos.service.connectionmanager/getStatus {}

{
    "wired": {
        "netmask": "<Your netmask>",
        "ipAddress": "<Your IP address>",
        "proxyinfo": {
            "method": "direct"
        },
        "onInternet": "no",
        "method": "manual",
        "state": "connected",
        "gateway": "<Your gateway address>",
        "checkingInternet": false,
        "interfaceName": "ethO",
        "plugged": true
    },
    "isInternetConnectionAvailable": false,
    "subscribed": false,
    "offlineMode": "disabled",
    "wifi": {
        "tetheringEnabled": false,
        "state": "disconnected"
    },
    "returnValue": true,
    "wifiDirect": {
        "state": "disconnected"
    }
}

Connecting Host Machine with the Target Device

After the network connection has been set up, you can connect or send files to the target device using Secure Shell (SSH) protocol.

Here are several methods that you can use for host-target communication:

• To connect to the target device, use the ssh command on the host machine.
• To send files to the target device, use the scp (secure copy) command on the host machine.