Switch to Repeater mode

LinkIt Smart 7688 development board can be used as a repeater with firmware v0.9.4 and above. A repeater relays a transmitted signal such as the Wi-Fi to different areas of a place, for example a house, thus extending the Wi-Fi coverage area in an establishment. This section describes how to switch the LinkIt Smart 7688 development board to Repeater mode. 

There are two methods to achieve this purpose:

  1. Use the Web UI.
  2. Apply UCI commands provided in OpenWrt

Using the Web UI

  • Follows the steps described in sign in the Web UI, if you haven't done so already.
  • Open the Web UI and click Network, as shown below.


  • In the Network setting screen, select Repeater mode and select an existing Wi-Fi network which you would like to join in.

  • Type the desired Repeater SSID name and password (if needed), which are assigned to this board as a repeater.

  • Click CONFIGURE & RESTART to finish, as shown below.

  • After you’ve switched to Repeater mode successfully, the system will restart and the system status is shown by the Wi-Fi LED. When the repeater is connecting to the desired network, the Wi-Fi LED confirms this by blinking twice per second, the same blinking status as the Station mode. When the connection is established, the LED turns into normal data transmission pattern. For more information about LED states of the board, check here.

    If you enter the password for joining the existing network incorrectly, you can reset the board to AP mode by pressing the Wi-Fi button for at least 5 seconds and release and then repeat the settings of the Repeater mode network setup.

  • Connect your host computer to the repeater with the SSID assigned in the previous step. Check the internet connection by typing  ping -c 5 www.mediatek.com in the Terminal window. If the ping utility reports errors such as unreachable destination, please reset your network setting to AP mode and repeat the steps above for configuring the Repeater mode again.

Using UCI Commands

Quick steps

  • Use UCI commands to assign repeater SSID, repeater password, and information about the network to be connected.
  • Type a command to restart the Wi-Fi driver to activate the Repeater configuration.
  • Check for internet connection.


Step 1 — Use UCI commands to assign repeater SSID, password and information of the network to be connected.

Assume the wireless router to be connected has the following properties:

  • SSID: SampleAP
  • Password: 12345678
  • Encryption: WPA2 Personal

And the repeater has the following configuration:

  • SSID: MyRepeater

In the system console of LinkIt Smart 7688, type the following commands: 

# uci set wireless.sta.ssid=SampleAP
# uci set wireless.sta.key=12345678
# uci set wireless.sta.encryption=psk2
# uci set wireless.ap.ssid=MyRepeater
# uci commit

Step 2 — Type a command to restart the Wi-Fi driver to activate the Repeater configuration.

Type the following command in the system console:

# wifi_mode apsta

If you use SSH to connect to the system console of the LinkIt Smart 7688 development board, you'll lose the connection once the wifi_mode command is set. This command will restart the Wi-Fi driver.

You can also refer to the LED behavior to check the states of the connection, which is identical to the Station mode.

Step 3 — Check for internet connection

Now the repeater has successfully connected to the existing network, you can connect your host PC to the repeater to check the internet connection by typing the following command in the system console:

# ping -c 5 www.mediatek.com

If you see messages similar to below, then congratulations. You’ve connected to the repeater with internet access.

root@mylinkit:/# ping -c 5 www.mediatek.com  
PING www.mediatek.com ( 56 data bytes  
64 bytes from seq=0 ttl=244 time=388.372 ms  
64 bytes from seq=1 ttl=244 time=368.003 ms  
64 bytes from seq=2 ttl=244 time=397.851 ms  
64 bytes from seq=3 ttl=244 time=417.423 ms  
64 bytes from seq=4 ttl=244 time=357.303 ms   
--- www.mediatek.com ping statistics ---  5 packets transmitted, 
5 packets received, 0% packet loss  
round-trip min/avg/max = 357.303/385.790/417.423 ms