SOFTLINK WACO WM868 Manual

Wireless communication system
Hide thumbs Also See for WACO WM868:
Table of Contents

Advertisement

Quick Links

WIRELESS COMMUNICATION SYSTEM
WACO WM868
WM868-TE-B
WM868-TES-B
Revision 1.0
SOFTLINK s.r.o., Tomkova 409, 278 01 Kralupy nad Vltavou, Czech Republic
Phone.: +420 315707111,
e-mail:
sales@softlink.cz,
www.softlink.cz

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the WACO WM868 and is the answer not in the manual?

Questions and answers

Summary of Contents for SOFTLINK WACO WM868

  • Page 1 WIRELESS COMMUNICATION SYSTEM WACO WM868 WM868-TE-B WM868-TES-B Revision 1.0 SOFTLINK s.r.o., Tomkova 409, 278 01 Kralupy nad Vltavou, Czech Republic Phone.: +420 315707111, e-mail: sales@softlink.cz, www.softlink.cz...
  • Page 2: Table Of Contents

    Contents 1 Introduction 1.1 WACO communication system ........1.2 LoRaWAN communication system .
  • Page 3: List Of Figures

    List of Figures Principle of data transmission from WM868-TE-B module via communication gateway ..Principle of data transmission from WM868-TE-B module to another WACO radio module ..Appearance of WM868-TE-B module (top) and WM868-TES-B module (bottom) .
  • Page 4: Introduction

    Introduction This document describes the features, parameters and configuration options of WM868-TE-B and WM868-TES- B radio modules, which are used for temperature measurement and radio transmission of information about the current state of the measured quantity through radio messages in WACO, LoRa, or Wireless M-Bus format. WACO communication system WACO (Wireless Automatic Collector) is radio frequency (RF) communication system intended especially for the remote reading of consumption meters (smart metering area), automatic data collection from sensors (telemetry...
  • Page 5: Wireless M-Bus Communication Protocol

    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 ”...
  • Page 6: Principle Of Data Transmission From Wm868-Te-B Module To Another Waco Radio Module

    Figure 2: Principle of data transmission from WM868-TE-B module to another WACO radio module In WACO and LoRa transmission modes, message data content is encoded using proprietary WACO/NEP protocol, in Wireless M-Bus transmission mode, message data content is encoded according to standard M-Bus protocol. The computer processing the messages must be equipped with appropriate decoder.
  • Page 7: Technical Parameters Overview

    Technical parameters overview Overview of technical parameters of WM868-TE-B and WM868-TES-B modules is shown in Table 1. Table 1: Technical parameters overview of WM868-TE-B and WM868-TES-B modules Radio Interface Frequency band Transmission modes WACO, wM-Bus, LoRa Modulation type - WACO GFSK Modulation type - wM-Bus Modulation type - LoRa...
  • Page 8: Module Configuration

    Description of connecting the module to a mobile phone via Bluetooth wireless connection and general rules for module configuration using the ”Softlink Configurator” mobile application are described in Chapter 3 of the above-mentioned manual ”Configuration of wacoSystem product line devices”. Section ”Setting WM868-TE-...
  • Page 9 wm868-SI4X>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 ---...
  • Page 10: Overview Of Module Configuration Commands ("Help")

    3.1.2 Overview of module configuration commands (”HELP”) A 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 listing will appear in the terminal window: wm868-SI4X>? - help...
  • Page 11: Commands For Basic Module Control

    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-SI4X>? - 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..
  • Page 13: Commands For Configuring The Rf Subsystem Of The Module

    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-TE-B module that are common to all modes. These are the following commands: - help info - print driver info clear...
  • Page 14: Commands For Configuring Waco Transmission Mode

    wm868-SI4X>rf rxt 10 RX timeout : 10 (500 ms) wm868-SI4X> 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-TE-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 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. In this case, the radio range of the module is about 2.5 times longer.
  • Page 16: Commands For Configuring Wireless M-Bus Transmission Mode

    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-TE-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-TE-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.
  • Page 18: Commands For Configuring Lora Transmission Mode

    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 ”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”. The current version of the WM868-TE-B module only supports the EU868 frequency plan, which is set at the factory.
  • Page 20 wm868-SI4X>lora rxdly Recv Delay : 2 wm868-SI4X>lora rxdly 1 Recv Delay : 1 wm868-SI4X> 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.
  • Page 22: Commands Of The "Application" Group For Setting The Data Sending Application

    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. In OTAA mode, it is thus possible to deploy modules directly from production, without the need for any settings.
  • Page 23: Commands For Setting The Bluetooth Subsystem

    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 wacoSystem product line devices”.
  • Page 24 Configuring the module from the mobile application via the Bluetooth wireless interface has several general steps: 1. Download the ”Softlink Configurator” mobile application from ”Google Play” (Android) or ”App Store” (iOS). Use the keyword ”Softlink” for search, the application is presented under the name ”BLE Configurator”;...
  • Page 25 - setting of max. number of hops (Hop Count) - setting of transmission power - setting of receive window length (RX TimeOut) - setting of carrier detection function (Carrier Detect) The ”WMBUS Settings” form is used to set parameters for communication in Wireless M-Bus transmission mode.
  • Page 26: Setting Module Parameters From A Remote Computer Using Reverse Channel

    Figure 4: Preview of forms for setting the module using mobile application Setting module parameters from a remote computer using reverse channel The WM868-TE-B module supports communication in the so-called reverse channel (from central application to module) in WACO and LoRa transmission modes. The possibilities of bidirectional communication via reverse channel can be used for remote parameter setting from a remote computer.
  • Page 27: Module Data Message Structure

    Jednotliv´ e promˇ e nn´ e jsou do datov´ e ho obsahu zpr´ a vy k´ o dov´ a ny pomoc´ ı propriet´ a rn´ ıho syst´ e mu k´ o dov´ a n´ ı ”NEP” firmy SOFTLINK, kdy kaˇ z d´ y typ promˇ e nn´ e m´ a sv´ e oznaˇ c en´ ı ”OID” (Object ID), urˇ c uj´ ıc´ ı v´ y znam, charakter a datov´...
  • Page 28: Struktura Datov´ E Zpr´ A Vy Syst´ E Mu Waco

    Figure 6: Struktura datov´ e zpr´ a vy syst´ e mu WACO Figure 7: N´ a hled tabulky ”NEP” pro k´ o dov´ a n´ ı promˇ e nn´ y ch v syst´ e mu WACO Je-li pˇ r ´ ıjemcem zpr´ a v ”INFO” z modulu sbˇ...
  • Page 29: Lora

    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)
  • Page 30: Operating Conditions

    Operating conditions This section of document provides basic recommendations for transport, storage, installation and operation of WM868-TE-B/WM868-TES-B radio modules. General Operating Risks WM868-TE-B/WM868-TES-B radio modules are electronic devices powered by internal battery that measure ambient air temperature at short intervals and transmit radio message with current temperature reading at set intervals.
  • Page 31: The Condition Of Modules On Delivery

    ˆ 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; ˆ...
  • Page 32: Module Replacement

    Important parts are color-marked on PCB in image: configuration connector (green), battery switch (yellow), external temperature probe cable connector (purple) and antenna connector (red). Figure shows WM868-TES-B module disassembled into individual components. WM868-TES-B module has Figure 10: WM868-TES-B module assembly with rod antenna external temperature probe connected at end of approx.
  • Page 33: Module Disassembly

    ˆ if module was sealed, check seal condition before disassembly. Handle broken seals according to internal rules for given customer/project; ˆ unscrew screws on top of case to release module cover and remove module base from lid; ˆ switch both micro-switches (”jumpers”) located on PCB next to configuration connector to ”Off” position to turn off module;...
  • Page 34: Troubleshooting

    Troubleshooting Possible System Failure Causes During operation of WM868-TE-B/WM868-TES-B devices, failures, malfunctions, or other operational problems may occur, which can be categorized by their cause into the following categories: 6.1.1 Poruchy nap´ a jen´ ı Modul je nap´ a jen z vnitˇ r n´ ı baterie s dlouhou dobou ˇ z ivotnost´ ı. Pˇ r ibliˇ z n´ a doba ˇ z ivotnosti baterie je bl´ ıˇ z e specifikov´ a na v odstavci Pouˇ...
  • Page 35: Sensor Failures

    If above described indications of unreliable radio-communication become evident, proceed with troubleshooting of the malfunctioning in following steps: ˆ visually check surrounding of the installation site to find out if there are any changes that can influence radio signal (e.g. new objects, things, machines...). If there are such negative circumstances, solve the trouble by reorganization of the object or by redesign of radio network;...
  • Page 36: Additional Information

    This manual is focused on description, parameters and configuration options of radio modules WM868-TE-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...

This manual is also suitable for:

Wm868-te-bWm868-tes-b

Table of Contents