Itead RBoard and RMini Example Sketch

  • Hello All,
    I've been using an Iteadstudio RBoard and RMini for MySensor nodes. These boards are perfect for MySensors as they are cheap and comes with nRF24 socket. I'm not sure why there isn't more mention of them here!

    Anyway, here is a simple sketch I put together for both boards, it follows the same basic pattern as the standard 'Relay With Button Actuator' example.

    I tested this with and it all worked as expect, however I am a coding novice, so any suggested improvements would be most welcome.


     * The MySensors Arduino library handles the wireless radio link and protocol
     * between your home built sensors/actuators and HA controller of choice.
     * The sensors forms a self healing radio network with optional repeaters. Each
     * repeater and gateway builds a routing tables in EEPROM which keeps track of the
     * network topology allowing messages to be routed to nodes.
     * Created by Henrik Ekblad <>
     * Copyright (C) 2013-2015 Sensnology AB
     * Full contributor list:
     * Documentation:
     * Support Forum:
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * version 2 as published by the Free Software Foundation.
     * Version 1.0 - Alex Scott
     * Example MySensor sketch for both the Itead RBoard and RMini
     * The code sends and receives commands from the GW unit.
     * This unit does the following.
     *     - Receives incoming commands to turn on or off the relays
     *     - Local input switches sends change to GW
     *     - Switch's ACK back from GW sets the corresponding relay i.e.
     *       if GW is down, local relay will not turn on.
     *       This can be good as you know your connected to
     *       the GW... However if you want the swtich-to-relay
     *       to be linked even if the GW is down, then change the
     *       enable the #define below
     *     - Option to save / restore relay states from EEPROM
     *     - Also a MySensors repeater node
    /*** Set Itead board type  ***/
    //#define RBOARD 1
    #define RMINI 1
    /*** Set direct switch-to-relay link if desired ***/
    //#define DIRECT_SW_TO_R
    /*** Set to save / restore relay sate from EEPROM  ***/
    //#define USE_EEPROM
    #include <MySensor.h>
    #include <SPI.h>
    #include <MyTransportNRF24.h>
    #include <Bounce2.h>
    #define SKETCH_VER        "1.0"                 // Sketch version
    #define NODE_ID           AUTO                  // Set number if static node ID if not assigned by HA
    #define NODE_REPEATER     true                  // Set true if a repeater node (i.e. always turned on)
    #define CHILD_NAME        "Switch & Relay"      // Optional child sensor name
    #define MSG_NO_ACK        false
    #define MSG_ACK           true
    #ifdef RBOARD
      #define SKETCH_NAME   "RBoard"
      #define NRF24_CE      8                       // RBoard nRF24 CE pin
      #define NRF24_CS      9                       // RBoard nRF24 CS pin
      byte switchInputs[] = {14, 15, 16, 17};       // input switches A0 - A3
      byte relayOutput[]  = {4, 5, 6, 7};           // relay output D4 - D7
    #elif RMINI
      #define SKETCH_NAME   "RMini"
      #define NRF24_CE      9                       // RMini nRF24 CE pin
      #define NRF24_CS      10                      // RMini nRF24 CS pin
      byte switchInputs[] = {A0};                   // input switche A0
      byte relayOutput[]  = {4};                    // relay output D4
    #define DEBOUNCE_TIME   5
    #define NUM_SWITCHES    sizeof(switchInputs)/sizeof(switchInputs[0])  // Number of input switches
    #define NUM_RELAYS      sizeof(relayOutput)/sizeof(relayOutput[0])    // Number of relay channels
    char childName[] = "Relay  ";                                         // Send child sensor name, leave space on end for No.
    Bounce *switchDebounce;                                               // Create pointer to bouncer object
    MyTransportNRF24 transport(NRF24_CE, NRF24_CS, RF24_PA_LEVEL);        // Set non-default CE and CS pins for RBoard
    MySensor gw(transport);
    // ************* Setup ***************
    void setup(void) {
      for (byte i = 0; i < NUM_SWITCHES; i++) {                           // Configure switch inputs
        pinMode(switchInputs[i], INPUT_PULLUP);                           // Set internal pullup resistor
      for (byte i = 0; i < NUM_RELAYS; i++) {                             // Configure outputs to relays
        pinMode(relayOutput[i], OUTPUT);
    #ifdef USE_EEPROM
        digitalWrite(relayOutput[i], gw.loadState(i));                    // Set output to state in EEPROM
        digitalWrite(relayOutput[i], LOW);                                // Just set relay off
      switchDebounce = (Bounce *) malloc(sizeof(Bounce) * NUM_SWITCHES);  // Allocated memory for bouncer objects
      for (byte i = 0; i < NUM_SWITCHES; i++) {                           // Attach switches to bouncer objects
      gw.begin(incomingMessage, NODE_ID, NODE_REPEATER);                  // RX message handler, node ID, node repeater
      gw.sendSketchInfo(SKETCH_NAME, SKETCH_VER);                         // Send sketch info
      for (byte i = 0; i < NUM_SWITCHES; i++) {                           // Present the switch / relay child sensors to the GW
        childName[(sizeof(childName))-2] = '0'+i;                         // Insert switch / relay number into end of child sensor char array
        gw.present(i, S_LIGHT, childName);
    // ************* Main Loop ***************
    void loop(void) {
      gw.process();                                                       // Pump the MySensor network
      for(int i = 0; i < NUM_SWITCHES; i++) {                             // Check for debounce switch changes
        if(switchDebounce[i].update()) {                                  // Cycle through debounce objects looking for switch change
          bool state = switchDebounce[i].read();
          MyMessage tmpMsg;                                               // Build a new message and send switch state to GW
    #ifdef DIRECT_SW_TO_R
          digitalWrite(relayOutput[i], state);                            // Set corresponding relay, no via GW ACK message
          gw.send(tmpMsg, MSG_NO_ACK);                                    // Send message, no ACK
      #ifdef USE_EEPROM
          gw.saveState(i, state);
          gw.send(tmpMsg, MSG_ACK);                                       // Send message, ask for ACK, which in turn will set the relay
    #endif                                                                // No EEPROM saving here as we haven't changed to relay state
    // ********* Handle Incoming MySensor Messages ********
    void incomingMessage(const MyMessage &message) {
      if (message.isAck()) {
         Serial.println("This is an ack from gateway");
      if (message.type == V_LIGHT) {
        int relayNum = message.sensor;                                    // get child / sensor ID from received message
        if (relayNum >= 0 && relayNum < NUM_RELAYS) {                     // Valid Relay Number?
          digitalWrite(relayOutput[relayNum], message.getBool());         // Set relay output to the received status
    #ifdef USE_EEPROM
          gw.saveState(relayNum, message.getBool());                      // Save relay state to EEPROM

  • @Alphalove
    I highly recommend itead products, especially for those just getting into MySensors. They remove alot of the pitfalls that electronic noobs (such as myself) encounter when building their first sensor nodes. I used the RMini to build my first relay and it could not have been easier. Many of the troubleshooting problems posted on the forum have to do with setting up relays and these boards eliminate many of those issues.

    I also recommend the nano shield from itead to any entry level electronics noobs for setting up early sensor nodes who are not ready for intricate soldering. It provides a nRf socket and a power jack and breaks out all of the nano pins with individual power and ground headers. Just plug in a nano and nRf and program from USB and power the entire setup through a single jack - perfect for beginners.

Suggested Topics