IoT & Home Automation w/nRF24l01 & Raspberry Pi

MQTT

NRF24 Adapter

nRF24 Module (Generic)

Mobile Device (iOS, Android, etc)

Raspberry Pi 3 Model B

Arduino UNO

<html><body><h3>Overview</h3>I've developed a <a href="https://github.com/nRF24">communication stack </a>based on the OSI model for nRF24 radios over the past number of years, and it is fairly complete and fully functional. It supports quite a wide range of communication scenarios, with a mesh layer that allows wireless nodes to find communication paths through the network automatically when a given connection fails and uses other nodes to bridge the distance between points in the network. This is one of the more advanced scenarios on how to use it. Basically what I am doing is using the internet connected Raspberry Pi as a gateway for all of my Arduino devices, which will run their own IP stack and communicate directly with the Raspberry Pi using the MQTT protocol. This allows me to send and receive information to and from the Arduinos using any device/software that supports MQTT, including mobile devices. All of this is done wireless, using nrf24l01 radios. These instructions assume users have working radios wired up and ready to go. There are numerous tutorials on setting up and transmitting simple messages. <figure><img src="https://projects.arduinocontent.cc/28a7d699-579a-43d7-a3df-724c2f9c3070.png"/><figcaption>IOS app MQTTool receiving data from Arduino</figcaption></figure><h3>Setting it Up</h3>The first steps are to install the RF24 libraries. On the Arduino, the easiest way is to open the Arduino Library Manager, and select the RF24Ethernet library. It should install all the required RF24 libraries. For linux devices, an install script has been written, the instructions for which can be found <a href="https://nrf24.github.io/RF24/md_docs_linux_install.html">here </a>. In this scenario we will select to install all of the RF24 libraries including the ncurses library, and use the SPIDEV driver when prompted. If running RPi OS Lite, you may need to <code class="code">sudo apt-get install pigpio </code>If there are any issues with the installer or the libraries, please report them at <a href="https://github.com/nRF24">https://github.com/nRF24 </a><figure><img src="https://projects.arduinocontent.cc/fab6c58b-3dd6-414a-b6ae-ccd9ea1f5af7.png"/><figcaption></figcaption></figure>Once installed, on the Raspberry Pi, we need to navigate to the example file and build it: 1. <code class="code">cd rf24libs/RF24Gateway/examples/ncurses </code>2. If you have used the default pin connections to wire up your nrf24 module to the RPi, then just run <code class="code">make </code>to build the example file. Else edit the file per step 3. 3. Run <code class="code">nano RF24Gateway_ncurses.cpp </code>to edit the file and change the line <code class="code">RF24 radio(22, 0); </code>to suit your chosen pin connections. Then run make per step 2. Scroll down at <a href="https://nrf24.github.io/RF24/index.html">https://nrf24.github.io/RF24/index.html </a>for wiring information. 4. RF24Gateway was designed to be run in <code class="code">screen </code>. This allows you to run it in the background while still being able to access the GUI as desired. Use <code class="code">sudo apt-get install screen </code>to install. Then just run <code class="code">screen </code>. Use key combination <code class="code">ctrl+A+D </code>to detatch from the screen and the command <code class="code">screen -r </code>to resume the screen. 5. Run the following commands to configure the interface manually. (Automatic configuration requires running the gateway as root) If your username is something other than 'pi' edit the command to specify it after 'user'. <code class="code">sudo ip tuntap add dev tun_nrf24 mode tun user pi multi_queue </code><code class="code">sudo ifconfig tun_nrf24 10.10.2.2/24 </code>6. If not enabled, enable the SPI interface on the RPi by running <code class="code">sudo raspi-config </code>7. Once built on the Raspberry Pi, we can run <code class="code">./RF24Gateway_ncurses </code>to execute the example. Almost ready to go! It should look something like the following: <figure><img src="https://projects.arduinocontent.cc/043f2fe5-b021-4ccf-a71a-dd65a8d89e1c.png"/><figcaption>RF24Gateway interface, default view</figcaption></figure>The next step on the RPi is to install mosquitto, an MQTT broker: 8. Run <code class="code">sudo apt-get install mosquitto </code>9. Run <code class="code">nano /etc/mosquitto/mosquitto.conf </code>and add two lines: a: <code class="code">allow_anonymous true </code>b: <code class="code">listener 1883 </code>10. Run <code class="code">sudo service mosquitto restart </code>to reload the configuration All done on the Raspberry Pi! Arduino Steps: 1. Open the Arduino library manager and search for RF24Ethernet. Install the library. We also need the MQTT library just labelled "MQTT" by Joel Gaehwiler. 2. Open one of the examples: File -&gt; Examples -&gt; RF24Ethernet -&gt; MQTT -&gt; mqtt_basic 3. If not using pins 7 and 8 for CE and CS respectively, set up your pin connections in <code class="code">RF24 radio(7, 8); </code>4. Upload to your Arduino Mobile Device Steps: On my iOS device, I installed MQTTool and it is fairly nice to use. As long as the Raspberry Pi is connected to the same LAN as your mobile device, you should now be able to send and receive messages to and from your Arduino. 1. On the Raspberry Pi, type in <code class="code">ifconfig </code>to get the IP address. Usually the eth0 or wlan0 interface depending on if you are connected via WiFi or cable. 2. This IP from step 1 is what you want to punch into the app on your phone, in the connection area. 3. Once connected, you can publish any message to inTopic, and the MQTT server will send it to your Arduino which will print it out over the serial port. <figure><img src="https://projects.arduinocontent.cc/d9ccba1c-83ad-4159-95b5-9b890f729ad9.png"/><figcaption>Arduino receiving data from a mobile device</figcaption></figure>4. You can also subscribe to 'outTopic' and your mobile device should start receiving messages from the connected node. To add more devices, just change the IP address in the example sketch from 10.10.2.4 to use any last octet from 3-254. ie: 10.10.2.5 <h3>Expanding on these Principles:</h3>That should get you started with RF24Gateway/RF24Ethernet and MQTT. The hard part is getting the first device working. From here it is a matter of customizing the MQTT topics and the information you send/receive. To expand on this, users can install software such as <a href="https://nodered.org/">Node Red </a>on the Raspberry Pi, and create charts and graphs, design input/output scenarios like on/off switches for devices etc. as in a home automation system. The RPi radio interface behaves just as it were a standard network interface, so a wide range of tools protocols and software can communicate with Arduino nodes running <a href="https://nrf24.github.io/RF24Ethernet/">RF24Ethernet </a>. This can be further extended by installing a vpn on the RPi to make the controls, charts etc accessible from anywhere. See <a href="http://tmrh20.blogspot.com/">http://tmrh20.blogspot.com </a>for further information and <a href="https://github.com/nRF24">https://github.com/nRF24 </a>for support. <figure><img src="https://projects.arduinocontent.cc/26a608a6-0660-4256-8d1f-3a86179afc2d.jpg"/><figcaption>Monitoring a DHT11 temperature and humidity sensor with an Arduino and nrf24 radio module reporting to NodeRed</figcaption></figure> <figure><iframe src="https://www.youtube.com/watch?v=eYiWUTjNSuc"></iframe></figure><figure><iframe src="https://www.youtube.com/embed/IPKItlEfsR4"></iframe></figure>Note: This configuration sets up an IP enabled wireless interface on your Raspberry Pi, so suitable firewall rules and strong passwords should be used to prevent unwelcome access. </body></html>

RF24Ethernet

nrf24l01 Adapter

MQTT Library

RF24Gateway

IoT & Home Automation w/nRF24l01 & Raspberry Pi

How to setup IoT devices with Arduino and a Raspberry Pi for a home automation system.