User guide

25
INSTALLATIONCONFIGURATIONOPERATION
FURTHER
INFORMATION
INDEX
APPENDIX B - Management APIspecication
Introduction
The AdderLink DV104T is monitored and managed by a web interface. This provides
topology and status information and allows conguration of the transmitter unit plus the
receiver units connected to it.
The unit also has a management API via the same HTTP interface. This allows the
status, topology and conguration to be managed from another application, via HTTP
commands. Only the rst line of the HTTP method is required as the URI contains all
the required information to perform the requested operation.
API Overview
The API allows monitoring of the following:
• Status of the ALDV104T unit,
• Status of the two HDMI inputs to the ALDV104T,
• Topology of the connections to ALDV100R units,
• Status of up to four ALDV100R units connected to the ALDV104T,
• Status of the screens connected to the ALDV100R units,
• Status of the connections between the ALDV104T and the ALDV100s.
The following aspects of the ALDV104T and the connected ALDV100s can be controlled:
• HDMI input routed to all ALDV100s,
• Automatic input switching mode,
• Enable/disable of all connected screens,
• Enable/disable of individual screens,
• Source of the EDID presented at each HDMI input.
API Operation
Message Structure
All operations of the API are performed using a URI contained in an HTTP request. The
control and conguration operations are performed by the following request:
GET /cgi-bin/api?<params> HTTP/1.1
Where <params> is one or more URI parameters to describe the operation to be performed.
The response is an HTTP response. The rst line contains the status code indicating the
success or failure of the operation.
The response is either:
HTTP/1.1 200 OK
or an HTTP error response:
HTTP/1.1 400 Bad Request
Command and Control Operations
The following command and control operations are available:
Switch to input
Select Input 1
Switch all outputs to the signal on HDMI input 1
GET /cgi-bin/api?opmode=0&insrc=1 HTTP/1.1
Select input 2
Switch all outputs to the signal on HDMI input 2
GET /cgi-bin/api?opmode=0&insrc=2 HTTP/1.1
Set input switching mode
Set xed mode
Set the input switching mode to xed. The selected input signal will be routed to the
outputs regardless of the status on the input signals on inputs 1 and 2. The opmode is set
to 0 to switch to single source mode at the same time.
GET /cgi-bin/api?opmode=0&swmode=0 HTTP/1.1
Set auto mode
Set the input switching mode to auto. In this mode the selected input source will
automatically switch when an input source becomes active, either by it being plugged in
or by the source becoming active (e.g. the player being powered on). If the active source
becomes inactive then it switches to the other input as long as it is active. This provides a
fallback to a backup source if the primary input fails. The opmode is set to 0 to switch to
single source mode at the same time.
GET /cgi-bin/api?opmode=0&swmode=1 HTTP/1.1