Lightware UCX-4x2-HC30 User Manual

 UCX series – User's Manual 74

Not Supported Commands

Protocol Command Note
REST API Not supported 404 error code
LW3
ç GET·<NODEPATH>
Example ç 
Subscribe to a node (OPEN)
Protocol Command Note
REST API Not interpreted Not supported
LW3
ç <NODEPATH>
Example ç 
Unsubscribe from a Node (CLOSE)
Protocol Command Note
REST API Not interpreted Not supported
LW3
ç <NODEPATH>
Example ç 
Status Codes, Error Messages

command like:
Error code Description
200 OK Standard response for successful HTTP request.
401 Unauthorized
405 Method Not Allowed
A request method is not supported for the requested resource. This is
the error code when trying to modify a read-only property.
404 Not Found Invalid nodepath or property name.
406 Not Acceptable
         quals the

pE: an error for the property
mE: an error for a method
500 Internal Server Error 
Polling
Subscription and unsubscription features are not supported, they can be substituted with polling. It means
that a custom user script sends a request for a detected property from time to time.
REST API Security
The REST API is designed with two security features: Authentication and Encryption. Both of them are optional
and can be used independently from each other.
Authentication
Basic access authentication is designed to limit user access for the REST API server. It requires user

Follow the instructions below to set the password:
Step 1. Set the password.
ɯ header: POST·<ip>·
ɯ body: <new_password>
Step 2. Enable the basic authentication on the chosen port (HTTP: 80 or HTTPS: 443).
ɯ header: POST·<ip>·
ɯ body: true
Step 3. Restart network services.
ɯ header: POST·<ip>·
ATTENTION!  The password will not be encrypted by this authentication mode, it remains accessible when
the communication happens on HTTP.
For more details, see Basic Authentication section.
Encryption (HTTPS)
There is no encryption when the REST API communication happens via HTTP, because the HTTP protocol
is not encrypted. The REST API server is available via HTTPS on the 443 port. To avoid the data interception
(e.g. stealing the password) HTTP should be disabled and HTTPS protocol used instead.
ATTENTION!  Please ensure proper UCX time and date setting in UCX because it affects the self-signed
               

HTTPS does not guarantee that the communication is secure. Make sure that the client communicates with
the server directly, without any third-party element in the communication route (Man-in-the-middle attack).
For more details, see section.





Lightware UCX-4x2-HC30 Specifications

General

Category	Switch
HDMI Inputs	4
HDMI Outputs	2
USB Device Port	1
HDCP Support	HDCP 2.2
EDID Management	Yes
USB Host Ports	2
Video Resolutions	Up to 4K@60Hz
Max Resolution	4096x2160@60Hz
Audio	HDMI embedded audio
Control	RS-232, Ethernet, USB

Summary

Important Safety Instructions

Ventilation

Ensures proper airflow around the appliance to prevent overheating and proper operation. Avoid blocking ventilation holes.

Introduction

Features of the Device

Details the common features of the UCX series switchers, including support for 4K, Pixel Accurate Reclocking, and various control interfaces.

Model Comparison

Compares the different UCX models (UCX-2x1-HC30, UCX-2x2-H30, UCX-4x2-HC30, UCX-4x2-HC30D) across various interfaces and features.

Product Overview

Front View

Identifies and describes the connectors and indicators on the front panel of the UCX series switchers.

Rear View

Identifies and describes the connectors and indicators on the rear panel of the UCX series switchers.

Front Panel Control

Button Functionality

Explains the function of each button on the front panel for source selection, DHCP enabling, and factory reset.

Status LEDs

Details the meaning of the status LEDs on the front and rear panels, indicating video and USB signal status.

Installation

Electrical Connections

Provides detailed information on connecting HDMI, USB, Audio, Ethernet, RS-232, GPIO, and OCS ports.

Mounting Options

Describes how to mount the switcher using optional accessories like rack shelves and mounting plates.

Device Concept

The Autoselect Feature

Explains the automatic input selection feature for video and USB ports based on signal presence and priority.

Basic Network Security

Details network security features like disabling ports, authentication, and encryption to prevent unauthorized access.

Software Control - Lightware Device Controller

Install and Update

Guides on installing and updating the Lightware Device Controller (LDC) software on Windows, macOS, and Linux.

Establishing the Connection

Provides steps to connect the LDC software to the device via Ethernet, including adding favorite devices.

Video & Audio Crosspoint

Explains the interface for managing video and audio signal routing and crosspoint settings within the LDC software.

EDID Menu

Details the Advanced EDID Management function for configuring and emulating EDID data for input ports.

Lightware REST API Reference

System Commands

Lists and describes system-level commands for managing the device, such as setting labels, resetting, and querying firmware.

Video Port Settings - General

Covers commands for switching video inputs, locking/muting ports, and managing autoselect policies.

Network Security

Details commands for managing network security, including enabling/disabling ports, authentication, and service ports.

LW3 Programmers’ Reference

System Commands

Provides a summary of LW3 commands for system management, including device label, reset, and firmware version.

Video Port Settings - General

Details LW3 commands for managing video inputs, outputs, autoselect, and HDCP settings.

Audio Port Settings

Explains LW3 commands for controlling audio inputs, outputs, volume, balance, and mute functions.

Firmware Update

Preparation

Details the prerequisites for firmware updates, including LFP2 files and LDU2 software installation.

Updating Via GUI

Provides a step-by-step guide for updating device firmware using the Lightware Device Updater (LDU2) GUI.

If the Update is not successful

Offers solutions and troubleshooting steps if the firmware update process fails.

Troubleshooting

Use Case Studies

Presents common problems and their solutions related to video output, USB data transmission, and power delivery.

How to Speed Up the Troubleshooting Process?

Provides information to help users gather and provide data to Lightware support for faster issue resolution.

Technologies

EDID Management

Explains Extended Display Identification Data (EDID) and advanced management functions for system integration.

HDCP Management

Details how Lightware devices manage HDCP encryption and decryption for protected content.

Appendix

Specifications

Provides detailed technical specifications for the UCX series switchers, including dimensions, power, and port types.

Factory Default Settings

Lists the default factory settings for network, crosspoint, video, audio, USB, RS-232, GPIO, and OCS ports.

Firmware Release Notes

Summarizes the changes, new features, and known issues for different firmware versions.