This request returns the device’s Auto-Discovery data string. Use this request to fetch pertinent device information using a TCP (HTTP) connection.
URL:
/get.cgi?req=ping
Response:
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 string 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) |
Errors:
If an error occurs during the processing of the request, only a single byte will be returned by this URL. The value of the returned byte is explained in the following table:
| Error Value | Description |
|---|---|
0xFF |
An internal memory error occurred. |
0xFE |
Invalid playback number was specified. |