7. Lightware REST API Reference
UCX series – User's Manual
79
Applied firmware package: v1.2.0b9 | LDC software: v2.5.10b1
7.6.10. Query the Input Switching Capability
Video crosspoint has a limitation: I1 or I5 ports can not be selected to any output at the same time.
Busy
value of the switchable property
refers to the limitation.
Request and Response
ɯ
header:
GET·http://
<ip>
/api/V1/MEDIA/VIDEO/XP/
<out>
/SWITCHABLE/
<in>
·HTTP/1.1
ɮ
header: 200·OK
ɮ
body:
<switchable_state>
Parameters
Parameter
Parameter description
Values
Value description
<switchable_state>
The chosen input is can be
switched to the output or not.
OK
The connection of the chosen input and
output is allowed.
Busy
The chosen input can not be switched to the
output.
Locked
The chosen input can not be switched to the
output, because input is locked.
Example
ɯ
header:
GET http://192.168.0.50/api/V1/MEDIA/VIDEO/XP/O2/SWITCHABLE/I1 HTTP/1.1
ɮ
header:
200 OK
ɮ
body: Busy
7.6.11. Query the Video Signal Presence
Request and Response
ɯ
header:
GET·http://
<ip>
/api/V1/MEDIA/VIDEO/
<port>
/SignalPresent·HTTP/1.1
ɮ
header: 200·OK
ɮ
body:
<state>
Parameters
Parameter
Parameter description
Values
Value description
<state>
This property gives a feedback about
the current signal presence of the port.
true
The video signal is present.
false
The video signal is not present.
Example
ɯ
header:
GET http://192.168.0.50/api/V1/MEDIA/VIDEO/I1/SignalPresent HTTP/1.1
ɮ
header:
200 OK
ɮ
body: true
7.6.12.
HDCP Setting (Input Port)
HDCP capability can be set on the input ports, thus, non-encrypted content can be seen on a non-HDCP
compliant display. See more information in the
section.
ATTENTION!
HDCP 2.2 signal handling is limited up to two input ports at the same time.
Request and Response
#hdcp
ɯ
header:
POST·http://
<ip>
/api/V1/MEDIA/VIDEO/
<in>
/HDCP/AllowedHdcpVersion·HTTP/1.1
ɯ
body:
<allowed_hdcp>
ɮ
header:
200 OK
ɮ
body:
<allowed_hdcp>
Parameters
Parameter
Parameter description
Values
Value description
<allowed_hdcp>
The input port reports
this HDCP capability.
HDCP 1.4
HDCP 2.2
Off
The input port reports HDCP 1.4 capability.
The input port reports HDCP 2.2 capability.
The input port reports non-HDCP compliant.
Example
ɯ
header:
POST http://192.168.0.50/api/V1/MEDIA/VIDEO/I1/HDCP/AllowedHdcpVersion HTTP/1.1
ɯ
body:
HDCP 1.4
ɮ
header:
200 OK
ɮ
body:
HDCP 1.4
7.6.13.
HdcpMode
HDCP capability can be set to Auto/Always on the output ports, thus, non-encrypted content can be
transmitted to a non-HDCP compliant display. See more information in the
section.
Request and Response
#hdcp
ɯ
header:
POST·http://
<ip>
/api/V1/MEDIA/VIDEO/
<out>
/HdcpMode·HTTP/1.1
ɯ
body:
<hdcp_mode>
ɮ
header:
200 OK
ɮ
body:
<hdcp_mode>
Parameters
Parameter
Parameter description
Values
Value description
<hdcp_mode>
HDCP encryption
setting on the output
port
Auto
The encryption is enabled on the output port if the signal
on the input port is encrypted.
Always
The outgoing signal is HDCP-encrypted.
