top of page

Only available for Logged-in member. Please login or register to access this information.

Or use the Temporary User that we have provided to you via email.

expiry time ​

WSSFCEX-GHC

Manual for WSSFC-DI | FW1

Normally Stock

Replaced by

Replaced by

Item codes
FW Released Date
Changes Information
WSSFC-DI-12, WSSFC-DI-12H
14/03/2023
First Firmware

1
QUICK INSTALLATION GUIDE

1.1 Introduction

WSSFC-DI is a Sigfox-Ready node with digital inputs to detect logic status 0/1 OR counting pulses from the water meter, gas meter, power meter, proximity sensor, limit switch, machine output, pressure switch… Ultra-low-power design and smart firmware allow the sensor to run on a 2 x AA battery 1.5V for 10 years with one update per day. It can support Sigfox Zones RC1, RC2, RC3c, and RC4.

How the sensor connect to system?

The architecture of the Sigfox system
The architecture of the Sigfox system

System components:
  1. The end nodes are Sigfox-Ready Sensors or Actuators;

  2. The Sigfox Base Stations (installed and operated by Sigfox Operator);

  3. The Sigfox Back-End (Operated by Sigfox Company);

  4. The Application Server is the destination software users want to utilize the data from/to Sigfox-Ready sensors/ actuators.


How do you set up the Sigfox-Ready device and get its data to the Application Software? Please follow these steps:
  1. Contact the local Sigfox Operator to sign a Data plan contract. You will be provided an account;

  2. Log in to the Sigfox Back-end by your own account then add the Sigfox-Ready Devices. Please follow the guidelines of Sigfox back-end;

  3. Configure the callback or data forwarding from the Sigfox Back-end to the Application Software. Please follow the guidelines of Sigfox back-end;

  4. Once the payload is on the Application server, decode data from Payload. Please check Section 1.9 for the Payload document.

1.2 Application Notes

For Applications

Electric Meter Reading, Gas Meter Reading, Water Meter Reading, Production Monitoring, Facility Monitoring, Flood Monitoring, Level Monitoring, Machine Health Monitoring, Safety Monitoring

Notes

  • Accept the dry-contact output or voltage output with a max of 3.3V; 

  • Consider the shortest signal cable to avoid noise, especially for high-speed pulse applications; 

  • Recommend using the shielded cable with twisted pairs; 

  • Take note of the signal's duty cycle to meet this device's requirement.

1.3 When does device send Uplink messages?

The device will send uplink messages in the following cases:


  • Case 1: After power-up in the 60s, the device will send the first message called START_UP. The payload will tell the user the HW version, FW version, and current configuration of the device;


  • Case 2: Then, in every interval time (pre-configured), for example, 10 minutes, it will send the message called CYCLIC_DATA. The payload will tell the user the following data like measured values, battery level, and alarm status...

To change the cycle of data sending, you can change the value of the parameter: CYCLIC_DATA_PERIOD (default is 600 seconds).

  • Case 3: In PULSE COUNTING mode, if COUNT_ALARM_ENABLED=1, the device will send ALARM message immediately when the resettable counter of channel 1 higher than the threshold value (parameter COUNT_THRESHOLD). After sending, the resettable counter of channel 1 will be reset to Zero for counting again for the next alarm. In STATUS DETECTION mode, when digital input device change status from 0 to 1 or from 1 to 0, the device will send the ALARM message immediately.


  • Case 4: During the commissioning, testing, or calibration sensor, the user can force the device to send the uplink message to get the data immediately. This message is called FORCE_DATA. The payload will provide data like raw measured value, scaled measured values, battery level, and alarm status... It can be forced by applying the magnet key on the reed switch in 1s;


  • Case 5: If users want to change the configuration immediately, they don't need to wait until the next cyclic data-sending message; instead, they can force the device to send a special uplink message so that the device can get the new downlink message. This uplink message is named PARAMETERS_UPDATE. It can be forced by applying the magnet key in more than 5s.


  • Case 6: The HEART_BEAT uplink message will be sent once a day (the default setting can be changed in configuration) to allow the Sigfox back-end system can send the downlink message for changing the configuration of the sensor. Please refer to the downlink section for more details. The uplink payload will tell the user the HW version, FW version, and current configuration of the device;

1.4 Default Configuration

This sensor type has default configuration parameters. However customer can change these parameters.


1.5 Battery/ Power Supply

The Device uses below batteries:

  • Battery type: Primary battery

  • Battery size and Voltage: AA 1.5VDC

  • Number of batteries: 02

  • Recommended batteries: Energizer® L91 or equivalent from Duracell®;


Please take note on the Polarity of the batteries as below picture.



Understanding the Battery Levels:

  • Level 3 (4 bars): battery energy is 60-99%

  • Level 2 (3 bars): battery energy is 30-60%

  • Level 1 (2 bars): battery energy is 10-30%

  • Level 0 (1 bar): battery energy is 0-10%


Note: to display accurately the remaining energy of battery, please configure the correct BATTERY_TYPE by downlink type 5 or offline cable. Please check the section Principle of Operation for more details.


1.6 What's in the Package?



1.7 Guide for Quick Test

With the default configuration, the device can be connected quickly to the Sigfox Network by the following steps.


Step 1: Prepare the values of communication settings
  • Device ID: Get Devive ID on the device nameplate 

  • Device PAC: Get Devive PAC on the device nameplate 


Note: All Sigfox sensors are pre-configured with the correct RC before delivery. The settings of Device ID, Device PAC, and RC could also be read from the device memory map. Please reference Section 3.2 Sensor configuration for details.


Step 2: Add the device to the Sigfox Backend

Please refer to the below Section 1.10 for details.


Step 3: Install the batteries to the device

Please refer to Section 1.5 above for instructions on battery installation.

After installing the battery in 60 seconds, the first data packet will be sent to the Sigfox network. After receiving the first data packet, the time of another packet depends on the value of the parameter: CYCLIC_DATA_PERIOD. Additionally, you can use a magnet key to touch the magnetic switch point on the housing within 1 second to initiate force packet of the device to send data instantly and the LEDs on the housing will be lit with SKY BLUE color.


Note:

If the device is required to connect to the external power, the correct external power supply must be connected to the device power connector. Refer section 1.8 INSTALLATION for details of the power wiring


If the device is required to connect to external sensor, the connection must be implemented before power up. Refer section 1.8 INSTALLATION for details of the wiring


If device is required the calibration for correct measurement, the calibration must be implemented. Refer detail at section 3.3 Calibration/ Validation.


Step 4: Decode the payload of the receiving package

Please refer to Section 1.9 Payload Document and Configuration Tables for details of decoding the receiving packet to get the measured values.

1.8 Installation

Dimension Drawings and Installation Gallery (Photos and Videos)

Please follow the checklist below for a successful installation:

1. Have you studied the dimensions of the device as above drawings?
 

2. Have you tested and make sure the device have been connected successfully as Section "1.7 Guide for Quick Test" above?
 

3. Have the device been configured properly as per Section 3.2 below?
 

4. Have the device been calibrated or validated as per Section 3.3 below?
 

5. Then you can start to install the device at site. Please check the following Installation Notes for Sensor Part (if available) before installation.

Installation Notes for Sensor Part (if available)
Notes:
  • Recommend using the shielded cable with twisted pairs;

  • The cable length should be as short as possible, typical max 2m. Longer cable can be used, but need actual testing;

  • Avoid the installation near by the high magnetic field like high power Motors, Transformers, and Power Generator.


Here are the wiring diagrams, applied for all versions.


Wiring for Dry-contact output

Wiring for Voltage input (max 3.3V)

Installation Guide for Main Device

Check the Location for the best RF Signal

Make sure the site is good enough for RF signal transmission.


Tip: To maximize the transmission distance, the ideal condition is Line-of-sight (LOS) between the device (wireless part) and the Base station. In real life, there may be no LOS condition. However, the device still communicates with the Base station, but the distance will be reduced significantly.


DO NOT install the wireless sensor or its antenna inside a completed metallic box or housing because the RF signal can not pass through the metallic wall. The housing is made from Non-metallic materials like plastic, glass, wood, leather, concrete, and cement… is acceptable.


Mounting the Device on the Wall or Pole

Mount the sensor onto a wall by the mounting bracket as below pictures



1.9 Payload Document and Configuration Tables

Please click below button for:
 

  • Payload decoding of Uplink messages;

  • Payload encoding of Downlink messages;

  • Configuration Tables of device.

​​

Note:

If the content of below web payload, memory map, and sample decoder could not be copied, please install the extension of "Enable Copy Paste - E.C.P" for Microsoft Edge and for Google Chrome.

1.10 How to connect device to Back-end/ Network Server/ Coordinator

This instruction is applied to all kinds of Sigfox-Ready sensor produced by Daviteq.


Step 1: Log in to the sigfox backend website


Step 2: Click on Device


Step 3: Click New → Select a group


Step 4: Fill in the required information


Note: Some of our products may not have end product certification in time, to add the product to Backend Sigfox please follow the steps below.


Click on the text as shown below


Check the box as shown below to register as a prototype


2
MAINTENANCE

2.1 Troubleshooting

Please find below the steps to identify the problems from the Communication Part or Sensor Part:

  • If the device cannot connect to the Gateway, or System, or Coordinator the first time, it is the Communication Problem;


  • If the device status like battery, RSSI level, data status, or other communication is normal, but the measured values are not updated or wrong, it would be the problems of the Sensor part;


  • If the data coming to the gateway, system, or coordinator is not frequent as expected, the problem would be Communication.


Please refer to the troubleshooting guide for the Communication and Sensor Part below.

Troubleshooting for Communication



Troubleshooting for Sensor Part (if available)

  1. The Digital input status is incorrect: check the wiring diagram, check the cable type and cable length, check the signal;

  2. The pulse counting value is missing (smaller values): the pulse has higher frequency or duty cycle of pulse is too short, OR wiring problem. Please check the specification and check wiring;

  3. The pulse counting value is higher than pulse generation device: there is noise. Please check the cable type, cable length, wiring...

2.2 Maintenance

Maintenance for Main device

There is no requirement for maintenance of the Hardware of this Sigfox-Ready device except:


1. The battery needs to be replaced. Please check the battery status via uplink messages;


Note: When the battery indicator shows only one bar (or 10% remaining capacity), please arrange to replace the battery with a new one as soon as possible. If not, the battery will drain completely, and the resulting chemical leakage can cause severe problems with the electronic circuit board.


2. Sensor, please refer to the maintenance section of the sensor document.

Maintenance for Sensor part (if available)

There is no maintenance requirement for this kind of device.

3
ADVANCED GUIDE

3.1 Principle of Operation

Principle of Operation for Device WSSFC-DI | FW1


The Daviteq Sigfox-Ready DI has 02 digital inputs with low voltage 3.3V. The Firmware can run in 2 modes:


  • Logic detection: to detect the status of digital input. It applies to both channels;

  • Pulse counting: to count the pulse of channel 1 only;


What are the primary output values?

  • Logic status of channel 1: parameter in the payload is STATUS_DI1

  • Logic status of channel 2: parameter in the payload is STATUS_DI2

  • Non-resettable counter for channel 1: Non-resettable counter values for the Digital Input 1. The counter only operate in Counting mode. This counter is not be reset if power/battery is off. Parameter in the payload is NRS_COUNTER_DI1

  • Resettable counter for channel 1: Resettable counter values for the Digital Input 1. The counter only operate in Counting mode.

  • Sensor operation mode: operate in counter mode or status detection mode. If OPERATION MODE equal 6, the sensor operate in Counting mode to count the output pulses with max frequency 2 Hz for digital input 1 only. If OPERATION MODE equal 7, the sensor operate in Status mode to detect the logic status 0/1 with max frequency 0.33 Hz.The parameter in the payload is OPERATION_MODE.


  • Alarm Status: Alarm when RS_COUNTER_DI1 > COUNT_THRESHOLD in counter mode OR when input channel 1/2 change the status from 0 to 1 and vice versa in status mode. This parameter in the payload is ALARM

Please check the payload document for more details.

What are the secondary output values?

Below output values are useful for device maintenance and troubleshooting.


  • Battery level (%), to understand the remaining capacity of the battery: parameter in the payload is BATTERY_LEVEL. Note: To get the accurate battery_level indication, please configure the battery type by Downlink type 5 or via offline cable to the parameter name BATTERY_TYPE. The default type is Primary battery. For Solar powered version, please configure to Rechargeable battery type.

  • Sensor error code, to understand whether the sensor is working properly or not: parameter in the payload is HW_ERROR

  • Sensor current configuration, to understand what is the current setting of the sensor: parameter in the payload is LATEST_SIGFOX_DOWNLINK

  • Hardware version and Firmware version, to understand the product version: parameter in the payload is HW_VERSION and FW_VERSION


Principle of operation

Most of the time, the device will be in sleep mode. However there is a micro process to monitor the status of digital input to detect the logic changing or pulse counting.


There are 02 operation modes:

  • Logic Detection: parameter OPERATION _MODE = 7

  • Pulse Counting: parameter OPERATION _MODE = 6


In LOGIC DETECTION mode:


  • The device will send ALARM message when the status changes from 0 to 1 or from 1 to 0.

  • If status does not change, the device will check the timer to reach the Cyclic_Data_Period to send the CYCLIC_DATA message;


In PULSE COUNTING mode:


If parameter COUNT_ALARM_ENABLE = 1

That meant the device will send ALARM message when the resettable counter higher than the threshold value (parameter COUNT_THRESHOLD). After sending, the resettable counter will be reset to Zero for counting again for the next alarm.


If the resettable counter <= COUNT_THRESHOLD, it will check the timer to reach the Cyclic_Data_Period to send the CYCLIC_DATA message;


If parameter COUNT_ALARM_ENABLE = 0

The device will check the timer to reach the Cyclic_Data_Period to send the CYCLIC_DATA uplink message;


In special case, the user want to change the innitial couting value of the counter, they can use the Downlink Type 5 command to write data for below parameters:
  • INIT_VAL_FOR_NRS_COUNTER_DI1: innitial value of Non-resettable counter

  • INIT_VAL_ENABLE: write 1 to enable the writing process of that innitial counter value.


Principle of Operation of Sensor part (if available)

With version DI-12, the microprocessor of the master device (wireless device or wired device) will read the status of digital input ports in a predefined time interval for battery saving. Therefore it can only count the Pulse with a max 2Hz frequency, and apply for the 1st channel only.


With version DI-12H, the digital input port will connect to an internal timer/counter of the microprocessor for high-speed counting. Therefore it can count the pulse up to 1 kHz, for both 2 channels.

Default Configuration Parameters of Sensor part (if available) 

This sensor type has default configuration parameters. However customer can change these parameters.


3.2 Configuration

How to configure the device?

Sensor configuration can be configured in 02 methods:

Method 1: Configuring via Downlink messages.

Method 2: Configuring via Offline cable.


Note: The sensor is only active for offline configuration in the first 60 since power up by battery or plugging the configuration cable.


Which Parameters are configured?

Please check Part G in Section 1.9 Payload Documents above.

Method 1: Configuration via Downlink messages

Please check the Part D & E in Section 1.9 Payload Documents above.

Method 2: Configuration by Offline Cable

Please download the Configuration Template File of this sensor to be used in Step 4 below.

Instructions for offline configuration of the Daviteq LoRaWAN sensors. Please follow the following steps.


Note: The sensor is only active for offline configuration in the first 60 since power up by battery or plugging the configuration cable.


1. Prepare equipment and tools

The following items must be prepared for configuration.

  • A PC using the Windows OS (Windows 7 or above versions). The PC installed the COM port driver of the Modbus configuration cable (if needed). The driver is at link: Modbus Configuration Cable COM port driver for PC and the instruction to install  the driver at link: How to install the driver.

  • A Modbus configuration cable 

  • Tools to open the plastic housing of LoRaWAN sensors (L hex key or screwdriver)


2. Download and launch Daviteq Modbus configuration software 
  • Click the link below to download Daviteq Modbus configuration software:

https://filerun.daviteq.com/wl/?id=yDOjE5d6kqFlGNVVlMdFg19Aad6aw0Hs

After downloading the software, unzip the file named: Daviteq Modbus Configuration.zip and then copy the extracted folder to the storage drive for long-term use. 

  • Open the folder, double click on the file Daviteq Modbus Configuration Tool Version.exe to launch the software and the software interface as below:


Note: The software only runs on Microsoft Windows OS (Windows 7 and above).


3. Connect the cable and configure the sensor

Step 1: 

Connect the PC to the sensor using the configuration cable.

- Use the configuration cable (Item code: TTL-LRW-USB-01).


- Connect the USB-A plug into the USB-A socket of the PC.


Step 2: 

On the configuration software, choose the relevant Port (the USB port which is the cable plugged in) and set the BaudRate: 9600, Parity: none


Step 3:

Click Connect button to connect the software to the sensor. After successful connection, the Connected status will show on the software.


Step 4: 

Import the configuration template file of the sensor (as above link) to the software: click menu File/ Import New and then browse the relevant sensor template file (csv file) and click Open to import the template file.


Note: The sensor is only active for configuration for 60 seconds since plugging the configuration cable or the power supply into the sensor.

Each sensor type has its own template file. Refer to the sensor's manual to download the correct file.


Step 5:

Open the housing of the sensor and quickly plug the connector of the configuration cable into sensor's modbus configuration port as below figure. After plugging the connector, the software will read the parameter values automatically.

Plug the cable connector into sensor's modbus configuration port. This port is located at a different location, depends on the sensor type.


Note: If the sensor has SKU of WSSFCEX-PPS and hardware version 1 &2, the sensor must be powered by batteries for configuration


Step 6: 

Read the current value of the parameter with Modbus Function 3

  • At the relevant row of the parameter, check box 3 on column Func to read the value of the parameter. The read value is shown in VALUE ON MEMMAP column.


The sensor is only active for configuration for 60 seconds since plugging the configuration cable or the power supply into the sensor. After 60 seconds, the TIME_OUT text will show on EXCEPTION column of the software.


Step 7: 

Write the new setting to the parameter with Modbus Function 16

  • Double click on the column VALUE TO WRITE of the parameter and input the new setting value of the parameter;

  • Uncheck the tick on the FC column of the parameter, click on the arrow, select 16 and then check on the FC column to write a new setting to the parameter. The WRITE_OK text will show on EXCEPTION column if the software successfully writes the setting.


Repeat Step 6 to read the setting of the parameter for double-checking.


Note: For some critical parameters of the sensor, the password in "password for setting" must be written before writing the new settings to these parameters.

Only read/ write registers are allowed to write.

The sensor is only active for configuration for 60 seconds since plugging the configuration cable or the power supply into the sensor. After 60 seconds, the TIME_OUT text will show on EXCEPTION column of the software.


4. Troubleshooting

3.3 Calibration/ Validation

How to force sensor to send data for calibration/ validation (if available)

By using the magnet key, the Sigfox node can be triggered to send data to base station immediately. There will be a beep sound from the buzzer meaning the data has been sent (Buzzer will be updated in the latest version).



Note:

Once sending the data to base station by the magnet key, the timer of sending time interval will be reset;

The shortest time interval between the two manual triggers is 15s. if shorter than 15s, there will be no data sending.


Calibration/ Validation sensor (if available)

This kind of sensor does not require calibration. However, the user can validate the status of digital input or validate the counting value by using a standard Pulse Generator.


How to validate the Pulse counting value? Please find the below instructions.

4
PRODUCT SPECIFICATIONS

4.1 Specifications

Digital Inputs2-channel dry contact or low voltage (≤3.3V)
OperationDetecting status or Pulse counting (max 1kHz)
VERSIONDI-12 (Low-speed digital input)
Input2-Digital channel inputs with dry-contact or voltage input (max 3.3VDC)
FunctionsLogic Detecting or Pulse Counting
Logic Detecting: 2 channels, recommended minimum interval time between 02 statuses is 5 seconds.
Pulse Counting: 1 channel only, max frequency 2Hz, minimum Pulse width (low or high) is 200mS, counter is uint32 type.
VERSIONDI-12H (High-speed digital input)
Input2-Digital channel inputs with dry-contact or voltage input (max 3.3VDC)
FunctionsLogic Detecting or Pulse Counting
Logic Detecting: 2 channels, recommended minimum interval time between 02 statuses is 5 seconds.
Pulse Counting: 2 channels, max frequency 1kHz, minimum Pulse width (low or high) is 200μS, counter is uint32 type.
COMMUNICATION
Sigfox zonesselect RC1-RC7
Sigfox Class1u
FunctionsSending data in interval or when alarms occur
AntennaInternal Antenna 2 dbi
Configurationvia Downlink of offline USB cable (PC software is supplied at free)
Electrical connectionShielded cable 2m length with PG9 cable gland
Power SupplyPrimary batteries 02 x AA size 1.5VDC (battery not included)
RF Module complies toETSI EN 300 220, EN 303 204 (Europe) FCC CFR47 Part15 (US), ARIB STD-T108 (Japan)
Working temperature-40∼60℃ (with AA L91 Energizer®)
DimensionsH106xW73xD42
Net-weight190g
HousingAluminum + Polycarbonate plastic, IP68

5
WARRANTY & SUPPORT

5.1 Warranty

Warranty

Below terms and conditions are applied for products manufactured and supplied by Daviteq Technologies Inc.


Free Warranty Conditions
  1. The manufacturer undertakes to guarantee within 12 months from shipment date.

  2. Product failed due to defects in material or workmanship.

  3. Serial number, label, warranty stamp remains intact (not purged, detected, edited, scraped, tore, blurry, spotty, or pasted on top by certain items).

  4. During the warranty period, if any problem of damage occurs due to technical manufacturing, please notify our Support Center for free warranty consultancy. Unauthorized treatments and modifications are not allowed.

  5. Product failed due to the defects from the manufacturer, depending on the actual situation, Daviteq will consider replacement or repairs.


Note: One way shipping cost to the Return center shall be paid by Customers.


Paid Warranty
  1. The warranty period has expired.

  2. The product is not manufactured by Daviteq.

  3. Product failed due to damage caused by disasters such as fire, flood, lightning or explosion, etc.

  4. Product damaged during shipment.

  5. Product damaged due to faulty installation, usage, or power supply.

  6. Product damage caused by the customer.

  7. Product rusted, stained by effects of the environment or due to vandalism, liquid (acids, chemicals, etc.)

  8. Product damage is caused by unauthorized treatments and modifications.


Note: Customers will be subjected to all repairing expenses and 2-way shipping costs. If arises disagreement with the company's determining faults, both parties will have a third party inspection appraise such damage and its decision be and is the final decision.


5.2 Support

Support via Help center

If you need our support for Daviteq device's installation, configuration, test, and decode, please email us at: support@daviteq.com OR input support request at link: https://forms.office.com/r/XWHbYG7yy7

Our support engineer will contact you via email or the support ticket system.

 

If you have any questions about the product, you can search for information on our web (https://www.iot.daviteq.com/). If you can't find the right information, please register an account and send us a request at link Contact us | Daviteq Technologies . We will respond within 24 hours.

bottom of page