{"id":2582,"date":"2019-02-12T10:31:48","date_gmt":"2019-02-12T15:31:48","guid":{"rendered":"https:\/\/blogs.mathworks.com\/iot\/?p=2582"},"modified":"2020-12-16T21:19:30","modified_gmt":"2020-12-17T02:19:30","slug":"thingspeak-library-for-arduino","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/iot\/2019\/02\/12\/thingspeak-library-for-arduino\/","title":{"rendered":"ThingSpeak Library for Arduino"},"content":{"rendered":"<p>The ThingSpeak team has released an updated version of the <a href=\"https:\/\/github.com\/mathworks\/thingspeak-arduino\">ThingSpeak Communication Library for Arduino, ESP8266, and ESP32<\/a> devices. The ThingSpeak library is the easiest way to get Arduino devices connected to ThingSpeak IoT services. The library now features a way to separate secret credentials from your main source code. This helps when you want to share your code but don&#8217;t want to share your WiFi credentials and ThingSpeak keys.<\/p>\n<h3>Installation<\/h3>\n<p>The Arduino IDE needs to have the ThingSpeak library installed in order for your devices to know how to send data to ThingSpeak. In the Arduino IDE, choose <em>Sketch<\/em>, <em>Include Library<\/em>, and <em>Manage Libraries<\/em>. Search for \u201cthingspeak\u201d and click <em>Install<\/em>.<\/p>\n<p><img decoding=\"async\" loading=\"lazy\" width=\"786\" height=\"443\" class=\"aligncenter size-full wp-image-2584\" src=\"https:\/\/blogs.mathworks.com\/iot\/files\/2019\/02\/Arduino_Library_Install.png\" alt=\"\" \/><\/p>\n<h3>Device Support<\/h3>\n<p>The ThingSpeak Communication Library supports many devices. Using the library makes the experience the same for each board type. When you learn one\u00a0way to\u00a0work with ThingSpeak, you will be to work with other devices in the same way.<\/p>\n<ul>\n<li>Arduino or compatible using a <strong>WiFi Shield<\/strong><\/li>\n<li>Arduino\u00a0or compatible using a <strong>WiFi Shield 101<\/strong><\/li>\n<li>Arduino\u00a0or compatible using an <strong>Ethernet Shield<\/strong><\/li>\n<li>Arduino\u00a0or compatible using a <strong>MKR ETH Shield<\/strong><\/li>\n<li><strong>Arduino MKR1000<\/strong> (use the WiFi101 library version 0.13.0 or older. WiFi101 library versions 0.14.0 and newer have a bug that stops this ThingSpeak library from working properly)<\/li>\n<li><strong>Arduino MKR1010<\/strong><\/li>\n<li><strong>Arduino VIDOR 4000<\/strong><\/li>\n<li><strong>Arduino GSM 14000<\/strong><\/li>\n<li><strong>Arduino Y\u00fan<\/strong> (Rev1 and Rev2)<\/li>\n<li><strong>ESP8266<\/strong> (tested with SparkFun ESP8266 Thing &#8211; Dev Board and NodeMCU 1.0 module)<\/li>\n<li><strong>ESP32<\/strong> (tested with SparkFun ESP32 Thing)<\/li>\n<\/ul>\n<p>Each supported device includes three ThingSpeak examples.<\/p>\n<ul>\n<li><strong>ReadField<\/strong>: Reading from a public channel and a private channel on ThingSpeak<\/li>\n<li><strong>WriteSingleField<\/strong>: Writing a sensor value to a single field on ThingSpeak<\/li>\n<li><strong>WriteMultipleFields<\/strong>: Writing sensor values to multiple fields and status in one transaction with ThingSpeak<\/li>\n<\/ul>\n<h3>Request Status Codes<\/h3>\n<p>To get the best compatibility with ThingSpeak IoT services, we recommend using the ThingSpeak library. The library has extra features that help you troubleshoot and get visibility\u00a0into any issues with requests to ThingSpeak. I find it useful to store the last status code from ThingSpeak. I can use this code to understand if the request succeeded or failed. Here&#8217;s an example of how to use the &#8220;getLastReadStatus&#8221; method.<\/p>\n<pre><code> \/\/ Read in field 1 of the private channel which is a counter  \r\n long fieldValue = ThingSpeak.readLongField(myChannelNumber, myFieldNumber, myThingSpeakReadAPIKey);  \r\n\r\n  \/\/ Check the status of the read operation to see if it was successful\r\n statusCode = ThingSpeak.getLastReadStatus();\r\n if(statusCode == 200) {\r\n   Serial.println(\"Field Value: \" + String(fieldValue));\r\n }\r\n else {\r\n   Serial.println(\"Problem reading channel. HTTP error code \" + String(statusCode)); \r\n }<\/code><\/pre>\n<p>The code behind the ThingSpeak library is available on <a href=\"https:\/\/github.com\/mathworks\/thingspeak-arduino\" target=\"_blank\" rel=\"noopener\">GitHub<\/a>. Discover other\u00a0<a href=\"https:\/\/mathworks.github.io\/\" target=\"_blank\" rel=\"noopener\">MathWorks Open Source and Community Projects<\/a> on The MathWorks GitHub page.<\/p>\n","protected":false},"excerpt":{"rendered":"<div class=\"overview-image\"><img decoding=\"async\"  class=\"img-responsive\" src=\"https:\/\/blogs.mathworks.com\/iot\/files\/2019\/02\/Arduino_Library_Install.png\" onError=\"this.style.display ='none';\" \/><\/div>\n<p>The ThingSpeak team has released an updated version of the ThingSpeak Communication Library for Arduino, ESP8266, and ESP32 devices. The ThingSpeak library is the easiest way to get Arduino devices&#8230; <a class=\"read-more\" href=\"https:\/\/blogs.mathworks.com\/iot\/2019\/02\/12\/thingspeak-library-for-arduino\/\">read more >><\/a><\/p>\n","protected":false},"author":148,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[4,293],"tags":[14,49,60,50,239],"_links":{"self":[{"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/posts\/2582"}],"collection":[{"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/users\/148"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/comments?post=2582"}],"version-history":[{"count":1,"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/posts\/2582\/revisions"}],"predecessor-version":[{"id":2586,"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/posts\/2582\/revisions\/2586"}],"wp:attachment":[{"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/media?parent=2582"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/categories?post=2582"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.mathworks.com\/iot\/wp-json\/wp\/v2\/tags?post=2582"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}