Contents 1 Introduction 1.1 WACO communication system ........1.2 LoRaWAN communication system .
Page 3
List of Figures Principle of data transmission from the WM868-SI4-B module through a communication gateway Principle of data transmission from the WM868-SI4-B module to another WACO radio module . . . Appearance of the WM868-SI4-B module ....... . . Preview of forms for setting the WM868-SI4-B module using a mobile application .
Introduction This document describes the configuration options of the WM868-SI4-B radio module, which is used for reading the status of consumption meters with pulse output (water meters, electricity meters, gas meters...) and for radio transmission of information about the current status of consumption meters through radio messages in WACO, LoRa, or Wireless M-Bus format.
Wireless M-BUS Communication Protocol Wireless M-BUS is the communications protocol described by international standards EN 13757-4 (physical and link layer) and EN 13757-3 (application layer), which is intended primarily for radio transmission of remote reading values from consumption meters and sensors. Protocol Wireless M-BUS (hereinafter WMBUS”) is based on a ”...
In WACO transmission mode, messages can be transmitted directly to another WACO system module that is constantly receiving. Figure shows the data transmission from the WM868-SI4-B module to the so-called ”Col- lecting Unit” of the WACO system, which collects data from battery-powered WACO modules, converts the data into standard messages of the M-Bus protocol, and further transmits them to the bus control unit (device type ”M-Bus Master”) in M-Bus format over a physical bus.
Overview of technical parameters An overview of the technical parameters of the WM868-SI4-B module is given in Table 1. Table 1: Overview of technical parameters of the WM868-SI4-B module Radio interface Frequency band Transmission modes WACO, wM-Bus, LoRa Modulation type - WACO GFSK Modulation type - wM-Bus Modulation type - LoRa...
” Description of connecting the module to a mobile phone via Bluetooth wireless connection and general rules for configuring the module using the mobile application ”Softlink Configurator” are described in Chapter 3 of the above-mentioned manual Configuration of wacoSystem product family devices”. In section ”Setting the pa-...
Page 9
wm868-SI4-2>conf Config : OK --- WACO protocol --- channel Group Hop count Repeater Test timeout: 20 sec. Encrypt port: Repeat count: 1 Master : 0x010000FE Repeat tout : 1 (50 ms) --- RF Driver --- TX power : 14 dBm RX timeout : 4 (200 ms) High Gain --- Application ---...
3.1.2 Overview of configuration commands of the WM868-SI4-B module (”HELP”) The summary of configuration commands (”HELP”) and their parameters can be displayed by entering the command ”?” into the command line and pressing the ”ENTER” key. The following output will appear in the terminal window: wm868-SI4-2>? - help...
3.1.3 Commands for basic module control This group of commands contains commands for controlling and monitoring the module as a whole. These are the following commands: wm868-SI4-2>? - help info - print system info conf - print configuration write - write configuration clear - clear configuration mode...
Page 12
parameters stored in FLASH. If the parameter should be set only temporarily (for example when turn on a ”test”), it is not needed to save the operational configuration to FLASH memory (after finishing diagnostics the ”test” will be turned off anyway). However, if it is necessary for the currently changed operating parameters to remain set permanently, it is necessary to enter at the end of the configuration sequence a command to save the current configuration to FLASH..
3.1.4 Commands for configuring the RF subsystem of the module This group of commands is used to set those parameters of the RF subsystem of the WM868-SI4-B module that are common to all modes. These are the following commands: - help info - print driver info clear...
wm868-SI4-2>rf rxt 10 RX timeout : 10 (500 ms) wm868-SI4-2> Using the command ”rf active”, you can switch the RF subsystem to a permanently active mode, where the receiver is constantly receiving, except for moments of transmission. For the battery-powered WM868-SI4-B module, such a setting would lead to rapid battery discharge, so it is strongly advised against using this command during normal module operation.
Page 15
kb/s with a theoretical receiver sensitivity of about 104 dBm, which allows communication in built-up objects in the order of tens of meters. Channels labeled ”3”, ”4”, ”5” and ”6” have a width of 15 kHz and are used for data transmission at a speed of 2.4 kb/s with a theoretical receiver sensitivity of about 120 dBm.
WACO protocol port number and any string of up to 16 characters after the ”waco encrypt” command. Based on this string, the module generates a cipher according to the proprietary Softlink algorithm. Spontaneously sent INFO messages of the WM868-SI4-B module have port number ”37”. The same string can be used to generate a key for decrypting messages on the receiving side (in the central data collection application) using the same algorithm.
Page 17
M-Bus standard. The code value for the WM868-SI4-B module is set at the factory to ”SFT” (unique code of the manufacturer SOFTLINK) and unless there is a serious reason, the module manufacturer does not recommend changing the manufacturer code setting.
The command ”wmbus ekey” is used to set the encryption key for message encryption using the AES-128 algorithm. Enter the 16-byte encryption key using the ”wmbus ekey” command followed by a string of 16 bytes, which we enter in hexadecimal form as 32 consecutive characters (characters ”0” to ”f”, without spaces and without prefixed ”0x”).
Page 19
The commands ”lora info” and ”lora regs” are used to display the settings of the LoRa subsystem. These commands are only used for module diagnostics in the manufacturer’s laboratory. The ”lora band” command can be used to set the regional frequency plan according to the LoRa specification. For the Czech Republic region in the 868 MHz band, the frequency plan EU863-870 (abbreviated as ”EU868”) is reserved, which corresponds to option ”0”.
Page 20
wm868-SI4-2>lora rxdly Recv Delay : 2 wm868-SI4-2>lora rxdly 1 Recv Delay : 1 wm868-SI4-2> In ABP mode (Activation by Personalization), the first receive window always opens with the set ”lora rxdly” delay. This value is also stored in the network’s BackEnd, so the network always sends reverse channel messages in this window.
Page 21
--- LoRa App --- Dev Addr : 0x00000000 NwkSKey : 1a2b3c4d5e6fa1b2c3d4e5f6778899af AppSKey : 00000000000000000000000000000000 Similarly, the key for encrypting application data is entered using the ”lora appskey” command. Warning! For modules with OTAA activation mode, these two keys are not entered, the module creates them during the initialization process based on information from the network.
be entered into the module configuration. When the module first logs into the network, it receives back from the network the network address ”NetAddr” and the ”JoinNonce” information, which it uses to create the ”Network Session Key” and ”Application Session Key” keys. The network BackEnd simultaneously generates both of these keys using the same algorithm.
Page 23
/input [index] set [value] setting the initial value of the counter (which is added to) /input [index] edge [0/1] setting the trigger edge of the counter /input [index] type [0/1/2] setting the counter operation mode: 0-fast pulses, 1-edges, 2-slow pulses /input [index] mul [value] setting the multiplier /input [index] div [value]...
wm868-SI4-2>input 0 set 127 wm868-SI4-2>input 0 set 127 wm868-SI4-2>input 0 edge 1 wm868-SI4-2>input 0 type 0 wm868-SI4-2>input 0 mul 5 wm868-SI4-2>input 0 div 10 wm868-SI4-2>input 1 type 1 wm868-SI4-2>input 1 on 5 wm868-SI4-2>input 1 off 4 wm868-SI4-2>input Idx. VALUE Edge Type Multiplier Divider AlarmON AlarmOFF --------------------------------------------------------------------- wm868-SI4-2>...
The description of connecting the module to a mobile phone via Bluetooth wireless connection and general rules for configuring the module using the ”Softlink Configurator” mobile application are described in Chapter 3 of the manual ”Configuration of devices in the wacoSystem product line”.
Page 26
”READ (GET)” button, which will display in the form the parameter values that the module currently has stored in memory; The ”Softlink Configurator” application currently offers five configuration forms for configuring the WM868-SI4-B module, which allow checking and setting all module parameters that are needed for its installation and normal operation.
- setting the frequency band - setting the frequency channel - setting the data rate (Data Rate) - setting the Receive Delay - setting the Join Delay - setting Acknowledge Limit Do not use! - setting Acknowledge Delay Do not use! - setting Acknowledge Timeout Do not use! The meaning of individual parameters is described in detail in section ”Setting WM868-SI4-B module parameters...
Page 28
transmission mode), during this time the module can receive a message from the central application that is prepared for it in the BackEnd or in the communication gateway. Messages in the reverse direction used for setting module parameters (so-called ”setting messages”) are encoded by the NEP protocol, so they have essentially the same structure as messages sent by the module in WACO and LoRa transmission mode.
Individual variables are coded into the data content of the message by using of ”NEP” proprietary coding system invented by SOFTLINK. In this system each type of variable has its own designation called ”OID” (Object ID), which determines meaning, character and data type of the variable. These variables, that could be used multiple...
Figure 6: Structure of WACO system data packet times (as multiple inputs, temperatures, voltages...) must be used jointly with order number of the variable called ”Index”. NEP coding table” is centrally maintained by SOFTLINK and it is available on the public WEB address ” Page. Preview of NEP coding table”...
Message length (L) Message length in Bytes Packet type (C) ”Spontaneous User Data” Manufacturer ID (M) ”SFT” (Softlink manufacturer code) Serial number (A) Module identification according to M-BUS standard (configurable) Version (V) Module generation/version according to M-BUS standard (configurable) Medium (T) Type of measured medium according to M-BUS standard (configurable)
Operating Conditions This section of the document provides basic recommendations for transport, storage, installation, and operation of WM868-SI4-B type radio modules. General Operational Risks Radio modules are electronic devices powered by their own internal battery, which register the status of counters or registers of connected consumption meters or sensors.
if higher grade of protection against humidity required (IP68), perform additional sealing of the module by high-adhesion silicon filling according to producer instruction (*). This treatment can be also ordered at manufacturer; install modules only to the sites where relative humidity exceed value of 95% only occasionally; install modules only to the sites where they can be squirted or sprayed by water only occasionally and only for a short time;...
Figure 9: Detailed view of the WM868-SI4-B module In the figure, important parts on the printed circuit board are color-coded: configuration connector (green), battery switch (yellow), terminal block for connecting input signal cables (purple), and antenna connector (blue). Figure shows the WM868-SI4-B module disassembled into individual components. Figure 10: Assembly of the WM868-SI4-B module with a stick antenna Figure shows the schematic for connecting cables from pulse sensors to the module’s terminal block.
case lid, covering the printed circuit board, with moldings for mounting the module to a substrate. We install the module following this procedure: attach the module to a suitable fixed object (wall, structural element...) using screws or a cable tie. The moldings on the sides of the case lid are used for mounting;...
if possible, immediately ensure the introduction of the new serial number into the collection system database The case lid does not carry any functional part, the type label with the module’s serial number is on the module base. If we use a mechanically identical product for replacement, it is permissible to only replace the module base and keep the original lid, which is already attached.
Page 37
the received signal from the module, which may reduce the reliability of reading the status of consumption meters or interrupt the connection with the module. To eliminate these risks, pay attention to the selection of the installation location of the module and its antenna, not only from the perspective of radio signal quality but also from the perspective of the possibility of mechanical damage to the module during normal operation of the facility.
Troubleshooting Possible causes of system failures During operation of the WM868-SI4-B device, failures, malfunctions, or other operational problems may occur, which can be divided into the following categories according to their cause: 6.1.1 Power supplying failures The module is supplied by electrical power from the long-life internal battery. Approximate battery life is specified in paragraph Modul usage”.
Internal Counter Setting Commands”. In case the setting is correct, the problem is the most probably in the ” malfunction of the radio module. Replace the module following the instructions in the paragraph 5.7. If the module register false” pulses (consumption registered by remote reading is significantly higher than con- ”...
check correctness of module settings, especially setting of radio parameters as described in paragraph 3.1.4 and perform the check of module overall functionality as described in paragraph 5.9; if there are breakdowns in communication with some specific element of the network, check functionality of that element according to the respective documentation;...
This manual is focused on description, parameters and configuration options of radio modules WM868-SI4-B of the WACO RF system, operating in the 868 MHz band, that are a part of the Softlink’s wacoSystem product family. More information about all WM868 (WACO), WB169 (Wireless M-BUS), WS868 (Sigfox), or NB (NB-IoT) series of the modules can be found on the manufacturer website: www.wacosystem.com...
Need help?
Do you have a question about the WACO WM868 and is the answer not in the manual?
Questions and answers