Wi-Fi setup

Table of contents

  1. Prerequisites
  2. Setup Hardware
  3. Configure Station Mode
  4. Configure Soft AP Mode
    1. Configure hostname for Soft AP Mode (Optional)
  5. Next Steps

Prerequisites

These instructions assume that the VOXL has the voxl-utils package installed (which is a factory default). If the package is not installed, please follow the instructions here: https://gitlab.com/voxl-public/voxl-utils

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 the unit back on
  • 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)

VOXL Wi-Fi

Configure Station Mode

Station Mode (STA) refers to the VOXL being configured into a typical ‘Wi-Fi client’, where it is a node on a wireless network.

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

voxl-wifi station <SSID> [Password]

A reboot of the VOXL is required to finish the setup:

shutdown -r now

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

ifconfig

Or you can use a tool like AngryIP and scan your local network for the device.

Configure Soft AP Mode

Software enabled Access Point Mode (AP) refers to the VOXL being configured such that it provides wireless router functionality, where other Wi-Fi devices can connect to it (camp on it).

To configure the VOXL into Access Point Mode, run the following command.

The password to connect to the VOXL while in Soft AP mode will be set to 1234567890.

voxl-wifi softap <ssid>

A reboot of the VOXL is required to finish the setup:

shutdown -r now

After connected to the newly setup AP, the VOXL’s IP will be 192.168.8.1.

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 the VOXL

Copyright (c) 2019 ModalAI Inc.