Section 7: Network Discovery - Xytronix Research & Design CONTROL BY WEB XW-111 User Manual

Network Discovery

Section 7: Network Discovery

XW-111 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
7.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)
Page 40
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
XW-111™ Wi-Fi Digital Sensor Users Manual
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
0x0025=XW-111
0xc0 0xa8 0x01 0x02 (192.168.1.2)
Xytronix Research & Design, Inc.
e b
0x65 0x62
0x00