Ivu Discovery Protocol; Udp Usage; Packet Format - Banner iVu Plus TG Series Instruction Manual

14.5 iVu Discovery Protocol

The iVu Discovery Protocol is a method to dynamically discover Banner iVu devices on an Ethernet network.
The goal is to both be able to find a device and, if necessary, change the IP address of that device so that it is on the same
subnet as the controlling PC. This is done without requiring the PC to change its IP address or using anything more than an
Ethernet cable connected to the device.
The iVu Discovery Protocol is implemented using UDP broadcast packets that are mapped to Ethernet Broadcast packets
by the TCP/IP stack. Broadcast packets are the only mechanism that ensures delivery of the data if the device and
controlling PC are configured for different subnets and on the same bridged Ethernet network. The contents of the packets
used for Banner's iVu devices are proprietary.
The iVu Discovery Protocol is supported by iVu devices from the 2012R1 or later releases.

14.5.1 UDP Usage

All packets are sent with the source and destination port number set to 19995.
The destination IP address is always set to a broadcast value of 255.255.255.255.

14.5.2 Packet Format

The packets used by the Discovery Protocol follow the same general format. The packets have a short header and a larger
body area with ASCII text.
Header Format
The header of the packets is as follows:
Name Offset
Protocol ID 0
Message Type 4
Correlation Tag 8
Body Format
The Body of the packet follows the header and consists of a long string of ASCII text. The ASCII text section contains some
strings in the format of "<name>=<value>," Those names and values are detailed in the following table. Note that the
comma is required, and is used as a string separator.
Name
SerialNumber String
Version String
Length
(bytes)
The number that identifies this as a Discovery Protocol Packet.
4
Always set to 0x6956752b. This appears as "iVu+" when viewed with packet
dump software.
Identifies the type of message:
DISCOVER = 0x44495343, ASCII translates as "DISC"
DISCOVER_REPLY = 0x52504c59, ASCII translates as "RPLY"
4
DISCOVER_SETIP = 0x53455449, ASCII translates as "SETI"
See the following for a detailed description of each of these messages:
DISCOVER Message
•
DISCOVER_REPLY Message
•
DISCOVER_SETIP Message
•
A number chosen by the sender of a DISCOVER packet. The value sent in a
4 DISCOVER packet is returned in the DISCOVER_REPLY packet. This allows
the sender to match its requests with responses it receives.
Values
www.bannerengineering.com - Tel: + 1 888 373 6767
iVu Plus TG and Color Gen2 Image Sensors
Description
(p. 126)
(p. 126)
(p. 127)
Description
Device serial number
Firmware version string
125