You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ex-commandstation/advanced-setup/supported-wifi/wifi-config_v5_7.rst
+30-26Lines changed: 30 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ From version 5.7.0, config.h options for WiFi configuration in ``config.h`` igno
34
34
35
35
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.)
36
36
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.
38
38
39
39
You can configuring WiFi settings through:
40
40
@@ -65,9 +65,11 @@ The are some additional settings that are not mode but effect the wifi connectio
65
65
Accessing via USB vs WiFi
66
66
==========================
67
67
68
-
Only **Station (STA) mode** can be changed over WiFi.
68
+
Only **Station (STA) mode** and the **HOSTNAME** can be changed over WiFi.
69
69
70
-
**Access Point (AP)** mode changes require a serial connection.
70
+
**Access Point (AP)** mode changes require a serial/USB connection.
71
+
72
+
----
71
73
72
74
Changing the settings
73
75
======================
@@ -105,9 +107,9 @@ EX-Toolbox
105
107
106
108
1. Connect your PC to the |EX-TB| via USB or Wifi. See :doc:`EX-Toolbox </ex-toolbox/using>` for more details.
107
109
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.
109
111
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.
111
113
112
114
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.
113
115
@@ -120,14 +122,15 @@ The process for configuring WiFi settings using the serial monitor or device mon
120
122
121
123
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.
122
124
123
-
Changing to Station Mode¶
124
-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
125
+
Changing to Station Mode
126
+
~~~~~~~~~~~~~~~~~~~~~~~~~~
125
127
126
128
i.e. your home router. You will need to issue the command:
127
129
128
-
```cpp
129
-
<C WIFI "routerSSID" "routerPassword">
130
-
```
130
+
.. code-block:: cpp
131
+
132
+
<C WIFI "routerSSID" "routerPassword">
133
+
131
134
e.g. Sets the STA mode to connect to a router with SSID "routerSSID" and password
132
135
133
136
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
137
140
138
141
To give the Access point a specific name and a password that will not be revealed on the OLED use the command:
139
142
140
-
```cpp
141
-
<C WIFI AP "MyCSB1" "SpamWonderfulSpam">
142
-
```
143
+
.. code-block:: cpp
144
+
145
+
<C WIFI AP "MyCSB1" "SpamWonderfulSpam">
146
+
143
147
e.g. Sets the AP name to "MyCSB1" and the password to "SpamWonderfulSpam":
144
148
145
149
The AP mode password must be at least 8 characters long.
146
150
147
151
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:
148
152
149
-
```cpp
150
-
<C WIFI AP "MyCSB1" "SpamWonderfulSpam" 6>
151
-
```
153
+
.. code-block:: cpp
154
+
155
+
<C WIFI AP "MyCSB1" "SpamWonderfulSpam" 6>
152
156
153
157
Use a phone WiFi analyser app to see which channels are relatively quiet in your area.
154
158
@@ -157,26 +161,26 @@ Hidden Access Point mode
157
161
158
162
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.
159
163
160
-
```cpp
161
-
<C WIFI HIDDENAP "MyCSB1" "SpamWonderfulSpam" 6>
162
-
```
164
+
.. code-block:: cpp
165
+
166
+
<C WIFI HIDDENAP "MyCSB1" "SpamWonderfulSpam" 6>
163
167
164
168
Configuring the Host Name
165
-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
169
+
~~~~~~~~~~~~~~~~~~~~~~~~~~
166
170
167
171
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.
168
172
169
-
```cpp
170
-
<C WIFI HOSTNAME "DCCEX-MYCSB1">
171
-
```
173
+
.. code-block:: cpp
174
+
175
+
<C WIFI HOSTNAME "DCCEX-MYCSB1">
172
176
173
177
e.g. Sets the hostname to "DCCEX-MYCSB1":
174
178
175
179
Clearing WiFi settings
176
180
~~~~~~~~~~~~~~~~~~~~~~~~
177
181
178
-
```cpp
179
-
<C WIFI DEFAULT>
180
-
```
182
+
.. code-block:: cpp
183
+
184
+
<C WIFI DEFAULT>
181
185
182
186
WiFi will revert to the internally generated ssid and password.
0 commit comments