background image

 

7. LW3 Programmers’ Reference

 

UCX series – User's Manual 

109

Applied firmware package: v1.2.0b9 | LDC software: v2.5.10b1

8.5. 

System Commands

8.5.1. 

Set the Device Label

INFO: 

The device label can be changed to a custom text in the 

Status 

tab of the LDC software.

Command and Response

 #devicelabel 

#label

 

ç

SET·/V1/MANAGEMENT/LABEL.DeviceLabel=

<custom_name>

 

æ

pw·/V1/MANAGEMENT/LABEL.DeviceLabel=

<custom_name>

The Device Label can be 49 character length and ASCII characters are allowed. Longer names are truncated.

Example

 

ç

SET /V1/MANAGEMENT/LABEL.DeviceLabel=UCX_Conference_room1

 

æ

pw /V1/MANAGEMENT/LABEL.DeviceLabel=UCX_Conference_room1

8.5.2. 

Reset the Device

The switcher can be restarted – the current connections will be terminated.

Command and Response

  #reboot #restart

 

ç

CALL·/V1/SYS:restart()

 

æ

mO·/V1/SYS:restart=

Example

 

ç

CALL /V1/SYS:restart()

 

æ

mO /V1/SYS:restart=

8.5.3. 

Restore the Factory Default Settings

Command and Response

 

ç

CALL·/V1/SYS:factoryDefaults()

 

æ

mO·/V1/SYS:factoryDefaults=

Example

 

ç

CALL /V1/SYS:factoryDefaults()

 

æ

mO /V1/SYS:factoryDefaults=

The device is restarted, current connections are terminated, and the default settings are restored. See the 

complete list in the 

Factory Default Settings

 section.

 #factory

8.5.4. Querying the Firmware Package Version

Command and Response

 #firmwareversion

 

ç

GET·/V1/MANAGEMENT/UID/PACKAGE.Version

 

æ

pr·/V1/MANAGEMENT/UID/PACKAGE.Version=

<firmware_version>

Example

 

ç

GET V1/MANAGEMENT/UID/PACKAGE.Version

 

æ

pr /V1/MANAGEMENT/UID/PACKAGE.Version=1.0.0b2

8.5.5. 

Control Lock

Enable/disable the operation of the front panel buttons.

Command and Response

 #lockbutton 

#buttonlock

 

ç

SET·/V1/MANAGEMENT/UI.ControlLock=

<lock_status>

 

æ

pw·/V1/MANAGEMENT/UI.ControlLock=

<lock_status>

Parameters

Parameter

Parameter description

Values

Value description

<lock_status>

Front panel button 

locking status

None

All functions of the front panel button are enabled.

Locked

The front panel buttons are locked and can be unlocked 

by button combination (

Control Lock

).

Force 

locked

The front panel buttons are locked and cannot be 

unlocked by button combination, only in LDC (on the 

Status 

tab) or using the LW3 command.

Example

 

ç

SET /V1/MANAGEMENT/UI.ControlLock=force locked

 

æ

pw /V1/MANAGEMENT/UI.ControlLock=force locked

8.5.6. 

Set Current Time

Command and Response

 #time

 

ç

CALL·/V1/MANAGEMENT/DATETIME:setTime(

<current_time>

)

 

æ

mO·/V1/MANAGEMENT/DATETIME:setTime=

Parameters

<current_time>: 

 The new router time in ISO 8601 date time format.

Example

 

ç

CALL /V1/MANAGEMENT/DATETIME:setTime(2020-11-01T04:39:54.000Z)

 

æ

mO /V1/MANAGEMENT/DATETIME:setTime=

 

Summary of Contents for UCX-2x1-HC30

Page 1: ...UCX 2x1 HC30 UCX 2x2 H30 UCX 4x2 HC30 UCX 4x2 HC30D User s Manual Universal Switcher v1 5 02 07 2021...

Page 2: ...structions The apparatus shall not be exposed to dripping or splashing and that no objects filled with liquids such as vases shall be placed on the apparatus No naked flame sources such as lighted can...

Page 3: ...Device Controller LDC software 2 5 10b1 Lightware Device Updater V2 LDU2 software v2 10 1b6 Firmware package 1 2 0b9 Hardware 2 2 Document revision 1 5 Release date 02 07 2020 Editor Judit Barsony Ab...

Page 4: ...Audio Interface 37 5 5 1 Analog Audio Interface 37 5 5 2 Dante Audio Interface 37 5 6 Ethernet Interface 39 5 7 Basic Network Security 40 5 7 1 Disable Ethernet Ports 40 5 7 2 HTTP HTTPS 40 5 7 3 Encr...

Page 5: ...ut 86 7 10 2 Query the Connected Source 86 7 10 3 Query the Connected Destinations 86 7 10 4 Lock the USB Port 86 7 10 5 Setting the 5V Sending to the USB Peripherals 87 7 10 6 Set the USB Autoselect...

Page 6: ...el Settings by Steps dB 118 8 9 14 Analog Audio Output Level Settings by Steps in Percent 118 8 9 15 Analog Audio Output Balance by Steps 118 8 10 USB Port Settings 118 8 10 1 Switch USB Input 118 8 1...

Page 7: ...te is not successful 144 10 TROUBLESHOOTING 145 10 1 Use Case Studies 146 10 2 How to Speed Up the Troubleshooting Process 147 11 TECHNOLOGIES 148 11 1 EDID Management 149 11 1 1 Understanding the EDI...

Page 8: ...uction Thank you for choosing Lightware s The Taurus UCX series devices In the first chapter we would like to introduce the device highlighting the most important features in the below listed sections...

Page 9: ...ding feature as well as support for DANTE AES67 network connection to send DANTE AES67 audio stream directly to a dedicated audio system See more details in the Dante Audio Interface section Dante is...

Page 10: ...simultaneous TCP IP connections are available with a simple ASCII based protocol for controlling configuring the product or perform a firmware update LWR Basic IT security new These entry level networ...

Page 11: ...erface OCS Interface Inputs Outputs USB C 3 1 Gen1 5 Gbps HDMI HDMI Analog audio de embedding USB A 3 1 Gen1 5 Gbps USB B 3 1 Gen1 5 Gbps Secure Control Ethernet Utility Ethernet Configurable Ethernet...

Page 12: ...1 Introduction UCX series User s Manual 12 Applied firmware package v1 2 0b9 LDC software v2 5 10b1 1 6 Typical Application UCX 4x2 HC30 Example 1 UCX 4x2 HC30 Example 2...

Page 13: ...eries User s Manual 13 Applied firmware package v1 2 0b9 LDC software v2 5 10b1 2 Product Overview The following sections are about the physical structure of the device input output ports and connecto...

Page 14: ...te 4 USB C Ports Displayport1 2andUSB3 1Gen1connections AVsignalcanbetransferred up to a resolution of 4K 60Hz 4 4 4 and data speeds up to 5 Gbps with remote charging The applied cable shall not be lo...

Page 15: ...connector for balanced analog audio output signal The signal is de embedded from the selected video signal 6 RS 232 port 3 pole Phoenix connector for bi directional RS 232 communication new 7 OCS sen...

Page 16: ...series User s Manual 16 Applied firmware package v1 2 0b9 LDC software v2 5 10b1 3 Front Panel Control The following sections are about front panel operation of the device and the status LEDs Button...

Page 17: ...UT SELECT OUT1 VIDEO AUDIO OUT OUT 2 OUT 1 VIDEO INPUT SELECT RESET 5 sec AUDIO OUT OUT 2 HDMI INPUT SELECT OUT1 VIDEO AUDIO OUT OUT 2 OUT 1 VIDEO INPUT SELECT 3x 3 1 Button Functionality INFO If the...

Page 18: ...nable front panel buttons front panel LEDs blink 4 times when locking unlocking If the control lock is enabled and a button is pressed front panel LEDs blink 3 times quickly AUDIO OUT OUT 2 HDMI INPUT...

Page 19: ...tion Off Not linked On Solid No activity Blinking Activity LED state Right LED Function Off 0 Mbit s On Solid 100 Mbit s 3 2 4 Dante Audio Out in UCX 4x2 HC30D model DIFFERENCE UCX 4x2 HC30D model has...

Page 20: ...UCX series User s Manual 20 Applied firmware package v1 2 0b9 LDC software v2 5 10b1 4 Installation Mounting Options Electrical Connections Powering Options Power Delivery USB C Cable Recommendation C...

Page 21: ...Using different e g longer ones may cause damage to the device 4 1 1 1U High Rack Shelf Allows rack mounting for half rack quarter rack and pocket sized units 1U high rack shelf provides mounting hole...

Page 22: ...e local hardware store 2x4pcs M3 M5 metric or wood screws needed M3 size is recommended ATTENTION To ensure the correct ventilation and avoid overheating insert the switcher face down to the UD Mounti...

Page 23: ...ata speed B type port for connecting USB hosts INFO Blue color inside the connector refers to the USB 3 0 data speed GND RX2 RX2 VBUS sBU1 D D CC VBUS TX1 TX1 GND GND TX2 TX2 VBUS CC sBU2 VBUS RX1 RX1...

Page 24: ...kOhm external resistor between the 1st and the 3rd pins is necessary Compatible Plug Type WR TBL series 3 81mm 3 pole 90 Reversed Gender Plug Phoenix type WR TBL Series 3483 3 81 mm ATTENTION Occupanc...

Page 25: ...3A Supported power profiles 5V 3A 9V 3A 15V 2A 20V 1 5A INFO Selecting the appropriate power profile happens automatically no manual intervention required Remote Powering via USB A Ports D1 D4 5V outp...

Page 26: ...al Role Power With USB C the connector is the same on all products Laptops certain tablets and smartphones can be both a charger and a charged device not simultaneously Source Sink defines the power r...

Page 27: ...the Utility Ethernet port to access the internet or local network USB USB Type A Optionally connect the USB device e g Speaker phone USB Type B Optionally connect the USB host e g PC HDMI Connect an...

Page 28: ...e following chapter describes the features of the device with a few real life examples Universal Switcher Concept USB Interface Video Interface The Autoselect Feature Audio Interface Ethernet Interfac...

Page 29: ...ge provides Ethernet connection over the USB C connector This function uses the High speed channels For more details see USB Port Diagram UCX 4x2 HC30D and Ethernet Interface section INFO USB 2 x and...

Page 30: ...B and USB C connectors also have high speed data lines besides Superspeed The built in USB Ethernet bridge provides Ethernet for the USB C connection It is still available while the USB 3 1 Gen1 data...

Page 31: ...mbedded audio signal to the Taurus HDMI input I3 The switcher forwards analog audio to the active speakers and digital video to the HDMI display Settings Step 1 In the Crosspoint menu USB tab switch t...

Page 32: ...ternate Mode USB C sources sends Displayport signal for video transmission Displayport Alternate mode allows using the USB C cable instead of DisplayPort cable for DP video signals The standard uses t...

Page 33: ...sending LW3 protocol command or using the Autoselect function There are three Autoselect policy as follows Disable autoselect First detect Last detect Follow video in case of USB and audio ports INFO...

Page 34: ...itor 1 and Monitor 2 O1 and O2 when it is powered on and no BYOD device is connected BYOD laptop 1 I1 is displayed on Monitor 1 O1 and BYOD device 2 I2 can be seen on Monitor 2 when they are connected...

Page 35: ...d Displayport or one USB cable USB B or USB C for data and one HDMI cable for video can be used The Taurus UCX series device will switch both USB and video layers accordingly Cable cubby for BYOD 1 ha...

Page 36: ...p uses USB C for video and data and USB C for data The individual input settings are the following Video O1 Last detect I1 priority 1 I2 disabled I3 priority 1 I4 disabled I5 priority 2 ATTENTION Take...

Page 37: ...n refers to the UCX 4x2 HC30D model UCX 4x2 HC30D model contains a special module that allows de embedding the audio stream of the incoming HDMI signal and transmitting as a 2 channel Dante or AES67 s...

Page 38: ...oftware Device Settings The discovered Dante compatible devices are displayed with middle blue color Double click on the name to open the device settings The default device name is UCX D Dante_MAC_add...

Page 39: ...bridge provides Ethernet for the USB C connection It is still available while the USB 3 1 Gen1 data channels are reserved for video or USB data transmission as it uses the USB 2 0 layer System Requir...

Page 40: ...via a network switch firewall for a proper working between the device and the softwares ATTENTION Be careful when combining the security functions improper settings may cause malfunction 5 7 1 Disable...

Page 41: ...transferred information HTTP request response To ensure the secure data transmission the HTTP port 80 can be disabled and the all the information can be transferred via HTTPS 443 port HTTPS protocol e...

Page 42: ...nly with protocol commands The setting is available with the following ways Lightware REST API HTTP posts see the details in Enable Disable Network Service Port section LW3 protocol commands see the d...

Page 43: ...pcs connected clients at the same time for each serial port Ethernet RS 232 Local serial TCP converter Message Sending Function Message sending function allows RS 232 command sending to a third party...

Page 44: ...ript does not need to use the unsecured ports for GPIO management ATTENTION Please always check the electrical parameters of the devices what you want to control The maximum current of one GPIO pin is...

Page 45: ...by a computer through Ethernet by the Lightware Device Controller LDC The software can be installed on a Windows PC or macOS The application and the User s Manual can be downloaded from www lightware...

Page 46: ...te and opens the update window if LDC updates are found The current and the update version number can be seen at the top of the window and they are shown in this window even with the snapshot install...

Page 47: ...5 5 LDC version Press the Add button in the appearing window you can enter the IP address The hostname of the desired device can be used instead if it is supported That allows setting a unique name t...

Page 48: ...4 LDC Layout ATTENTION Up to the v1 0 1b1 firmware version and v2 5 3b3 LDC version the older LDC layout can be seen From the 1 1 0b7 firmware version and v2 5 4b3 LDC the LDC design changed as it is...

Page 49: ...Audio Input 6 Audio output port Analog audio output port clicking on the O3 tile opens the Analog Audio Output window The de embedded audio is mirrored to the Dante Audio Output in case of UCX 4x2 HC3...

Page 50: ...of the port signal Icon is grey Description Icon is highlighted Description Port is unmuted Port is muted Port is unlocked Port is locked Signal is not encrypted with HDCP 2 2 Signal is encrypted with...

Page 51: ...x length 63 characters Lock lock unlock The port can be locked to the currently connected output ports by putting the tick If the port is locked the crosspoint state of this port cannot be changed Mut...

Page 52: ...this port cannot be changed Mute mute unmute The incoming signal can be muted unmuted by putting a tick If the port is muted no signal is transmitted from the input port HDP Mode Hot Plug Detection f...

Page 53: ...d BYOD devices supporting USB3 x usually choose shared mode USB3 1 and 2 lane DP Prefer video Uses 4 Lanes for Displayport video in this case USB 3 x data transmission does not operate Prefer USB 3 1...

Page 54: ...d output ports by putting the tick If the port is locked the crosspoint state of this port cannot be changed INFO When the locked input was switched to the output the crosspoint state can not be chang...

Page 55: ...ting the tick If the port is locked the crosspoint state of this port cannot be changed Mute mute unmute The incoming signal can be muted unmuted by putting a tick If the port is muted no signal is tr...

Page 56: ...lick on the Apply autoselect settings button after the changes to launch the new settings See more details about the feature in The Autoselect Feature section 6 6 5 Embedded Audio Input Port propertie...

Page 57: ...rmation about the signal like full size and active video resolution This feature is a good troubleshooter if compatibility problems occur during system installation To access this function open the po...

Page 58: ...usb usbc 6 7 1 USB C Port Properties Available settings and tools General Port name The name of a port can be changed by typing the new name and clicking on the Set button The following characters are...

Page 59: ...n does not happen depending on the connected device INFO Using Dual role setting is highly recommended the other options are mainly for troubleshooting Source When the connected device is a sink e g s...

Page 60: ...locked the crosspoint state of this port cannot be changed Autoselect autoselect usbautoselect For more details about this feature see Autoselect section Autoselect settings Disable autoselect Follow...

Page 61: ...e the emulated EDID Learning an EDID The process is the same as changing the emulated EDID the only difference is the Destination panel press the User button Thus one or more EDIDs can be copied into...

Page 62: ...anced EDID Editor window The editor can read and write all descriptors which are defined in the standards including the additional CEA extensions Any EDID from the device s memory or a saved EDID file...

Page 63: ...low Source panel Easy EDID Creator is opened in a new window For more details about EDID Editor please visit our website www lightware com and download the EDID Editor Application note EDID Creator Wi...

Page 64: ...2 Interval Interval section is designed for setting the chosen GPIO pin to the specified level for a specified time Configure the Duration time and the Logic level of the desired value Confirm by clic...

Page 65: ...0 Settings Menu 6 10 1 Status DIFFERENCE The dark mode identify me and control lock features are available only from FW package 1 2 0 devicelabel label producttype firmwareversion status serialnumber...

Page 66: ...red via HTTPS 443 port 80 or 443 port is necessary to upload download WelcomeScreen image a UserScripts log and clone files so one of them should be opened to reach these functions ATTENTION Please en...

Page 67: ...ading another script or disable this function Click Upload File to browse a zipped file It will replace the previous one Clone configuration DIFFERENCE This feature is available only from FW package 1...

Page 68: ...starts with character received response starts with character The color of each item depends on the type of the command and response The content of the window can be emptied by the Clear button If the...

Page 69: ...ilable from 1 2 0 firmware package new Instructions for the Terminal Application Usage Protocol Rules REST API Security System Commands Video Port Settings General Welcome Screen Settings Video Port S...

Page 70: ...or more details see Lightware REST API vs LW3 Protocol section Lightware devices can be controlled with LW3 protocol commands for more details see LW3 Programmers Reference LW3 protocol consist of rea...

Page 71: ...T API communication in a command line window GET Command Example Query the Signal Presence curl i X GET ip api NodePath PropertyName C Users Juca curl i X GET http 192 168 0 55 api V1 MEDIA VIDEO XP I...

Page 72: ...in Mozilla Method POST URL http 192 168 0 55 api V1 MEDIA VIDEO XP switch Body content type text plain Body I2 O1 7 3 2 General Rules All names and parameters are case insensitive The methods nodes a...

Page 73: ...e read only eg pr V1 MEDIA VIDEO I5 Connected and read write properties pw V1 MEDIA VIDEO I5 Name can be listed For more details about LW3 tree structure see LW3 Programmers Reference section or Advan...

Page 74: ...thentication and Encryption Both of them are optional and can be used independently from each other 7 4 1 Authentication Basic access authentication is designed to limit user access for the REST API s...

Page 75: ...plain header 200 OK Example header POST http 192 168 0 50 api V1 SYS factoryDefaults HTTP 1 1 header 200 OK The device is restarted current connections are terminated and the default settings are rest...

Page 76: ...the RJ45 connectors Ethernet and TPS in darkmode Request and Response header POST http ip api V1 MANAGEMENT UI DARKMODE Enable HTTP 1 1 body mode_state header 200 OK body mode_state Parameters If the...

Page 77: ...POST http 192 168 0 50 api V1 MEDIA VIDEO XP switch HTTP 1 1 body I1 O1 header 405 Method Not Allowed 7 6 2 Switch an Input to All Outputs Request and Response header POST http ip api V1 MEDIA VIDEO X...

Page 78: ...OK body out1 out1 Example header GET http 192 168 0 50 api V1 MEDIA VIDEO XP I3 ConnectedDestinations HTTP 1 1 header 200 OK body O1 O2 7 6 5 Set the Autoselect Policy Request and Response header POST...

Page 79: ...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 compl...

Page 80: ...s muted or not true The embedded audio is muted false The embedded audio is unmuted Example header POST http 192 168 0 50 api V1 MEDIA VIDEO O1 EmbeddedAudioMute HTTP 1 1 body false header 200 OK body...

Page 81: ...escription text_state true false The welcome screen text is displayed The welcome screen text is not displayed Example header POSThttp 192 168 0 50 api V1 MEDIA VIDEO I5 WELCOMESCREEN MessageEnabled H...

Page 82: ...ll be disconnected and no signal will appear on the output ATTENTION When I5 is selected for video source the de embedded audio of the I1 is not available because the video crosspoint has a limitation...

Page 83: ...00 OK body locked_state Parameters Parameter Parameter description Values Value description audio_port Audio Port I1 I4 O3 Audio input port number Audio output port number locked_state Locked state tr...

Page 84: ...io output port number signal_state Signal presence true false The audio signal is present No audio signal is present Example header GET http 192 168 0 50 api V1 MEDIA AUDIO I1 SignalPresent HTTP 1 1 h...

Page 85: ...step value in dB Example header POST http 192 168 0 50 api V1 MEDIA AUDIO O3 stepVolumedB HTTP 1 1 body 1 header 200 OK body OK The volume is decreased with 1 dB the current volume is 1 95 dB which m...

Page 86: ...cription host USB Host U1 U4 USB C and USB B port number Example header GET http 192 168 0 50 api V1 MEDIA USB XP H1 ConnectedSource HTTP 1 1 header 200 OK body U4 7 10 3 Query the Connected Destinati...

Page 87: ...is disabled Last Detect Always the last attached input is switched to the output automatically First Detect The first active USB input is selected Follow video Follows the video crosspoint state auto...

Page 88: ...put power on the two ports 30W each Port1 maximum Port2 minimum 60W for U1 Port1 minimum Port2 maximum 60W for U2 Example header POST http 192 168 0 50 api V1 SYS MB USBCPOWER PowerLimit HTTP 1 1 body...

Page 89: ...tive Example header GET http 192 168 0 50 api V1 MEDIA USB U2 ActiveAltMode HTTP 1 1 header 200 OK body DP 7 11 5 Query the Port Data Role Request and Response header GET http ip api V1 MEDIA USB usb...

Page 90: ...cription source Source EDID memory place F1 F120 Factory EDIDs U1 U14 User EDIDs D1 D2 Dynamic EDIDs Example header GET http 192 168 0 50 api V1 EDID EdidStatus HTTP 1 1 header 200 OK body F47 E1 F47...

Page 91: ...ce EDID memory place F1 F148 Factory EDIDs U1 U100 User EDIDs D1 D2 Dynamic EDIDs Example header POST http 192 168 0 50 api V1 EDID switchAll HTTP 1 1 body F47 header 200 OK body OK 7 12 6 Copy an EDI...

Page 92: ...y dhcp_status header 200 OK body dhcp_status Parameters If the dhcp_status parameter is true the current IP address setting is DHCP if the parameter is false the current IP address is static Example h...

Page 93: ...rrent setting can be queried by using the GET command 7 13 5 Apply Network Settings Request and Response header POST http ip api V1 MANAGEMENT NETWORK applySettings HTTP 1 1 INFO The body has to be em...

Page 94: ...tion Parameter values port Port type HTTP HTTPS LW3 SERIAL1 SERIAL2 port_num Port number 80 443 6107 8001 8002 Example header GET http 192 168 0 50 api V1 MANAGEMENT NETWORK SERVICES HTTP Port HTTP 1...

Page 95: ...ngth 100 accepted characters a z A Z 0 9 Example header POSThttp 192 168 0 50 api V1 MANAGEMENT NETWORK AUTH USER1 setPassword HTTP 1 1 body password header 200 OK body password 7 14 6 Enable Authenti...

Page 96: ...meters Identifier Parameter description Parameter values serial_port Serial port number P1 P2 stopbits Stop bit value 1 2 The UCX 2x1 HC30 model has one serial port P1 Example header POST http 192 168...

Page 97: ...body state header 200 OK body state Parameters Identifier Parameter description Parameter values serial_port Serial port number P1 P2 state true false The UCX 2x1 HC30 model has one serial port P1 Ex...

Page 98: ...high level Low low level Example header POST http 192 168 0 50 api V1 MEDIA GPIO P1 Output HTTP 1 1 body High header 200 OK body High 7 17 3 Setting the Output Level for a Specified Time Request and R...

Page 99: ...ensor_type It defines that the low or high input level means the occupancy Active low Occupancy status is Occupied when the input level is low Active high Occupancy status is Occupied when the input l...

Page 100: ...eader POST http ip api V1 MEDIA VIDEO XP port Lock HTTP 1 1 body locked_state Mute the Video Port header POST http ip api V1 MEDIA VIDEO XP port Mute HTTP 1 1 body muted_state Set the Autoselect Polic...

Page 101: ...lect header POST http ip api V1 MEDIA AUDIO AUTOSELECT O3 VideoFollowPort HTTP 1 1 body out Lock the Audio Port header POST http ip api V1 MEDIA AUDIO XP audio_port Lock HTTP 1 1 body locked_state Mut...

Page 102: ...ort ActiveAltMode HTTP 1 1 Query the Port Data Role header GET http ip api V1 MEDIA USB usb c_port ActivePortDataRole HTTP 1 1 Query the Port Power Role header GET http ip api V1 MEDIA USB usb c_port...

Page 103: ...port Baudrate HTTP 1 1 body baudrate Stop Bits Setting header POST http ip api V1 MEDIA SERIAL serial_port StopBits HTTP 1 1 body stopbits Query Data Bits header GET http ip api V1 MEDIA SERIAL serial...

Page 104: ...Overview Instructions for the Terminal Application Usage Instructions for the Websocket WS or Secured Websocket WSS Usage Protocol Rules System Commands Video Port Settings General Welcome Screen Sett...

Page 105: ...the IP address of the device default DHCP and the port number 6107 Step 4 Select the Raw connection type and open the connection Once the terminal window is opened you can enter the LW3 protocol comma...

Page 106: ...nes have to be closed by Carriage Return and Line Feed CrLf It can manage 18 connected clients simultaneously for WS 80 WSS 443 and LW3 6107 ports in total CALL V1 MEDIA VIDEO XP switch I1 O2 mO V1 ME...

Page 107: ...O1 Output5VMode pm V1 MEDIA VIDEO O1 Output5VMode On Auto Off Enables disables power 5V output 8 4 5 Prefix Summary DEFINITION The prefix is a 2 character long code that describes the type of the res...

Page 108: ...ions Hence if the connection is terminated all registered subscriptions are deleted After reopening a connection all subscribe commands have to be sent in order to get the notifications of the changes...

Page 109: ...Factory Default Settings section factory 8 5 4 Querying the Firmware Package Version Command and Response firmwareversion GET V1 MANAGEMENT UID PACKAGE Version pr V1 MANAGEMENT UID PACKAGE Version fir...

Page 110: ...onse SET V1 MANAGEMENT UI DARKMODE Delay delay_time pw V1 MANAGEMENT UI DARKMODE Delay delay_time Parameters The delay_time parameter means seconds and the default value is 60 If set to 0 no delay is...

Page 111: ...elect Policy Command and Response SET V1 MEDIA VIDEO AUTOSELECT out Policy autoselect_mode pw V1 MEDIA VIDEO AUTOSELECT out Policy autoselect_mode Parameters Parameter Parameter description Values Val...

Page 112: ...Example GET V1 MEDIA VIDEO XP I3 ConnectedDestinations pr V1 MEDIA VIDEO XP I3 ConnectedDestinations O1 O2 8 6 10 Query the Input Switching Capability Video crosspoint has a limitation I1 or I5 ports...

Page 113: ...Command and Response hdcp SET V1 MEDIA VIDEO out HdcpMode hdcp_mode pw V1 MEDIA VIDEO out HdcpMode hdcp_mode Parameters Parameter Parameter description Values Value description hdcp_mode HDCP encrypti...

Page 114: ...MEDIA VIDEO I5 WELCOMESCREEN ImageEnabled image_state pw V1 MEDIA VIDEO I5 WELCOMESCREEN ImageEnabled image_state Parameters Parameter Parameter description Values Value description image_state true...

Page 115: ...ponse CALL V1 MEDIA AUDIO XP switch audio_in O3 mO V1 MEDIA AUDIO XP switch Parameters Parameter Parameter description Values Value description audio_in Audio input port I1 I4 Audio input port number...

Page 116: ...ommand and Response SET V1 MEDIA AUDIO AUTOSELECT O3 VideoFollowPort out pw V1 MEDIA AUDIO AUTOSELECT O3 VideoFollowPort out Example SET V1 MEDIA AUDIO AUTOSELECT O3 VideoFollowPort O1 pw V1 MEDIA AUD...

Page 117: ...o output port number signal_state Signal presence true false The audio signal is present No audio signal is present Example GET V1 MEDIA AUDIO I1 SignalPresent pr V1 MEDIA AUDIO I1 SignalPresent false...

Page 118: ...volume is 1 52 dB which means 82 84 in percent 8 9 15 Analog Audio Output Balance by Steps Command and Response CALL V1 MEDIA AUDIO O3 stepBalance step m0 V1 MEDIA AUDIO O3 stepBalance Parameters The...

Page 119: ...Parameters Parameter Parameter description Values Value description usb_port USB Port U1 U4 H1 USB C and USB B port number USB hub locked_state Locked state true false The port is locked The port is...

Page 120: ...1 MEDIA USB AUTOSELECT H1 VideoFollowPort O1 8 10 8 Change the Autoselect Included USB Ports DIFFERENCE This command is available only from FW package 1 1 0b7 Command and Response SET V1 MEDIA USB AUT...

Page 121: ...USB3 1 and 2 lane DP Prefer video all the four lanes reserved for video transmission USB 3 1 data transmission does not operate Prefer USB 3 1 2 lanes are reserved for USB 3 1 2 lanes for video Exampl...

Page 122: ...T V1 MEDIA USB usb_port ActivePortPowerRole pr V1 MEDIA USB usb_port ActivePortPowerRole power_role Parameters Parameter Parameter description Values Value description usb c_port USB C port number U1...

Page 123: ...valid EDID is stored in D1 memory place 8 12 3 Query the Preferred Resolution of a User EDID Command and Response GET V1 EDID U user_edid PreferredResolution pr V1 EDID U user_edid PreferredResolutio...

Page 124: ...py 8 12 7 Deleting an EDID from User Memory Command and Response CALL V1 EDID delete user_edid mO V1 EDID delete Parameters Parameter Parameter description Values Value description user_edid The emula...

Page 125: ...Settings mO V1 MANAGEMENT NETWORK applySettings INFO The applySettings method will save and apply the new value and results the device to reboot INFO The current setting can be queried by using the GE...

Page 126: ...pw V1 MEDIA ETHERNET ethernet_port Enabled status Parameters Identifier Parameter description Parameter values ethernet_port Ethernet port number P1 P5 status The port is enabled The port is disabled...

Page 127: ...d password mO V1 MANAGEMENT NETWORK AUTH USER1 setPassword 8 14 6 Enable Authentication DIFFERENCE This command is available from 1 2 0 firmware package INFO Set the password before enable the authent...

Page 128: ...ters Identifier Parameter description Parameter values serial_port Serial port number P1 P2 stopbits Stop bit value 1 2 The UCX 2x1 HC30 model has one serial port P1 Example SET V1 MEDIA SERIAL P1 Sto...

Page 129: ...ing a Message via RS 232 ATTENTION Serial message sending is implemented only via Lightware REST API This function is not available with LW3 protocol command For more details see Serial Port Messaging...

Page 130: ...d Response CALL V1 MEDIA GPIO port toggle mO V1 MEDIA GPIO port toggle Example CALL V1 MEDIA GPIO P1 toggle mO V1 MEDIA GPIO P1 toggle 8 18 OCS Port Configuration DIFFERENCE Occupancy sensor related c...

Page 131: ...arameters Parameter Parameter description Value Value description status It reports the occupancy state of the room depending on the sensor type Free When the SensorType Active high and the Inputlevel...

Page 132: ...te Set the Autoselect Policy SET V1 MEDIA VIDEO AUTOSELECT out Policy autoselect_mode Change the Autoselect Included Input Ports SET V1 MEDIA VIDEO AUTOSELECT out in Included state Change the Input Po...

Page 133: ...V1 MEDIA AUDIO O3 Balance level Analog Audio Output Level Settings by Steps dB CALL V1 MEDIA AUDIO O3 stepVolumedB step Analog Audio Output Level Settings by Steps in Percent CALL V1 MEDIA AUDIO O3 st...

Page 134: ...V1 MANAGEMENT NETWORK StaticNetworkMask netmask Change the Gateway Address Static SET V1 MANAGEMENT NETWORK StaticGatewayAddress gw_address Apply Network Settings CALL V1 MANAGEMENT NETWORK applySett...

Page 135: ...GPIO Pin SET V1 MEDIA GPIO port Direction dir Querying the Output Level of a GPIO Pin GET V1 MEDIA GPIO port Output Setting the Output Level of a GPIO Pin SET V1 MEDIA GPIO port Output value Setting t...

Page 136: ...rmware updates on our products by giving a few tips on how to start and by explaining the features of the Lightware Device Updater v2 LDU2 software To get the latest software and firmware pack can be...

Page 137: ...Installation ATTENTION Minimum system requirement 2 GB RAM INFO The Windows and the Mac application has the same look and functionality Download the software from www lightware com downloads Installa...

Page 138: ...firmware package button the release notes of the LFP2 file will be displayed in the right panel see the Step 1 Select the Firmware Package section Device List When the discovery has completed the dev...

Page 139: ...mode Backup and restore cannot be performed in this case 9 4 Updating Via GUI To update the desired device s via the Graphical User Interface follow these steps ATTENTION While the firmware is being...

Page 140: ...s shown in percent in the right side of the device line and the overall process in the bottom progress bar The device might reboot during the firmware update procedure START UPDATE When the progress b...

Page 141: ...te bash LightwareDeviceUpdaterV2 sh update ip 172 24 5 27 package Downloads taurus_ v1 2 0b9 lfp2 The commands and options are the same under Windows and Linux too Following sections contain examples...

Page 142: ...tware Device Updater V2 LightwareDeviceUpdaterV2_CLI cmd deviceInfo ip 192 168 1 7 packageVersion C Program Files x86 Lightware Lightware Device Updater V2 lib jre bin java exe jar lib ldu2 jar device...

Page 143: ...192 168 0 52 Uploading firmware package 2021 06 17 08 53 16 108 INFO ProgressReporter Progress 2 The lines containing ProgressReporter can be enabled optionally If it is enabled the current state is...

Page 144: ...sconnected from the device Please wait while the device completes the update 2021 07 01 08 37 20 194 INFO 192 168 0 52 Done All 1 update s finished successfully 9 6 8 Exit Codes There is a return valu...

Page 145: ...check signal integrity through the whole signal chain starting from source side and moving forward to receiver end At first check front panel LEDs and take the necessary steps according to their state...

Page 146: ...ate is set 1 10 The source sends 4K signals but the emulated EDID is not supported this resolution Check the emulated EDID and select another e g F139 EDID on the input port 6 8 1 LW3 8 12 4 Symptom R...

Page 147: ...tly consult with the hardware or software engineer who designed the product to get the information from the most reliable source However the troubleshooting process can be even faster with your help T...

Page 148: ...s Thefollowingsectionscontaindescriptionsandusefultechnicalinformationhowthedevicesworkinthebackground The content is based on experiences and cases we met in the practice These sections help to under...

Page 149: ...later they do not sense that EDID has been changed You need to restart your source to make it read out the EDID again 11 1 2 Advanced EDID Management Each DVI sink e g monitors projectors plasma disp...

Page 150: ...troduced the HDCP enabling disabling function the HDCP capability can be disabled in the Lightware device If HDCP is disabled the connected source will detect that the sink is not HDCP capable and tur...

Page 151: ...v2 2 Source and HDCP v1 4 Sink In this case the signal of an HDCP v2 2 compliant source is switched to an HDCP v1 4 compliant sink device The signal is encrypted with HDCP v2 2 on the input and encryp...

Page 152: ...uit eliminates the following errors Intra pair skew Skew between the and wires within a differential wire pair e g Data2 and Data2 It s caused by different wire lengths or slightly different wire cons...

Page 153: ...12 Appendix Tables drawings guides technical details and hashtag keyword list as follows Specifications Port Numbering Factory EDID List Cable Wiring Guide Mechanical Drawings Factory Default Setting...

Page 154: ...9 59 W x 5 57 D x 1 01 H Weight UCX 2x1 HC30 890 g Weight UCX 2x2 H30 625 g Weight UCX 4x2 HC30 700 g UCX 4x2 HC30D Enclosure material 1 mm steel Dimensions in mm 271 W x 150 D x 26 H Dimensions in in...

Page 155: ...tor Audio formats 2 ch PCM Sampling frequency 48 kHz Volume 95 62 dB 0 dB Balance 100 100 0 center Dante Audio Output Port Connector type RJ45 female connector Signal transmission Dante or AES67 Suppo...

Page 156: ...e Feature UCX 2x1 HC30 UCX 2x2 H30 UCX 4x2 HC30 UCX 4x2 HC30D v1 2 0bx Supports UCX 2x1 HC30 and UCX 2x2 H30 models Bi directional RS 232 Authentication Https WSS support Lightware REST API Identify m...

Page 157: ...s Port name USB port nr LW3 Upstream Facing Ports USB C Host 1 U1 USB C Host 2 U2 USB B Host 3 U3 USB B Host 4 U4 USB Hub Downstream Port USB hub H1 USB Device 1 D1 USB Device 2 D2 USB Device 3 D3 USB...

Page 158: ...1024 75 02 Hz H F104 1600 x 1200 50 00 Hz H F105 1600 x 1200 60 00 Hz H F106 1920 x 1200 59 56 Hz H F107 2560 x 1440 59 95 Hz H F108 2560 x 1600 59 86 Hz H F109 3840 x 2400 24 00 Hz H F110 3840 x 216...

Page 159: ...hoenix connectors so we would like to help users assembling their own audio cables See the most common cases below ATTENTION Symmetric and asymmetric lines can be linked with passive accessories e g s...

Page 160: ...software v2 5 10b1 12 5 Mechanical Drawings INFO UCX 2x1 HC30 UCX 2x2 H30 UCX 4x2 HC30 models have the same size Dimensions are in mm UCX 2x1 HC30 UCX 2x2 H30 UCX 4x2 HC30 models 26 246 150 140 3 87...

Page 161: ...12 Appendix UCX series User s Manual 161 Applied firmware package v1 2 0b9 LDC software v2 5 10b1 UCX 4x2 HC30D model 140 3 26 150 271 87 53 3 178 5 21 25 Mounting hole Mounting hole...

Page 162: ...0 UCX 2x2 H30 I1 I2 HDCP 2 2 HDCP mode out Auto Power 5V Enable On Emulated EDID on all four inputs Factory 47 Universal HDMI PCM Analog audio output port settings Volume 0 00 dB 100 Balance 0 center...

Page 163: ...ing properties can be set to On or Off mode V1 MEDIA VIDEO O1 Output5VMode V1 MEDIA VIDEO O2 Output5VMode Auto mode will be available in a future release Ethernet port P5 is counting TX Ethernet packe...

Page 164: ...connected device sourcing the Vconn and avoiding this issue Properties in SYS node may change in future releases HPDsignalisactivatedwithupto100msdelaycomparedtothe5Vsignal Thismightcausecompatibilit...

Page 165: ...rosspoint Crosspoint switch setting devicelabel Device label dhcp Dynamic IP address DHCP setting diagnostic Failure diagnostic related tool information displayportalternatemode Displayport Alternate...

Page 166: ...o any product that has been 2 1 Modified repaired or altered by anyone other than a certified Lightware engineer unless expressly agreed beforehand 2 2 Used in any application other than that for whic...

Page 167: ...2021 Lightware Visual Engineering All rights reserved All trademarks mentioned are the property of their respective owners Specifications subject to change without notice...

Reviews: