Wi-Fi

The Wi-Fi connection on your controller can be configured using the Linux service named Network Manager. You can use Network Manager via the serial terminal or the SSH terminal.

---

Connect to a Wi-Fi Network

When you are connected to your controller using Wi-Fi, keep in mind that changing Wi-Fi setting will disconnect the SSH session and eventually lock you out. Be sure to have a backup over wired ethernet or USB before changing Wi-Fi settings.

Start with scanning for available Wi-Fi networks:

nmcli dev wifi 

Note: You might need to deactivate the Access Point first with:

nmcli con down GOcontroll-AP

Typical output:

To connect to a Wi-Fi network that is available to the controller, you can use the following command:

nmcli dev wifi connect "net name" password "password"

Lets assume we want to connect to the “GOcontroll_Guest” network. The command look like this:

nmcli dev wifi connect "GOcontroll_Guest" password "WelcomeGuest"

At this point the controller might still decide to activate the Access Point instead of connecting to this network on the next boot. To make sure that doesn’t happen you can disable the Access Point with:

nmcli con mod GOcontroll-AP connection.autoconnect no

Here we modify the connection.autoconnect property of the connection named GOcontroll-AP, to re-enable the Access Point simply change the “no” into “yes” in the above command.

---

Validate an active Wi-Fi connection

After successful connection to the network, your terminal should confirm your wlan connection is sucesfully activated. To verify if your connection is up and running, you can use command:

nmcli con

This command will list all active connections

---

Delete existing Wi-Fi connection

If you want to delete an existing connection you can simply execute:

nmcli con delete "net name"

Lets assume we want to delete the GOcontroll_Guest network, we execute:

nmcli con delete "GOcontroll_Guest"

---

Reset access point configuration

To switch back to the default access point configuration, GOcontroll prepared a script that restores the default settings of the access point. Naming is based on the serial number and the password is set to default: Moduline. The following command can be used:

go-reset-ap 

---

Change access point password

nmcli connection modify "connection name" wifi-sec.psk "your new password"

Lets assume we want to change the password from our existing access point with SSID “GOcontroll-AP-B041” to “ModulineIV”, the following command can be used:

nmcli connection modify "GOcontroll-AP" wifi-sec.psk "ModulineIV"

Note: the new password must be at least 8 characters, otherwise it will give a “property is invalid” error.

Your new password is required during the next login after a reboot of the controller. When you want to change the password during runtime, the following commands can be used:

nmcli connection down "GOcontroll-AP"
nmcli connection up "GOcontroll-AP"