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
Note: The server name is obtained from the Device Shadow URL entry
177
+
!!! note
178
+
The server name is obtained from the Device Shadow URL entry
178
179
179
180
180
181
181
182
### MQTT Topic
182
183
183
184
The MQTT topic value is based uses the ***MQTT topic prefix*** from above, and has the value ***update*** added to it. So for this example, the MQTT topic is:
184
185
185
-
```$aws/things/TestThing23/shadow/update```
186
+
$aws/things/TestThing23/shadow/update
186
187
187
188
188
189
@@ -212,9 +213,15 @@ This value was downloaded as a file during the creation process. The contents of
212
213
213
214
## Setting Properties
214
215
215
-
The above property values must be set on the DataLogger before use. They can be passed on via a JSON file that is loaded by the system at startup. Of course, you can also manually set the values using the menu system like the previous MQTT example.
216
+
The above property values must be set on the DataLogger before use. They can be set manually by using the menu system like the previous MQTT example.
216
217
217
-
For the DataLogger IoT example outlined in this document, the entries in the settings JSON file are as follows:
218
+
For users that are interested in using the menu system, you will need to open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then type <kbd>11</kbd> to enter the AWS IoT Menu. When the menu system for the AWS IoT connection is presented, you will need to configure the property values as listed in the JSON file. Saving the values through the menu system will save the credentials to the ESP32's persistent memory. The following options are displayed:
The alternative to using the menu system is a JSON file. These values can be set using a JSON file that is loaded by the system at startup. For the DataLogger IoT example outlined in this document, the entries in the settings JSON file are as follows:
218
225
219
226
```json
220
227
"AWS IoT": {
@@ -235,11 +242,10 @@ For the DataLogger IoT example outlined in this document, the entries in the set
235
242
},
236
243
```
237
244
238
-
Besides updating the `Server`, `MQTT Topic`, `Client Name`, `CA Cert Filename`, `Client Cert Filename`, and `Client Key Filename`, you will need to also ensure that the `port` is set to `8883`. The default in previous firmware versions was `1883`. As of firmware v01.00.04, the default is `8883`. You will need to adjust the port value to properly connect to the [AWS IoT service](https://aws.amazon.com/about-aws/whats-new/2018/02/aws-iot-core-now-supports-mqtt-connections-with-certificate-based-client-authentication-on-port-443/). Don't forget to enable AWS IoT service by setting the value to `true`.
239
-
240
-
If the JSON file is saved in the microSD card, you will need to load the credentials to the DataLogger IoT. Of course, you can manually update the values through the command line as well to save the credentials to the ESP32's persistent memory.
241
-
245
+
Besides updating the `Server`, `MQTT Topic`, `Client Name`, `CA Cert Filename`, `Client Cert Filename`, and `Client Key Filename`, you will need to also ensure that the `port` is set to `8883`. The default in previous firmware versions was `1883`. As of firmware v01.00.04, the default is `8883`. You will need to adjust the port value to properly connect to the [AWS IoT service](https://aws.amazon.com/about-aws/whats-new/2018/02/aws-iot-core-now-supports-mqtt-connections-with-certificate-based-client-authentication-on-port-443/). Don't forget to enable AWS IoT service by setting the value to `true`. If the JSON file is saved in the microSD card, you can load the credentials to the DataLogger IoT.
242
246
247
+
!!! tip
248
+
To load the values by the system at startup using a JSON file and microSD card, you will need to [configure the Save Settings](../configuration#general-save-settings). This JSON file will be created with the "**Save to Fallback**" option. Make sure to enable the AWS IoT as well.
Copy file name to clipboardExpand all lines: docs/example_azure.md
+11-4
Original file line number
Diff line number
Diff line change
@@ -144,9 +144,15 @@ The file to download is the ***Baltimore CyberTrust Root*** entry in the **Root
144
144
145
145
## Setting Properties
146
146
147
-
The above property values must be set on the DataLogger IoT before use. They can be set via a JSON file that is loaded by the system at startup. Of course, you can also manually set the values using the menu system like the previous MQTT example.
147
+
The above property values must be set on the DataLogger IoT before use. They can be set manually by using the menu system like the previous MQTT example.
148
148
149
-
For the example outlined in this document, the entries in the settings JSON file are as follows:
149
+
For users that are interested in using the menu system, you will need to open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then type <kbd>13</kbd> to enter the Azure IoT Menu. When the menu system for the Azure IoT connection is presented, you will need to configure the property values as listed in the JSON file. Saving the values through the menu system will save the credentials to the ESP32's persistent memory. The following options are displayed:
The alternative to using the menu system is a JSON file. These values can be set using a JSON file that is loaded by the system at startup. For the example outlined in this document, the entries in the settings JSON file are as follows:
150
156
151
157
```json
152
158
"Azure IoT": {
@@ -164,10 +170,11 @@ For the example outlined in this document, the entries in the settings JSON file
164
170
},
165
171
```
166
172
167
-
Besides updating the `Server`, `Device Key`, `Device ID`, and `CA Cert Filename`, you will need to also ensure that the `port` is set to `8883`. The default in previous firmware versions was `1883`. As of firmware v01.00.04, the default is `8883`. You will need to adjust the port value to properly connect to the Azure IoT service.
173
+
Besides updating the `Server`, `Device Key`, `Device ID`, and `CA Cert Filename`, you will need to also ensure that the `port` is set to `8883`. The default in previous firmware versions was `1883`. As of firmware v01.00.04, the default is `8883`. You will need to adjust the port value to properly connect to the Azure IoT service. Don't forget to enable Azure IoT service by setting the value to `true`. If the JSON file is saved in the microSD card, you can load the credentials to the DataLogger IoT.
168
174
169
-
If the JSON file is saved in the microSD card, you will need to load the credentials to the DataLogger IoT. Of course, you can manually update the values through the command line as well to save the credentials to the ESP32's persistent memory.
170
175
176
+
!!! tip
177
+
To load the values by the system at startup using a JSON file and microSD card, you will need to [configure the Save Settings](../configuration#general-save-settings). This JSON file will be created with the "**Save to Fallback**" option. Make sure to enable the Azure IoT as well.
Copy file name to clipboardExpand all lines: docs/example_http.md
+6-1
Original file line number
Diff line number
Diff line change
@@ -79,7 +79,7 @@ These values are set using the standard DataLogger methods - the interactive men
79
79
80
80
### Menu System
81
81
82
-
When the menu system for the HTTP connection is presented, the following options are displayed:
82
+
For users that are interested in using the menu system, you will need to open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then type <kbd>14</kbd> to enter the HTTP IoT Menu. When the menu system for the HTTP IoT connection is presented, you will need to configure the property values as listed in the JSON file. Saving the values through the menu system will save the credentials to the ESP32's persistent memory. The following options are displayed:
*`CA Cert Filename` - Set to the cert filename on the SD card if being used.
131
131
132
+
If the JSON file is saved in the microSD card, you can load the credentials to the DataLogger IoT.
133
+
134
+
!!! tip
135
+
To load the values by the system at startup using a JSON file and microSD card, you will need to [configure the Save Settings](../configuration#general-save-settings). This JSON file will be created with the "**Save to Fallback**" option. Make sure to enable the HTTP IoT as well.
Copy file name to clipboardExpand all lines: docs/example_mqtt.md
+3-2
Original file line number
Diff line number
Diff line change
@@ -94,7 +94,7 @@ These values are set using the standard DataLogger methods - the interactive men
94
94
95
95
We'll need to adjust the settings for the MQTT Client using the MQTT Menu System.
96
96
97
-
Open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then type <kbd>9</kbd> to enter the MQTT Client Menu. When the menu system for the MQTT connection is presented, the following options are displayed:
97
+
For users that are interested in using the menu system, open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then type <kbd>9</kbd> to enter the MQTT Client Menu. When the menu system for the MQTT connection is presented, the following options are displayed:
To load the values by the system at startup using a JSON file and microSD card, you will need to [configure the Save Settings](../configuration#general-save-settings). This JSON file will be created with the "**Save to Fallback**" option. Make sure to enable the MQTT Client as well.
Copy file name to clipboardExpand all lines: docs/example_thingspeak.md
+11-4
Original file line number
Diff line number
Diff line change
@@ -154,9 +154,15 @@ You can download the cert file for ThingSpeak.com page using a web-browser. Clic
154
154
155
155
## Setting Properties
156
156
157
-
The above property values must be set on the DataLogger IoT before use. They can be set via a JSON file that is loaded by the system at startup. Of course, you can also manually set the values using the menu system like the previous MQTT example.
157
+
The above property values must be set on the DataLogger IoT before use. They can be manually by using the menu system like the previous MQTT example.
158
158
159
-
For the ThingSpeak example outlined in this document, the entries in the settings JSON file are as follows:
159
+
For users that are interested in using the menu system, you will need to open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then type <kbd>12</kbd> to enter the ThingSpeak MQTT Menu. When the menu system for the ThingSpeak MQTT connection is presented, you will need to configure the property values as listed in the JSON file. Saving the values through the menu system will save the credentials to the ESP32's persistent memory. The following options are displayed:
The alternative to using the menu system is a JSON file. These values can be set using a JSON file that is loaded by the system at startup. For the ThingSpeak example outlined in this document, the entries in the settings JSON file are as follows:
160
166
161
167
```json
162
168
"ThingSpeak MQTT": {
@@ -176,9 +182,10 @@ For the ThingSpeak example outlined in this document, the entries in the setting
176
182
!!! note
177
183
The **Channels** value is a list of **[DEVICE NAME]=[Channel ID]** pairs. Each pair is separated by a comma.
178
184
179
-
Besides updating the `Server`, `Client Name`, `Username`, `Password`, `CA Cert Filename`, and `Channels`, you will need to also ensure that the `port` is set to `8883`. The default in previous firmware versions was `1883`. As of firmware v01.00.04, the default is `8883`. You will need to adjust the port value to properly connect to the ThingSpeak service.
185
+
Besides updating the `Server`, `Client Name`, `Username`, `Password`, `CA Cert Filename`, and `Channels`, you will need to also ensure that the `port` is set to `8883`. The default in previous firmware versions was `1883`. As of firmware v01.00.04, the default is `8883`. You will need to adjust the port value to properly connect to the ThingSpeak service. Don't forget to enable ThingSpeak MQTT service by setting the value to `true`. If the JSON file is saved in the microSD card, you can load the credentials to the DataLogger IoT.
180
186
181
-
If the JSON file is saved in the microSD card, you will need to load the credentials to the DataLogger IoT. Of course, you can manually update the values through the command line as well to save the credentials to the ESP32's persistent memory.
187
+
!!! tip
188
+
To load the values by the system at startup using a JSON file and microSD card, you will need to [configure the Save Settings](../configuration#general-save-settings). This JSON file will be created with the "**Save to Fallback**" option. Make sure to enable the ThingSpeak MQTT as well.
Copy file name to clipboardExpand all lines: docs/example_timestamp.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
Open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Then send a <kbd>6</kbd> to adjust how data is logged.
1
+
Open a Serial Terminal, connect to the COM port that your DataLogger enumerated to, and set it to **115200** baud. In this case, we connected to **COM13**. Press any key to enter the Main Menu. Type <kbd>1</kbd> to enter the Settings menu. Then send a <kbd>6</kbd> to adjust how data is logged.
2
2
3
3
<divstyle="text-align: center">
4
4
<ahref="../assets/SparkFun_Datalogger_IoT_Logger_Menu.JPG"><imgsrc="../assets/SparkFun_Datalogger_IoT_Logger_Menu.JPG"width="600"height="600"alt="Logger Menu Options"></a>
Copy file name to clipboardExpand all lines: docs/hardware_hookup.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ In this section, we will go over how to connect to the SparkFun DataLogger IoT.
9
9
10
10
For users that are interested in soldering to the edge of the board, we recommend [soldering](https://learn.sparkfun.com/tutorials/how-to-solder-through-hole-soldering) headers to the PTHs on the breakout for a permanent connection and using jumper wires. Of course, you could also solder wires to the breakout board as well. For a temporary connection during prototyping, you can use [IC hooks like these](https://www.sparkfun.com/products/9741).
*[Fritzing Part (FZPZ)](https://github.com/sparkfun/Fritzing_Parts/blob/main/products/20594_sfe_datalogger_iot_9dof_esp32_fuel_gauge_imu_micro_sd_card_qwiic.fzpz)
*[Fritzing Part (FZPZ)](https://github.com/sparkfun/Fritzing_Parts/blob/main/products/22462_sfe_datalogger_iot_esp32_fuel_gauge_micro_sd_card_qwiic.fzpz)
0 commit comments