WiFi setup

Table of contents

  1. Overview
  2. Setup Hardware
  3. Power up VOXL
  4. Configure Station Mode
  5. Configure SoftAP Mode
  6. Check VOXL’s IP Address
  7. Check WiFi Mode
    1. Configure hostname for Soft AP Mode (Optional)
  8. Next Steps

Overview

VOXL supports two wifi modes, Station and SoftAP. Station Mode refers to the VOXL being configured into a typical ‘WiFi client’ on a wireless network like your phone or laptop. Software enabled Access Point Mode (SoftAP) configures VOXL to generate its own hotspot so that other WiFi devices can connect to it. This is useful if you are in the field away from your home or office WiFi network.

By default, the unit ships configured in SoftAP mode with an SSID of VOXL-XX:XX:XX:XX:XX:XX with password 1234567890 (where XX:XX:XX:XX:XX:XX is the unit’s MAC address).

These instructions requires the voxl-utils package from the voxl-software-bundle that you installed in the previous step.

Setup Hardware

  • Disconnect power from the VOXL
  • Attach Wi-Fi antennas as shown below (note it takes a little force to connect the MHF4 U.FL connectors)
  • Power up VOXL

VOXL Wi-Fi

Configure Station Mode

To configure the VOXL into Station Mode, run the following command:

me@mylaptop:~$ adb shell voxl-wifi station <SSID> <Password>

A reboot of VOXL is required to finish the setup:

me@mylaptop:~$ adb reboot && adb wait-for-device

Configure SoftAP Mode

To configure the VOXL into Access Point Mode with your desired SSID, use the voxl-wifi utility and reboot for the changes to take effect.

me@mylaptop:~$ adb shell voxl-wifi softap <SSID>
me@mylaptop:~$ adb reboot && adb wait-for-device

The password to connect to the VOXL’s hotspot is 1234567890 and VOXL will assign itself the IP 192.168.8.1. Your device will be assigned an IP with DHCP in the 192.168.8.X subnet, usually 192.168.8.60, but not always.

Check VOXL’s IP Address

VOXL will connect to the network when it powers up. If you need to locate its IP address, you can connct via ADB and run the following command:

me@mylaptop:~$ adb shell ifconfig
lo        Link encap:Local Loopback
          inet addr:127.0.0.1  Mask:255.0.0.0
          inet6 addr: ::1/128 Scope:Host
          UP LOOPBACK RUNNING  MTU:65536  Metric:1
          RX packets:81 errors:0 dropped:0 overruns:0 frame:0
          TX packets:81 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:0
          RX bytes:6140 (5.9 KiB)  TX bytes:6140 (5.9 KiB)

wlan0     Link encap:Ethernet  HWaddr 48:5F:99:9D:40:9D
          inet addr:192.168.8.1  Bcast:192.168.8.255  Mask:255.255.255.0
          inet6 addr: fe80::4a5f:99ff:fe9d:409d/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:218 errors:0 dropped:0 overruns:0 frame:0
          TX packets:141 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:3000
          RX bytes:23365 (22.8 KiB)  TX bytes:13134 (12.8 KiB)

Here you can see the localhost interface at 127.0.0.1 just as you have on your Linux host computer. The wlan0 interface is for the onboard WiFi.

Check WiFi Mode

Print the current mode (softap or station)

me@mylaptop:~$ voxl-wifi getmode
station

Configure hostname for Soft AP Mode (Optional)

It may be desired to have a dedicated hostname for your target instead of using an IP. This thread describes how to enable.

TODO Clean up contents of thread into clear instructions.

Next Steps

Next, we can SSH into VOXL.