Skip to content

Commit 218ac35

Browse files
committed
Update wifi-config_v5_7.rst
1 parent a3b9f6d commit 218ac35

1 file changed

Lines changed: 30 additions & 26 deletions

File tree

docs/ex-commandstation/advanced-setup/supported-wifi/wifi-config_v5_7.rst

Lines changed: 30 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ From version 5.7.0, config.h options for WiFi configuration in ``config.h`` igno
3434

3535
It is now necessary to use the new WiFi configuration method, which involves connecting to the |EX-CS| *after you have flashed the firmware.* You do so by connecting to the |EX-CS| via USB or by connecting to the WiFi Access Point network of the CS. (Note that the WiFi Access Point network approach has limitations.)
3636

37-
The advantage of this is that it is independent of the flashing process, and will remeber your WiFi settings across firmware updates and changes.
37+
The advantage of this is that it is independent of the flashing process, and will remember your WiFi settings across firmware updates and changes.
3838

3939
You can configuring WiFi settings through:
4040

@@ -65,9 +65,11 @@ The are some additional settings that are not mode but effect the wifi connectio
6565
Accessing via USB vs WiFi
6666
==========================
6767

68-
Only **Station (STA) mode** can be changed over WiFi.
68+
Only **Station (STA) mode** and the **HOSTNAME** can be changed over WiFi.
6969

70-
**Access Point (AP)** mode changes require a serial connection.
70+
**Access Point (AP)** mode changes require a serial/USB connection.
71+
72+
----
7173

7274
Changing the settings
7375
======================
@@ -105,9 +107,9 @@ EX-Toolbox
105107

106108
1. Connect your PC to the |EX-TB| via USB or Wifi. See :doc:`EX-Toolbox </ex-toolbox/using>` for more details.
107109

108-
2. go to the ``WiFi Setup`` page from the menu or the toolbar buttons and follow the same steps as outlined for the |EX-WT| above.
110+
2. Go to the ``WiFi Setup`` page from the menu or the toolbar buttons and follow the same steps as outlined for the |EX-WT| above.
109111

110-
Note: Only **Station (STA) mode** can be changed over WiFi. **Access Point (AP)** mode changes require a USB connection.
112+
Note: Only **Station (STA) mode** and the **HOSTNAME** can be changed over WiFi. **Access Point (AP) mode** changes require a USB connection.
111113

112114
In every case above, the Command Station will restart to apply the new settings. You will need to reconnecting to the Command Station in the |EX-TB| interface.
113115

@@ -120,14 +122,15 @@ The process for configuring WiFi settings using the serial monitor or device mon
120122

121123
In every case below, the Command Station will restart to apply the new settings. You will need to reconnecting to the Command Station in the app's interface.
122124

123-
Changing to Station Mode
124-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
125+
Changing to Station Mode
126+
~~~~~~~~~~~~~~~~~~~~~~~~~~
125127

126128
i.e. your home router. You will need to issue the command:
127129

128-
```cpp
129-
<C WIFI "routerSSID" "routerPassword">
130-
```
130+
.. code-block:: cpp
131+
132+
<C WIFI "routerSSID" "routerPassword">
133+
131134
e.g. Sets the STA mode to connect to a router with SSID "routerSSID" and password
132135

133136
The command station will attempt to connect to this network immediately, and on each rerstart. If it fails to connect, it will revert to AP mode.
@@ -137,18 +140,19 @@ Changing the Access Point settings
137140

138141
To give the Access point a specific name and a password that will not be revealed on the OLED use the command:
139142

140-
```cpp
141-
<C WIFI AP "MyCSB1" "SpamWonderfulSpam">
142-
```
143+
.. code-block:: cpp
144+
145+
<C WIFI AP "MyCSB1" "SpamWonderfulSpam">
146+
143147
e.g. Sets the AP name to "MyCSB1" and the password to "SpamWonderfulSpam":
144148

145149
The AP mode password must be at least 8 characters long.
146150

147151
The default channel is set to "11". If you need to use an alternate channel (we recommend using only 1,6, or 11) you may change it with the command:
148152

149-
```cpp
150-
<C WIFI AP "MyCSB1" "SpamWonderfulSpam" 6>
151-
```
153+
.. code-block:: cpp
154+
155+
<C WIFI AP "MyCSB1" "SpamWonderfulSpam" 6>
152156
153157
Use a phone WiFi analyser app to see which channels are relatively quiet in your area.
154158

@@ -157,26 +161,26 @@ Hidden Access Point mode
157161

158162
In some environments you may want to hide the SSID from phones scanning for access points. If you do hide the SSID, it is still possible to connect by entering the SSID manually on the phone/tablet.
159163

160-
```cpp
161-
<C WIFI HIDDENAP "MyCSB1" "SpamWonderfulSpam" 6>
162-
```
164+
.. code-block:: cpp
165+
166+
<C WIFI HIDDENAP "MyCSB1" "SpamWonderfulSpam" 6>
163167
164168
Configuring the Host Name
165-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
169+
~~~~~~~~~~~~~~~~~~~~~~~~~~
166170

167171
The default hostname "DCCEX" but you can change this if you have more than one CS on your network to make them show up with different names. Host names containing "DCCEX" are more readily found by WiFi throttles.
168172

169-
```cpp
170-
<C WIFI HOSTNAME "DCCEX-MYCSB1">
171-
```
173+
.. code-block:: cpp
174+
175+
<C WIFI HOSTNAME "DCCEX-MYCSB1">
172176
173177
e.g. Sets the hostname to "DCCEX-MYCSB1":
174178

175179
Clearing WiFi settings
176180
~~~~~~~~~~~~~~~~~~~~~~~~
177181

178-
```cpp
179-
<C WIFI DEFAULT>
180-
```
182+
.. code-block:: cpp
183+
184+
<C WIFI DEFAULT>
181185
182186
WiFi will revert to the internally generated ssid and password.

0 commit comments

Comments
 (0)