CueServers on the network can be discovered by using an auto-discovery technique.
All CueServers (both the original CueServer and the CueServer 2 series) are listening on the CueServer Multicast Group Address (239.255.204.2) on port 52737. This socket is typically used to send CueScript commands to the CueServer, but it also used for auto-discovery.
To ask CueServers to report themselves, simply send the 6 character string #PING# via UDP to this group address and port number.
Every CueServer that receives this message will reply to the sender with a UDP packet. The returned data is an ASCII string. It begins with #PING and contains several fields, each separated by a bar character (|).
The following is an example ping reply packet from a CueServer:
#PING|600001|10.0.1.5|1.5.5|CueServer 2|255.0.0.0|10.0.1.1|0|239|
000000000000|6/30/2017 12:59:59 PM|N|shows/My Show|1|1|0.0.0.0|0.0.0.0|0The bar-separated fields are explained in the following table:
| Field | Example | Description |
|---|---|---|
| Fields below are present on both CueServer 1 and CueServer 2 models | ||
| 1 | 600001 |
Serial number (6 characters, may include only numbers and letters, no special characters) |
| 2 | 10.0.1.5 |
Primary interface IP address (standard IPv4 notation) |
| 3 | 1.5.5 |
Current firmware version (format is <number>.<number>.<number>[<dev-stage><number>[<letter>]], an extreme example would be 2.34.567b99z) |
| 4 | CueServer 2 |
Device name (maximum 15 characters) |
| 5 | 255.0.0.0 |
Primary interface subset mask (standard IPv4 notation) |
| 6 | 10.0.1.1 |
Gateway address (standard IPv4 notation) |
| 7 | 0 |
Primary interface DHCP mode (may be 0 or 1) |
| 8 | 239 |
Hardware model (see Hardware Model Identifiers) |
| 9 | 000000000000 |
Reserved for future use (only used on CueServer 1) |
| 10 | 6/30/2017 12:59:59 PM |
The current device time (MM/DD/YY HH:MM:SS AP) |
| 11 | N |
Reserved for future use (only used on CueServer 1) |
| Fields below are only present on CueServer 2 models | ||
| 12 | shows/My Show |
Current show path |
| 13 | 1 |
Number of physical Ethernet ports (may be 1 or 2) |
| 14 | 1 |
Number of logical Ethernet interfaces (may be (1 or 2) |
| 15 | 0.0.0.0 |
Secondary interface IP address (standard IPv4 notation) |
| 16 | 0.0.0.0 |
Secondary interface subnet mask (standard IPv4 notation) |
| 17 | 0 |
Secondary interface DHCP mode (may be 0 or 1) |