Wi-Fi

In order to use Wi-Fi network, you need to plug a wifi dongle to the USB port of the device. We pre-installed Linux firmware package to support a wide ranges of the wifi chips. The full list is in section.

So far we confirmed the following wifi dongles are tested and working:

USB ID	driver
7392:b811	rtl8188eu
0bda:8179	rtl8188eu

It can be a dongle with native Type-C interface or with a adapter like the following image:

Tips

The command in this document can be executed in Console Tab or in a SSH session.

Verify USB Dongle working

Plug your Wi-Fi dongle. use ip command to check if there is a new network device.
```
ip link
```

You should find wlan0 in the output.

web-888:~# ip link
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
2: sit0@NONE: <NOARP> mtu 1480 qdisc noop state DOWN qlen 1000
    link/sit 0.0.0.0 brd 0.0.0.0
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
    link/ether 66:4f:19:a8:c0:41 brd ff:ff:ff:ff:ff:ff
4: wlan0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc mq state DOWN qlen 1000
    link/ether 20:0d:b0:1f:64:7c brd ff:ff:ff:ff:ff:ff

If you cannot find wlan0, please try to use lsusb to verify the dongle is recognized.

web-888:~# lsusb
Bus 001 Device 001: ID 1d6b:0002
Bus 001 Device 002: ID 0bda:8179

The first line is the usb hub. The second line is the usb dongle device. It is vary with the different Wi-Fi dongles.

If you can find your device is listed while no wlan0, please check your dmesg to find out if there is error related to wifi or USB. If not, most likely your chip is not supported.

Connect to Wi-Fi network

Connect to the existing Wi-Fi network. The command has two parameters. The first one is the Wi-Fi SSID name, which is mandatory. The second one is the password, omit it if the network is Open and no password.
```
/root/wifi/client.sh SSID PASSWORD
```
Use ip command to check if there is IP address for the wlan0 adapter.
```
ip addr
```
If everything works fine, store the change to tf-card
```
lbu commit -d
```

Setup a Wi-Fi hotpot

Warning

Some cheap USB dongle may not support AP mode though.

Switch to Wi-Fi hot-spot mode:
```
/root/wifi/hotspot.sh
```
If everything works fine, store the change to tf-card
```
lbu commit -d
```
Scan WEB-888 WIFI hotspot in minutes.

Supported Chipset of Wi-Fi dongle

The list is based on the firmware and driver included in the firmware image. We didn't test this but in theory they should work.

Driver	Manufacturer	cfg80211	AP	IBSS	mesh	monitor	PHY modes
ar5523	Atheros	yes	no	no	no	yes	A(2)/B/G
at76c50x-usb	Atmel	yes	no	no	no	no	B
ath6kl	Atheros	yes	no	yes	no	no	A/B/G/N
ath9k_htc	Atheros	yes	yes	yes	yes	yes	B/G/N
brcmfmac	Broadcom	yes	yes	yes	no	no	A(1)/B/G/N/AC
carl9170	ZyDAS/Atheros	yes	yes	yes	yes	yes	A(1)/B/G/N
libertas_tf	Marvell	yes	yes	no	yes	?	B/G
mt7601u	Mediatek	yes	?	?	?	?	B/G/N/
p54usb	Intersil/Conexant	yes	yes	yes	yes	yes	A(1)/B/G
prism2_usb	Intersil/Conexant	yes	?	?	?	?	B
r8192u_usb	Realtek	no	?	?	?	?	B/G/N
r8712u	Realtek	no	?	?	?	?	B/G/N
rt73usb	Ralink	yes	yes	yes	no	yes	A(1)/B/G
rt2500usb	Ralink	yes	yes	yes	no	yes	A(1)/B/G
rt2800usb	Ralink	yes	yes	yes	yes(5)	yes	A(1)/B/G/N
rtl8xxxu	Realtek	yes	?	?	?	?	A(1)/B/G/N
rtl8187	Realtek	yes	no	yes	no	yes	B/G
rtl8188eu	Realtek	yes	yes	yes	no	yes	B/G
rtl8192cu	Realtek	yes	yes	?	?	yes	B/G/N
r8723au	Realtek	yes	?	?	?	?	B/G/N
vt6656	VIA	yes	yes	yes	no	no	A/B/G
winbond	Winbond	yes	?	?	?	?	B
zd1201	ZyDAS/Atheros	no	?	?	?	?	B
zd1211rw	ZyDAS/Atheros	yes	yes	yes	yes	yes	A(2)/B/G