Skip to content

Commit

Permalink
Add Troubleshooting Tips for ThingSpeak
Browse files Browse the repository at this point in the history
  • Loading branch information
bboyho committed Jul 30, 2024
1 parent d1cddcc commit 379786b
Show file tree
Hide file tree
Showing 7 changed files with 51 additions and 1 deletion.
Binary file added docs/assets/DataLogger_Connected_ThingSpeak.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/Device_Name_ENS160.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/ThingSpeak_ENS160_No_Data.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/ThingSpeak_ENS160_with_Data.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -432,7 +432,7 @@ In the Application Settings Menu, users will be able to configure the addressabl
* <kbd>1</kbd> to enable _(default)_
* <kbd>0</kbd> to disable
* <kbd>4</kbd> **Board Name** &mdash; A specific name for this DataLogger
* Accaps a string
* Accepts a string
* <kbd>5</kbd> **SD Card Format** &mdash; Enable and set the output format
* Accepts the following values:
* <kbd>1</kbd> to disable = 0
Expand Down
50 changes: 50 additions & 0 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,23 @@ In this case, the DataLogger IoT failed to connect to AWS IoT service because th



#### ThinkSpeak IoT Error

The following error occurred when the DataLogger IoT was initializing with ThingSpeak.

``` bash
[I] ThingSpeak MQTT: connecting to MQTT endpoint mqtt3.thingspeak.com:8883 .......[E] ThingSpeak MQTT: Connection Error [4]
```

<div style="text-align: center">
<a href="../assets/Incorrect_Configuration_Connection_Failed_IoT_Service_ThingSpeak.JPG">
<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>
</div>

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.



#### Arduino Cloud Error 1

The following error was occurred when the DataLogger IoT was initializing with Arduino Cloud.
Expand All @@ -56,6 +73,7 @@ The following error was occurred when the DataLogger IoT was initializing with A
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.



#### Arduino Cloud Error 2

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



### ThingSpeak Data Points Not Updating

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.

<div style="text-align: center; pointer-events:none;">
<table style="border:none;>
<tr style="vertical-align:middle;">
<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>
<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>
</tr>
</table>
</div>

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.

<div style="text-align: center">
<a href="../assets/Device_Name_ENS160.JPG">
<img src="../assets/Device_Name_ENS160.JPG" width="600px" height="600px" alt="Matching Device Name with Qwiic-Enabled ENS160 Breakout Board"></a>
</div>

!!! note
Only one device can be loaded per channel! ThingSpeak is not able graph two different devices in the same channel.

Head back to your ThingSpeak Channel to verify that data is being plotted on the graphs.

<div style="text-align: center">
<a href="../assets/ThingSpeak_ENS160_with_Data.JPG">
<img src="../assets/ThingSpeak_ENS160_with_Data.JPG" width="600px" height="600px" alt="ThingSpeak Outputting ENS160 Sensor Data on Graphs"></a>
</div>



### U-Blox I<sup>2</sup>C Device Disappears when IoT DataLogger Initializes

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.
Expand Down

0 comments on commit 379786b

Please sign in to comment.