Table of contents
- Setup Hardware
- Power up VOXL
- Configure Station Mode
- Configure SoftAP Mode
- Check VOXL’s IP Address
- Check WiFi Mode
- Next Steps
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.
- 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
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, we can SSH into VOXL.