Hobby Components SmartRFy HCMODU0145 User manual

SmartRFy Relay Modules
Manual
HCMODU0145,
HCMODU0146,
& HCMODU0147
Revision 1.0.0

DISCLAIMER
SmartRFy modules are micro power short range devices (SRD) using the 433MHz requency band.
This requency band is licensed exempt (within certain restrictions) in many countries including
the UK, Europe, Asia, and the US. It is the end users responsibility to ensure that it is legal to
operate devices in this requency band within your own country be ore use.
As with all wireless devices, external factors such as range and interference may cause transmissions to
be corrupted or blocked. Therefore these devices should not be used in applications where control or
monitoring is a critical re uirement.
This document is provided "as is". Hobby Components Ltd makes no warranties, whether express,
implied or statutory, including, but not limited to, implied warranties of merchantability and fitness for a
particular purpose, accuracy or lack of negligence. Hobby components Ltd shall not, in any circumstances,
be liable for any damages, including, but not limited to, special, incidental or conse uential damages for
any reason whatsoever.
COPYRIGHT NOTICE
This manual, including content and artwork is copyright of Hobby Components Ltd and may not be
reproduced without written permission. If you paid for or received a copy of this manual from a source
other than Hobby Components Ltd, please contact us at [e-mail]
2
© Hobby Components Ltd

Ta le of Contents
SmartRFy system overview..................................................................................................................5
SmartRFy relay modules......................................................................................................................8
Features.......................................................................................................................................9
Specification.........................................................................................................................................9
Relay Module Features.......................................................................................................................10
Power.............................................................................................................................................10
Relay s)..........................................................................................................................................10
LEDs..............................................................................................................................................11
Serial UART..................................................................................................................................12
Command interface feature.......................................................................................................12
Wireless serial port feature........................................................................................................12
Default configuration settings...................................................................................................12
Clear Factory Reset).....................................................................................................................13
SmartRFy commands.........................................................................................................................14
Command formats..........................................................................................................................14
Command format requirements................................................................................................14
Local command format.............................................................................................................15
Command quick lookup table........................................................................................................15
Generic commands........................................................................................................................15
Relay module specific commands.............................................................................................16
Generic SmartRFy commands.......................................................................................................16
Firmware version FWV?)........................................................................................................17
Get the modules zone ZON?)..................................................................................................17
Get the modules address ADD?).............................................................................................17
Serial serial timeout time STO=).............................................................................................17
Set the baud rate BUR=)..........................................................................................................18
Set number of transmit resends TRS=)....................................................................................19
Set the serial verbose mode VBM=)........................................................................................19
Set the modules zone number ZON=).....................................................................................20
Set the modules address ADD=)..............................................................................................20
Turn on/off repeater mode TRP=)...........................................................................................21
Factory reset FTRE)................................................................................................................21
SmartRFy relay module commands...............................................................................................23
Set the state of the relay SWx=)..............................................................................................23
Set an alternative relay name SxN=).......................................................................................23
Set the relay on time SxO=).....................................................................................................24
Set the threshold value to energise the relay TxH=)................................................................24
Set the threshold value to de-energise the relay TxL=)...........................................................25
Set the test condition for energising the relay MxH=).............................................................25
Set the test condition for de-energising the relay RML=).......................................................26
Appendix A: Example relay modes...............................................................................................28
Threshold mode.........................................................................................................................28
Timer mode...............................................................................................................................29
Toggle mode..............................................................................................................................31
Dimensions....................................................................................................................................32
3
© Hobby Components Ltd

1 channel relay module.............................................................................................................32
2 channel relay module.............................................................................................................32
4 channel relay module.............................................................................................................32
4
© Hobby Components Ltd

SmartRFy system overview
SmartRFy modules are a range of wireless modules that provide a simple low cost way of
controlling and monitoring remote devices and sensors. They are designed to work at their
basic level with no programming re uired. However, when reconfigured or controlled via
their serial interface they can also provide more complex and even autonomous functions.
SmartRFy modules work by wirelessly communicating with one another using simple text
based commands - for example, to turn on a remote relay a command such as RLY=1 can
be sent, and to turn it back off RLY=0. These commands can be automatically sent from
one module to another or can be sent by a user via a modules serial interface to manually
control modules on the SmartRF network.
They are addressable and can grouped into one of 255 zones, with each zone capable of
individually addressing 255 devices, giving a total of over 65,000 uni ue addresses.
SmartRFy modules are designed to be both easy and flexible to use by providing three
levels of control:
Zero con iguration (out-o -the-box)
5
© Hobby Components Ltd
Example: Controlling a remote digital pin and light from a push switch.

With no configuration at all the SmartRFy range of modules allow basic functionality such
as remotely switching relays, digital pins, or monitoring sensors, such as temperature,
humidity, light, motion etc. All SmartRFy modules default to the same zone and address
and so can respond to, or control, other modules without the need to modify any zone or
address settings.
Serial port con iguration
All smartRFy modules include a serial port which allows them to be re-configured using
simple text based commands. These text commands allow changing of configuration
settings and control of specific features of each module. Any setting changes are stored by
the modules non-volatile memory and so are retained even when power is removed from
the module. When reconfigured they are able to perform more complex functions and even
some basic autonomous tasks. For example, a SmartRFy relay module can be
reconfigured to control a heating system based on the temperature transmitted from a
remote sensor or, turn on a flood light for a set amount of time when triggered by a remote
6
© Hobby Components Ltd
Example: Remote 1CH relay module configured to turn on light when local modules’ PIR is
triggered and second remote relay module is configured to control a heating de ice based on local
modules’ temperature sensor readings.

PIR – all without any additional hardware. Serial port configuration also allows a modules
zone and address (all SmartRFy modules default to zone and address 0) to be changed.
This provides the option for modules to be placed into groups, which will then only respond
to other modules with a matching zone or address.
Slave controlled
SmartRFy modules can also be controlled via their serial port by other devices such as
microcontrollers or computer based automation software such as Node-RED. Using a
SmartRFy module as a slave device (must be capable of transmitting/receiving) gives a
master device the ability to monitor and control any other SmartRFy devices on the
network, regardless of their zone and address. SmartRFy modules can even be used as a
passive wireless serial port for passing non-SmartRFy data to other remotely connected
devices.
7
© Hobby Components Ltd
Example 1: Turning on a remote relay with zone = 1 and address = 5
Example 2: Send plain serial text “Hello” to a remote microcontroller

SmartRFy relay modules
The SmartRFy relay modules are available in 1, 2, and 4 channel versions and give the
ability to remotely switch electrical devices via other SmartRFy modules. For example, a
SmartRFy relay module can be used to switch a floodlight when triggered by a PIR sensor
connected to a remote SmartRFy digital TX module without re uiring any configuration.
Out of the box the relays can be remotely controlled by the appropriate input pin of the 4
channel digital TX module (HCMODU0143) or the single channel switch module
(HCMODUxxxxx). When reconfigured via the serial port these relay modules can be
programmed to automatically respond to a greater range such as temperature, humidity,
light etc.
Screw terminals provide convenient access to each relays normally open, closed, and
common terminals. As with all SmartRFy modules, the relay modules also include a serial
interface which can be used to reconfigure the device using simple text based commands,
or can be used as a basic wireless serial port allowing it to receive serial data sent from
other remote SmartRFy devices.
8
© Hobby Components Ltd

Features
•Available in 1 channel (HCMODU0045), 2 channel (HCMODU0046), and 4 channel
HCMODU0047) relay versions.
•Local and remote control via simple text based serial commands.
•Up to 255 zones and 255 addresses (default zone 0, address 0).
•Basic automation features (re uires a USB to serial adaptor or microcontroller for
configuration).
•Compatible with most microcontrollers featuring a serial UART interface.
•Wireless serial communication with 8 different baud rates (9600 default).
•Built in 1, 2, or 4 channel relays providing a set of NO/NC clean contacts accessed
via a screw terminal header.
•Relays can be controlled remotely via serial commands, or other SmartRFy
modules. The module can be set to automatically switch the relay based on
temperature, humidity, light or motion and supports on/off, toggle, and timer modes.
Speci ication
Model number: HCMODU0145, HCMODU0146, & HCMODU0147
Supply Voltage: 4.5 to 5.5V
Supply current min: 9.5mA (idle)
Supply current max: 1ch: 101mA (transmit + relay energised)
2ch: 181mA (transmit + all relays energised)
4ch: 341mA (transmit + all relays energised)
Operating fre uency: 433MHz (OOK)
Operating range: 30 Meters (unobstructed)
Interfaces: RF Tx and Rx, serial UART, and 1, 2, or 4 relay clean
contacts
Relay contact rating (resistive
load):
5A max at 28VDC or 240VAC
9
© Hobby Components Ltd

Module dimensions (WxDxH): 1ch: 45.5mm x 40.4mm x 19mm
2ch: 62.5mm x 40.4mm x 19mm
4ch: 136.5mm x 40.4mm x 19mm
Relay Module Features
Power
Power can be applied to the module via the 5V and GND pins on the serial interface
header. It can be powered using an external power supply ranging from 4.5 to 5.5V with a
minimum current capacity of 120mA (1ch), 200mA (2ch), or 360mA (4ch).
Relay(s)
The relay modules include built-in relays to allow external electrical e uipment to be
remotely switched.
A screw terminal provides access to the relay(s) normally open (NO), common (COM) and
normally closed (NC) contacts.
Each relay can be controlled using the SWx command where x is the relay number (0 to
3). The module will respond to this command being sent via its serial interface, or remotely
from any other SmartRFy device set to the same zone and address. By default, setting the
SWx command to 1 (e.g. SW0=1) will energise the relay, and setting it to 0 (e.g. SW0=0)
will de-energise the relay.
10
© Hobby Components Ltd

The four relay switch commands (SW0, SW1, SW2, SW3) can also be renamed to any
three letter command and the name to an existing device name (e.g. PIR, TMP, LDR etc.)
they can be made to automatically respond to other devices set to the same zone and
address.
The relays can also be configured to be energised for a set period of time (specified in
seconds) using the SxO command (where x is the relay number 0 to 4), or set to a toggle
(on/off) mode where its state will toggle when receiving an appropriate trigger command.
For more information on how to configure the relays to automatically respond to certain
conditions please see Appendix A: Relay examples.
LEDs
The sensor module includes a 2 LEDs which indicate the current state of the module.
PWR LED (green) Indicates the module is currently powered.
RX LED (amber) Indicates the module is currently receiving data from another
SmartRFy device with any zone or address.
11
© Hobby Components Ltd

Serial UART
Command interface feature
The module includes a full duplex serial UART interface which can be used for issuing
local commands and settings directly to the module (local commands).
By default the serial interface will also output any received data from other SmartRFy
modules no matter what their zone and address settings. The type of information that the
serial interface outputs can be controlled using the verbose command (VBM).
Wireless serial port eature
Additionally, the serial interface can also act as a passive wireless serial port for receiving
non-SmartRFy related data from other devices connected to remote SmartRFy modules.
Default configuration settings
By default the serial interface is configured to 9600 baud, 8 data bits, no parity, and 1 stop
bit. See the serial interface control section for more information on setting the baud rate,
verbose mode, and issuing commands.
Note: Connecting the module to a PC via its serial port will re uire an additional USB to
serial adapter (see Hobby Components items HCARDU0011 or HCMODU0076).
12
© Hobby Components Ltd

Clear (Factory Reset)
The module is capable of storing a number of user configuration settings in its non-volatile
memory. This allows it to retain these settings even after power is removed. The two pads
marked ‘CLEAR’ provide a means of restoring the module back to its original factory
default settings. Should you wish to reset the module, connect power to the module whilst
shorting the two pads together.
Alternatively the module can be restored back to factory default settings by issuing the
factory reset (FTRE) command via the serial interface – see the SmartRFy commands
section for more information.
13
© Hobby Components Ltd

SmartRFy commands
Command formats
SmartRFy modules are capable of responding to an array of text based commands sent
via the serial interface. These commands can be either module configuration settings or
commands to control the locally connected module or a remote module.
Command format requirements
•In all cases the command must always be terminated with a carriage return (ASCII
code 13) and a line feed (ASCII code 10).
•The relay modules do not have transmit capability. Therefore commands can only
be processed by the module itself (local commands) and cannot be transmitted to
other modules (remote commands). To tell the module that you are issuing a local
command, the command must be prefixed with an asterisk (*). For example
*SW0=1 will cause relay 0 to be energised. Remote commands, i.e. commands
prefixed with a greater than symbol (>) will be ignored.
•Commands must always be in uppercase and no part of the command should
include white space characters, including spaces.
•Some commands re uire more than one parameter. In this case parameters should
be separated by commas (,) with no spaces.
•Commands are always 4 characters in length. Commands that re uire one of more
parameters will have an e uals (=) as the last character (e.g. XXX=), and
commands that are uerying information will have a uestion mark (?) as the last
character (e.g. XXX?).
•The device will respond to a successful local command with the response ‘OK’. An
unsuccessful command will responded with an ‘ERROR’. There is no response by
the local device when issuing remote commands. All responses are terminated with
a carriage return and line feed.
•No serial data sent to the local device, command or otherwise, may exceed 25
characters in length (including carriage return / linefeed termination).
14
© Hobby Components Ltd

Local command format
Example: Setting and confirming the zone of the local device
*ZON=1<CR><LF>
Sets the zone of the connected module to 1.
Response:
OK<CR><LF>
*ZON?<CR><LF>
Re uests the current zone of the local device.
Response:
1<CR><LF>
15
© Hobby Components Ltd
Prefix Command Line feed
* XXXX <parameter 1> ,<parameter 2> ,<parameter n> 0x0D (\r) 0x0A (\n)
Optional
parameter
Optional
parameter
Optional
parameter
Carriage
return

Command quick lookup ta le
Generic commands
16
© Hobby Components Ltd
Description Parameter(s) Response
Get firmware ersion None
Get zone number (default: 0) None Zone number (0 to 255)
Get address (default: 0) None Address (0 to 255)
OK
Sets the BAUD rate for the serial interface OK
OK
OK
Sets the de ices zone number OK
Sets the de ices address OK
Turns on or off repeater mode (default: off) OK
None OK
Vx.x
(C) HobbyComponents.com
Sets the timeout time for the serial interface (default:
2000ms) Time: Timeout time in milliseconds (0 to 65535)
Baud: 0 = 1200 BAUD
Baud: 1 = 2400 BAUD
Baud: 2 = 4800 BAUD
Baud: 3 = 9600 BAUD (default)
Baud: 4 = 19200 BAUD
Baud: 5 = 38400 BAUD
Baud: 6 = 57600 BAUD
Baud: 7 = 115200 BAUD
Sets the number of times any Tx data will be
retransmitted Resends: Number of resends (0 to 5)
Sets the erbose mode which specifies what recei ed
data is output to the serial interface (default: 0)
Mode: 0 = Both passi e serial & commands from all zones and addresses
Mode: 1 = Only passi e serial data from all zones and addresses
Mode: 2 = Only control from all zones and addresses
Mode: 3 = Both passi e serial & commands with matching zone and address
Mode: 4 = Only passi e serial data with matching zone and address
Mode: 5 = Only commands with matching Zone and address
Zone: Zone number (0 to 255)
Address: De ices address (0 to 255)
State: Repeater state (0 = off, 1 = on) Note: Only a ailable on modules with both RF Tx &
Rx capability
Performs a factory reset – all settings a restored to their
default alues

Relay module specific commands
Generic SmartRFy commands
Commands listed below are common to all SmartRFy modules, including the sensor
module. Note that all commands must be proceeded with a carriage return and line feed,
but for clarity purposes this is omitted from the examples in this section.
Firmware version (FWV?)
Gets the firmware version of the module.
Example: *FWV?
Returns: Vx.x
C) HobbyComponents.com
Where Vx.x is the version number
17
© Hobby Components Ltd
Command Description Parameter(s) Response
SWx=State Sets the state of relay x OK
SxN=Name OK
SxO=Time OK
TxH=Threshold OK
TxL=Threshold OK
MxH=Mode OK
MxL=Mode OK
x: The relay number (0 to 3). E.g. SW0 is relay 0
State: Floating point alue which determines the state of the relay depending on T0H, T0L,
M0H, & M0L settings. Default: 0 = relay off, 1 = relay on
Sets an alternati e three letter command name the relay
will respond to (default SWx)
x: The relay number (0 to 3). E.g. S0N is relay 0
Name: Three letter name of the alternate command
Sets the amount of time the relay will stay energised
when triggered. The relay will automatically de-energise
when time has elapsed
x: The relay number (0 to 3). E.g. S0O is relay 0
Time: Relay on time in seconds (0 to 65525). Default = 0 (disabled).
Sets the threshold alue required to energise the relay
(default: 1)
x: The relay number (0 to 3). E.g. T0H is relay 0
Threshold: A decimal number which sets the le el required to energise the relay
Sets the threshold alue required to de-energise the
relay (default: 0)
x: The relay number (0 to 3). E.g. T0L is relay 0
Threshold: A decimal number which sets the le el required to de-energise the relay
Sets the test condition under which the relay will
energise (default: =)
x: The relay number (0 to 3). E.g. M0H is relay 0
Mode: > The alue passed by the SW0= command must be greater than the
Threshold le el set by the T0H= command
Mode: = The alue passed by the SW0= command must equal the Threshold le el set by
the T0H= command
Mode: < The alue passed by the SW0= command must be less than the Threshold le el
set by the T0H= command
Sets the test condition under which the relay will de-
energise (default: =)
x: The relay number (0 to 3). E.g. M0L is relay 0
Mode: > The alue passed by the SW0= command must be greater than the
Threshold le el set by the T0H= command
Mode: = The alue passed by the SW0= command must equal the Threshold le el set by
the T0H= command
Mode: < The alue passed by the SW0= command must be less than the Threshold le el
set by the T0H= command

Get the modules zone (ZON?)
Gets the modules current zone number
Example: *ZON?
Returns: The current zone number as a decimal value (0 to 255)
Get the modules address (ADD?)
Gets the modules current address
Example: *ADD?
Returns: The current address as a decimal value (0 to 255)
Serial serial timeout time (STO=)
Sets the timeout time for the serial interface in milliseconds. Maximum timeout time is
65535ms (65.535 seconds). If a complete command (including CR + LF termination) is not
received within this time the command will be ignored and an ‘ERROR’ will be retuned.
Default: 2000 (2 seconds)
Example: *STO=1000
The above example will set the serial port timeout time to 1000ms (1 second).
Returns: OK
Set the aud rate (BUR=)
Sets the communication baud rate for the serial UART interface. There are 8 (0 to 7)
possible settings for the baud rate:
0 = 1200 BAUD
1 = 2400 BAUD
18
© Hobby Components Ltd

2 = 4800 BAUD
3 = 9600 BAUD (default)
4 = 19200 BAUD
5 = 38400 BAUD
6 = 57600 BAUD
7 = 115200 BAUD
NOTE: This command sets the serial communication speed between the connected device
and the SmartRFy module – it does not set the wireless RF communication speed
between modules.
Default: 3
Example: *BUR=5
The above example will set the serial port baud rate to 38400 baud.
Returns: OK
Set num er of transmit resends (TRS=)
Sets the number of times the module will automatically re-transmit data. Increasing the
number of times data is retransmitted will reduce the chances of the data not being
received due to interference but will also increase transmission times and network traffic.
The number of resends can be set from 0 (no resends) to 5.
Default: 2
Example: *TRS=3
The above example will set the number of resends to 3. Therefore any data wirelessly
transmitted by the module will be transmitted a total of 4 times.
Returns: OK
19
© Hobby Components Ltd

Set the serial ver ose mode (VBM=)
Sets what type of data received by the module is automatically output to its serial port.
There are 6 possible modes (0 to 5):
0 = Both passi e serial and commands from all zones and addresses
1 = Only passi e serial data from all zones and addresses
2 = Only control from all zones and addresses
3 = Both passi e serial and commands with matching zone and address
4 = Only passi e serial data with matching zone and address
5 = Only commands with matching zone and address
Default: 0
Example: *VBM=5
The above example will set the module to only output received commands that have been
transmitted from a module with the same zone and address as itself.
Returns: OK
Set the modules zone num er (ZON=)
Sets the modules zone number. The zone number can be between 0 and 255.
Note that zone 255 is a special zone number. Setting the module to this zone number
means that it will treat received data from any zone as if it were in the same zone as itself.
Therefore this zone number can be used when you wish the module to respond to
commands from modules in multiple zones. Additionally, when transmitting data with a
zone of 255 all modules within range will respond to the data as if it is in the same zone as
itself. Therefore this zone number can also be used when you re uire the module to
control multiple remote modules in different zones.
Default: 0
Example: *ZON=2
The above example will set the modules zone number to 2.
20
© Hobby Components Ltd