"I want to have sensors everywhere!" In this article we'll show you how to create a wireless sensor node using an inexpensive NodeMCU module. NodeMCU is a tiny, low-cost WiFi-enabled microcontroller that supports direct connectivity to sensors via SPI, I2C, ADC, GPIO, etc. Programming of the module is made easier with support for the Arduino Integrated Development Environment (IDE). You can build up as many wireless sensor nodes as needed to create your wireless sensor network.
The wireless sensor nodes will send data to the Universal Sensor Hub that we showed you how to build in our prior article. We use the same sensor from the universal hub article, but feel free to experiment with other sensors - gas sensors, door switches, noise detectors, water level, soil moisture level, etc. The Universal Sensor Hub uses Machinechat JEDI One software running on the Raspberry Pi. JEDI One enables you to collect data from all the sensors and display the data on a dashboard accessible from any browser on the network.
Here is an example of a JEDI One system view of multiple sensors:
We will show you in just 4 steps, how to get a wireless sensor network started. A few items you will need:
- NodeMCU modules - less than $5 each
- BME280 Environmental sensor module w/ wires - $12 This one is used in example below
- Micro USB cable - $5
- Arduino IDE - Free
- Universal Sensor Hub
Step 1: Setting up the Arduino IDE
Download the IDE here for your MAC, PC or Linux computer. If you are new to Arduino, please review this tutorial. Once you have it installed and running, you should see something like this:
Now install the libraries needed to talk to the BME280 environmental sensor. Select Tools -> Manage Libraries. Type bme into the search box. Install the Adafruit BME280 Library. Also install the supporting libraries it recommends. Here is a short video of this:
We also need the Arduino IDE to know how to talk to our NodeMCU module. Select:
- Arduino -> Preferences -> Additional Boards Manager URLs:
- Enter: http://arduino.esp8266.com/stable/package_esp8266com_index.json
- Click: OK
That window looks like this:
Finally, setup the details about your NodeMCU under Tools. This is important; if not correct, undesired behavior may occur! If you purchased the NodeMCU in the link above, the settings you want to select are:
Tools -> Board -> NodeMCU 1.0 (ESP-12E Module)
Tools -> Flash Size -> 4M (3M SPIFFS)
Tools -> CPU Frequency -> 80 Mhz
Tools -> Upload Speed -> 921600
Now, close the Arduino IDE program.
Step 2: Connecting the BME280 Sensor to the NodeMCU
Connect the NodeMCU to the recommended Waveshare BME280 module as follows:
Step 3: Loading, configuring, and running the software
Plug the micro USB cable into your PC and attach the NodeMCU to the other end. Important: The NodeMCU module will get power from the USB cable. Open the Arduino IDE. Your screen should look like this:
Download the sketch attached to this article, NodeMCU-BME280-JEDI-sketch.ino. Within the Arduino IDE click on FILE -> Open and then select the file you just downloaded. It will prompt to create a directory, agree to this.
Find the following lines of code in the sketch and change the "your-ssid" and "your-wifi-password" with the settings for your wireless router or access point.
// Wi-Fi settings - replace with your Wi-Fi SSID and password
const char* ssid = "your-ssid";
const char* password = "your-wifi-password";
Also, edit the line in the sketch with the IP address and port number for your Universal sensor hub running on the Raspberry Pi. The default HTTP listener for JEDI One is on port 8100. For this example we use 192.168.1.7:8100:
// IP address of server or Raspberry Pi running Machinechat JEDI software
// If you changed the JEDI port number, replace 8100 with the new port
const char* host = "192.168.1.7:8100";
Save the sketch:
It is finally time to compile and load the sketch into the NodeMCU:
Success! Now that the code is in the NodeMCU flash, the Arduino IDE can be closed and the unit moved to another location. A USB charger can be used to power the NodeMCU; no need for the computer at this point.
The serial window in the video above shows that the information from the sensor is being successfully sent to our Universal Sensor hub. The LED on the NodeMCU will blink every five seconds when data is transmitted.
You can setup several of these NodeMCU sensor nodes to create a network and put them in various places to monitor several locations. Just make sure you change the target_id to a unique name for each NodeMCU. Here is what you will want to change:
You might choose to call them BMESensorNode2, BMESensorNode3... You can call them whatever you like, they just need to be unique for each NodeMCU. Then when you go to setup the dashboards and notifications in JEDI One, you will be able to tell which NodeMCU's data you are working with.
We are now done setting up the NodeMCU module. The hard part is over and now we will take a moment to setup a JEDI One system view dashboard.
Step 4: Create a system view dashboard with JEDI One to monitor your data
JEDI One allows you to view your data in two ways:
- as a real-time or historical data chart dashboard; or
- in a system view, which allows you to view real-time data in the context of the environment your sensors and devices are operating in.
In this example, we will create a system view dashboard and add the temperature (bedroom) value from the wireless NodeMCU sensor and also the temperature (study) value from a sensor attached directly to our Universal Sensor Hub:
Notice how the target ID, BMESensorNode1 automatically showed up along with its the properties, tempC, humi, and pressure. These are being collected by the default HTTP listener. Our software below is sending the data via HTTP POST.
Congratulations! You’ve just learned how to set up and configure a wireless sensor in a NodeMCU environment. Now go ahead and add more sensors (just repeat steps 2 and 3, and remember to give each of your NodeMCU a unique target_id name)…and in no time, you can be the environmental data master of your universe (wherever it may be).
Check out the following links to learn how you can easily configure JEDI One to view, store and monitor your data in different ways:
- Creating and using data dashboards
- Creating rules and notifications
- Sending data using the HTTP Post method
Click here to download Arduino sketch
Code listing from Github below: