RCSwitchFirmata

Current state of development

The current implementation, version 2.0.0-SNAPSHOT, is work in progress and tested against

• ConfigurableFirmata 2.10.0
• RCSwitch 2.5.2
• perl-firmata 0.63
• fhem with support for Firmata > 2.6 fhem-mirror/dev

Description

RCSwitchFirmata is an adapter between ConfigurableFirmata and the RCSwitch library. It comes with an integration into FHEM.

RCSwitchFirmata allows you to use a single Arduino for multiple purposes, including radio transmissions. For example, you can read digital inputs, control a relais and switch radio outlets with a single Arduino today. You could extend that to receive the temperature from your weather station tomorrow, without a change to the Arduino sketch.

Firmata is a protocol for communicating with microcontrollers from software on a host computer. ConfigurableFirmata is a plugin-based version of Firmata which allows to read and control an Arduino from a host computer without changes to the Arduino firmware. rc-switch is a library for sending and receiving signals to radio controlled devices.

Hardware configuration

Requirements

• Any host machine (e.g. your computer)
• Any Arduino (e.g. an Arduino Nano)
• Any RF sender to send RF signals (e.g. FS1000A)
• Any RF receiver to receive RF signals (e.g. RXB6)

Setup

1. Connect the sender to an arbitrary pin.
2. Connect the receiver to a pin that supports interrupts (depending on your Arduino model, usually pins 2 & 3).
3. Connect the Arduino to the host.

Arduino configuration

• Details: arduino/libraries/RCSwitchFirmata/README.md

Requirements

• Arduino IDE
• RCSwitchFirmata library (directory arduino/libraries/RCSwitchFirmata within this repository)

Setup

1. Add RCSwitchFirmata, ConfigurableFirmata and RCSwitch as arduino libraries, either with the Arduino IDE menu item Add library... or by copying them into your Arduino library folder.
   • On Windows and Mac, this is the Documents folder in your user home directory, e.g. My Documents/Arduino/libraries
   • On Linux, this is Sketchbook/libraries in your user home directory.
2. Copy the example sketch directory examples/RCSwitchFirmata to you Arduino sketch folder or a working directory.
3. Open the RCSwitchFirmata.ino sketch in the Arduino IDE and configure it according to your needs.
4. Connect your hardware to the pins of your Arduino board
   1. If you want to send RF signals: connect a RC sender to an arbitrary pin
   2. If you want to receive RF signals: connect a RC receiver to an interrupt-enabled pin
5. Connect your Arduino board to the host; save, compile and upload your RCSwitchFirmata.ino sketch
6. Connect your Firmata client software to the Arduino
   1. If you want to send RF signals: send an RCOUTPUT_ATTACH message to sender pin
   2. If you want to receive RF signals: send an RCINPUT_ATTACH message to receiver pin

Firmata features can be en-/disabled by in-/excluding the corresponding header in the RCSwitchFirmata.ino sketch. By default, all features are enabled. Microcontrollers with limited memory (< 16k) are not able to support all features simultaneously. To overcome this limitation, comment out the feature class declaration and associated include for any features that you do not need.

FirmataExt

FirmataExt must be enabled because it is required for communication between host and Arduino. It is enabled by default:

#include <utility/FirmataExt.h>
FirmataExt firmataExt;

RCOutputFirmata

RCOutputFirmata is required to send. It is enabled by default:

#include <utility/RCOutputFirmata.h>
RCOutputFirmata rcOutput;

RCInputFirmata

RCInputFirmata is required to receive. It is enabled by default:

#include <utility/RCInputFirmata.h>
RCInputFirmata rcInput;

Other Firmata features

You may disable any Firmata feature to save memory. For example, if you don't need analog outputs:

//#include <utility/AnalogOutputFirmata.h>
//AnalogOutputFirmata analogOutput;

FHEM configuration

• Details: FHEM/README.md

Requirements

1. A working FHEM installation in version 5.5 or higher

Setup

1. Add the RCSwitchFirmata repository to your FHEM installation so that it will be included by the FHEM update command. To achieve this, enter the following command on the FHEM commandline once: update add https://raw.githubusercontent.com/git-developer/RCSwitchFirmata/dev-2.0.0/FHEM/controls_frm_rc.txt
2. Update RCSwitchFirmata manually: update https://raw.githubusercontent.com/git-developer/RCSwitchFirmata/dev-2.0.0/FHEM/controls_frm_rc.txt
3. Add a device for Firmata
4. To send, add a device for the sender
5. To receive, add a device for the receiver

Example

Now let's say you want to switch an Intertechno socket outlet.

• Your Arduino is connected to /dev/ttyUSB0,
• RF sender module is connected to pin 11,
• RF receiver module is connected to pin 2

RCSwitch Configuration

define firmata FRM /dev/ttyUSB0@57600
define rc_sender FRM_RCOUT 11
attr   rc_sender IODev firmata
define rc_receiver FRM_RCIN 2
attr   rc_receiver IODev firmata
define switch IT 0FF00F0F0F 0F 00
attr   switch IODev rc_sender

To switch your socket, call set switch on. To send a tristate code directly without IT device, call set sender tristateCode 0FF00F0F0F0F. When you press a button on the remote of your socket, the device rc_receiver receives a message and the state of the IT device changes.

Known problems

Signal quality

The signal quality depends on the quality of the RF modules and the antenna.

• Each RF module should have an antenna with a length of λ = c₀/f (speed of light divided by frequency) or a fraction of it. An effective and cheap antenna is a copper wire with the length of λ/4, e.g. 17.4 cm for 433 MHz.
• Even very cheap senders (XY-FST, FS1000A) have shown good results.
• For best results, a superheterodyne receiver (RXB6) is recommended. Very cheap receivers (XY-MK-5V) may work, but this depends on the environment and the sensitivity of controlled devices.

Build environment

RCSwitchFirmata was developed on and works with Arduino IDE 1.8.4. In earlier versions of the IDE, the include mechanism is different causing compile errors.

Project status

This project was developed on the FHEM forum in 2014, moved to GitHub in 2015 and was updated to ConfigurableFirmata 2.10 in 2017.

History

See the thread FHEM+Arduino Firmata via Ethernet+RF 433 Mhz Sender+Baumarkt-Funksteckdosen for details about the development of this project.

Links

• FHEM+Arduino Firmata via Ethernet+RF 433 Mhz Sender+Baumarkt-Funksteckdosen
• Arduino Firmata in FHEM
• Firmata Protocol
• Firmata Implementation
• ConfigurableFirmata
• rc-switch on GitHub
• rc-switch on Google Code (deprectaed)
• perl-firmata with support for Firmata versions newer than 2.6
• fhem-mirror/dev with support for Firmata versions newer than 2.6

License

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. See file LICENSE for further informations on licensing terms.