Section 8: Network Discovery - ControlByWeb XW-110 User Manual

XW-110™ WiFi Temperature Sensor Users Manual

Section 8: Network Discovery

XW-110 and XW-110-Plus has implemented a network discovery and provisioning protocol to aid in
accessing the device. With this protocol, a user may connect the device to a network without knowing
the IP address, search and identify the IP address, query basic information and if not yet configured
send the desired network and remote services configurations. This feature can be utilized in the latest
versions of the Android and iOS apps.
The network discovery protocol listens for specific requests on UDP port 65431 sent to the IP broadcast
address 255.255.255.255. All requests must have the proper header and, when applicable, the correct
MAC address. This header is the first 12 bytes of all messages and is simply the string 'ControlByWeb'.
Note: Due to resource constraints, the Network Discovery feature is not available when Modbus is
enabled.
C o
0x43 0x6f 0x6e
8.1 Initial Contact
The initial contact request is sent to discover ControlByWeb devices on the network. It is recommended
to send this message multiple times in environments where many ControlByWeb devices are present
due to potentially lost traffic where collisions occur as UDP does not guarantee deliver of packets.
Request:
Header (12 bytes)
Message ID (1 byte)
Response:
Header (12 bytes)
Message ID (1 byte)
MAC Address (6 bytes)
Device Info (2 bytes)
Model Code (2 bytes)
IP Address (4 bytes)
Xytronix Research & Design, Inc.
n t r
0x74 0x72
ASCII String
Initial Contact Response
Binary version
Bit[15-7] Reserved
Bit 6 – Mode
Bit 5 – Reserved
Bit 4 – Remote Services Status
Bit 3 – DHCP Status
Bit 2 – Remote Services Enabled
Bit 1 – DHCP Enabled
Bit 0 – Configuration Allowed
Network endianness
Header
o l
0x6f 0x6c
ASCII String
Initial Contact Request
B y W
0x42 0x79 0x57
ControlByWeb
ControlByWeb
0x01
0x00 0x0c 0xc8 0x00 0x00 0x00
0b0
0b0=Station, 0b1=AP
0b0
0b0=Disconnected, 0b1=Connected
0b0=Waiting, 0b1=Success
0b0=Disabled, 0b1=Enabled
0b0=Disabled, 0b1=Enabled
0b0=Not Allowed, 0b1=Allowed
0x0024=XW-110, 0x002B=XW-110-Plus
0xc0 0xa8 0x01 0x02 (192.168.1.2)
Network Discovery
e b
0x65 0x62
0x00
Page 45