SOFTLINK WB169-RFG Manuale utente

WIRELESS COMMUNICATION SYSTEM

Wireless M-BUS

WB169-RFG

Revision 1.0

SOFTLINK s.r.o., Tomkova 409, 278 01 Kralupy nad Vltavou, Czech Republic

Phone.: +420 315707111, e-mail: [email protected],www.softlink.cz

Contents

1 Introduction 1

1.1 Wireless M-BUS Communication Protocol ................................ 1

1.2 Module usage ................................................. 1

1.3 Module features ................................................ 1

2 Technical parameters overview 3

3 Conﬁguration of the WB169-RFG module 4

3.1 Connection of the module to the computer ................................. 4

3.2 Using of ”PuTTy” freeware program for conﬁguration .......................... 5

3.3 General rules for entering of conﬁguration commands ........................... 6

3.4 Conﬁguration of the module individual parameters via cable ....................... 7

3.4.1 List of WB169-RFG module conﬁguration parameters ...................... 7

3.4.2 Displaying a summary of conﬁguration commands (”HELP”) .................. 7

3.4.3 Commands of ”System commands” group for control of module basic functions and diagnostics 9

3.4.4 Commands of ”ip” subsystem for setting of IP communication ................. 12

3.4.5 Commands of ”gsm” subsystem for setting of communication via GSM network ........ 13

3.4.6 Commands of ”gw” subsystem for setting of RF network communication ............ 15

3.4.7 Commands of ”Utils” group for setting of communication .................... 18

3.4.8 Commands of ”sys”, ”disp” and ”cc” subsystems for module initial setting and diagnostics . 21

3.4.9 Command of ”ntp” subsystem for setting of time synchronization ................ 21

3.4.10 Command of ”hist” subsystem for examination of ”History” table records ........... 22

3.5 Display of WB169-RFG module parameters on the LCD screen ..................... 23

3.6 Setting of parameters by using of optical converter ............................ 24

3.7 Setting the module parameters via Internet ................................ 25

4 Structure of forwarded messages 27

4.1 Structure of UDP-packet ........................................... 27

4.1.1 Setting of target application IP-address .............................. 27

4.2 UDP message data content ......................................... 27

4.3 Filtering of the GateWay traﬃc ....................................... 29

5 Operational conditions 30

5.1 General operational risks ........................................... 30

5.1.1 Risk of mechanical damage ..................................... 30

5.1.2 Risk of electrical damage ...................................... 30

5.2 The condition of modules on delivery .................................... 30

5.3 Modules storage ............................................... 30

5.4 Safety precautions .............................................. 31

5.5 Environmental protection and recycling .................................. 31

5.6 WB169-RFG module installation ...................................... 31

5.7 Module replacement ............................................. 32

5.8 The module dismantling ........................................... 32

5.9 Functional check of the module ....................................... 32

5.10 Operation of the WB169-RFG module ................................... 33

6 Troubleshooting 34

7 Additional information 35

List of Tables

1 Overview of WB169-RFG technical parameters .............................. 3

WB169-RFG i

List of Figures

1 View of the WB169-RFG module ...................................... 2

2 Appearance of the module in Windows ”Device Manager” ........................ 4

3 Terminal setting for serial line communication ............................... 5

4 Open terminal window for module conﬁguration via serial line ...................... 5

5 Display the main screen, main menu and system information ...................... 23

6 Appearance of Ethernet, GSM, CC1120 and History menu items .................... 24

7 Table of parameters of the WB169-RFG module. that are readable via the optical interface ..... 24

8 Telnet connection to the WB169-RFG module ............................... 25

9 Display of the ”History” table of the WB169-RFG module via HTTP ................. 26

10 UDP packet structure ............................................ 27

11 NEP Table of variables ............................................ 28

12 General structure of NEP variable ..................................... 28

13 Structure of the message from the WB169-RFG GateWay containing the WMBUS packet . . . . . . 29

14 Example of a message with the WMBUS-packet .............................. 29

15 View of installed WB169-RFG module ................................... 31

WB169-RFG ii

1 Introduction

This document describes features, parameters and setting possibilities of the WB169-RFG communication gateway,

which is used for receiving of radio messages from the devices for remote reading of consumption meters working

in the communication system Wireless M-BUS (hereinafter referred as WMBUS) in the 169 MHz band and for

transmitting of these messages over a standard IP network (Internet) to a central collecting system.

1.1 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

standard M-BUS deﬁnition (uses the same application layer as M-BUS standard), but is adapted for data transfer

via radio signals.

Communications via WMBUS protocol works in Master-Slave mode, where ”Master” is a collecting data device,

”Slave“ is a providing data device. Slave device could be integrated or external radio module transmitting data

from the meter/sensor. The communications protocol WMBUS deﬁnes several communication modes (simplex or

duplex). If working in simplex mode a ”Slave” device only transmits messages to ”Master” that these messages

receives. If working in ”bidirectional” mode, it is possible to use a reverse channel from ”Master” device to ”Slave”

device for ”Request” type of messages, that can contain e.g. request for the change of slave’s conﬁguration.

Wireless M-BUS communications protocol partially supports repeating of the messages. If receiving from some

”Slave” device is not possible because of the low level of radio signal, the messages can be re-transmitted (repeated)

by appointed element of the radio network (repeater or slave with such functionality). Each repeated message is

marked as ”repeated message” so as not to be repeated again.

1.2 Module usage

The WB169-RFG module is intended for data transfer from the RF modules of remote reading in 169 MHz radio

band and a central computer application that receives and processes the data. The module receives radio messages

coded according to the Wireless M-Bus EN 13757-3 and EN 13757-4 standard for the 169 MHz band, checks

their correctness, encodes (”repacks”) them into IP/UDP frames and sends them to the conﬁgured IP address

and a central application port number. Wireless M-Bus messages are packed to the IP/UDP frames with using

of proprietary coding system ”NEP” by SOFTLINK. As the Internet access is provided through the mobile data

services, the module is equipped with the integrated GSM/LTE modem.

The WB169-RFG module works in the N2 bidirectional communication mode, where it can transmit Wireless

M-BUS messages of ”Request” type addressed to any subordinate module supporting N2 mode. These messages

can be used for remote changing of parameters of the subordinate ”Slave” device. Broadcasting of the reverse-

channel message for a particular ”Slave” device is under way during 500 ms long reverse-channel communication

window that opens immediately after transmitting of ”User Data” message from the device. During this time period

the ”Slave” activates its receiver so as to be able to receive a ”Request” message (if transmitted). Receiving of the

reverse-channel message is conﬁrmed by ”Acknowledgment” type of message.

Management of ”Request” type of messages must be implemented into the central application software. These

messages addressed to the particular ”Slave” are transferred to the WB169-RFG module through the IP/UDP

protocol with using of ”NEP” coding. WB169-RFG module stores the ”Request” messages (that contain also the

lifetime period of each message) into its memory tables and after receiving of next ”User Data” message from

the ”Slave” device transmits the reverse-channel message within the communication window. If the message is

conﬁrmed by receiving of ”ACK” message from the ”Slave”, the message is removed from the WB169-RFG memory

table. If ”ACK” message does not come, ”Request” is sent again during next window until its lifetime period is

elapsed. WB169-RFG module can keep just one message in the memory table, so if the module receives another

”Request” message from the central application, stored message is replaced by new one so that only the last message

is transferred to the ”Slave”. ”Request” messages are coded by using of common M-Bus principles and the coding

system must be implemented in the central application as well as in the ”Slave” device in a specular manner. The

WB169-RFG module performs just transferring of the messages.

1.3 Module features

The basis of the module is a microcomputer with one 10/100 Mb/s Ethernet communication port, one mini

USB conﬁguration port and an integrate GSM/LTE modem.

WB169-RFG 1

Communication ports are used for the following purposes:

•10/100 Mb/s Ethernet port – this port is not used

•mini USB 2.0 port - the module conﬁguration port;

•169 MHz RF modem - RF communication with subordinate elements (terminal devices);

•GSM/LTE modem - communication with the central application.

The module is enclosed in a plastic casing adapted for mounting on a DIN-rail. The box has a standard ”circuit

breaker” proﬁle and width of four standard DIN-modules. The module needs an external power supply 12V to 24V

DC. For connecting of the power supply there is a screw terminal with marked voltage polarity.

The module RF transceiver is equipped with the coaxial connector of SMA (Female) type designated for inter-

connection of an external antenna (directly or via coaxial cable). The GSM modem is equipped in the same way.

Both connectors are connected to the module front panel and are marked as ”ANT 169 MHz” and ”ANT GSM”.

The module is equipped with a SIM card holder for using with a SIM card of the ”Mini-SIM” format (2FF) with

dimensions of 25 x 15 x 0.76 mm. The SIM holder is located on the module front panel, to the left of the LCD

display.

On the right side of the front panel there is the 40x20 mm LCD display and control buttons. These elements are

used for displaying the module basic parameters.

View of the WB169-RFG module is shown in Figure 1.

Figure 1: View of the WB169-RFG module

WB169-RFG 2

2 Technical parameters overview

Overview of all WB169-RFG module technical parameters is shown in the Table 1.

Table 1: Overview of WB169-RFG technical parameters

Transmitter and receiver parameters

Frequency band 169,400 ÷169,475 MHz

Modulation type 2GFSK, 4GFSK

No of channels in band 10

Transmission rate 2400, 4800, 19200 Baud

Receiver sensitivity -109 dBm

Reverse channel transmitting power 500 mW

Antenna connector SMA female

Communication protocol Wireless M-Bus

Communication mode (by EN 13757-4) N2

Communication interface GSM

Supported standards LTE-TDD B38/B40/B41

LTE-FDD B1/B3/B5/B7/B8/B20

UMTS/HSPA+ B1/B5/B8

GSM/GPRS/EDGEB3/B8

Antenna characteristic impedance 50 Ω

Antenna connector SMA female

Conﬁguration interface USB

Transmission speed 115 200 Baud

Operation mode asynchronous

Transmission rate 8 data bits, 1 stop bit, none parity

Connector mini USB 2.0

Optical conﬁguration interface

Transmission speed 115 200 Baud

Optical band 870 nm

Optical interface speciﬁcation IrPHY 1.4 standard

Power supplying

External power supply (12 ÷24) V

Input power 3 W

Weight and dimensions

Width 70 mm

Height 90 mm

Depth 58 mm

Weight cca 200 g

DIN case 4 modules

SIM-card format (15x12x0,76)mm) ”Micro-SIM”

Storing and installation conditions

Installation environment (CSN 33 2000-3) normal AA6, AB4, A4

Operating temperatures range (-10 ÷50) ◦C

Storage temperatures range (0 ÷70) ◦C

Relative humidity 90 % (no condensation)

Degree of protection IP20

WB169-RFG 3

3 Conﬁguration of the WB169-RFG module

Conﬁguration parameters of the WB169-RFG module can be displayed and changed from the common computer

(PC) by one of these methods:

- with using of common USB cable connected to the module conﬁguration port;

- visually, with using of built-in LCD and control buttons;

- wirelessly, with using of ”USB-IRDA” converter;

-remotely via Internet connection.

Technique of interconnection of the module with conﬁguration computer and general rules of conﬁguration are

described in detail in paragraph 3.3. The description and meaning of all conﬁguration parameters that can be

checked and changed by cable can be found in the section 3.4 ”Setting of WB169-RFG parameters via conﬁguration

cable”.

The description of checking of basic parameters and operational statistics of the module by using of LCD display

and control buttons can be found in the section 3.5 ”Display of WB169-RFG module parameters on the LCD”.

The description of checking of basic parameters and operational statistics of the module by using of optical converter

can be found in the section 3.6 ”Setting of parameters by using of optical converter”.

The description of checking and setting of module parameters through the Internet connection can be found in the

section 3.7 ”Setting of parameters via the Internet data network”.

3.1 Connection of the module to the computer

Conﬁguration via USB cable can be performed by using of any PC with MS Windows or Linux operating systems.

The module is equipped with the ”mini USB” conﬁguration interface and can be connected with the PC by common

”USB 2.0 A Male - USB 2.0 mini B Male” interconnection cable.

After the module is connected to the computer for the ﬁrst time, operating system will ﬁnd and install appropriate

generic driver of ”USB Serial Device” category automatically. After driver installation is completed, the device will

appear in the ”Ports (COM and LPT)” section of the ”Device Manger” window as ”USB Serial Device (COMx)”

(see ﬁgure 2).

Figure 2: Appearance of the module in Windows ”Device Manager”

Thus the computer is connected with the module and ready for performing any changes in conﬁguration.

WB169-RFG 4

3.2 Using of ”PuTTy” freeware program for conﬁguration

The module conﬁguration can be done with using of any suitable program for the serial line communication. The

description bellow is relevant for the open-source software ”PuTTY“ that is available for free on www.putty.org.

Figure 3: Terminal setting for serial line communication

”PuTTY” software runs after clicking on the downloaded ﬁle ”putty.exe“. There will open a window of the terminal

communication (see Figure 3). For switching the program into the serial line communication, choose ”Serial” option

of the connection type in the ”Session” tab.

Check (or set up) the communication speed (”Speed”) to 115200 bits/s and then enter into the ”Serial line“ tab the

number of the serial port that the system automatically assigned to the virtual port at the moment of interconnection

module to the computer. The number of the serial port can be found in OS Windows by using of ”Device Manager”

(Control Panel/System and Maintenance/Device manager) by clicking on ”Ports (COM a LPT)” where the numbers

of ports appear (e.g. ”COM23” - see ﬁgure 2).

Click on ”Open” button in ”PuTTY” program and open the terminal window. After pressing of ”ENTER” key

there will appear a request for login and (after entering login) password. Factory preset login/pasword couple

is ”admin/admin”, it is recommended to change it after installation. After login procedure there will appear a

sequence with an information about last reset ended by system command line marked by ”GW33H7-0#” prompt,

which announces that the module is ready to be conﬁgured (see ﬁgure 4).

Figure 4: Open terminal window for module conﬁguration via serial line

WB169-RFG 5

3.3 General rules for entering of conﬁguration commands

Activate the terminal window for the conﬁguration via the conﬁguration cable according to the instructions above.

These general rules are valid for entering commands in the command line:

•the command must be entered only when a prompt for command appears in front of the cursor mark (colored

or ﬂashing little square); the prompt is either ”GW33H7-0#” or ”mon” format (see ﬁgure 4);

•it is possible to enter only one command each time;

•the command could be entered in an alphanumeric character (or several characters);

•the command is sent to device by clicking on ”ENTER” key. After the command being carried out, the

prompt will appear again and it is ready for a new command to be entered. In case the command fails to

execute, there will appear an error report;

•if it takes longer from the last command, due to a loss of communication on the serial line the module may

respond to the command with the error message ”command not found” even if the command is correct. In

that case, just enter the command again. Before entering each command (especially for longer and more

complex commands) it is recommended to ”refresh” the serial line by pressing of ”ENTER” key.

•check the execution of the command by displaying of the list of conﬁguration parameters which appears by

entering ”show” or ”/” and pressing on ”ENTER” key;

•to display a summary of conﬁguration commands and their parameters (”HELP”), enter ”?” (question mark),

or ”/?” and press ”ENTER” key;

•some subsystems have their own command set. To view a summary (set) of commands for a given subsystem,

enter the set name and the ”?” (question mark). For example, to display a set of commands for the GSM

subsystem, enter the command ”gsm?”. The individual commands for a given subsystem can be entered

by writing of ”distinguishing” command for the given subsystem followed by the command itself (after the

space). For example, setting the APN for GSM communication is done with the command ”gsm apn”, where

”gsm” is the distinguishing command for the GSM subsystem and ”apn” is the command for conﬁguring the

APN. The distinguishing commands for each set are listed at the end of the ”HELP” conﬁguration command

summary;

•when entering characters, distinguish strictly the capital and small letters (according to the documentation

or ”HELP”);

•Do not enter other characters than those listed in ”HELP“ or in the documentation, otherwise you would

be risking the unwanted command enter that might be the same as the ones used for manufacturer settings,

diagnostics or service and repair.

WB169-RFG 6

3.4 Conﬁguration of the module individual parameters via cable

In following part of the document there is a description of these parameters of the WB169-RFG module, that can

be displayed and examined from PC connected to the module by conﬁguration cable. Some of the parameters can

be changed by conﬁguration commands entered ”from the console” of the serial line communication program as

described in paragraph 3.3 of this document.

3.4.1 List of WB169-RFG module conﬁguration parameters

List of all conﬁguration parameters of the module can be displayed by entering of ”show” command and pressing

of ”ENTER” key. The following list of parameters will display in the terminal window:

GW33H7-0#show

-- CPU info --

CPUID : 411fc271

FPU Type : 00000002

Flash size 2048 kB

Flash bank size 1048576 B, 0x00100000

Flash base addr 0x08000000

CPU UID 3339510a001c0036

SW version 1.02, date Apr 19 2021

-- HW configuration --

Active bank : 2

Name : GW33H7

Type : 2, version 1

Vendor ID : 0000000000

Mac addr : 0004d0ffffff

x32 0.00 ppm

In slot P card : ’RF169, cc1120, LNA’, type 122, version 1

In slot L card : ’GSM LTE, SIM7600E’, type 140, version 1

GW33H7-0#

As can be seen from the example, the report contains the identiﬁcation data of the module as well as data on its

hardware conﬁguration and software version.

3.4.2 Displaying a summary of conﬁguration commands (”HELP”)

List of all conﬁguration commands (”HELP”) can be displayed by entering of ”?” command into the command

line and pressing of ”ENTER” key. The following list of commands will display in the terminal window:

WB169-RFG 7

Indice

Altri manuali SOFTLINK Modulo wireless

SOFTLINK

SOFTLINK WB169-430 Manuale utente

Manuali Modulo wireless popolari di altre marche

Laird

Laird RM024 Manuale utente

Laird

Laird BT830-SA Guida rapida alla configurazione

Ebyte

Ebyte E49-400T20S Manuale utente

Fibocom

Fibocom FM101-NA-20 Istruzioni per l'installazione

Waldmann

Waldmann EnOcean TALK MODUL G2 Manuale utente

Smartech

Smartech LBT-1.DO4 Manuale utente

Cooper Wiring Devices

Cooper Wiring Devices ESPIRE RF RFAPM Manuale utente

Yuga

Yuga CLM920 Manuale utente

Waldmann

Waldmann TALK Bluetooth Manuale utente

Telit Wireless Solutions

Telit Wireless Solutions UC864-G Manuale di installazione

Ebyte

Ebyte E07-900M10S Manuale utente

Quectel

Quectel SC690A Series Supplemento

Panasonic

Panasonic INDUSTRY PAN9028 Guida rapida alla configurazione

Ebyte

Ebyte E70-433NW30S Manuale utente

LongSung Technology

LongSung Technology U9507E Manuale utente

Wistron NeWeb

Wistron NeWeb DNUR-S2 Manuale utente

Ebyte

Ebyte E49-400M20S4 Manuale utente

RF-Star

RF-Star SimpleLink RF-BM-2652P1 CC2652P Manuale utente