ControlByWeb XW-112, Руководство пользователя

Страница: 25 / 33

XW-112™ Wi-Fi Water Detector Users Manual Network Discovery
Section 5: Network Discovery
XW-112 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'.
Header
C o n t r o l B y W e b
0x43 0x6f 0x6e 0x74 0x72 0x6f 0x6c 0x42 0x79 0x57 0x65 0x62
5.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) ASCII String ControlByWeb
Message ID (1 byte) Initial Contact Request 0x00
Response:
Header (12 bytes) ASCII String ControlByWeb
Message ID (1 byte) Initial Contact Response 0x01
MAC Address (6 bytes) Binary version 0x00 0x0c 0xc8 0x00 0x00 0x00
Device Info (2 bytes) Bit[15-7] Reserved 0b0
Bit 6 – Mode 0b0=Station, 0b1=AP
Bit 5 – Reserved 0b0
Bit 4 – Remote Services Status 0b0=Disconnected, 0b1=Connected
Bit 3 – DHCP Status 0b0=Waiting, 0b1=Success
Bit 2 – Remote Services Enabled 0b0=Disabled, 0b1=Enabled
Bit 1 – DHCP Enabled 0b0=Disabled, 0b1=Enabled
Bit 0 – Configuration Allowed 0b0=Not Allowed, 0b1=Allowed
Model Code (2 bytes) 0x002D=XW-112
IP Address (4 bytes) Network endianness 0xc0 0xa8 0x01 0x02 (192.168.1.2)
Xytronix Research & Design, Inc. Page 25