Skip to content

Commit 379786b

Browse files
committed
Add Troubleshooting Tips for ThingSpeak
1 parent d1cddcc commit 379786b

7 files changed

+51
-1
lines changed
Loading

docs/assets/Device_Name_ENS160.JPG

71.3 KB
Loading
Loading
115 KB
Loading
147 KB
Loading

docs/configuration.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -432,7 +432,7 @@ In the Application Settings Menu, users will be able to configure the addressabl
432432
* <kbd>1</kbd> to enable _(default)_
433433
* <kbd>0</kbd> to disable
434434
* <kbd>4</kbd> **Board Name** &mdash; A specific name for this DataLogger
435-
* Accaps a string
435+
* Accepts a string
436436
* <kbd>5</kbd> **SD Card Format** &mdash; Enable and set the output format
437437
* Accepts the following values:
438438
* <kbd>1</kbd> to disable = 0

docs/troubleshooting.md

+50
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,23 @@ In this case, the DataLogger IoT failed to connect to AWS IoT service because th
3535

3636

3737

38+
#### ThinkSpeak IoT Error
39+
40+
The following error occurred when the DataLogger IoT was initializing with ThingSpeak.
41+
42+
``` bash
43+
[I] ThingSpeak MQTT: connecting to MQTT endpoint mqtt3.thingspeak.com:8883 .......[E] ThingSpeak MQTT: Connection Error [4]
44+
```
45+
46+
<div style="text-align: center">
47+
<a href="../assets/Incorrect_Configuration_Connection_Failed_IoT_Service_ThingSpeak.JPG">
48+
<img src="../assets/Incorrect_Configuration_Connection_Failed_IoT_Service_ThingSpeak.JPG" width="600px" height="600px" alt="Configuration entered incorrectly, DataLogger not connecting to IoT Service - ThingSpeak"></a>
49+
</div>
50+
51+
In this case, the DataLogger IoT failed to connect to ThingSpeak service because the credentials were entered incorrectly. Ensure that the and saved in persistent memory in order for the DataLogger IoT to successfully connect.
52+
53+
54+
3855
#### Arduino Cloud Error 1
3956

4057
The following error was occurred when the DataLogger IoT was initializing with Arduino Cloud.
@@ -56,6 +73,7 @@ The following error was occurred when the DataLogger IoT was initializing with A
5673
In this case, the DataLogger IoT failed to connect to the Arduino Cloud service because the credentials were incorrect. Ensure that the credentials (i.e. API client ID, API secret, device secret, device ID) are entered correctly and saved in persistent memory in order for the DataLogger IoT to successfully connect.
5774

5875

76+
5977
#### Arduino Cloud Error 2
6078

6179
The following error was occurred when the DataLogger IoT was initializing with Arduino Cloud.
@@ -88,6 +106,38 @@ In this case, the DataLogger IoT failed to connect to the Arduino Cloud service
88106

89107

90108

109+
### ThingSpeak Data Points Not Updating
110+
111+
If your DataLogger IoT is connected to ThingSpeak but you do not see any data, ensure that the device name matches the Qwiic device that is connect to the DataLogger IoT. For example, the DataLogger IoT and Qwiic-enabled ENS160 was able to connect to ThingSpeak as shown in the image on the bottom left. However, there were no data points in any of the graphs as shown on ThingSpeak as shown in the image on the bottom right.
112+
113+
<div style="text-align: center; pointer-events:none;">
114+
<table style="border:none;>
115+
<tr style="vertical-align:middle;">
116+
<td style="text-align: center; vertical-align: middle; border: none;"><a href="../assets/DataLogger_Connected_ThingSpeak.JPG"><img src="../assets/DataLogger_Connected_ThingSpeak.JPG" width="600px" height="600px" alt="DataLogger Connected to ThingSpeak"></a></td>
117+
<td style="text-align: center; vertical-align: middle; border: none;"><a href="../assets/ThingSpeak_ENS160_No_Data.JPG"><img src="../assets/ThingSpeak_ENS160_No_Data.JPG" width="600px" height="600px" alt="No Data Points in ThingSpeak Channel"></a></td>
118+
</tr>
119+
</table>
120+
</div>
121+
122+
If you head back into the configuration menu for the DataLogger's ThingSpeak channel, make sure that the _<device name>_ matches the connected Qwiic device's name that was shown during initialization. In this case, the device that was loaded and detected was **ENS160**. Then add the channel ID before saving the system settings.
123+
124+
<div style="text-align: center">
125+
<a href="../assets/Device_Name_ENS160.JPG">
126+
<img src="../assets/Device_Name_ENS160.JPG" width="600px" height="600px" alt="Matching Device Name with Qwiic-Enabled ENS160 Breakout Board"></a>
127+
</div>
128+
129+
!!! note
130+
Only one device can be loaded per channel! ThingSpeak is not able graph two different devices in the same channel.
131+
132+
Head back to your ThingSpeak Channel to verify that data is being plotted on the graphs.
133+
134+
<div style="text-align: center">
135+
<a href="../assets/ThingSpeak_ENS160_with_Data.JPG">
136+
<img src="../assets/ThingSpeak_ENS160_with_Data.JPG" width="600px" height="600px" alt="ThingSpeak Outputting ENS160 Sensor Data on Graphs"></a>
137+
</div>
138+
139+
140+
91141
### U-Blox I<sup>2</sup>C Device Disappears when IoT DataLogger Initializes
92142

93143
If you have issues where a u-blox device that is connected to the I<sup>2</sup>C port fails to connect a second time when the IoT DataLogger initializes, this is due to a bug in the firmware from an initial release. You may see an output similar to the following message and image shown below.

0 commit comments

Comments
 (0)