Radiocrafts RC1682-SSM User manual

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 1 of 20
Radiocrafts
Embedded Wireless Solutions
RC16xxxx-SSM User Manual
Table of contents
TABLE OF CONTENTS............................................................................................................ 1
INTRODUCTION....................................................................................................................... 2
QUICK START.......................................................................................................................... 2
INTRODUCTION - SIGFOX NETWORK................................................................................... 3
................................................................................................................................................... 3
SIGFOX ZONES........................................................................................................................ 3
SIGFOX PROTOCOL................................................................................................................ 4
UART INTERFACE FOR MODULE CONFIGURATION...................................................................... 4
UART TIMING INFORMATION..................................................................................................... 5
POWER MANAGEMENT.............................................................................................................. 7
TEMPERATURE READING .......................................................................................................... 7
POWER SUPPLY VOLTAGE READING.......................................................................................... 7
HOW TO REGISTER THE DEVICE IN THE SIGFOX BACKEND SYSTEM........................... 8
HOW TO USE THE DEVICE WITH THE SIGFOX NETWORK EMULATOR KIT (SNEK)...... 8
MODULE CONFIGURATION.................................................................................................... 9
SSM CONFIGURATION COMMANDS ........................................................................................... 9
SSM CONFIGURATION MEMORY ............................................................................................. 11
SENSORS AND ACTUATORS............................................................................................... 13
SENSOR OVERVIEW ................................................................................................................ 13
ANALOG SENSOR INTERFACE.................................................................................................. 13
GPIO SENSOR AND ACTUATOR............................................................................................... 14
SENSIRION SHT35 TEMPERATURE AND HUMIDITY SENSOR...................................................... 15
SENSOR CONFIGURATION.................................................................................................. 17
EXAMPLE CONFIGURATION...................................................................................................... 17
SENSOR DATA TRANSMISSION.......................................................................................... 19
SENSOR INTERFACE ELECTRICAL CONNECTIONS........................................................ 19
DIGITAL IOS........................................................................................................................... 19
I2C ........................................................................................................................................ 19
UART ................................................................................................................................... 19
ANALOG INPUTS ..................................................................................................................... 19
DOCUMENT REVISION HISTORY......................................................................................... 20
DISCLAIMER .......................................................................................................................... 20
TRADEMARKS....................................................................................................................... 20
LIFE SUPPORT POLICY........................................................................................................ 20
CONTACT INFORMATION..................................................................................................... 20

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 2 of 20
Radiocrafts
Embedded Wireless Solutions
Introduction
RC16xxxx-SSM are a series of RF module with embedded application for reading sensors
and reporting sensors to cloud via the Sigfox network. There is no need to add external
microcontroller to read the sensors.
Each sensor can be enable and configured and it can be setup how often the results shall be
sent via RF/Sigfox
Quick Start
How do I use sensors?
Sensors needs to be physically connected to the correct interface and needs to be configured
via the UART once. The internal firmware will then control the sensors automatically and
gather the data for transmission. The user do not need to do anything more, as all drivers etc
is incorporated in the module.
How do I transmit data?
The module needs to be configured to a specified interval when data should be transmitted
(e.g. every 30 minutes). Then, data from the sensors are automatically transmitted.
What about the antenna?
In most cases a simple quarter wavelength wire or a PCB track will do. Connect a piece of wire
to the RF pin with length corresponding to the quarter of a wavelength. For space limited
products, contact Radiocrafts and we will recommend the best antenna solution for your
application.
How do I change any configuration parameter?
To change configurable parameters, send one byte to the module with the value 0x00 or assert
the CONFIG pin. This will take the module into configuration mode. Special commands are then
used to access the configuration registers and test modes. Exit from configuration mode by
sending the ‘X’ command. Parameters can be changed permanently and stored in non-volatile
memory in the module.

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 3 of 20
Radiocrafts
Embedded Wireless Solutions
Introduction - SIGFOX Network
The system can be divided into four main parts as shown on figure 1. The host controller is
responsible for data collection. It connects to the RC16XXXX-SSM module through a standard
UART interface, which can forward the collected information through an RF link (called Uplink)
to the SIGFOX Base Station. The Base Station receives the incoming data and pass it to the
back-end system, which provides an interface for the back-end users and client applications.
Optionally the SIGFOX Base Station can also send information to the RC16xxxx-SSM module
through a wireless link (called Downlink).
Base Stations are deployed and operated by SIGFOX in cooperation with local telecom
companies.
Figure 1: System topology
SIGFOX Zones
The global SIGFOX network defines zones/regions where different channel definitions apply.
These zones are named as RCZx where x is an index. The following zones are available:
SIGFOX Zones
Zone
Region
RCZ1
Europe
RCZ2
US
RCZ3
Japan, Korea
RCZ4
Australia, New Zealand, Latin America
Ethernet,
3G,
etc.
RC16XXXX-SSM
Radio Module
SIGFOX
Base
Station
RF channel
RF channel
Back-
end and
clients
Sensors
(e.g
temperature,
humidity,
analog)
RC16XXXX-SSM
Radio Module
Sensors
(e.g
temperature,
humidity,
analog)

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 4 of 20
Radiocrafts
Embedded Wireless Solutions
SIGFOX protocol
Basic functionality
The SIGFOX protocol defines two types of network modes:
1. Only uplink mode
Packets are only transmitted from the RC16xxxx-SSM module to the base station.
This mode can be used for pure data collection.
2. Uplink and downlink mode
RC16xxxx-SSM does not use this mode
UART Interface for Module Configuration
Figure 5: Configuration mode flow diagram
The configuration of the module can be changed in-circuit from the host during operation, at
the time of installation of the equipment, at the manufacturing test, or even as a stand-alone
module. The configuration is changed by sending commands on the UART interface after the
module is set in configuration mode. The configuration mode is entered by sending 00h to the
module (see timing details later), or by asserting the CONFIG pin (set low).
In configuration mode the module will respond by sending a ‘>’ prompt on the TXD pin. This
indicates that the module is ready to receive commands. The CONFIG pin (if used) can then
be de-asserted. Note that the CONFIG pin must be de-asserted before the Exit command (‘X’)
is sent to the module in order to return to normal operation.
After a command is executed, the module responds with the ‘>’ prompt character again,
indicating it is ready for a new command. Do not send a new command before the ‘>’ prompt
is received. The time required to execute a command can vary depending on the command
(see the Timing Information section). There is no ‘>’ prompt after the ‘X’ exit command.
Permanent changes of parameters can be done by writing to the configuration memory using
the memory command ‘M’. Also, special configurations, such as sensor configuration
(command ‘J’), writing of ID, KEY and PAC (command ‘A’) permanently changes the non-
volatile memory and these changes are remembered across resets and power cycles. See the
Configuration Memory section for details.

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 5 of 20
Radiocrafts
Embedded Wireless Solutions
The flow diagram above illustrates how to use the UART interface to enter configuration mode,
change configuration parameters and return to IDLE mode.
UART Timing Information
A UART byte consist of one start bit, 8 data bits, and one stop bit.
The command-to-prompt wait time (TCONFIG-PROMPT) is different from command to command.
The IDLE (SLEEP) state is the normal state where the module waits for a character to be
received on the UART. RXD is the state when receiving characters from the host filling up the
internal buffer. TX/RX state is when the data is transmitted on the air and when data is received
from the air. TXD is the state where the received data is sent to the host on the UART.
CONFIG is the configuration mode, the state entered by sending 00h or asserting the CONFIG
pin. As the module is default in SLEEP mode, a character FFh must be sent to wake it up before
sending the 00h. The minimum and maximum time between sending FFh and 00h is specified
in the table below as tFFh-00h(MIN) and tFFh-00h(MAX) .
MEMORY CONFIG is the sub-state entered by the ‘M’ command where the non-volatile
configuration memory is being programmed. Note the limitation on maximum number of write
cycles using the ‘M’ command, see Electrical Specifications in the Data Sheet. These limitations
also applies to the ‘J’, ‘A’ and ‘B’ commands.
Symbol
Value
Description / Note
GENERAL
tOFF-IDLE
13.2 ms
Time from voltage is stabilized until the module is ready to receive on
RXD pin.
tRESET-IDLE
13.2 ms
Time from the rising edge of reset pin until the module is ready to
receive on RXD pin.
CONFIGURATION MODE
tCONFIG-
PROMPT
86 us
Time from the edge of config pin until the start bit of prompt.
tC-CONFIG
80 us
Time from the last byte is sent until the prompt.
tCONFIG-IDLE
1 ms
Time from the ‘X’ command is sent until the module is in IDLE mode.
tMEMORY-
CONFIG
31 ms
Time from the end character 0xFF until the prompt is issued.
tFFh-00h(MIN)
100 ms
Minimum time (wakeup time) to wait after sending FFh before sending
00h
tFFh-00h(MAX)
2000 ms
Maximum time (timeout) to wait after sending FFh before sending 00h

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 6 of 20
Radiocrafts
Embedded Wireless Solutions
General:
Configuration mode:
v
Figure 7: UART timing diagrams
IDLE
RESET
t
tRESET-IDLE
IDLE
SLEEP
tSLEEP-IDLE
IDLE
Config pin set low
CONFIG
tCONFIG-PROMPT
CONFIG
tC-CONFIG
tCONFIG-IDLE
IDLE
Command
‘X’ command
CONFIG
‘M’ command
CONFIG
tMEMORY-CONFIG
0xFF
IDLE
OFF
tOFF-IDLE
MEMORY

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 7 of 20
Radiocrafts
Embedded Wireless Solutions
Power Management
The module will automatically enter SLEEP mode in order to reduce the power consumption
between transmissions and sensor accesses.
In SLEEP mode the module will not receive or detect incoming data, neither from the UART
port nor from the air. The module is awakened from the SLEEP mode by sending the wake-up
byte FFh on the UART RXD line (use a UART Baud rate > 4.8 kBd due to a maximum pulse
length requirement). After the module has woken up (see Timing Information) it is ready to
receive data on the UART.
All configuration settings and RAM values are retained during SLEEP.
If the module is shut completely off (supply power turned off), all configuration settings in non-
volatile memory is restored, but values in RAM are overwritten with default settings.
Temperature Reading
The module provides readings of a digital temperature monitoring sensor (TEMP) through the
‘U’ command. The module returns an 8 bit character (one byte) indicating the current
temperature in degrees Celsius (°C) followed immediately by a second character which is the
prompt (‘>’).
The TEMP value increases with increased temperature in 1 °C steps and has an accuracy of
+/- 2 °C. The temperature is given by:
T = TEMP(dec) - 128 [°C] (example: TEMP=0x98 equals +24 °C)
Power Supply voltage Reading
The module provides readings of an internal power supply voltage monitoring sensor (VCC)
through the ‘V’ command. The module returns an 8 bit character (one byte) indicating the
current power supply voltage level followed immediately by a second character which is the
prompt (‘>’). The command can be useful for battery power monitoring.
The VCC value increases with increased supply voltage in 30 mV/step. The power supply
voltage is given by:
V = VCC(dec)*0.030 [V] (example: VCC=0x68 equals 3.12 V)

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 8 of 20
Radiocrafts
Embedded Wireless Solutions
How to register the device in the SIGFOX backend system
To be able to register the final product in the backend system of SIGFOX, the device ID and
PAC number has to be delivered to the customer with the final product.
Radiocrafts programs each device with the correspondent ID and PAC in configuration memory.
It is the responsibility of product manufacturer to extract this information and forward them to
the final customer i.e. to print the ID and PAC onto the label of product.
The exact procedure of registration on the SIGFOX network is described in RC16xxxx-SSM-
DK_Quick_Start document.
How to use the device with the SIGFOX Network Emulator Kit (SNEK)
The RCxxxx-SSM modules provide the option to connect to the SIGFOX Network Emulator
Kit, briefly SNEK. The SNEK is a USB dongle with the capability of emulating the SIGFOX
back-end system. The purpose of this dongle is to ease and enable product development in
areas where the global SIGFOX network is not available.
Public KEY
The SNEK is only able to receive and acknowledge packets which are encrypted with a Public
KEY. This means that standard SIGFOX packets are ignored, and the module need to be
configured in a special mode before any link is created to the SNEK.
There are three options provided by our radio modules which can be configured within the
parameter PUBLIC_KEY in the configuration memory:
Parameter
Addr.
Value
Mode
ID
KEY
Description
PUBLIC_KEY
0x28
0x00
Standard
Unique
Unique
This mode is used for
normal operation i.e. on
deployed units.
0x01
SNEK
Public
Public
This mode can be used
for development and
qualification purposes.
The packets are sent
with both the Public ID
and KEY, thus it is also
interoperable with the
SNEK.
Please remember that registering the ID in the SNEK user interface requires MSB order, and
thus the Public ID 0x89ABCDEF (or Unique ID) has to be entered as FEDCBA98.

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 9 of 20
Radiocrafts
Embedded Wireless Solutions
Module configuration
SSM Configuration Commands
A list of commands is shown in the table below. Commands must be sent as ASCII characters
or their corresponding binary value. All arguments must be sent as binary values to the module
(not as ASCII representation for hex or decimal).
Parameter
Comman
d
Argument in hex (decimal)
Note
Read ID
‘9’ – 0x39
(none)
Returns with 12 bytes: 4
bytes ID (LSB first) and 8
bytes PAC (MSB first).
Configure ID
‘A’ –0x41
4 bytes ID + 16 bytes KEY + 8
bytes PAC
Set ID, KEY and PAC in non-
volatile memory.
Rewrite PAC
‘B’ – 0x42
8 bytes PAC
Set/Rewrite the PAC in non-
volatile memory.
**Test mode
‘D’ – 0x54
(none)
TX carrier
920,8000 MHz (Domain 3)
902,2000 MHz (Others)
SIGFOX mode
‘F’ – 0x46
0: Only uplink
1: Uplink and Downlink
Data is stored in volatile
memory only.
Write sensor
configuration
‘J’ – 0x4A
100 bytes sensor
configuration array
Write sensor configuration
array. Array must be 100
bytes excactly.
Read sensor
configuration
‘j’ – 0x6A
(none)
Read sensor configuration
array. 100 bytes are
transmitted on the UART
Memory
configuration
‘M’ –
0x4D
(Address, Data): see list of
parameters below.
0xFF exits memory
configuration.
Used to enter memory
configuration menu.
Parameters changed are
stored in non-volatile
memory.
Signal Strength
(RSSI)
‘S’ – 0x53
Returns one byte indicating
the signal strength of a
detected signal or a valid
packet.
If a valid packet has been
received when in
configuration mode, it will
return the RSSI of the last
received packet.
Temperature
monitoring
‘U’ – 0x55
Returns one byte indicating
the temperature.
See page 12 for details
Battery
monitoring
‘V’ – 0x56
Returns one byte indicating
the power supply voltage.
See page 12 for details
Memory Read
one byte
‘Y’ – 0x59
0x00 –0x7F
(The argument is the address
in the configuration memory.)
Return one byte value from
the configuration memory.
Exit command
‘X’ – 0x58
(none)
Exit to normal operation
mode. All changes of
parameters take effect.
Test mode 0
‘0’ – 0x30
(none)
List all configuration memory
parameters
Test mode 1
‘1’ – 0x31
(none)
TX carrier:
** 920,1375 MHz (Domain 3)
** 902,1375 MHz (Others)
*868,1300 MHz

RC16xxxx-SSM
2017 Radiocrafts AS RC16xxxx-SSM User Manual (rev. 1.00) Page 10 of 20
Radiocrafts
Embedded Wireless Solutions
Test mode 2
‘2’ – 0x32
(none)
TX modulated signal PN9
sequence
Test mode 3
‘3’ – 0x33
(none)
TX Off, RX mode
Test mode 4
‘4’ – 0x34
(none)
IDLE
*Test mode 5
‘5’ – 0x35
(none)
Transmits 1 packet on
Channel 200.
**Test mode 5
‘5’ – 0x35
(none)
TX carrier
921,3875 MHz (Domain 3)
903,3875 MHz (Others)
*Test mode 6
‘6’ – 0x36
(none)
Waits 30s to receive a packet
on channel 200 with the
Sequence number 10. The
received packet is sent out
on UART.
**Test mode 6
‘6’ – 0x36
(none)
TX carrier
922,6625 MHz (Domain 3)
904,6625 MHz (Others)
*Test mode 7
‘7’ – 0x37
(none)
Send 200 packets with
frequency hopping.
**Test mode 7
‘7’ – 0x37
Arg_0, Arg_1, Arg_2
SIGFOX_API_test_mode
(Arg_0, Arg_1)
Test mode 8
‘8’ – 0x38
(none)
Verify EEPROM.
*Available on RC1682-SSM only.
**Available on RC1692HP-SSM only.
Note: ASCII characters are written as ‘X’, hexadecimal numbers are written like 0x00, and
decimal numbers are written like 10 throughout the text. A table of ASCII characters and their
respective hex and decimal values are found in the Appendix.
Any invalid command will be ignored and the ‘>’ prompt will be re-sent.
If Test mode 1 or 2 is used, it is important to enter Test mode 3 before exiting the
configuration mode (‘X’) in order to ensure proper operation in normal mode.
Example:
To change the SIGFOX mode to Uplink and Downlink, use the following sequence:
Command Hex Response Comment/Note
Enter 0x00 ‘>’ Or assert CONFIG pin
De-assert CONFIG after ‘>’ prompt
‘F’ 0x46 ‘>’
1 0x01 ‘>’ Wait for ‘>’ prompt
[A new command could be issued here]
‘X’ 0x58 (none) Module returns to IDLE state
Note that the CONFIG line must be de-asserted after the first ‘>’ prompt was received, but
before the ‘X’ command.