The NodeMCU Development Kit is based on the ESP8266, and integrates GPIO, PWM, IIC, 1-Wire and ADC into one board.
By following this guide you will be able to PUBLISH and SUBSCRIBE data to/from Ubidots using the NodeMCU ESP8266 module in just a couple of minutes!
Requirements
NodeMCU version 1.0
1. Setting up the Arduino IDE
1. To be able to work with the NodeMCU ESP8266 platform in the Arduino IDE, you will need to install the ESP8266 platform using the preconfigured Arduino Board Manager. If you are not familiar with adding a board with the Arduino IDE, refer to this article for additional guidance.
NOTE: When installing the ESP8266 platform in your Arduino IDE, please make sure to install version v.2.7.4.
2. With the ESP8266 platform installed, select the ESP8266 device you are working with. In the case, we are working with a “NodeMCU 1.0(ESP12E module)”. To select your board from the Arduino IDE, select Tools > Board “NodeMCU 1.0(ESP12E module)”.
3. Download and install the UbidotsMQTTESP8266 library. For a detailed explanation of how to install libraries using the Arduino IDE, refer to this guide.
2. Sending (PUBLISH) Data to Ubidots
With the following sample code you will be able to post the readings taken from ANALOG pin A0 of the NodeMCU ESP8266.
1. To publish your first value in Ubidots, open the Arduino IDE and paste the sample code below. Once you have pasted the code, you will need to assign your unique Ubidots TOKEN, SSID (WiFi Name) and Password of the available network.
/****************************************
* Include Libraries
****************************************/
#include "UbidotsESPMQTT.h"
/****************************************
* Define Constants
****************************************/
#define TOKEN "....." // Your Ubidots TOKEN
#define WIFINAME "...." //Your SSID
#define WIFIPASS "....." // Your Wifi Pass
Ubidots client(TOKEN);
/****************************************
* Auxiliar Functions
****************************************/
void callback(char* topic, byte* payload, unsigned int length) {
Serial.print("Message arrived [");
Serial.print(topic);
Serial.print("] ");
for (int i=0;i<length;i++) {
Serial.print((char)payload[i]);
}
Serial.println();
}
/****************************************
* Main Functions
****************************************/
void setup() {
// put your setup code here, to run once:
//client.ubidotsSetBroker("industrial.api.ubidots.com"); // Sets the broker properly for the industrial account
client.setDebug(true); // Pass a true or false bool value to activate debug messages
Serial.begin(115200);
client.wifiConnection(WIFINAME, WIFIPASS);
client.begin(callback);
}
void loop() {
// put your main code here, to run repeatedly:
if(!client.connected()){
client.reconnect();
}
float value1 = analogRead(A0);
client.add("temperature", value1);
client.ubidotsPublish("my-new-device");
client.loop();
delay(5000);
}
2. Verify your code within the Arduino IDE. To do this, in the top left corner of our Arduino IDE you will see the "Check Mark" icon; press it to verify your code.
3. Upload the code into your “NodeMCU 1.0(ESP12E module)”. To do this, choose the "right-arrow" icon beside the "check mark" icon.
4. To verify the connectivity of the device and the data sent, open the serial monitor by selecting the "magnifying glass" icon in the top right corner of the Arduino IDE to see the connectivity logs.
NOTE: If no response is seen, try unplugging the NodeMCU and then plugging it again. Make sure the baud rate of the Serial monitor is set to the same one specified in your code 115200.
5. Confirm your data in Ubidots. Now you should see the posted data in your Ubidots account, located the device called "my-new-device".
NOTE: To change the name ID of the device being updated in Ubidots, replace the string assigned in code with the following line:
client.ubidotsPublish("my-new-device");
3. Receiving (SUBSCRIBE) Data from Ubidots
With the following sample code you will be able to subscribe a value from Ubidots to start controlling any asset you desire.
1. To begin receiving values from Ubidots, open the Arduino IDE and paste the sample code below. Once you have pasted the code, be sure to assign the following parameters:
SSID (WiFi Name) & Password of the available network connection.
Device Label of the device which contains the variable to want to GET.
Variable Label of the variable you want to GET.
/****************************************
* Include Libraries
****************************************/
#include "UbidotsESPMQTT.h"
/****************************************
* Define Constants
****************************************/
#define TOKEN "....." // Your Ubidots TOKEN
#define WIFINAME "....." //Your SSID
#define WIFIPASS "....." // Your Wifi Pass
#define DEVICE_LABEL "..." // Put here your Ubidots device label
#define VARIABLE_LABEL "..." // Put here your Ubidots variable label
Ubidots client(TOKEN);
/****************************************
* Auxiliar Functions
****************************************/
void callback(char* topic, byte* payload, unsigned int length) {
Serial.print("Message arrived [");
Serial.print(topic);
Serial.print("] ");
for (int i=0;i<length;i++) {
Serial.print((char)payload[i]);
}
Serial.println();
}
/****************************************
* Main Functions
****************************************/
void setup() {
// put your setup code here, to run once:
client.ubidotsSetBroker("industrial.api.ubidots.com"); // Sets the broker properly for the Industrial account
client.setDebug(false); // Pass a true or false bool value to activate debug messages
Serial.begin(115200);
client.wifiConnection(WIFINAME, WIFIPASS);
client.begin(callback);
client.ubidotsSubscribe(DEVICE_LABEL, VARIABLE_LABEL); //Insert the dataSource and Variable's Labels
}
void loop() {
// put your main code here, to run repeatedly:
if(!client.connected()){
client.reconnect();
client.ubidotsSubscribe(DEVICE_LABEL, VARIABLE_LABEL); //Insert the dataSource and Variable's Labels
}
client.loop();
}
2. Verify & Upload the code into the board following the same steps provided in the PUBLISH step above.
3. To verify the connectivity of the device and the data which is being received, open the serial monitor by selecting the "magnifying glass" icon in the top right corner of the Arduino IDE to see the connectivity logs.
NOTE: If no response is seen, try unplugging the NodeMCU ESP8266 and then plugging it again. Make sure the baud rate of the Serial monitor is set to the same one specified in your code 115200.
4. In the serial monitor, you will be able to see the last value received in Ubidots of the variable specified in the firmware.
4. Summary
With this simple tutorial you are able to PUBLISH & SUBSCRIBE data to/from Ubidots with the ease of the Arduino IDE and an NodeMCU ESP8266. If your wish to find more examples to handle context or timestamp values in your request checkout Ubidots documentation with the ESP8266 by clicking here.
Now its time to create Ubidots Dashboards to visualize your data and deploy your IoT solution! Happy Hacking! :)