Networking on the VMX

info

Out of the box, the VMX broadcasts a Wi-Fi network with SSID VMX-1234 and uses the password password. Older VMX versions may ship with SSID WorldSkills-1234 and the same default password.

The VMX supports four communication methods.

1. Wi-Fi Access Point (AP)
2. Wi-Fi Client (Normal Internet Connection)
3. Ethernet (Preferred)
4. Direct Desktop Connection

tip

Keep the VMX in Wi-Fi AP mode for normal use. Use Ethernet as the preferred connection method.

Wi-Fi Access Point (AP)

In Wi-Fi AP mode, the VMX creates its own Wi-Fi network. Connect a computer directly to that network.

In Wi-Fi AP mode, the VMX uses 10.XX.YY.2. Replace XX.YY with the four-digit team number. The default image uses team number 1234, which yields 10.12.34.2.

A built-in VMX script manages the Wi-Fi AP SSID, team number, and password.

Ubuntu

sudo setupHotspot SSID TEAMNUMBER BAND PASSWORD

Where:

• SSID defines the Wi-Fi name prefix. The default uses VMX (the VMX in VMX-1234).
• TEAMNUMBER defines the Wi-Fi name suffix. The default uses 1234 (the 1234 in VMX-1234).
• BAND defines the Wi-Fi band to use. 2.4 or 5.
• PASSWORD optionally sets the Wi-Fi password.

After running the command above, the script prompts for a channel number based on the selected BAND. For 2.4 networks, valid channels range from 1 to 11. For 5 networks, valid channels vary by country due to strict compliance requirements. The script automatically shows the valid channels for your country.

tip

For 2.4 networks, use channels 1, 6, or 11 because those channels do not overlap.

important

5 networks require a country code. Run the command below to define it. This example uses CA for Canada.

sudo iw reg set CA 

The default image configures Wi-Fi as VMX-1234 with password password on the 2.4 band and channel 1. Run the setup script like this:

sudo setupHotspot VMX 1234 2.4 password

To change the Wi-Fi name to TestRobot-4444 with password Checkers, run:

sudo setupHotspot TestRobot 4444 2.4 Checkers

Raspbian

setupWifiAP.sh SSID TEAMNUMBER PASSWORD

Where:

• SSID defines the Wi-Fi name prefix. The default uses VMX (the VMX in VMX-1234).
• TEAMNUMBER defines the Wi-Fi name suffix. The default uses 1234 (the 1234 in VMX-1234).
• PASSWORD optionally sets the Wi-Fi password.

The default image configures Wi-Fi as VMX-1234 with password password. Run the setup script like this:

setupWifiAP.sh VMX 1234 password

To change the Wi-Fi name to TestRobot-4444 with password Checkers, run:

setupWifiAP.sh TestRobot 4444 Checkers

After running the command, the network will now look like this:

Ubuntu

When switching from Client mode to AP mode, keep the existing SSID, team number, and password. Run the toggleNetMode script.

toggleNetMode ap

Raspbian

When switching from Client mode to AP mode, keep the existing SSID, team number, and password. Run the script with no parameters:

setupWifiAP.sh

Ethernet

Ethernet remains active at all times and uses a fixed configuration. Use Ethernet whenever possible, except when a run requires wireless operation.

The VMX Ethernet port uses 172.22.11.2.

Wi-Fi Client

Wi-Fi Client mode disables the Wi-Fi AP and connects the VMX to a Wi-Fi router. Use this mode only for updates or package downloads.

Run the following command in the terminal to put the VMX into Wi-Fi Client mode.

Ubuntu

toggleNetMode wifi

Raspbian

setupWifiClient.sh

tip

Connect to the VMX over Ethernet, remote in, switch to Client mode, complete the required task, then switch back to AP mode using the commands above.