background image

[email protected]

webdyn.com

V2.0 subject to changes | Webdyn © by Flexitron Group

29

The Hall effect sensor is used for various actions such as:

• 

Requesting the current operating mode and activating the interfaces for local configuration.

•  Changing the operating mode.
•  Re-applying factory settings (combined with the RESET button).

2.4.4.2 RESET Button

The RESET button has two functions:

•  Restarting the product: a short press on the button
•  Re-applying factory settings by following this procedure:

•  Place the magnet on the top of the box opposite the Hall effect sensor and keep it in 

place.

• 

Briefly press the RESET button. 

•  A long beep (1 second) is issued, informing that the factory settings have been re-applied. 
•  Remove the magnet.

2.4.4.3 Modem LED

The Modem led lights when the modem is activated to upload files to the remote server.

2.4.5 USB Interface

The hub USB interface can be used for:

• 

Configuration.

•  Commands.
•  Product updates.

For proper operation, it is essential to strictly follow the steps below:

•  Switch the WebdynEasy W M-Bus to RUN mode.
•  Connect the hub to a computer using a USB cord (A male - mini B male type). 
•  A new drive called “WebdynEasy W M-Bus” will appear on the computer (like a thumb drive).
•  Open this drive.
• 

Copy the configuration, command or update file to the hard drive.

• 

Eject the removable drive and wait for confirmation from the system.

•  Press the RESET button.

Summary of Contents for WebdynEasy W M-Bus

Page 1: ...WebdynEasy W M Bus 868MHz User Manual www webdyn com...

Page 2: ...ported Equipment 12 1 5 Product and Accessory References 12 1 6 Technical Specifications 12 1 6 1 General Specifications 12 1 6 2 Technical Specifications 13 1 6 3 Software Specifications 16 1 6 4 Bat...

Page 3: ...Local Configuration 37 4 1 1 USB 37 4 1 2 Bluetooth BLE 37 4 2 Configuration File 39 4 2 1 System 39 4 2 2 W M Bus radio 43 4 2 3 Hub Connectivity 48 4 2 4 Alarms 54 4 2 5 Schedule and Monitoring 55...

Page 4: ...6 5 6 9 logClean Command 77 5 6 10 supervisionClean Command 77 5 6 11 supervisionGet Command 78 5 6 12 certificate Command 78 5 6 13 certClean Command 79 5 7 Supervision 79 5 8 The Log 86 6 Update 88...

Page 5: ...nded for the computer exchange of files on a TCP IP network variant of FTP secured with SSL or TLS protocols It allows visitors to verify the identity of the server they are accessing using an authent...

Page 6: ...ovides a reliable data transfer service See also IP TCP IP Transmission Control Protocol Internet Protocol a set of network protocols that provide interconnection services between computers of differe...

Page 7: ...M Bus hubs from hardware version V1 and software version V1 0 onwards 2 2 Target Audience This guide is for on site installers who will cable and configure the installations for those in charge of lo...

Page 8: ...command Changed the update command to firmware Modification of the configGet command V2 0 Added NB IoT Adding supervision variables Addition and presentation of the new case Added network unregistrati...

Page 9: ...Bus allows you to build your private network and is part of a package WM Bus communication is point to point in a non operated way The meters or sensors regularly send data frames which are received a...

Page 10: ...2 reserved LED 5 Modem status 5 868MHz radio SMA antenna 6 Box output for the 868MHz radio external antenna optional 7 Battery Pack 8 Battery pack connector 9 Aerator 10 Box output for external power...

Page 11: ...al 868MHz radio antenna optional 8 Battery Pack 9 Battery pack connector 10 Breakable output of the box for installation of M12 cable gland allowing installation of aerator optional 11 Breakable outpu...

Page 12: ...612 A12 WebdynEasy with BLE Accessories REFERENCES DESCRIPTIONS AC0803 01 Battery pack 7 2V 14Ah Webdyn proposes factory preconfiguration services for your WebdynEasy W M Bus Please contact our sales...

Page 13: ...REACH Regulation CE marking created in the framework of European technical harmonisation legislation It is mandatory for all products covered by one or more European regulatory texts directives or reg...

Page 14: ...6 B85 NB IoT B1 B2 B3 B4 B5 B8 B12 B13 B18 B19 B20 B25 B28 B66 B85 Antenna Internal SMA external as an option BLE interface 160 x 150 x 55 mm SIM format ASA Protected against dust and bad weather Webd...

Page 15: ...MHz 849 MHz LTE M NB IoT Band 8 880 MHz 915 MHz LTE M NB IoT Band 12 699 MHz 716 MHz LTE M NB IoT Band 13 777 MHz 787 MHz LTE M NB IoT Band 18 815 MHz 830 MHz LTE M NB IoT Band 19 830 MHz 845 MHz LTE...

Page 16: ...account Standard environmental conditions 1 radio listening window per day 20KB of data recorded per listening window ie 300 frames of 64 bytes or 500 frames of 40 bytes With LTE M LENGTH OF LISTENING...

Page 17: ...s 10 years 12 years 8 7 years 8 years 10 years 10 6 years 7 years 8 years 12 5 years 6 years 8 years 15 5 years 5 years 6 years 20 4 years 4 years 5 years 30 3 years 3 years 3 years With 2G LENGTH OF...

Page 18: ...he WebdynEasy W M Bus product can be damaged by electrostatic discharges ESD When the equipment is open do not carry out any operations other than those described in this manual Avoid any contact with...

Page 19: ...y available from Webdyn or on website www webdyn com Recycling The European directives enacted into national law covering battery waste and electric and electronic equipment provide the framework for...

Page 20: ...the product Use a remote antenna if radio or cellular modem reception is deteriorated Have an Android smartphone with the WebdynEasy W M Bus app installed to facilitate product configuration Have a P...

Page 21: ...0 subject to changes Webdyn by Flexitron Group 21 The QR Code is used by the mobile app for synchronisation with the hub Each product is labelled with the following information This label is accessibl...

Page 22: ...ront face Then follow these steps Unscrew the 4 screws behind the box Remove the cover Follow these steps to close the hub box Place the cover on the box base Screw in the 4 screws on the back of the...

Page 23: ...Power Supply 2 4 1 1External Power Supply The WebdynEasy W M Bus hub can be powered using 12V DC with or without a battery pack connected Power is supplied from terminal block J8 on the left side of...

Page 24: ...e the power supply used can provide a minimum power of 10 watts 2 4 1 2Battery Pack The WebdynEasy W M Bus hub has a Lithium battery that can keep the product running for 10 years The hub includes a g...

Page 25: ...ed RF on the board to connect a radio antenna The product is delivered with an internal antenna An external antenna can be connected to the product To do this unscrew the cap on the box and fit a M16...

Page 26: ...tion that does not have proper signal reception the use of a remote antenna is strongly recommended Be careful to use an antenna compatible with the connector and frequencies used In the new box the c...

Page 27: ...Slide the SIM card into the flap Then close the flap by sliding it to the left in the LOCK direction Webdyn does not supply any SIM cards Please contact an M2M operator that supports the 2G NB IoT and...

Page 28: ...ron Group 28 2 4 4 Indicators Buttons The hub is equipped with 1 Hall Effect sensor 1 push button 1 modem indicator 2 4 4 1Hall Effect Sensor The WebdynEasy W M Bus hub is equipped with a Hall effect...

Page 29: ...Briefly press the RESET button A long beep 1 second is issued informing that the factory settings have been re applied Remove the magnet 2 4 4 3 Modem LED The Modem led lights when the modem is activa...

Page 30: ...B cord Never disconnect the USB cord or restart the board before having the system eject the removable drive You could damage the file system and corrupt the loaded files If the removable drive is ina...

Page 31: ...to be stored for long periods of time limiting battery consumption To find out whether the WebdynEasy W M Bus has a customer configuration check the product s commercial reference see section 2 2 2 Id...

Page 32: ...he hub will switch to RUN mode Each mode STORAGE FACTORY SETTINGS and RUN is associated with a number of beeps indicating the equipment status The mode can be changed by specifying it when sending a c...

Page 33: ...mode is only possible by configuring the product The hub can be configured using USB Connecting the USB cord automatically wakes up the product Bluetooth BLE BLE is activated when the magnet is passed...

Page 34: ...tically shut down after 4 minutes without any activity A new configuration phase will need to be launched to reactivate it if necessary The required mode can be set when configuring the product When t...

Page 35: ...m Monitoring These tasks are regular and not synchronised with each other 3 1 2 1 WM BUS Task The WM BUS task is used to collect WM BUS data from the sensors It has its own scheduler to set its run fr...

Page 36: ...recorded in the supervision file The maximum temperature not to be exceeded can also be configured The product battery level the minimum battery level percentage can be defined If a defined threshold...

Page 37: ...the USB cord to the product wakes it up A new drive called WebdynEasy W M Bus appears as a thumb drive A configuration file placed on this drive is automatically taken into account when the hub is re...

Page 38: ...R Code on the product label see section 2 2 2 Identification Enter the Bluetooth Authentication PIN by default 1234 Now that you are connected to the hub you can configure the mobile data and choose t...

Page 39: ...s html To avoid file alteration during exchanges a CRC32 is included in each file See section 5 1 1 4 File Format The WebdynEasy W M Bus hub configuration file is in BSON format and its format is as f...

Page 40: ...n only be put into RUN mode locally see chapter 3 1 Start up of the product Example Using a JSON file to be converted to BSON format for the hub config mode run name WebdynEasy logLevel 2 crc 0 4 2 1...

Page 41: ...only if the testCount parameter is equal to 1 default disabled 0 If the number of diagnostic command sequences in a row is greater than 1 then there will be no Beep to notify of the result at the end...

Page 42: ...the FTP Coding in AES128 CBC All the BSON files can be encrypted using an AES128 CBC with the following key as Initial Vector IV C0 50 3E CD E3 DB 6B 2E 52 F5 9B 95 B6 F1 9B 58 The padding standard u...

Page 43: ...radio variables are in the radio object in JSON PARAMETERS DESCRIPTION mode WM Bus mode used 0 for S1 1 for T1 2 for T1 C1 default duration WM Bus listening window duration in seconds 1 to 3600 The d...

Page 44: ...Metering system specification true information used in the long header default false information used in the short header skipVersionField In case of Whitelist allows to ignore the version of the coun...

Page 45: ...to recover the WM Bus data from other sensors which are in another mode In the case of a multi listening mode the mode and duration parameters are arrays The first element of the arrays corresponds to...

Page 46: ...ng to the WM Bus identifiers entered in the white list During a listening window it may close before the programmed duration if the data for all the equipment on the white list has been recorded The w...

Page 47: ...can either Send a whitelisterase whitelist erasing command see chapter 5 6 6 whiteListErase command whiteListErase command Send a configuration file with a null value for the wlFilter object In the ca...

Page 48: ...of CRC if the frame length is less than 128 bytes 4 otherwise In the WM Bus frames recorded by the gateway the CRCs are not present Depending on the frame format the processing of the frame is not the...

Page 49: ...LTEM Authorize the modem in LTE M NB IoT Authorize the modem in NB IoT band List of authorized bands for the modem connection in NB IoT numerical value of the band Available bands are 1 2 3 4 5 8 12...

Page 50: ...e network in NB IoT it is strongly recommended to enter the bands authorized by the operator and the country Please find below a table of the bands deployed worldwide for your information Bands U S A...

Page 51: ...eq LTEM 2G NB IoT band 3 8 20 deregisterOnLocalAction false cpin 1234 apn null user null pass null timeout 240 randomDelay 0 crc 0 4 2 3 2 FTP FTPS All the hub FTP FTPS variables are in the ftp object...

Page 52: ...ver TLS user FTP account username 32 characters max pass FTP account password 32 characters max dir FTP server root directory 64 characters max null FTP account root directory Example Using a JSON fil...

Page 53: ...een 1 and 65535 Data recording and file name generation is relative to the date and time retrieved from the NTP server in UTC 0 format If you want to change the time zone you will have to develop proc...

Page 54: ...alarm is triggered between 10 and 50 null or 0 disables the temperature alarms default timeGap Monitoring of the hub clock drift compared to the time retrieved using NTP in seconds before an alarm is...

Page 55: ...FTP Schedule which is used to upload files and synchronise the product clock Monitoring which is used to monitor the battery and the product temperature 4 2 5 1 Schedules Schedules are timer triggers...

Page 56: ...tands for every hour 24 times on Mondays A range operator 30 11 13 at 11 30 12 30 and 13 30 every day 3 times a day A set of values operator 5 12 47 at hh 05 hh 12 and hh 47 where hh stands for every...

Page 57: ...be the one defined in config radio duration see section 4 2 2 WM Bus radio Example Using a JSON file to be converted to BSON format for the hub config scheduleRadio cron 30 data 30 cron 15 23 data 12...

Page 58: ...15 p m we have a first listening window according to the duration defined in the config radio duration 1st mode parameter followed by a second listening window according to the duration defined in th...

Page 59: ...imer that starts at a fixed interval defined in minutes The hub includes battery level and product temperature monitoring but also triggers data acquisition for statistics that will be recorded in the...

Page 60: ...contact webdyn com webdyn com V2 0 subject to changes Webdyn by Flexitron Group 60 Example Using a JSON file to be converted to BSON format for the hub config monitoringPeriod 60 crc 0...

Page 61: ...or trigger actions on it the configuration or command files must be uploaded to the server in an INBOX directory associated with the hub Monitor the hub and assist in diagnosis the hub can upload hub...

Page 62: ...s the alarms and acknowledgements ACK The alarm file name is in the following format uid timestamp alarm bson The acknowledgement file ACK name is in the following format uid timestamp ack bson SUPERV...

Page 63: ...an additional tmp extension When the file transfer is complete it is renamed by removing the tmp extension This process allows the remote server to easily differentiate between files being uploaded a...

Page 64: ...F 74 65 00 2D 00 00 00 04 4E 54 50 00 23 00 00 00 02 30 00 0F 00 00 00 6E 74 70 2E 67 6F 6F 67 6C 65 2E 63 6F 6D 00 02 31 00 01 00 00 00 00 00 00 00 10 43 52 43 00 A3 7B 0C 2A 00 5 2 The Configuration...

Page 65: ...in the ALARM directory A pre defined name must be used for the configuration file uid cfg bson Once the new configuration has been applied an acknowledgement file containing the result of the new con...

Page 66: ...f a diagnostic the hub takes advantage of the connection to upload the data in its memory The data file consists of the following elements PARAMETERS DESCRIPTION uid Hub identifier source Source that...

Page 67: ...Group 67 Example of a data file converted to JSON uid WE_1234 source schedule TS 1560068897 frameCount 2 data T 1560066602 R 199 F type 80 binary fAviGIskafDwA4E0UkO26w T 15600645887 R 178 F type 80...

Page 68: ...23456 1591083697 alarm bson Alarms can be configured to be uploaded only once per day see section 4 2 4 Alarms The alarm file consists of the following elements PARAMETERS DESCRIPTION uid Hub identifi...

Page 69: ...edgement file name format is uid timestamp ack bson Where uid Hub identifier timestamp Number of seconds elapsed since January 1st 1970 at midnight UTC precisely Example 123456 1591083697 ack bson Ack...

Page 70: ...tion update cid Command identifier corresponding to the acknowledgement result Command result ok command or update successfully processed ko error processing the command or the update data Data associ...

Page 71: ...y will be downloaded before being deleted and run An acknowledgement file will be uploaded to the remote server notifying of the result of the command processing USB on the removable drive After the p...

Page 72: ...whiteListErase Erase the radio white list operatorInit Reset the modem network operator selection logGet Force logs to be uploaded to the remote server logClean Erase the event log supervisionClean R...

Page 73: ...Request Command The request command triggers the immediate connection of the product to the remote server making it possible to upload data the configuration and the supervision but also to download t...

Page 74: ...e the hub software see section 6 Update 5 6 4 Diag Command The diag command can be used to trigger a hub diagnosis by collecting the data sent by the WM Bus sensors over a configured period of time se...

Page 75: ...o effect if used in FTP No subcommands or parameters are required for this command Example Using a JSON file to be converted to BSON format for the hub cmd type configGet crc 0 5 6 6 whiteListErase Co...

Page 76: ...are required for this command Example Using a JSON file to be converted to BSON format for the hub cmd type operatorInit crc 0 5 6 8 logGet Command The logGet command is used to force the upload of t...

Page 77: ...re required for this command Example Using a JSON file to be converted to BSON format for the hub cmd type logClean crc 0 5 6 10 supervisionClean Command The supervisionClean command is used to reset...

Page 78: ...e Command The certificate command allows you to add a certificate to the concentrator In the order you must indicate the name of the certificate to be taken into account in the data field You must als...

Page 79: ...nt in the concentrator No subcommands or parameters are needed for this command Example By JSON file to be converted into BSON format for the concentrator cmd type certClean cid 123456 crc 0 5 7 Super...

Page 80: ...of seconds elapsed since January 1st 1970 at midnight UTC precisely supervision Supervision information The information from the supervision supervision is as follows SECTION PARAMETERS DESCRIPTION id...

Page 81: ...modem imei Modem IMEI iccid ICCID identification number of the SIM card num SIM card phone number operator Preferred operator name mode Connection type 2G LTEM auto counters wakeup Total number of wa...

Page 82: ...fore the first estimate capaPrcent Percentage of remaining battery capacity capamAh Capacity in mAh remaining in the battery WmBus CptRxPreamb Number of radio preambles detected in radio reception Cpt...

Page 83: ...een 0 C and 10 C 10 c to 20 c Number of times the hub temperature was between 10 C and 20 C 20 c to 30 c Number of times the hub temperature was between 20 C and 30 C 30 c to 40 c Number of times the...

Page 84: ...1234 name 1234 SN SN20200423_9876543210 version hw 11 sw 01 04 swBle 0 1 swModem BG95M3LAR02A03_01 005 01 005 uptime run 85484 radio 69090 modem 5873 lowPower 336583 measures vAlim 7100 temperature 15...

Page 85: ...bleWakeup 0 ftp 137 radio 2094 alarms 0 usb 14 wd 0 fault 0 dates lastConfig 1598364963 lastUpdate 0 lastPowerOn 0 lastCnxOk 1610968521 lastCnxKo 1610752526 battery remainTime null capaPrcent 95 capa...

Page 86: ...456 1591083697 log bson Log files are uploaded when connecting to the FTP server The log file consists of the following elements PARAMETERS DESCRIPTION uid Hub identifier source Source that triggered...

Page 87: ...ppRun 27 run application T 1598348100 C 3 D RADIO appRadioTask 57 radio task T 1598348100 C 3 D FRAME Frame_FastFilter_Init 57 white list filter disable T 1598348100 C 33554432 D RADIO appRadioTask 98...

Page 88: ...mware to be taken into account must be indicated in the data field A firmware cmd bson command file is supplied along with the firmware Just rename it to uid cmd bson With uid Username of the concentr...

Page 89: ...ub locally connect the USB cord between the hub and a computer and then follow the file download procedure see section 4 1 1 USB The file or files containing the update and the associated command must...

Page 90: ...le free of charge for Windows on our site at this address https www webdyn com support BSON JSON and JSON BSON Conversion Tools To facilitate the conversion of JSON and BSON files Webdyn has created a...

Page 91: ...if the product is started Remotely by checking the regularly uploaded files if the product configuration is correct On site by passing the magnet over the product you will hear 3 short beeps How to r...

Page 92: ...at B to format A false Field L of format B is not modified true radio duration Duration of the WM Bus listening window in seconds Integer min 1 max 3600 60 radio manufFilter List of authorised manufac...

Page 93: ...t 2G forces the modem to 2G LTEM Forces the modem to LTE M auto The modem manages the network automatically auto remote modem scanseq Search Sequence Preference Table List 2G Forces the modem to 2G LT...

Page 94: ...alarms temperature Maximum temperature in degrees C before an alarm is triggered Integer min 10 max 50 null or 0 disables the temperature alarms null alarms timeGap Monitoring of the hub clock drift c...

Page 95: ...0 to 23 dd represents the day of the month from 1 to 31 MM represents the month from 1 to 12 DD represents the day in the week 0 Sunday 1 Monday Tuesday 6 Saturday scheduleFTP data File type to send I...

Page 96: ...purt 110058 Delhi Phone 91 1141519011 Email contact webdyn com PORTUGAL Av Coronel Eduardo Galhardo 7 1 C 1170 105 Lisbon Phone 351 218162625 Email comercial lusomatrix pt TAIWAN 5F No 4 Sec 3 Yanping...

Reviews: