From fe667463aa43f29980722a9b437f2be976edd362 Mon Sep 17 00:00:00 2001 From: alexandra Date: Thu, 11 Apr 2024 11:25:00 +0200 Subject: [PATCH 1/6] first draft --- .../X8-Manually-connect-to-WiFi.md | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md diff --git a/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md b/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md new file mode 100644 index 000000000..7d0a0c897 --- /dev/null +++ b/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md @@ -0,0 +1,71 @@ +--- +title: "X8 - Manually connect to WiFi" +--- + +To manually connect your board to WiFi, you have to utilize the command-line tool 'nmcli'. + +## Using the network manager tool + +To connect your board to a WiFi network using the network manager tool, use the following command: + +`nmcli device wifi connect password ` + +You can check the connection status by using this command: + +`nmcli de` + +It provides an overview of the current network connections managed by Network Manager. + +## Rescanning WiFi access points + +If you're having trouble connecting via the local web host or 'nmcli', you may need to refresh the list of available WiFi networks. To do this, simply use the following command: + +`nmcli device wifi rescan` + +This command instructs the system to search for nearby WiFi networks again, which updates the list of available networks. + +## Manage WiFi connections + +Managing WiFi connections allows you to create and delete custom connections on your board. + +``` +connectionName="" +mySSID="" +myPass="" + +#Create +nmcli con add type wifi ifname wlan0 con-name $connectionName ssid $mySSID password $myPass + +#Delete connection id +nmcli con del $connectionName +``` + +### For Enterprise Access Points + +When connecting to enterprise access points, the process differs slightly. Use these commands to create and manage connections for enterprise networks. + +``` +connectionName="" +mySSID="" +myUser="" +myPass="" +#Create and modify, it will connect autoamtically +nmcli con add type wifi ifname wlan0 con-name $connectionName ssid $mySSID +nmcli con modify $connectionName +ipv4.method auto +802-1x.eap peap +802-1x.phase2-auth mschapv2 +802-1x.identity $myUser +802-1x.password $myPass +wifi-sec.key-mgmt wpa-eap +#Delete connection id +nmcli con del $connectionName +``` + +### Connecting or Disconnecting from an existing connection + +If you already have a connection set up, you can easily connect or disconnect using the following commands: + +``` +#Connect +ncmli con up +``` + +``` +#Disconnect +nmcli con down +``` From 2581274cc728d7889a3406bb8dffa63581c688c2 Mon Sep 17 00:00:00 2001 From: alexandra Date: Mon, 15 Apr 2024 14:18:58 +0200 Subject: [PATCH 2/6] Corrected information added + grammar & structure --- .../X8-Manually-connect-to-WiFi.md | 96 ++++++++++++++----- 1 file changed, 73 insertions(+), 23 deletions(-) diff --git a/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md b/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md index 7d0a0c897..e5e6b54d6 100644 --- a/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md +++ b/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md @@ -2,70 +2,120 @@ title: "X8 - Manually connect to WiFi" --- -To manually connect your board to WiFi, you have to utilize the command-line tool 'nmcli'. +To manually connect your board to WiFi, you have to utilize the command-line tool `nmcli` through the Network Manager tool. -## Using the network manager tool +## Setting up the Network Manager tool -To connect your board to a WiFi network using the network manager tool, use the following command: +the Network Manager tool should be available in the Arduino IDE folder. Here's the path: `%localappdata%\Arduino15\packages\arduino\tools\adb\32.0.0` -`nmcli device wifi connect password ` +**For Windows:** -You can check the connection status by using this command: +1. Open Command Prompt. -`nmcli de` +1. Use the `cd` command to navigate to the extracted folder's location. `cd ` -It provides an overview of the current network connections managed by Network Manager. +1. Run `adb.exe shell`. -## Rescanning WiFi access points +**For Mac:** -If you're having trouble connecting via the local web host or 'nmcli', you may need to refresh the list of available WiFi networks. To do this, simply use the following command: +1. Open Terminal. -`nmcli device wifi rescan` +1. Use the `cd` command to navigate to the extracted folder's location. `cd ` -This command instructs the system to search for nearby WiFi networks again, which updates the list of available networks. +1. Run `./adb shell`. + +If you don't have the Network Manager tool, you can download it [here](https://developer.android.com/tools/releases/platform-tools#downloads). + +After downloading, follow these steps: + +1. Unzip the downloaded package to a convenient location on your computer. + +1. Copy the path to the extracted folder. You'll need this to navigate to the adb tool in the terminal. ## Manage WiFi connections Managing WiFi connections allows you to create and delete custom connections on your board. +### Set up variables + +Define variables to customize your WiFi connection + ``` -connectionName="" -mySSID="" -myPass="" +connectionName= +mySSID= +myPass= +``` + +### Create connection -#Create +With your variables set, you can establish a WiFi connection using this command: + +``` nmcli con add type wifi ifname wlan0 con-name $connectionName ssid $mySSID password $myPass +``` + +If the board successfully connects to WiFi, [The Status LED should be green](https://docs.arduino.cc/tutorials/portenta-x8/user-manual/#first-use-of-your-portenta-x8). + +### Delete connection -#Delete connection id +To remove a previously created connection, use the following command. + +``` nmcli con del $connectionName ``` -### For Enterprise Access Points +## For Enterprise Access Points When connecting to enterprise access points, the process differs slightly. Use these commands to create and manage connections for enterprise networks. +### Set up variables + +Define variables to configure your enterprise WiFi connection. + ``` connectionName="" mySSID="" myUser="" myPass="" -#Create and modify, it will connect autoamtically +``` + +### Create and configure connection + +With your variables set, use the following commands to configure the connection to the enterprise network. + +``` nmcli con add type wifi ifname wlan0 con-name $connectionName ssid $mySSID nmcli con modify $connectionName +ipv4.method auto +802-1x.eap peap +802-1x.phase2-auth mschapv2 +802-1x.identity $myUser +802-1x.password $myPass +wifi-sec.key-mgmt wpa-eap -#Delete connection id +``` + +### Delete connection + +To remove a previously created enterprise connection, use the following command. + +``` nmcli con del $connectionName ``` -### Connecting or Disconnecting from an existing connection +## Connecting or Disconnecting from an existing connection + +If you already have a connection set up, you can easily connect or disconnect using the following commands. -If you already have a connection set up, you can easily connect or disconnect using the following commands: +### Connect ``` -#Connect ncmli con up ``` +### Disconnect + ``` -#Disconnect nmcli con down ``` + +## Rescanning WiFi access points + +If you're having trouble connecting via the local web host or `nmcli`, you may need to refresh the list of available WiFi networks. To do this, simply use the following command. + +`nmcli device wifi` + +This command instructs the system to search for nearby WiFi networks again, which updates the list of available networks. From 578d57f8e077be2aada042ffb9e0e4eab00d5ac2 Mon Sep 17 00:00:00 2001 From: alexandra Date: Mon, 22 Apr 2024 11:04:41 +0200 Subject: [PATCH 3/6] revision after fb --- .../Connect-X8-to-Wi-Fi-using-nmcli.md | 127 ++++++++++++++++++ .../X8-Manually-connect-to-WiFi.md | 121 ----------------- 2 files changed, 127 insertions(+), 121 deletions(-) create mode 100644 content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md delete mode 100644 content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md diff --git a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md new file mode 100644 index 000000000..822a8d6f6 --- /dev/null +++ b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md @@ -0,0 +1,127 @@ +--- +title: "Connect X8 to Wi-Fi using nmcli" +--- + +To manually connect your board to Wi-Fi, you have to utilize the command-line tool `nmcli` through the Network Manager tool. + +## Setting up the Network Manager tool + +The Network Manager tool should be available in the [Arduino15](https://support.arduino.cc/hc/en-us/articles/360018448279-Open-the-Arduino15-folder) folder. Here's the path: `%localappdata%\Arduino15\packages\arduino\tools\adb\32.0.0` + +**For Windows:** + +1. Open Command Prompt. + +1. Use the `cd` command to navigate to the extracted folder's location. `cd %localappdata%\Arduino15\packages\arduino\tools\adb\32.0.0`. + +1. Run `adb.exe shell`. + +**For Mac:** + +1. Open Terminal. + +1. Use the `cd` command to navigate to the extracted folder's location. `cd ~/Library/Arduino15/packages/arduino/tools/adb/32.0.0`. + +1. Run `./adb shell`. + +**For Linux:** + +1. Open Terminal. + +1. Use the `cd` command to navigate to the extracted folder's location. `cd ~/.arduino15/packages/arduino/tools/adb/32.0.0`. + +1. Run `./adb shell`. + +If you don't have the Network Manager tool, you can download it [here](https://developer.android.com/tools/releases/platform-tools#downloads). + +## Manage Wi-Fi connections + +Managing Wi-Fi connections allows you to create and delete custom connections on your board. + +### Set up variables + +Define variables to customize your Wi-Fi connection + +``` +connectionName= +mySSID= +myPass= +``` + +### Create connection + +With your variables set, you can establish a Wi-Fi connection using this command: + +``` +nmcli con add type Wi-Fi ifname wlan0 con-name $connectionName ssid $mySSID password $myPass +``` + +If the board successfully connects to Wi-Fi, [The Status LED should be green](https://docs.arduino.cc/tutorials/portenta-x8/user-manual/#first-use-of-your-portenta-x8). + +### Delete connection + +To remove a previously created connection, use the following command. + +``` +nmcli con del $connectionName +``` + +## For Enterprise Access Points + +When connecting to enterprise access points, the process differs slightly. Use these commands to create and manage connections for enterprise networks. + +### Set up variables + +Define variables to configure your enterprise Wi-Fi connection. + +``` +connectionName="" +mySSID="" +myUser="" +myPass="" +``` + +### Create and configure connection + +With your variables set, use the following commands to configure the connection to the enterprise network. + +``` +nmcli con add type Wi-Fi ifname wlan0 con-name $connectionName ssid $mySSID +nmcli con modify $connectionName +ipv4.method auto +802-1x.eap peap +802-1x.phase2-auth mschapv2 +802-1x.identity $myUser +802-1x.password $myPass +Wi-Fi-sec.key-mgmt wpa-eap +``` + +### Delete connection + +To remove a previously created enterprise connection, use the following command. + +``` +nmcli con del $connectionName +``` + +## Connecting or Disconnecting from an existing connection + +If you already have a connection set up, you can easily connect or disconnect using the following commands. + +### Connect + +``` +nmcli con up +``` + +### Disconnect + +``` +nmcli con down +``` + +## Rescanning Wi-Fi access points + +If you're having trouble connecting via the local web host or `nmcli`, you may need to refresh the list of available Wi-Fi networks. To do this, simply use the following command. + +`nmcli device Wi-Fi` + +This command instructs the system to search for nearby Wi-Fi networks again, which updates the list of available networks. + +--- + +For further details, please refer to the [documentation](https://developer-old.gnome.org/NetworkManager/stable/nmcli.html). diff --git a/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md b/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md deleted file mode 100644 index e5e6b54d6..000000000 --- a/content/Hardware Support/Portenta Family/X8-Manually-connect-to-WiFi.md +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: "X8 - Manually connect to WiFi" ---- - -To manually connect your board to WiFi, you have to utilize the command-line tool `nmcli` through the Network Manager tool. - -## Setting up the Network Manager tool - -the Network Manager tool should be available in the Arduino IDE folder. Here's the path: `%localappdata%\Arduino15\packages\arduino\tools\adb\32.0.0` - -**For Windows:** - -1. Open Command Prompt. - -1. Use the `cd` command to navigate to the extracted folder's location. `cd ` - -1. Run `adb.exe shell`. - -**For Mac:** - -1. Open Terminal. - -1. Use the `cd` command to navigate to the extracted folder's location. `cd ` - -1. Run `./adb shell`. - -If you don't have the Network Manager tool, you can download it [here](https://developer.android.com/tools/releases/platform-tools#downloads). - -After downloading, follow these steps: - -1. Unzip the downloaded package to a convenient location on your computer. - -1. Copy the path to the extracted folder. You'll need this to navigate to the adb tool in the terminal. - -## Manage WiFi connections - -Managing WiFi connections allows you to create and delete custom connections on your board. - -### Set up variables - -Define variables to customize your WiFi connection - -``` -connectionName= -mySSID= -myPass= -``` - -### Create connection - -With your variables set, you can establish a WiFi connection using this command: - -``` -nmcli con add type wifi ifname wlan0 con-name $connectionName ssid $mySSID password $myPass -``` - -If the board successfully connects to WiFi, [The Status LED should be green](https://docs.arduino.cc/tutorials/portenta-x8/user-manual/#first-use-of-your-portenta-x8). - -### Delete connection - -To remove a previously created connection, use the following command. - -``` -nmcli con del $connectionName -``` - -## For Enterprise Access Points - -When connecting to enterprise access points, the process differs slightly. Use these commands to create and manage connections for enterprise networks. - -### Set up variables - -Define variables to configure your enterprise WiFi connection. - -``` -connectionName="" -mySSID="" -myUser="" -myPass="" -``` - -### Create and configure connection - -With your variables set, use the following commands to configure the connection to the enterprise network. - -``` -nmcli con add type wifi ifname wlan0 con-name $connectionName ssid $mySSID -nmcli con modify $connectionName +ipv4.method auto +802-1x.eap peap +802-1x.phase2-auth mschapv2 +802-1x.identity $myUser +802-1x.password $myPass +wifi-sec.key-mgmt wpa-eap -``` - -### Delete connection - -To remove a previously created enterprise connection, use the following command. - -``` -nmcli con del $connectionName -``` - -## Connecting or Disconnecting from an existing connection - -If you already have a connection set up, you can easily connect or disconnect using the following commands. - -### Connect - -``` -ncmli con up -``` - -### Disconnect - -``` -nmcli con down -``` - -## Rescanning WiFi access points - -If you're having trouble connecting via the local web host or `nmcli`, you may need to refresh the list of available WiFi networks. To do this, simply use the following command. - -`nmcli device wifi` - -This command instructs the system to search for nearby WiFi networks again, which updates the list of available networks. From c1fab9e1a1e084353715f10b2d30ba317cb0dfc5 Mon Sep 17 00:00:00 2001 From: seaxwi <71350948+seaxwi@users.noreply.github.com> Date: Tue, 7 May 2024 15:57:31 +0200 Subject: [PATCH 4/6] Clarify scope and purpose of article --- .../Connect-X8-to-Wi-Fi-using-nmcli.md | 93 ++++++++++++++++--- 1 file changed, 79 insertions(+), 14 deletions(-) diff --git a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md index 822a8d6f6..5787be911 100644 --- a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md +++ b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md @@ -2,39 +2,104 @@ title: "Connect X8 to Wi-Fi using nmcli" --- -To manually connect your board to Wi-Fi, you have to utilize the command-line tool `nmcli` through the Network Manager tool. +Learn how to connect and configure a Wi-Fi connection for Portenta X8 using `nmcli` (Network Manager tool). -## Setting up the Network Manager tool +> [!TIP] +> Portenta X8 features an [Out-of-the-box experience](https://docs.arduino.cc/tutorials/portenta-x8/user-manual/#out-of-the-box-experience) that helps you set up a Wi-Fi connection. -The Network Manager tool should be available in the [Arduino15](https://support.arduino.cc/hc/en-us/articles/360018448279-Open-the-Arduino15-folder) folder. Here's the path: `%localappdata%\Arduino15\packages\arduino\tools\adb\32.0.0` +--- + +## 1. Open the Android Debug Bridge shell + +The Network Manager tool is available in the [Arduino15 folder](https://support.arduino.cc/hc/en-us/articles/360018448279-Open-the-Arduino15-folder) if you've installed **Arduino Mbed OS Portenta Boards** package using Arduino IDE or Arduino CLI. -**For Windows:** +**Windows:** 1. Open Command Prompt. -1. Use the `cd` command to navigate to the extracted folder's location. `cd %localappdata%\Arduino15\packages\arduino\tools\adb\32.0.0`. +1. Run the following command to enter the `adb` folder: + + ``` + cd %localappdata%\Arduino15\packages\arduino\tools\adb + ``` + +1. Run this command to list the installed versions: + + ``` + dir + ``` -1. Run `adb.exe shell`. +1. Open the installed version: -**For Mac:** + ``` + cd + ``` + +1. Run adb: + + ``` + adb.exe shell + ``` + +**macOS:** 1. Open Terminal. -1. Use the `cd` command to navigate to the extracted folder's location. `cd ~/Library/Arduino15/packages/arduino/tools/adb/32.0.0`. +1. Run the following command to enter the `adb` folder: + + ``` + cd ~/Library/Arduino15/packages/arduino/tools/adb + ``` + +1. Run this command to list the installed versions: -1. Run `./adb shell`. + ``` + ls + ``` -**For Linux:** +1. Open the installed version: + + ``` + cd + ``` + +1. Run adb: + + ``` + ./adb shell + ``` + +**Linux:** 1. Open Terminal. -1. Use the `cd` command to navigate to the extracted folder's location. `cd ~/.arduino15/packages/arduino/tools/adb/32.0.0`. +1. Run the following command to enter the `adb` folder: + + ``` + cd ~/.arduino15/packages/arduino/tools/adb + ``` + +1. Run this command to list the installed versions: -1. Run `./adb shell`. + ``` + ls + ``` -If you don't have the Network Manager tool, you can download it [here](https://developer.android.com/tools/releases/platform-tools#downloads). +1. Open the installed version: + + ``` + cd + ``` + +1. Run adb: + + ``` + ./adb shell + ``` + +--- -## Manage Wi-Fi connections +## 2. Using nmcli to manage Wi-Fi connections Managing Wi-Fi connections allows you to create and delete custom connections on your board. From 4a39e370c3ce67de0edc79f72085dc39f1948ead Mon Sep 17 00:00:00 2001 From: alexandra Date: Mon, 20 May 2024 11:17:23 +0200 Subject: [PATCH 5/6] Removed step for opening the Android Debug Bridge shell --- .../Connect-X8-to-Wi-Fi-using-nmcli.md | 94 +------------------ 1 file changed, 4 insertions(+), 90 deletions(-) diff --git a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md index 5787be911..574fb7e1d 100644 --- a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md +++ b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md @@ -9,99 +9,13 @@ Learn how to connect and configure a Wi-Fi connection for Portenta X8 using `nmc --- -## 1. Open the Android Debug Bridge shell +## Using nmcli to manage Wi-Fi connections -The Network Manager tool is available in the [Arduino15 folder](https://support.arduino.cc/hc/en-us/articles/360018448279-Open-the-Arduino15-folder) if you've installed **Arduino Mbed OS Portenta Boards** package using Arduino IDE or Arduino CLI. - -**Windows:** - -1. Open Command Prompt. - -1. Run the following command to enter the `adb` folder: - - ``` - cd %localappdata%\Arduino15\packages\arduino\tools\adb - ``` - -1. Run this command to list the installed versions: - - ``` - dir - ``` - -1. Open the installed version: - - ``` - cd - ``` - -1. Run adb: - - ``` - adb.exe shell - ``` - -**macOS:** - -1. Open Terminal. - -1. Run the following command to enter the `adb` folder: - - ``` - cd ~/Library/Arduino15/packages/arduino/tools/adb - ``` - -1. Run this command to list the installed versions: - - ``` - ls - ``` - -1. Open the installed version: - - ``` - cd - ``` - -1. Run adb: - - ``` - ./adb shell - ``` - -**Linux:** - -1. Open Terminal. - -1. Run the following command to enter the `adb` folder: - - ``` - cd ~/.arduino15/packages/arduino/tools/adb - ``` - -1. Run this command to list the installed versions: - - ``` - ls - ``` - -1. Open the installed version: - - ``` - cd - ``` - -1. Run adb: - - ``` - ./adb shell - ``` - ---- +Managing Wi-Fi connections allows you to create and delete custom connections on your board. -## 2. Using nmcli to manage Wi-Fi connections +### Open the Android Debug Bridge shell -Managing Wi-Fi connections allows you to create and delete custom connections on your board. +Before starting, open the [Android Debug Bridge shell](https://support.arduino.cc/hc/en-us/articles/14013004356124-Access-the-Linux-command-line-shell-on-Portenta-X8) ### Set up variables From 06e181c726f3c37432bce6ca8ce9e14f104b97c6 Mon Sep 17 00:00:00 2001 From: alexandra Date: Wed, 22 May 2024 10:10:39 +0200 Subject: [PATCH 6/6] Structure change --- .../Connect-X8-to-Wi-Fi-using-nmcli.md | 82 ++++--------------- 1 file changed, 18 insertions(+), 64 deletions(-) diff --git a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md index 574fb7e1d..185dbaa5f 100644 --- a/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md +++ b/content/Hardware Support/Portenta Family/Connect-X8-to-Wi-Fi-using-nmcli.md @@ -9,97 +9,51 @@ Learn how to connect and configure a Wi-Fi connection for Portenta X8 using `nmc --- -## Using nmcli to manage Wi-Fi connections - -Managing Wi-Fi connections allows you to create and delete custom connections on your board. - -### Open the Android Debug Bridge shell +## Open the Android Debug Bridge shell Before starting, open the [Android Debug Bridge shell](https://support.arduino.cc/hc/en-us/articles/14013004356124-Access-the-Linux-command-line-shell-on-Portenta-X8) -### Set up variables - -Define variables to customize your Wi-Fi connection - -``` -connectionName= -mySSID= -myPass= -``` - -### Create connection - -With your variables set, you can establish a Wi-Fi connection using this command: - -``` -nmcli con add type Wi-Fi ifname wlan0 con-name $connectionName ssid $mySSID password $myPass -``` - -If the board successfully connects to Wi-Fi, [The Status LED should be green](https://docs.arduino.cc/tutorials/portenta-x8/user-manual/#first-use-of-your-portenta-x8). - -### Delete connection +## View Wi-Fi Access points -To remove a previously created connection, use the following command. +To see a list of the Wi-Fi access points available, you can use the following command. ``` -nmcli con del $connectionName +nmcli dev wifi list ``` -## For Enterprise Access Points - -When connecting to enterprise access points, the process differs slightly. Use these commands to create and manage connections for enterprise networks. +## Create a new Wi-Fi connection profile -### Set up variables +### Add Wi-Fi Connection Profile -Define variables to configure your enterprise Wi-Fi connection. +Use the `nmcli con add` command to add a new Wi-Fi connection profile. ``` -connectionName="" -mySSID="" -myUser="" -myPass="" +nmcli con add con-name [connection-name] ifname wlp61s0 type wifi ssid [ssid] ``` -### Create and configure connection +Replace [connection-name] with the prefered connection name and [ssid] with the name of the Wi-Fi. -With your variables set, use the following commands to configure the connection to the enterprise network. +### Modify Wi-Fi Connection Profile -``` -nmcli con add type Wi-Fi ifname wlan0 con-name $connectionName ssid $mySSID -nmcli con modify $connectionName +ipv4.method auto +802-1x.eap peap +802-1x.phase2-auth mschapv2 +802-1x.identity $myUser +802-1x.password $myPass +Wi-Fi-sec.key-mgmt wpa-eap -``` - -### Delete connection - -To remove a previously created enterprise connection, use the following command. +Use the `nmcli con modify` command to change various settings of the network connection. For example, to rename an existing connection, use the following command. ``` -nmcli con del $connectionName +nmcli con modify [old-connection-name] connection.id [new-connection-name] ``` -## Connecting or Disconnecting from an existing connection +Replace [old-connection-name] with the current name of the connection and [new-connection-name] with the new prefered name. -If you already have a connection set up, you can easily connect or disconnect using the following commands. +## Connect to a network -### Connect +Once you've set up a connection profile, you can easily connect to the Wi-Fi using the following command. ``` -nmcli con up +nmcli con up [connection-name] ``` -### Disconnect +Replace [connection-name] with the name of the connection profile you created earlier. -``` -nmcli con down -``` - -## Rescanning Wi-Fi access points - -If you're having trouble connecting via the local web host or `nmcli`, you may need to refresh the list of available Wi-Fi networks. To do this, simply use the following command. - -`nmcli device Wi-Fi` - -This command instructs the system to search for nearby Wi-Fi networks again, which updates the list of available networks. +If the board successfully connects to Wi-Fi, [The Status LED should be green](https://docs.arduino.cc/tutorials/portenta-x8/user-manual/#first-use-of-your-portenta-x8). ---