Arduino Sensor Plugin

The Arduino sensor plugin allows you to build your own cheap wireless sensors [for less than $10]. The sensors is using Nordic Semiconductors transceiver nRF24L01 for wireless data transmissions. The Arduino Vera plugin automatically creates the sensor devices it finds on the radio network. Creating your own sensors should be pretty simple using the supplied Arduino library and example sensor sketches.

Arduino is an open source hardware prototype board that have lots of both digital and analog IO pins. There are an enormous amount of different cheap sensors that is compatible with the Arduino hardware.

Link Arduino page: ​http://arduino.cc
Relevant forum thread: ​http://forum.micasaverde.com/index.php/topic,16170.msg123378.html

Architecture

Author

Henrik Ekblad - henrik.ekblad at gmail.com (hek on forum)

Using the Arduino library

All the components developed and compiled here are Open Source. The Vera plugin was inspired by the excellent rfxtrx plugin. I've also written a Arduino library handling all encoding and communication between Arduino sensors and ArduinoGateway. The Vera plugin part automatically creates newly found sensors in Vera. New sensors nodes will automatically find the closest relay node or gateway and WILL be assigned a unique id from vera.

It should be pretty simple to use the library (some more documentation in ​vera.h). But here follows the basic usage in your Arduino sketch:

#include <SPI.h>  
#include <RF24.h>
#include <Sensor.h>  
#include <EEPROM.h>

// Create a Sensor library instance
Sensor sensors(9,10); 

void setup()  
{
  // Initialize and start up vera library (this also initializes the radio stuff and node id)
  vera.begin(AUTO);

  // Register sensor(s) to Vera (vera must be in include mode to pick up sensor). The arguments as follows.
  // childId      Each Arduino can have up to 128 child sensors. 0-127. 
  //              Here we register childId 0.
  // deviceType   Which (vera) device type to use for this sensor. See Vera.h for all options available. 
  //              In this example we use a motion sensor
  vera.sendSensorPresentation(0, S_MOTION); 
}

void loop()      
{     
   // Send a variable change to vera. In this case for childId 0 set the Tripped value to "1".  
   vera.sendVariable(0, V_TRIPPED, "1");
   delay(10000); // Delay 10 seconds
}

Arduino Sketches

A sketch is a small program that you download to the Arduino boards. To get started download Arduino SDK here: ​http://arduino.cc/en/Main/Software

Also make sure to install all Arduino libraries I've created and collected here before trying to build the sensor sketches below. ​http://code.mios.com/git_public/mios/arduino-sensor.git/tree/HEAD:/VeraArduino/Arduino/libraries?js=1

Follow the description below on how to assemble hardware and configure each type of sensor. I've also tried to link all the hardware necessary to build each sensor [from aliexpress.com].

You can connect more than one sensor to each Arduino. Each Pro Mini Arduino has 13 digital in/out pins and 5 analog dito. The radio uses 5 pins so there are plenty left for connecting sensors. Some of them (humidity and pressure) actually use one pin but give also give temperature information (for free) without using any extra pins. When connecting several sensors to one Arduino you'll also have to combine the example sketches below. Also keep in mind that it could be challenging to use interrupts (to be able to sleep most of the time) when several sensors fight for attention and some of them wants to report at a interval.

Arduino Gateway

Acts as a link between Vera and your wireless sensors. This is a mandatory sketch that must be downloaded to an Arduino Nano. This nano is then connected to your Vera using a usb cable. It is important to use a Arduino Nano board for the ArduinoGateway because it contains a serial usb chipset recognized by Vera.

Dallas Temperature Sensor

This is an example sensor sketch that sends in Dallas temperature information and presents it as a temperature devices in Vera.

Distance Sensor

Bed occupancy sensor? Or use it in the garage to show when the car has reached the right location. Why not measure your own length every day using your Vera?

Humidity Sensor (DHT22)

Sketch that sends DHT11/22 data to Vera which displays them as a humidity and temperature device.

Light Sensor

Sensor sketch that reports light level and displays it in Vera using a light sensor device.

Motion Sensor

Motion sensor sketch that triggers a motion sensor security device in Vera.

Pressure/Temperature/Weather forecast sensor (BMP085)

Example sketch showing how to use a BMP085 pressure sensor to create a simple weather station with forecast calculation. Everything is sent and displayed as a barometer and temperature device in Vera.

Soil Moisture Sensor

Soil moisture sensor that triggers a security sensor device in Vera.

Relay Actuator

Relay sketch that can be controlled from Vera using a regular binary light switch device in Vera.

Power Consumption

My initial power measurements on a Arduino Mini Pro with radio module and motion detector shows a power consumption of 0.48 mAh in sleep mode. When motion is detected consumption raises to 1,5 mAh for a couple of seconds when radio powers up and transmits data to vera.

Converted to real life figures, this would make three 2000mAh alkaline AA batteries connected in series (giving 4.5V) last for almost 6 months (2000/0.48 hours) directly connected to VCV (not raw as it passes a regulator). Note that this is just a theoretical calculation. I have not made any long time measurements or tests myself yet. Read more about the subject on the following links:

​http://hwstartup.wordpress.com/2013/03/11/how-to-run-an-arduino-on-a-9v-battery-for-weeks-or-months/ ​http://hwstartup.wordpress.com/2013/04/15/how-to-run-an-arduino-clone-on-aa-batteries-for-over-a-year-part-2/ ​http://www.thalin.se/2013/04/arduino-pro-mini-low-power-modification.html

When feeding the Arduino Pro Mini with 5V through VCC (unregulated). It is possible to reduce the consumption a few additional uA by cutting of the power regulator which also disables the power led. Note that you cannot feed the arduino through the raw pin after this operation. Note: This tip does not apply to newer pro minis (or funduino in my case) with a different layout.

Buying guide

There are many Arduino models out there. Here is a good overview of the different models:
​https://www.sparkfun.com/arduino_guide

A good start kit for building 9 sensors and one Vera gateway could consist of the following components. This is pretty much the list of stuff I bought when building my sensors and you can probably find the parts cheaper from other sellers.

1x Arduino Nano (and USB-cable) for the gateway
​http://www.aliexpress.com/item/Free-Ship-Wholesale-IC-Parts-Integrated-Circuits-Atmel-ATmega328-Board-with-Mini-USB-Cable-Full-Compatible/704043993.html

10x Arduino Pro Mini for the sensors (2 lots = 10 pcs)
​http://www.aliexpress.com/item/16Pcs-Lot-Pro-Mini-Module-Atmega328-5V-16M-For-Arduino-Compatible-Nano/710613095.html

10x NRF24L01+ wireless data transmission module 2.4Ghz (1 lot)
​http://www.aliexpress.com/item/Free-shipping-NRF24L01-wireless-data-transmission-module-2-4G-the-NRF24L01-5PCS-LOT-upgrade-version-New/603756080.html

160x Dupont cable Female->Female (2 lots)
​http://www.aliexpress.com/item/40pcs-in-Row-Dupont-Cable-20cm-2-54mm-1pin-1p-1p-Female-to-Female-jumper-wire/1265984941.html

80x Dupont cable Female->Male (1 lot)
​http://www.aliexpress.com/item/Free-Shipping-80pcs-1P-40x2-New-20cm-2-54mm-1pin-1p-1p-female-to-male-jumper/905874108.html

1x Serial to USB adapter to download code to Arduino Pro Mini
​http://www.aliexpress.com/item/Free-Shipping-FT232RL-USB-To-Serial-Adapter-Module-USB-TO-232-For-Arduino-Download-Cable/827218126.html

Some pull up resistors 4k7 (used for dallas and humidity sensors)
​http://www.aliexpress.com/item/200-pcs-1-4W-4-7k-4k7-ohm-1-Metal-Film-Fixed-Resistor/1109852578.html

Power regulators for connecting radio module to Arduino Pro Mini (which lacks 3.3v output)
​http://www.aliexpress.com/item/XC6206P332MR-XC6206P252MR-SOT-23-SMD-triode-transistor-Good-quality-ROHS-leave-message-model-you-need/473456552.html

Base package price: $8 (Nano+USB) + $32 (Pro Minis) + $9.3 (NRF24) + $4.2 (M->F), $8 (F->F) + $5.3 (Adapter) + $3.5 (Resistors) + $5.6 (Regulators) = $76
Average sensor price for base parts: $76/10 = $7,6

Changelog

Planned features:

CHANGES 1.3 (Beta 1)

Download zip: ​http://code.mios.com/git_public/mios/arduino-sensor.git/snapshot/HEAD.zip?js=1 Browse tree: ​http://code.mios.com/git_public/mios/arduino-sensor.git/tree/HEAD?js=1

• More debug info is printed to serial monitor in sensors (can be turned off).
• Nodes that receive messages from vera don't need to busy wait. New API methods. See new example code in RelayActuator sketch.
• Increased transfer speed (1MBPS) between radios.
• Sent time to sensors uses vera configured timezone
• Radio protocol updated. from/to/version/crc/binary added in message header. This change requires sensors to update their (1.2) library version.
• Variables in vera only gets updated if changed.
• Increased baudrate between vera gateway and vera.
• Message can be sent between sensors without being processed by vera.
• Vera library is now a subclass of RF24 .
• Remove gateway specific code from vera library. New class hierarchy RF24->Node->Relay->Gateway.
• Preserve memory by placing static strings in PROGMEM
• Inclusion mode. Can be started from the Arduino Vera plugin or by using digital input pin on vera gateway (inclusion button). All found devices during inclusion time will be created at once (no multi vera reload/restart cycle needed anymore).
• ArduinoGateway support blinking leds for RX/TX/ERR and a special blink when inclusion mode is activated.
• Dimmer support
• Lastupdate-variable is set in vera for all changes.
• A new device is created in vera for each physical arduino/radio This device will hold info about node, such as library version, battery info and relay information.
• Support for message relaying. All nodes can act as relay. This functionality can be used for communicating with sensors far away. An relay node forwards messages between sensors and vera gateway. Multiple relays (message hops) is also supported. See RelayActuator sketch for an example how to create an relay node.
• Relay node for a sensor (could be GW) is dynamically located each time a sensor is losing connection. This information is also sent to vera and can be seen in radio node device.
• Unit system can be configured in vera plugin (metric/imperial). Sensors can fetch this setting (isMetricSystem()) and send in data in the correct unit.

CHANGES 1.2

Download: ​http://forum.micasaverde.com/index.php/topic,16170.msg130599.html#msg130599

• Added possibility to request time from vera
• Support for 5 custom variables (can be stored in any sensor device). Note that chixxis variable container is still not supported. But the functionality is similar.
• Sensors reports their library version to Vera.
• New example sketch showing time and variable functionality
• SendCommand action added in vera plugin which makes it possible to send data to sensors from scenes (advanced-section) or via luup-calls.
• Auto-id added. A sensor can now request id from vera at first start. The id gets stored in the sensors EEPROM. All example sketches now uses auto-id functionality. You can still use static ids if that is preferred.
• Automatically sets LAST_TRIP and BATTERY_DATE
• Fixed "No Implementation" message when pressing Armed/Bypassed on security sensors.
• Cleaned up plugin code

CHANGES 1.0

• Initial release