GA0001329_04
Wireless Data Acquisition System for WD Pro Receiver Application Note

Wireless Data Acquisition System
for WD Pro Receiver
Application Note

 Notice to Customer
Thank for your purchasing our PATLITE products.
 Prior to use, read this manual and [WDT-□LR-Z2, WDR-L(E)-Z2-PRO (-L) Installation Manual]thoroughly.
 If you have any questions about the contents of this manual, please contact our sales office.

1

Wireless Data Acquisition System for WD Pro Receiver Application Note
1. Before you begin ................................................................ 3

5.1.4. WD PRO Receiver Control Sequence ............................ 26

The Purpose of This Manual ................................................... 3

5.1.5. WDT Control Sequence .................................................. 27

Precautions............................................................................. 3

5.1.6. WDT-PRO Control Sequence ......................................... 29

Term ....................................................................................... 4

Communication Protocol ....................................................... 32

2. Before Design..................................................................... 5

5.2.1. Communication Data Format .......................................... 32

Applicable Products ................................................................ 5

5.2.2. List of Communication Packet Commands ..................... 34

Selecting the Information Collection Method ........................... 5

Communication Packet Commands ...................................... 35

Precautions on adding or replacing in existing WD system ..... 6

5.3.1. Notification of Change in Transmitter Status ................... 36

Precautions on operating with WD PRO receiver and multiple

5.3.2. Notification of Counter Value .......................................... 39

hosts.............................................................................................. 6

5.3.3. Notification of Change in Signal Tower Display ............... 40

3. Using DB communication ................................................... 7

5.3.4. Request/Response to Get Transmitter Status ................. 42

Preparing the database........................................................... 7

5.3.5. Request/Response to Get Transmitter List ..................... 45

3.1.1. Database.......................................................................... 7

5.3.6. Request/Response to Get Transmitter Information ......... 47

3.1.2. Table Settings ................................................................... 8

5.3.7. Request/Response to Display Calling Transmitter Status54

Information About Each Field .................................................. 9

5.3.8. Request/Response to Output Serial Data ....................... 55

3.2.1. wdt_signal_info table ........................................................ 9

5.3.9. Request/Response to Control Signal Tower Display ....... 57

3.2.2. counter_info table ........................................................... 125.3.10. Request/Response to Release Signal Tower Display .... 59

Design Considerations .......................................................... 125.3.11. Request/Response to Register Counter Value .............. 60

4. Using Modbus/TCP communication ................................. 13

5.3.12. Request/Response to Get Receiver Information ........... 61

Steps to Start Using .............................................................. 13

5.3.13. Request/Response to Reset Receiver .......................... 63

4.1.1. Procedure....................................................................... 13

5.3.14. Request/Response to Get Counter Value ..................... 64

4.1.2. About the Unit Identifier and User Name......................... 14

5.3.15. Request/Response to Get Signal Tower Display ........... 66

Modbus/TCP communication protocol................................... 15

5.3.16. Command Error response ............................................ 68

4.2.1. Communication Data Format .......................................... 15

Design Considerations .......................................................... 68

4.2.2. WDT Data Allocation ...................................................... 18

6. Using Cloud Communication (MindSphere) ..................... 69

4.2.3. Example communication ................................................ 20

Use APIs & Services ............................................................. 69

Design Considerations .......................................................... 21

Asset..................................................................................... 69

5. Using Socket Communication (WDR-PRO Protocol) ....... 22

6.2.1. Asset name .................................................................... 69

Operation Sequence ............................................................. 22

6.2.2. Asset type name ............................................................. 69

5.1.1. Sequence ....................................................................... 22

6.2.3. Asset type Configurations ............................................... 69

5.1.2. Startup sequence ........................................................... 23

6.2.4. Aspects Detail................................................................. 70

5.1.3. WDT Notification Sequence............................................ 25

About Trademarks and Registered Trademarks

 MySQL is a trademark or registered trademark of Oracle Corporation and its subsidiaries and affiliates in
the United States and other countries.
 Modbus is a registered trademark of Modicon Inc (Schneider Automation International).
 Company names and product names described in this document are trademarks or registeredtrademarks of those respective companies.
 Siemens and MindSphere are trademarks or registered trademarks of Siemens AG.

2

Wireless Data Acquisition System for WD Pro Receiver Application Note

1. Before you begin
The Purpose of This ManualThis manual describes how you can collect information in a WD system with the WD PRO receiver.
This manual covers the following: Operating a new WD PRO receiver with socket communication (WDR-PRO format protocol)
 Operating WD PRO receiver with database communication
 Operating WD PRO receiver with Modbus/TCP communication
 Operating WD PRO receiver with Cloud communication
When collecting information using the following methods, refer to the specified manual.
 Adding a WD PRO receiver with socket communication (WDR format protocol)
Refer to ☞ [Wireless Data Acquisition System Application Note]
Refer to ☞ [Application Note for WD PRO Series] Using the WDS-WIN01 CSV file
Refer to ☞ [Application Note for WD PRO Series]
Refer to ☞ [Wireless Data Acquisition System Hardware System Setting Software WDS-WIN01
Instruction Manual]*This manual does not include steps on how to store (such as in a database) nor how to visualize (suchas in a Gantt chart or graph) collected Signal Tower information.

Precautions
CAUTION
This document describes only the information that is required to design an informationcollection method for a WD PRO receiver. Please note that this document is not intended todescribe information about WD PRO receivers.
Any unauthorized copying of part or all of this manual is prohibited.
The contents of this manual are subject to change without notice.
There is no assumption of responsibility for inaccuracies in this manual.
The software described in this manual and related information are provided as examples.
You may use this information for software design subject to assuming all responsibility.
There is no assumption of responsibility for damages incurred by you or a third party as aresult of using this information.
Sample code is not provided.

3

Wireless Data Acquisition System for WD Pro Receiver Application Note

Term
Descriptions of terms used in this manual are listed below.
Term

Description

WDT

Transmitter for a WD system. Refers to the WDT-6M-Z2, WDT-5E-Z2,
WDT-6LR-Z2, WDT-5LR-Z2, WDT-4LR-Z2, and WDT-6LR-Z2-PRO (including
WDB-D80S-PRO).

WDR

Receiver for a WD system. Refers to the WDR-L-Z2, WDR-LE-Z2,
WDR-L-Z2-PRO, WDR-LE-Z2-PRO, WDR-L-Z2-PRO-L, and
WDR-LE-Z2-PRO-L.

WD PRO ReceiverAmong the WDR, refers to WDR-L-Z2-PRO, WDR-LE-Z2-PRO,
WDR-L-Z2-PRO-L, and WDR-LE-Z2-PRO-L only.

WD Series

Series that refers to all WDR and WDT.

Host

In this manual the term is in reference to a device that communicates with
WDR over either LAN or USB, gets information from WDR and WDT, andcontrols WDR and WDT. In most cases the device is a personal computer.

WD System

Refers to the system as a whole. Consists of WDT, WDR, and host.

Existing WD System

On the WDR-L-Z2 and WDR-LE-Z2, refers to a WD system that is alreadyrunning.

4

Wireless Data Acquisition System for WD Pro Receiver Application Note

2. Before Design
Applicable Products
WDR-L-Z2-PRO, WDR-LE-Z2-PRO, WDR-L-Z2-PRO-L, WDR-LE-Z2-PRO-L

Selecting the Information Collection Method
For each of the described purposes, use to the references provided for the information collection method.

1. In an existing WD system, add the ability
to collect information

2. Use WDS-WIN01 CSV file to collectinformation

3. Use a database to collect information*1[Wireless Data Acquisition System Application Note][Application Note for WD PRO Series][Wireless Data Acquisition System Hardware System
Setting Software WDS-WIN01 Instruction Manual][Wireless Data Acquisition System Application Note]

Refer to ☞ "3. Using DB communication".

4. Use Modbus/TCP protocol to collectinformation*1

5. Use WD PRO receiver and socket
communication to collect information*1

6. Use Cloud Communication to collectinformation*1

Refer to ☞ "4. Using Modbus/TCP communication".

Refer to ☞ "5. Using Socket Communication (WDR-PRO
Protocol)".

Refer to ☞ "6. Using Cloud Communication (MindSphere)".

*1 On WDR-L-Z2-PRO-L and WDR-LE-Z2-PRO-L, you cannot collect information with database,Modbus/TCP, or socket communication (WDR-PRO format protocol),Cloud Cmmunication.

5

Wireless Data Acquisition System for WD Pro Receiver Application Note

Precautions on adding or replacing in existing WD system
You can use the WD PRO receiver as a receiver that is equivalent to WDR-L-Z2 or WDR-LE-Z2.
Make sure it is used under the following conditions.
 Specify and communication via the [WDR Port]. (Default value: 10001)*Communication is not possible using the Setting Port, WDR-PRO Port 1, or WD-PRO Port 2.
 The WD PRO receiver firmware version does not display properly with WDS-WIN01 Ver1.04 or earlier,nor with WDS-WIN01 or earlier (such as WDS-AUTO2).
For example, WD PRO receiver Ver1.00 displays Ver129.00 (status where the major version mostsignificant bit is ON).

Precautions on operating with WD PRO receiver and multiple hosts
In addition to connecting to multiple hosts, WD PRO receivers can collect information and implement
settings.
However, be aware there is a limit to the number of units you can connect.
Number of hosts you can connect

Host connection method

Socket communication connection(maximum)*1

WDR Port

1 unit

WDR-PRO port

2 units

Setting port*2

1 unitDatabase connection

1 unitModbus/TCP connection

1 unit*1 With the above combination, you can connect a maximum 6 hosts.
*2 You can use only with WDT/WDR settings in WDS-WIN01.

6

Wireless Data Acquisition System for WD Pro Receiver Application Note

3. Using DB communication
Describes requirements for the WD PRO receiver to write Signal Tower information to the database.

Preparing the database
Describes the database required for the WD PRO receiver to write information as well as the required
preparations.

3.1.1. Database
Item

Preparation items

Database System

MySQL (version 5.6) recommended

Database Address

Database system host name or IP address

Port Number

Port number used by the database system

Database

Create the following database.
Database Name

Name of database set up in the WD PRO receiverUser Name

User name for writing (INSERT/UPDATE) to the database set
up in the WD PRO receiver
Password set up in the WD PRO receiver

Password

Table Name

* If "Authentication Type" can be selected, be sure to specify"Standard"

Create table with the following name.
For information on tables, refer to "Table Settings".
wdt_signal_info
counter_info

Signal Tower information is written to this table.
A simple counter's count information is written here.

7Wireless Data Acquisition System for WD Pro Receiver Application Note

3.1.2. Table Settings(1) wdt_signal_info table
Describes the required fields and data types for the wdt_signal_info table.
Field Name

Data Type

Information Written

insert_timestamp

TIMESTAMP

Date/Time

ieee_address

UNSIGNED BIGINT

WDT IEEE address information

red_information

UNSIGNED SMALLINT

Signal Tower Information (red)amber_information

UNSIGNED SMALLINT

Signal Tower Information (amber)green_information

UNSIGNED SMALLINT

Signal Tower Information (green)

blue_information

UNSIGNED SMALLINT

Signal Tower Information (blue)

white_information

UNSIGNED SMALLINT

Signal Tower Information (white)buzzer_information

UNSIGNED SMALLINT

Buzzer information

wdt_monitoring_information

UNSIGNED TINYINT

WDT monitoring information

external_input_information

UNSIGNED TINYINT

External Input information

serial_number

UNSIGNED TINYINT

Serial number (for serial data)

rs_232c_data

VARBINARY

Serial dataclear_input_information

UNSIGNED TINYINT

Clear Input information

time_counter

UNSIGNED SMALLINT

Time Counter(2) counter_info table
Describes the required fields and data types for the counter_info table.
Field Name

Data Type

Information Written

timestamp

TIMESTAMP

Date/Time

ieee_address

UNSIGNED BIGINT

WDT IEEE address information

count_val

UNSIGNED INTCounter value

8Wireless Data Acquisition System for WD Pro Receiver Application Note

Information About Each Field
Describes information about each field.

3.2.1. wdt_signal_info table(1) insert_timestamp field
Indicates the date and time the WDR received notification from WDT that there was a change in Signal
Tower information.
The value is based on the WD PRO receiver's internal clock. (timezone: UTC)(2) ieee_address field
Indicates the WDT IEEE address (8-byte hexadecimal value) where there was a change in Signal Tower
information.
Note that the field is set with a decimal value.
(Example)
When "1885667171979194497" (decimal value) is written to ieee_address,
the address is "1A2B3C4D5E6F7081" (hexadecimal value).
(3) red_information field
Indicates the status of Signal Tower Information (red). Values are as follows.
Value

Description

0Light off

1

Light on2

Flashing(4) amber_information field
Indicates the status of Signal Tower Information (amber). Values are as follows.
Value

Description

0Light off

1

Light on2

Flashing(5) green_information field
Indicates the status of Signal Tower Information (green). Values are as follows.
Value

Description

0Light off

1

Light on2

Flashing

9

Wireless Data Acquisition System for WD Pro Receiver Application Note(6) blue_information field
Indicates the status of Signal Tower Information (blue). Values are as follows.
Value

Description

0Light off

1

Light on2

Flashing(7) white_information field
Indicates the status of Signal Tower Information (white). Values are as follows.
Value

Description

0Light off

1

Light on2

Flashing(8) buzzer_information field
Indicates the status of buzzer information. Values are as follows.
Value

Description

0

Buzzer off

1

Buzzer on(9) wdt_monitoring_information field
Indicates the WDT connection status. Values are as follows.
Value

Description0

WDT disconnected

9

WDT connected10Wireless Data Acquisition System for WD Pro Receiver Application Note(10) external_input_information field
Indicates the status of the WDT external input line. Values are as follows.
Value

Description
The value indicates the status of input information 1 to 8.
External Input
Line

0 to 255

bit

External Input 8

7

External Input 7

6

External Input 6

5

External Input 5

4

External Input 4

3

External Input 3

2

External Input 2

1

External Input 1

0

References

StatusDescription

0b0

OFF

0b1

ON

(11) serial_number field
Number (0 to 255) that indicates the serial information is a retransmission.
If the number is the same, consider it retransmitted data.
(12) rs_232c_data field
Indicates serial information received from WDT-PRO.
Maximum length of 60 bytes.
(13) clear_input_information field
Indicates the WDT-PRO clear input information. Values are as follows.
Value

Description

0

Clear input has not executed

1

Clear input has been executed(14) time_counter field
Amount of time (in seconds) from a Signal Tower status change to a Signal Tower information transmission
Calculate the amount of time it took for the change to occur by subtracting the time_counter (seconds)
from the date and time in the date_time field.

11

Wireless Data Acquisition System for WD Pro Receiver Application Note

3.2.2. counter_info table(1) timestamp field
Indicates the date and time the database server received notification from WD PRO receiver.
The value is based on the internal clock of the database server.
(2) ieee_address field
Indicates the WDT IEEE address (8-byte hexadecimal value) where there was a change in the countervalue.
Same as the wdt_signal_info table, note that the field is set with a decimal value.
(3) count_val field
Indicates the simple counter function's counter value stored on WDT.
0 to 4,294,967,295

Design Considerations
 Data is written to the database whenever there is a change in status any of the WDT information.
 Depending on the number of WDT connected and the frequency of changes in Signal Tower information,
the database may become very large, resulting in poor responses when trying to get information from thedatabase.
 Periodically back up old data Create a different database for each receiver
Make adjustments so too many records are not collected.
(Example)
In an environment with 30 WDT, where the status of Signal Towers change 100 times per day, in 1 month(30 days) 90,000 records are generated.

12

Wireless Data Acquisition System for WD Pro Receiver Application Note

4. Using Modbus/TCP communication
The WD PRO receiver operates as a Modbus/TCP slave.
Using a Modbus/TCP master such as SCADA software, you can read the WDT status information into the
WD PRO receiver.

Steps to Start Using
4.1.1. Procedure
The steps to start using Modbus/TCP are as follows.
Step
1

Description
On the WD PRO receiver's Modbus/TCP communication screen, set up the port
On the WD PRO receiver's transmitter user name registration screen, register a user name

2

* The unit identifier, for specifying which transmitter data to read, is assigned with transmittersthat have been registered with a user name
For information, refer to ☞ "4.1.2 About the Unit Identifier and User Name"3

Set up the Modbus/TCP master(Start address of registers to read, number of registers to read, transmission interval, and so on)Start operation:① Establish a connection between the master and WD PRO receiver② Send a request from the Modbus/TCP master to the WD PRO receiver

4③ Receive a response from the WD PRO receiver④ During operation, steps ② and ③ are repeated⑤ At the end of the operation, release the connection*Only 1 master can connect at any one time with the WD PRO receiver. Multiple
masters cannot connect simultaneously

13Wireless Data Acquisition System for WD Pro Receiver Application Note

4.1.2. About the Unit Identifier and User Name
The unit identifier number is assigned, in order of registered user names, starting from 1.

For example, unit identifiers when registering user names in the following CSV file (abc.csv)
Unit Identifier

Contents of "abc.csv"
1 ⇒00255CFFFEBABDDC, Line 01 Transmitter

2 ⇒00255CFFFEBABDDD, Line 02 Transmitter

3 ⇒00255CFFFEBABDDE, Line 03 Transmitter

4 ⇒00255CFFFEBABDDF, Line 04 Transmitter

:

:

:

:

:

:

29 ⇒

00255CFFFEBABDFA, Line 29 Transmitter

30 ⇒00255CFFFEBABDDB, Line 30 Transmitter* For information on how to register user names, refer to ☞ 7.3.4.5 Register Tranmitter User Name, in the"[WDT-□LR-Z2、WDR-L(E)-Z2-PRO(-L) Instruction Manual]".

14

Wireless Data Acquisition System for WD Pro Receiver Application Note

Modbus/TCP communication protocol
4.2.1. Communication Data Format(1) Request command from master

Item

Transaction ID

Protocol ID

Number of
bytes

Data

DescriptionHigh

The value set here is applied to the WD PRO receiver's reply
commandLow

0x0000 to 0xFFFF

High

Static value

2

2
Low

Field Length

0x0000High

Static valueLow

0x0006

2

Requested WDT identification number
Unit ID*Unit identification (1 to 30) is assigned in order of user nameregistration

1

0x01 to 0x1E
Function CodeStatic value

1

Register's start
address2

Number ofRegisters

2

0x03
High

Specify the value of the start address of registers to readminus 1Low

0x0000 to 0x002C

High

Specify the number of registers to read

Low

0x0000 to 0x002D*Items with multiple bytes are stored in Big Endian format, unless otherwise specified.

15

Wireless Data Acquisition System for WD Pro Receiver Application Note(2) Response command from the WD PRO receiver

Item

Transaction ID

Protocol ID

Field Length

Number of
bytes

Data

Description

High

Sets the value in the request commandLow

0x0000 to 0xFFFF

High

Static valueLow

0x0000High

Sets number of bytes after the unit identification

Low

0x0000 to 0x005A

2

2

2

Unit ID

1

Function Code1

Identification number of responded WDT
0x01 to 0x1E
Static value
0x03 (Read Holding Registers)
Sets the number of bytes read.

Number of bytes
read1(Number of registers x 2 bytes)
0x00 to 0x5A
MSB

Read data

Variable

Sets the data requested by the master.
(Number of registers x Number of bytes of data read)

LSB*Items with multiple bytes are stored in Big Endian format, unless otherwise specified.

16

Wireless Data Acquisition System for WD Pro Receiver Application Note(3) Error command from the WD PRO receiver
Returned when there is an issue with a request command from the master.

Item

Transaction ID

Protocol ID

Field Length

Number of
bytes

Data

Description

High

Sets the value in the request commandLow

0x0000 to 0xFFFF

High

Static valueLow

0x0000High

Static valueLow

0x00032

2

2

Unit ID

1

Sets the received unit identifier.

Function Code1

Adds 0x80 with the received function code and sets theresulting value.
Code indicating error type
Exception Code
0x01

0x02
Exception Code1

Description
Illegal Function
Function code other than 0x03
Illegal Address
Register Address out of range
Illegal Data Value

0x03

Invalid register start address orinvalid number of registers
Server Device Failure

0x04

17

Transmitter user name is notregistered

Wireless Data Acquisition System for WD Pro Receiver Application Note

4.2.2. WDT Data Allocation
The following WDT information is allocated to register addresses.
Registers are 2 bytes long. Note that there is a distinction between the top part and bottom part of registerstorage locations.
Register
Address

Item

Data
High

Description

MSB

1
Low
High
2
Low
IEEE Address

WDT IEEE address (unique 8-byte value)
High

3
Low
High
4
Low
5

6

7

8

9

Signal Tower Information(red)
Signal Tower Information(amber)LSB

High

Signal Tower status information

Low

Value

DescriptionHigh

0x0000Light off

Low

0x0001

Light on0x0002

Flashing

Signal Tower Information(green)High

Signal Tower Information(blue)

High

Signal Tower Information(white)

High

Low

Low

Low
Buzzer status information
High

10

Buzzer information
Low

18

Value

Description

0x0000Buzzer off

0x0001

Buzzer on

Wireless Data Acquisition System for WD Pro Receiver Application Note
WDT monitoring information
High

11

WDT monitoring
information

MSB

0x0000

WDT disconnected

0x0009WDT connected

Counter value information

12
Counter value

Description*When the WDT is not connected, the Signal Tower
information, Buzzer information, Counter value,
external input information, and RS232C data are allread in as “0”.

Low

High

Value

0x00000000 to 0xFFFFFFFF

Low
High

13

Low

LSB
External input status information
Item

bit
15

Dummy Data

High

to
8

14

External Input information

Low

External Input 8

7

External Input 7

6

External Input 6

5

External Input 5

4

External Input 4

3

External Input 3

2

External Input 2

1

External Input 1

0

Description
Static value
0x00

Value

Description

0b0

OFF

0b1

ON

*For anything other than WDT-PRO, read in "0".
Serial number for Serial information

High

0x0000 to 0x00FF
15

Each time RS232C data is received from WDT,
1 is added to the number.

Low

After 00FF, resets to 0000.
RS232C Data

High

MSB

RS232C data information

16

Maximum 60 bytes

Low
To*For anything other than WDT-PRO, read in "0".
High

45

Low

LSB

*Items with multiple bytes are stored in Big Endian format, unless otherwise specified.

19

Wireless Data Acquisition System for WD Pro Receiver Application Note

4.2.3. Example communication
The following are actual examples of communication. (The communication example is a hexadecimal byte
string)Get the WDT Signal Tower information registered with the 20th user name: red: light on status, yellow:
flashing status, green: light off status, blue: light off status, white: light off status, buzzer information:
buzzer on status[Send Host]Item

Set value(hexadecimal)
0x00

Transaction ID

0x00
0x00

Protocol ID

0x00
0x00

Field Length

0x06

Unit ID

0x14

Function Code

0x03
0x00

Register's start address

0x04
0x00

Number of Registers

0x06

20

Wireless Data Acquisition System for WD Pro Receiver Application Note

[Receive Host]Item

Set value(hexadecimal)
0x00

Transaction ID

0x00
0x00

Protocol ID

0x00
0x00

Field Length

0x0F

Unit ID

0x14

Function Code

0x03

Number of bytes read0x0C

Signal Tower Light
Information (red)0x00

Signal Tower Light
Information (amber)

0x00

Signal Tower Light
Information (green)

0x00

Signal Tower Light
Information (blue)

0x00

Signal Tower Light
Information (white)

0x00

0x01

0x02

0x00

Read data

0x00

0x00
0x00

Buzzer information

0x01

Design Considerations
 Cannot connect simultaneously to multiple masters.
 Cannot use as a master. Fixed as a slave.
 Can only read registers. You cannot write to them.

21Wireless Data Acquisition System for WD Pro Receiver Application Note

5. Using Socket Communication (WDR-PRO Protocol)
Use to collect information via TCP socket communication when WD PRO receiver is connected directly toa PC or PLC.

Operation Sequence
Describes the sequence of steps between the host and WD PRO receiver.

5.1.1. Sequence
Describes the sequence between the host and WD PRO receiver.
There are two patterns: 1) Host sends a [request] and receives a [reply], and 2) WD PRO receiver monitors
the WDT status, and sends a [notification] when there is a status change.
*As the [notification] is outside the host's control, it could be received between a [request] command andits corresponding [response]. Please take care when making your design.
Host Request Sequence example

Host Notification Sequence example

22Wireless Data Acquisition System for WD Pro Receiver Application Note

5.1.2. Startup sequence(1) WD PRO Receiver Startup Sequence
Operation sequence when starting up the WD PRO receiver. The network startup process is run
automatically.
When the network startup process is complete, the WDT can join the network.

(2) Initial Host Connection Sequence
Operation sequence when the host executes the connection process. Implement after the sequence iscomplete (WD PRO Receiver Startup Sequence).
*If WDT status information and counter values are accumulated, after connection the accumulated values
for [Notify WDT Change Information] and [Counter Value Notification] are continuously notified.

23

Wireless Data Acquisition System for WD Pro Receiver Application Note

(3) Get Transmitter List Sequence
Operation sequence for getting the list of transmitters connected to the WD PRO receiver. Design as
required.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

(4) Counter Value Initialization Sequence
Operation sequence for registering the initial value (usually 0) when starting the counter on the WDT.
Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 15 seconds is recommended between a request and its response.

24

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.1.3. WDT Notification Sequence(1) Sequence for Notification of Change in Transmitter Status
Notified when there is a change in WDT Signal Tower information, buzzer information, external input
information, RS232C data, or the WDT monitoring status, and when the WDT connection status changes
from connected to unconnected status.

(2) Counter Value Notification Sequence
If the WDT counter setting is enabled, notified when the counter value is updated.
*Notification of value updates is not done in real time.

(3) Sequence for Notification of Change in Signal Tower Display
Notified when the WDT Signal Tower display is released.
*WDT-PRO only25

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.1.4. WD PRO Receiver Control Sequence(1) Get Receiver Information Sequence
Operation sequence for getting WD PRO receiver information (such as ExtendedPanID and firmware
version). Design as required.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

(2) Reset Receiver Sequence
Operation sequence for restarting the WD PRO receiver. Design as required.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

26

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.1.5. WDT Control Sequence(1) Get Transmitter Information Sequence
Operation sequence for getting transmitter information (such as firmware version) or transmitter setup
information (such as user names, firmware version, and ExtendedPanID). Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

(2) Get Transmitter Status Sequence
Operation sequence for getting the transmitter status (such as changes in Signal Tower information andbuzzer information). Design as required.
*If the status of transmitters is accumulated, you can get the status from the oldest.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

27

Wireless Data Acquisition System for WD Pro Receiver Application Note

(3) Call Transmitter Sequence
Operation sequence when calling the transmitter (WDT indicator flashes blue). Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 15 seconds is recommended between a request and its response.

(4) Get Counter Value Sequence
Operation sequence for getting the counter value in the WDT. Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

28

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.1.6. WDT-PRO Control Sequence(1) Output Serial Data Sequence
Operation sequence when outputting data from the WDT-PRO RS232C interface. Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 15 seconds is recommended between a request and its response.

29

Wireless Data Acquisition System for WD Pro Receiver Application Note

(2) Control Signal Tower Display Sequence
Operation sequence for controlling the WDT-PRO Signal Tower display. Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 15 seconds is recommended between a request and its response.

30

Wireless Data Acquisition System for WD Pro Receiver Application Note(3) Release Signal Tower Display Sequence
Operation sequence for releasing control of the WDT-PRO Signal Tower display. Design as required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 15 seconds is recommended between a request and its response.

(4) Get Signal Tower Display Sequence
Operation sequence for getting the control status of the WDT-PRO Signal Tower display. Design as
required.
*Specify an IEEE address for each unit.
*In regards to a request, wait until you receive a response before sending the next request.
*Timeout (T) of 2 seconds is recommended between a request and its response.

31

Wireless Data Acquisition System for WD Pro Receiver Application Note

Communication Protocol
Describes the data format for communication control.

5.2.1. Communication Data Format
The structure of communication data format is as follows.
Set value(Example)

Item

Numberof bytes

Product Category

2

ID

1

0x01

Indicates the WD PRO Receiver

Extension

1

0x00

Static value

Size

2

Communication
packetVariable

Description

0x58

Indicates a wireless product (“XB”)

0x42

0xXX
0xXX

Data length (bytes) of "communication packet" part

Data of the WDR-PRO protocol part
*Variable value 0 to XX bytes

0xXX toThe format of the communication packet varies depending on whether it is a request command, responsecommand, or notification command.
Basic configuration of the communication packet part is shown below.
(1) Data Format of Request Command
Numberof bytes

Set value(Example)

Description

Command type

1

0x20

Indicates a request command

IEEE Address

8-IEEE address (MAC address) of the request destination

Command mode2-

Command mode of the request

Data Area

Variable-

Data added to the command or mode

Numberof bytes

Set value(Example)

Description

Command type

1

0x30

Indicates a response command

IEEE Address

8-IEEE address (MAC address)of the source of the response

Command mode2-

Indicates the requested command mode

Response status

1-

Response status for a request

Data Area

Variable-

Data added to the command or mode

Item
Communication
packet(2) Data Format of Response Command
Item
Communication
packet32

Wireless Data Acquisition System for WD Pro Receiver Application Note

(3) Data Format of Notification Command
Numberof bytes

Set value(Example)

Description

Command type

1

0x10

Indicates a notification command

IEEE Address

8-IEEE address (MAC address)of the request destination

Command mode2-

Command mode of the notification

Data Area part

Variable-

Data added to the command or mode

Communication
packetItem

33

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.2.2. List of Communication Packet Commands
List of commands you can use and relationships between commands.
(1) Notification command (command type: 0x10)
Notification commands for the WDR are shown below.
Command mode

CommandNotification Command
Notification of Change in Transmitter Status

0x2001

Notification of Counter Value

0x2007

Notification of Change in Signal Tower Display

0x2008(2) Request command (command type: 0x20) and response command (command type: 0x30).

Command

Request and response commands for WDR are shown below.
Command mode

Request Command

Response Command

Request to Get Transmitter Status

Response to Get Transmitter Status

0x2002

Request to Get Transmitter List

Response to Get Transmitter List

0x2003

Request to Get Transmitter
Information

Response to Get Transmitter
Information

0x2004

Request to Display Calling
Transmitter Status

Response to Display Calling theTransmitter

0x4010

Request to Output Serial Data

Response to Output Serial Data

0x9011

Request Control of Signal Tower
Display

Response to Control Signal Tower
Display

Request: 0xE001
Response: 0xE000

Request to Release Signal Tower
Display

Response to Release Signal Tower
Display0xE0FF

Request to Register Counter Value

Response to Register Counter Value

0x6001

Request to Get Receiver Information

Response to Get Receiver
Information

0x2005

Request to Reset Receiver

Response to Reset Receiver

0x2006

Request to Get Counter Value

Response to Get Counter Value

0x2009Request to Get Signal Tower Display

Response to Get Signal Tower
Display0x200A–

Command Error response34-

Wireless Data Acquisition System for WD Pro Receiver Application Note

Communication Packet Commands
Describes information about commands.

Data Areapart

The size and communication packet parts of the “communication data format” are described in thefollowing example.

Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x01

Static value

IEEE Address

8-

Set the IEEE address on WDT.

Command mode2

Description

0x00
0x0C

0x10
0x11

Static value

Status1-

0x12: XXXX
0x13: VVVV

...

・

-

...

*In the command details, describe the Set Value for important items only. Otherwise, a dash “-” is shown.
*Items with multiple bytes are stored in Big Endian format, unless otherwise specified.
*Item names in the data area vary depending on the command. Or, it may consist of multiple items.

35

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.1. Notification of Change in Transmitter Status
Notified when there is a change in WDT Signal Tower information, buzzer information, external input
information, RS232C data, or the WDT monitoring status.
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x10

IEEE Address

8-

Command mode2

Dummy data

1

Description

0x00
0x6F
Static value
Set IEEE address of responding WDT

0x20

Static value

0x01
0x00

Static value

Serial number

4-

Every time there is a notification about a change in WDT
information, increments and sets the counter value.
The count starts at 0, and after it reaches the maximum
value, the count starts again from 0.

Time

8

-

Time when change occurred*The format is UNIX time (UTC)

Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".
-

Minor version (0x00 to 0xFF)

Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter mode

0x04

Check Radio Waves mode

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static value.

WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"36

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Base Unit
Information

5-

Description
Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
Signal Tower
Information (red)1Signal Tower
Information (amber)

1

Signal Tower
Information (green)

1

Signal Tower
Information (blue)

1

Signal Tower
Information (white)

1

Signal Tower status information
Value-

Description

0x00

Not registered, unused

0x01

Light off

0x02

Light on

0x04

Flashing

Buzzer status information
Buzzer information

1

Value

-

Description

0x00

Buzzer off

0x01

Buzzer on

WDT monitoring information
WDT monitoring
information

1

Value

-

Description

0x00

WDT disconnected

0x09

WDT connected

External input status information
bit

External Input
information

RS232C Data

1

62

-

-

External Input 8

7

External Input 7

6

External Input 6

5

External Input 5

4

External Input 4

3

External Input 3

2

External Input 2

1

External Input 1

0

Description

Value

Description

0b0

OFF

0b1

ON

RS232C data information*For information, refer to ☞ "RS232C data information
details"37

Wireless Data Acquisition System for WD Pro Receiver Application Note

(1) WDT Information
Item

Number ofbytes

Description

1

WDT-PRO major version
0x01 to 0xFF
*Other than for WDT-PRO, version information is static (0x0000)

1

WDT-PRO minor version
0x00 to 0xFF

Version information

Status information

1

Static value

1

Static value

Number ofbytes

Description(2) Base Unit Information
Item

Unit model information
Unit model

1

Value

Description

0x00

Unknown

0x11

WDB-D80S-PRO

1

Major version
0x01 to 0xFF
*Other than for WDT-PRO, version information is static (0x0000)

1

Minor version
0x00 to 0xFF

Version information

1

Static value
States of 4 DIP switchesbit

DIP switch information

1

Description

3
2
1
0

Value

Description

0b0

OFF

0b1

ON

(3) RS232C data information details
Item

Number of
bytes

Size of Input Information

1

Data length of input information (bytes)
0x00 to 0x3C (0 to 60)

1

Number to indicate retransmission
0x00 to 0xFF
*When you receive data with the same number, consider it aretransmission.

60

RS-232C receive data
0x00 to 0xFF
*Areas besides the input information size are stored with 0xFF
*Until input information is updated, the previous information is kept

Serial number

Input Information

Description

38Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.2. Notification of Counter Value
Notifies when the WDT counter value is updated.
*Notification of value updates is not done in real time.
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x10

IEEE Address

8-

Command mode2

Description

0x00
0x2D
Static value
Set IEEE address of responding WDT

0x20

Static value

0x07
0x00
0x00

Dummy data

5

Static value

0x00
0x00
0x00

Time

8

-

Time when change occurred*The format is UNIX time (UTC)
Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".
-

Minor version (0x00 to 0xFF)
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter mode

0x04

Check Radio Waves mode

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static value.
WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
Information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00

39

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Counter value

4-

Description
Counter value information
0x00000000 to 0xFFFFFFFF

5.3.3. Notification of Change in Signal Tower Display
Notifies when the WDT Display Control status is released.
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x10

IEEE Address

8-

Command mode2

Description

0x00
0x2F
Static value
Set IEEE address of responding WDT

0x20

Static value

0x08
0x00
0x00

Dummy data

5

Static value

0x00
0x00
0x00

Time

8

-

Time when change occurred*The format is UNIX time (UTC)
Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".
-

Minor version (0x00 to 0xFF)
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter mode

0x04

Check Radio Waves mode

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static value.

WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

40

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
Red unit

1-

Yellow unit

1-

Green unit

1-

Blue unit

1-

White unit

1

Buzzer Unit

1

Unit status information
Value

Description

0x00

Non-control state

0x10Light off / buzzer off

0x11

Light on / buzzer on

-

0x12

Flashing / continuous buzzer

-

0x13

Triple flash

41

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.4. Request/Response to Get Transmitter Status
Gets the WDT status information (information about changes).
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0B
Static value
Specifies the WDT IEEE address for the get operation

0x20

Static value

0x02(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x6F
Static value
Set IEEE address of responding WDT

0x20

Static value

0x02
Status information
Value

Response status

1-

Description

0x00

Normal response

0x86

Get data error

0xFF

Exception error

0x00
Dummy data

4

0x00

Static value

0x00
0x00

Time

8

Time when change occurred*The format is UNIX time (UTC)42

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".
-

Minor version (0x00 to 0xFF)
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter mode

0x04

Check Radio Waves mode

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static value.

WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
Signal Tower
Information (red)1Signal Tower
Information(amber)1

Signal Tower
Information (green)

1

Signal Tower
Information (blue)

1

Signal Tower
Information (white)

Signal Tower status information
Value-

Description

0x00

Not registered, unused

0x01

Light off

0x02

Light on

0x04

Flashing

1

Buzzer status information
Buzzer information

1

Value

-

43

Description

0x00

Buzzer off

0x01

Buzzer on

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
WDT monitoring information

WDT monitoring
information

1

Value

-

Description

0x00

WDT disconnected

0x09

WDT connected

External input status information

External Input
information

RS232C Data

1

62

-

-

Item

bit

External Input 8

7

External Input 7

6

External Input 6

5

External Input 5

4

External Input 4

3

External Input 3

2

External Input 2

1

External Input 1

0

Description

Value

Description

0b0

OFF

0b1

ON

RS232C data information*For information, refer to ☞ "RS232C data information
details"44

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.5. Request/Response to Get Transmitter List
Gets the WDT list managed by the WD PRO receiver.
(1) Request
Item

Numberof bytesSize

2

Command type1

Set value(Hexadecimal)

Description

0x00
0x0B
0x20

Static value

0x00
0x00
0x00
IEEE Address

8

0x00

Static value

0x00
0x00
0x00
0x00

Command mode

2

0x20

Static value

0x03(2) Response
Item

Numberof bytes

Set value(Hexadecimal)

Description

Size

2

-

0x000D to 0x02C9

Command type

1

0x30

Static value

0x00
0x00
0x00
IEEE Address

8

0x00

Static value

0x00
0x00
0x00
0x00

Command mode

2

0x20

Static value

0x03
Status information
Value

Response status

1

-

45

Description

0x00

Normal response

0xFF

Exception error

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description

Number to get

1-

Number of WDT managed by the WD PRO receiver
0x00 to 0x46 (0 to 70)-

WDT IEEE address

8

WDT Registration Status
1

Value

0x01

WDT Status
Information 1

Description

0x00

Not registered

0x01

Registered

WDT connection status
1

Value

0x01

Description

0x00

Disconnected

0x01

Connect

WDT Status
Information 2・・・

Variable0 to 700*WDT status information (0 to 70 units) is added to
the number of units to get part.

WDT Status
Information 70

46

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.6. Request/Response to Get Transmitter Information
Gets transmitter information of the specified WDT.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0B
Static value
Specifies the WDT IEEE address for the get
operation

0x20

Static value

0x04(2) Response For WDT-6M/5E-Z2 and WDT-6LR/5LR/4LR-Z2
Item

Numberof bytesSize

2

Set value(Hexadecimal)

Description

0x00
0xA7
Command type

1

0x30

IEEE Address

8-

Command mode2

Static value
Set IEEE address of responding WDT

0x20

Static value

0x04
Status information
Value

Response status

User Name

1

121

-

Description

0x00

Normal response

0xFF

Exception error

WDT user name
*If nothing is registered, NULL-

Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".
-

Minor version (0x00 to 0xFF)

47

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter mode

0x04

Check Radio Waves mode

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static value.
WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
ExtendedPanID

8-

ExtendedPanID information
0x0000000000000000
to 0xFFFFFFFFFFFFFFFE

Frequency Channel

4-Frequency Channel Information*For information, refer to ☞ "Frequency Channel
Information details"
Determine Signal Tower Input information
Value

Determine Signal
Tower Input

1-

Description

0x00

Normal0x05

Flashing (Short)

0x10

Flashing (medium)

0x20

Flashing (Long)

Power Supply Settings information
Power Supply
Settings

1

-

Value

Description

Value

Description

0x00

Power
Supply Wire

0x03

Green

0x01

Red

0x04

Blue

0x02

Yellow

0x05

White

Counter Settings information

Counter Settings

1

-

48

Value

Description

Value

Description

0x00

Do not use

0x04

Blue

0x01

Red

0x05

White

0x02

Yellow

0x06

Buzzer

0x03

Green

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
Transmission Mode information

Transmission Mode

2

-

Value

Description

0x0000

Immediate transmission mode

0x0001

Request transmission mode For WDT-6LR-Z2-PRO
Item

Numberof bytesSize

2

Set value(Hexadecimal)

Description

0x00
0xB0
Command type

1

0x30

IEEE Address

8-

Command mode2

Static value
Set IEEE address of responding WDT

0x20

Static value

0x04
Status information
Value

Response status

User Name

1

121

-

Description

0x00

Normal response

0xFF

Exception error

WDT user name
*If nothing is registered, NULL-

Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".
-

Minor version (0x00 to 0xFF)
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter mode

0x04

Check Radio Waves mode

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static value.
WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"49

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
ExtendedPanID

8-

ExtendedPanID information
0x0000000000000000
to 0xFFFFFFFFFFFFFFFE

Frequency Channel

4-Frequency Channel Information*For information, refer to ☞ "Frequency Channel
Information details"
Determine Signal Tower Input information
Value

Determine Signal
Tower Input

1-

Description

0x00

Normal0x05

Flashing (Short)

0x10

Flashing (medium)

0x20

Flashing (Long)

Power Supply Settings information
Power Supply
Settings

1

-

Value

Description

Value

Description

0x00

Power Supply
Wire

0x03

Green

0x01

Red

0x04

Blue

0x02

Yellow

0x05

White

Counter Settings information

Counter Settings

1

-

Value

Description

Value

Description

0x00

Do not use

0x04

Blue

0x01

Red

0x05

White

0x02

Yellow

0x06

Buzzer

0x03

Green

Transmission Mode information
Transmission Mode

2

Value

-

Description

0x0000

Immediate transmission mode

0x0001

Request transmission mode

Input Information Transmission Method information
Input Information
Transmission
Method

1

Value

-

50

Description

0x00

WDT-PRO Format

0x01

WDT-LR Format

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
Signal Tower Format information

Signal Tower Format

1

Value

-

Description

0x00

Standard Format

0x01

Extended Format

Periodic Transmission information
Value
Periodic
Transmission

1-

Description

0x00

None

0x01

Unit Information

0x02

Input Information/Signal Tower
Information

Determine Simultaneous Input Sensitivity Setting
information
Determine
Simultaneous Input
Sensitivity Setting

Value
1

-

Description

0x00

High sensitivity

0x01

Medium sensitivity

0x02

Low sensitivity

File Format for Received Data information
Value
File Format for
Received Data

1-

Description

0x00

Direct Communication Format

0x01

Bar Code Reader (Denso Wave)
Communication Format

0x02

Barcode Reader (Generic)Communication

0xFF

Other Communication Method

Baud rate information
Value
Communication
Settings
Baud rate1-

Description

0x00

4800bps

0x01

9600bps

0x02

19200bps

0x03

38400bps

0x04

57600bps

0x05

115200bps

Data Length information
Communication
Settings
Data Length

1

Value

-

51

Description

0x00

7

0x01

8

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
Parity information

Communication
Settings
ParityValue
1

Description

0x00

None

0x01

Even

0x02

Odd

Stop Bit information
Communication
Settings
Stop Bit

Value

1

52

Description

0x00

1

0x01

2

Wireless Data Acquisition System for WD Pro Receiver Application Note

(3) Frequency Channel Information details
Frequency Channel

byte

Channel 26
Channel 25

bit
31 to 274

26
25

Channel 24

24

Channel 23

23

Channel 22

22

Channel 21

21

Channel 20
Channel 19

Description

3

20
19

Channel 18

18

Value

Description

Channel 17

17

0b0

OFF

Channel 16

16

0b1

ON

Channel 15

15

Channel 14

14

Channel 13

13

Channel 12
Channel 11

2

12
11
10

-

9
8

-

1

7 to 053

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.7. Request/Response to Display Calling Transmitter Status
Display on the specified WDT to indicate calling a transmitter.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0B
Static value
Sets the defined WDT IEEE address

0x40

Static value

0x10(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x0C
Static value
Set IEEE address of responding WDT

0x40

Static value

0x10
Status information
Value

Response status

1

-

0x01

54

Description
SuccessfulWireless Data Acquisition System for WD Pro Receiver Application Note

5.3.8. Request/Response to Output Serial Data
Output serial data from the specified WDT-PRO RS232C interface.
(1) Request
Item

Numberof bytes

Set value(Hexadecimal)

Size

2

-

Command type

1

0x20

IEEE Address

8-

Command mode2

Dummy data

2

Serial number

Output information

1

1 to 40

Description
0x000F to 0x0036
Static value
Sets the defined WDT IEEE address

0x90

Static value

0x11
0x00

Static value

0x00

-

Number to indicate retransmission
0x00 to 0xFF
*When you receive data with the same number,design so it is determined a retransmission.

-

RS-232C output data
0x00 to 0xFF
*Maximum 40 bytes of data can be stored as
variable length.

55

Wireless Data Acquisition System for WD Pro Receiver Application Note(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x0C
Static value
Set IEEE address of responding WDT

0x90

Static value

0x11
Status information
Value

Response status

1

-

56

Description

0x01

Normal response

0x81Mode error

0x83

Connection unit error

0xFF

Exception error

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.9. Request/Response to Control Signal Tower Display
Controls the specified WDT-PRO Signal Tower display.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x12
Static value
Sets the defined WDT IEEE address

0xE0

Static value

0x01

Specifies the amount of the control time (seconds).
Control time

1

-

Value

Description

0x00

No time is specified

0x01 to 0xFF

Red unit

1-

Control time isspecified

Specifies the light pattern of each unit.
Value

Yellow unit

1-

Green unit

1-

Blue unit

1-

White unit

1-

Description

0x00

Control by control wiring

0x10Light off

0x11

Light on

0x12

Flashing

0x13

Triple flash

Specifies the buzzer pattern.
Value
Buzzer Unit

1

-

57

Description

0x00

Control by control wiring

0x10

Buzzer off

0x11

Buzzer on

0x12

Intermittent buzzer

Wireless Data Acquisition System for WD Pro Receiver Application Note(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x13
Static value
Set IEEE address of responding WDT

0xE0

Static value

0x00
Status information
Value

Response status

1

-

0x00

Description
Successful

Control Status Information
Control state

Red unit

1

1

-

Value

Description

0x00

Non-control state

0x01

Control state

Unit status information

Yellow unit

1-

Green unit

1-

Blue unit

1-

White unit

1-

Buzzer Unit

1

-

Value

58

Description

0x00

Light off / buzzer off (control line)

0x01

Light on / buzzer on (control line)

0x10Light off / buzzer off

0x11

Light on / buzzer on

0x12

Flashing / continuous buzzer

0x13

Triple flash

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.10. Request/Response to Release Signal Tower Display
Releases control of the specified WDT-PRO Signal Tower display.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0B
Static value
Sets the defined WDT IEEE address

0xE0

Static value

0xFF(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x13
Static value
Set IEEE address of responding WDT

0xE0

Static value

0x00
Status information

Response status

1

Value

-

0x00

Description
Successful

Control Status Information
Control state

1

-

Value

Description

0x00

Non-control state

Red unit

1-

Yellow unit

1-

Green unit

1

-

Value

Blue unit

1

-

0x00

Light off / buzzer off (control line)

0x01

Light on / buzzer on (control line)

White unit

1-

Buzzer Unit

1-

Unit status information

59

Description

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.11. Request/Response to Register Counter Value
Registers the value as the specified WDT counter value.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0F
Static value
Sets the defined WDT IEEE address

0x60

Static value

0x01
-

Count
Registration value

4-

Registered count value
0x00000000 to 0xFFFFFFFF-(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x0C
Static value
Set IEEE address of responding WDT

0x60

Static value

0x01
Status information

Response status

1

Value

-

0x01

60

Description
SuccessfulWireless Data Acquisition System for WD Pro Receiver Application Note

5.3.12. Request/Response to Get Receiver Information
Gets the WD PRO receiver information.
(1) Request
Item

Numberof bytesSize

2

Command type1

Set value(Hexadecimal)

Description

0x00
0x0B
0x20

Static value

0x00
0x00
0x00
IEEE Address

8

0x00

Static value

0x00
0x00
0x00
0x00

Command mode

2

0x20

Static value

0x05(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x25
Static value
WD PRO Receiver IEEE address

0x20

Static value

0x05
Status information
Value

Response status

1-

Description

0x00

Normal response

0xFF

Exception error

ExtendedPanID

8-

ExtendedPanID information
0x0000000000000000
to 0xFFFFFFFFFFFFFFFE

Frequency Channel

4-Frequency Channel Information*For information, refer to ☞ "Frequency Channel
Information details"-

Major version
0x00 to FF-

Minor version
0x00 to 0xFF

Firmware Version

2

61

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)

Description
Network Status information
Value

Network status

1-

Description

0x00

Network not started

0x01

Network starting up

0x02

Waiting for network to start

0x03

Network operating

Network Startup Method information
Network startup
method

1

Value

-

Description

0x00

Automatic Start

0x01

Manual Start

In operation
ExtendedPanID

8-

ExtendedPanID information during network
operation

In operation
Frequency Channel

1-Frequency channel during network operation
Channel 11 to 26 (0x0B to 0x1A)

62

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.13. Request/Response to Reset Receiver
Resets the WD PRO receiver.
(1) Request
Item

Numberof bytesSize

2

Command type1

Set value(Hexadecimal)

Description

0x00
0x0B
0x20

Static value

0x00
0x00
0x00
IEEE Address

8

0x00

Static value

0x00
0x00
0x00
0x00

Command mode

2

0x20

Static value

0x06(2) Response
Item

Numberof bytesSize

2

Command type1

Set value(Hexadecimal)

Description

0x00
0x0C
0x30

Static value

0x00
0x00
0x00
IEEE Address

8

0x00

Static value

0x00
0x00
0x00
0x00

Command mode

2

0x20

Static value

0x06
Status information

Response status

1

-

63

Value

Description

0x00

Normal responseWireless Data Acquisition System for WD Pro Receiver Application Note

5.3.14. Request/Response to Get Counter Value
Gets the specified WDT counter value.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0B
Static value
Sets the defined WDT IEEE address

0x20

Static value

0x09(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x2D
Static value
Set IEEE address of responding WDT

0x20

Static value

0x09
Status information
Value

Response status

1-

Description

0x00

Normal response

0x86

Get data error

0xFF

Exception error

0x00
Dummy data

4

0x00

Static value

0x00
0x00

Time

8

-

Time when change occurred*The format is UNIX time (UTC)
Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".

64

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)-

Description
Minor version (0x00 to 0xFF)
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter operation

0x04

Check Radio Waves operation

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static
value.
WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
Information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
Counter value

4-

Counter value information
0x00000000 to 0xFFFFFFFF

65

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.15. Request/Response to Get Signal Tower Display
Gets the specified WDT Signal Tower display status.
(1) Request
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x20

IEEE Address

8-

Command mode2

Description

0x00
0x0B
Static value
Sets the defined WDT IEEE address

0x20

Static value

0x0A(2) Response
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Command mode2

Description

0x00
0x2F
Static value
Set IEEE address of responding WDT

0x20

Static value

0x0A
Status information
Value

Response status

1-

Description

0x00

Normal response

0x86

Get data error

0xFF

Exception error

0x00
Dummy data

4

0x00

Static value

0x00
0x00

Time

8

-

Time when change occurred*The format is UNIX time (UTC)
Major version
Value

Version information2-

Description

0x01

WDT-6M/5E

0x02

WDT-5E/6M-Z2

0x03

WDT-4LR/5LR/6LR-Z2

0xFF

WDT-6LR-Z2-PRO**Version information is static (0xFFFF)
For information, refer to ☞ "WDT Information".

66

Wireless Data Acquisition System for WD Pro Receiver Application Note
Item

Numberof bytes

Set value(Hexadecimal)-

Description
Minor version (0x00 to 0xFF)
Transmitter Operation Mode information
Value

Operation Mode

1-

Description

0x00

Normal operation

0x02

Counter operation

0x04

Check Radio Waves operation

0xFF

WDT-6LR-Z2-PRO static value**Regardless of the operation mode, 0xFF static
value.
WDT Information

4-

WDT-PRO version information*For information, refer to ☞ "WDT Information"

Base Unit
information

5-

Version information of WDT-PRO base unit
*For information, refer to ☞ "Base Unit Information"

0x00
0x00
Dummy data

5

0x00

Static value

0x00
0x00
Red unit

1-

Yellow unit

1-

Green unit

1-

Blue unit

1-

White unit

1-

Buzzer Unit

1-

Unit status information
Value

67

Description

0x00

Non-control state

0x10Light off / buzzer off

0x11

Light on / buzzer on

0x12

Flashing / continuous buzzer

0x13

Triple flash

Wireless Data Acquisition System for WD Pro Receiver Application Note

5.3.16. Command Error response
Returned by the WDR when there is an issue with the request command's command mode.
Set value(Hexadecimal)

Item

Numberof bytesSize

2

Command type

1

0x30

IEEE Address

8-

Set IEEE address of responding WDT

Command mode

2-

Sets the requested command mode

Description

0x00
0x0C
Static value

Error Status information
Value

Response status

1-

Description

0x80

Command Error

0x81

Mode error

0x82

Data error

0x83

Connection unit error

0x84

Error Response from
Wireless Module

0x86

Get data error

0xC0

Initialization error

0xFF

Exception error

Design Considerations
 UDP socket communication is not run.
 WDR and WDT setting changes not run. Run in WDS-WIN01.
 WDR-PRO port cannot be used with the WDR protocol.

68Wireless Data Acquisition System for WD Pro Receiver Application Note

6. Using Cloud Communication (MindSphere)
Information for MindSphere communication in WD PRO Reciever.

Use APIs & Services
Service
Iot Time Series Service

Description
This service is used to obtain or control information on the WDT.

API

Description
Used to get information on the WDT.

GET*The "_time" indicates the time and date when the receiver detects a change in thetransmitter information (time zone: UTC).
Used to control the WDT.

PUT*"_time" sets a fixed value of "2018-01-1T00:00:00Z

Please contact Siemens for more information on APIs and services.

Asset
6.2.1. Asset nameWdt + IEEE Address of WDT例）Wdt0011223344556677 * IEEE Address :0011223344556677

6.2.2. Asset type name
PatWdt01

6.2.3. Asset type Configurations
Aspect name

Description

WdtSignal

Signal Tower Information

WdtExtInput

External Input Information

WdtSerialData

Serial Information

WdtCount

Count Information

WdtConfigInfo

Control Information

WdtControlRequest

Control Request

WdtCountControl

Control Result（Count Clear）

WdtControlResult

Control Result（Signal Tower Control）

69

Wireless Data Acquisition System for WD Pro Receiver Application Note

6.2.4. Aspects Detail(1) WdtSignal
Variables

type

value

Description

Red

Int

Yellow

Int

0

Light off

Signal Tower Information (amber)

Green

Int

1

Light onSignal Tower Information (green)

Blue

Int

2

Flashing

Signal Tower Information (blue)

White

Int

BuzzerInt

Value

Signal Tower Information (white)
Value

Description

0

Buzzer off

1

Buzzer on

Value

WdtState

TimeCounter

Int

Int

Signal Tower Information (red)Description

Buzzer information

Description0

WDT disconnected

9

WDT connected

status change to a Signal Tower
information transmission. (seconds)

WDT monitoring information

Time counter(2) WdtExtInput
Variables

type

value

Description

Input1Int

External Input 1

Input2Int

External Input 2

Input3Int

External Input 3

Input4Int

Value

Description

0

OFF

1

ON

External Input 4

Input5Int

External Input 5

Input6Int

External Input 6

Input7Int

External Input 7

Input8Int

External Input 8

TimeCounterInt

status change to a External Input
information transmission. (seconds)

70

Time counterWireless Data Acquisition System for WD Pro Receiver Application Note
(3) WdtSerialData
Variables

type

value

SerialData

string String of Max 60 bytes.

TimeCounterInt

Description
Serial Data

status change to Serial datatransmission. (seconds)

Time counter(4) WdtCount
Variables
Count

type
long

value

Description

0 to 4294967295

Count Information(5) WdtConfigInfo
Variables

ControlCounterState

type

Int

Int

value
Value

Description

0

Disabled

1

Enabled

Value

Description

0

Disabled

1

EnabledDescription

Signal Tower Display Control state

Simple Counter state71

Wireless Data Acquisition System for WD Pro Receiver Application Note

(6) WdtControlRequest
Variables

type

value
Value

Trigger

Int

Description

0

OFF

1

ON

Display.
been executed.

Description

0

Int

Control request for Signal Tower* Set to "OFF" after the request has

ValueControlTime

Description

No time is specified

1 to 255

Specifies the amount of the control time(seconds).

Control time is specified

Red

Int

Value

YellowInt

0

Control by control wiring

Green

Int

16

Light off

17

Light on

Blue

Int

18

Flashing

Blue unit

White

Int

19

Triple flash

White unit

Description

Value

BuzzerCounterClear

Int

Int

Red unit
Yellow unit
Green unit

Description

0

Control by control wiring

16

Buzzer off

17

Buzzer on

18

Intermittent buzzer

Value

Description

Buzzer Unit

Control request for Count Clear.

0OFF

Set to "OFF" after the request has

1ONbeen executed.

(7) WdtCountControl
Variables

type

value
Value

ResultInt

Description

Description0

No request

1

Running2

Successful

3

FailureRequest result of Count Clear72

Wireless Data Acquisition System for WD Pro Receiver Application Note

(8) WdtControlResult
Variables

type

value
Value

ResultInt

Description0

No request

1

Running2

Successful

3

Failure

Value

State

Int

Description

Request result of Signal Tower
Display control.

Description0

Non-control state

1

Control state

Control Status Information

Red

Int

Value

YellowInt

0

Control by control wiring

Green

Int

16

Light off

17

Light on

Blue

Int

18

Flashing

Blue unit

White

Int

19

Triple flash

White unit

Value

BuzzerInt

Description

Red unit
Yellow unit
Green unit

Description

0

Control by control wiring

16

Buzzer off

17

Buzzer on

18

Intermittent buzzer

Buzzer Unit

73

Wireless Data Acquisition System for WD Pro Receiver Application Note74