9. Programmer's Reference
UBEX series – Matrix Application Mode – User's Manual
106
9. Programmer's Reference
UBEX series – Matrix Application Mode – User's Manual
106
MA
TRIX APPLIC
A
TION MODE
Applied F-series endpoint firmware package: v1.4.1 | Applied R-series endpoint firmware package: v1.4.1 | Applied MMU firmware package: v1.2.1 | LDC software: v1.34.0b2
9.3. The Tree Structure of the UBEX Matrix
When the UBEX matrix builds up and starts to operate, the individual
endpoints and the MMU cease to be individual devices, but the whole
system becomes one big tree structure including all UBEX devices
which are the part of the matrix.
When you connect one of endpoints you always will reach the LW3
tree of the MMU. The endpoints can be controlled over the MMU only.
9.3.1. The Tree Structure of the MMU
9.3.2. Endpoint ID Calculation
The endpoint devices of the matrix are listed under the
/SYS/ENDPOINTS node by the MAC address. The formula is the
following:
MAC address of the
endpoint
The last 6 characters
of the MAC address
Endpoint node
under /SYS
A8:D2:36:00:39:A1
0039A1
UBEX0039A1
Where the path of a LW3 command/method/etc contains a UBEX
endpoint, the following parameter refers to it:
<UBEX_EP>
/
MEDIA
EDID
VIDEOWALLS
XP
VIDEO
AUDIO
DEVICEMAP
X1
X2
[...]
STREAMS
VIDEO
AUDIO
CONTROL
MANAGEMENT
SYS
EB
CECU
ENDPOINTS
UBEX0039A1
UBEX003C17
[...]
DISCOVERY
9.4. System Commands - MMU
9.4.1. Set the Device Label
INFO:
The device label can be changed to a custom text in the
of the LDC software.
The Device Label can be 39 characters long and ASCII characters are
allowed. Longer names will be truncated.
Command and Response
#label #devicelabel
ç
SET•/MANAGEMENT/LABEL.DeviceLabel=
<custom_name>
æ
pw•/MANAGEMENT/LABEL.DeviceLabel=
<custom_name>
Example
ç
SET /MANAGEMENT/LABEL.DeviceLabel=MMU_ServerRoom
æ
pw /MANAGEMENT/LABEL.DeviceLabel=MMU_ServerRoom
9.4.2. Query the Product Name
ATTENTION!
The name of the product is a read-only parameter and
cannot be modified.
Command and Response
ç
GET•/.ProductName
æ
pr•/.ProductName=
<Product_name>
Example
ç
GET /.ProductName
æ
pr /.ProductName=UBEX-MMU-X200
9.4.3. Query the Firmware Package Version
Command and Response
#firmwareversion
ç
GET•/MANAGEMENT/UID/PACKAGE.Version
æ
pr•/MANAGEMENT/UID/PACKAGE.Version=
<firmware_version>
Example
ç
GET /MANAGEMENT/UID/PACKAGE.Version
æ
pr /MANAGEMENT/UID/PACKAGE.Version=v1.2.1b1
9.3.3. Stream ID Calculation
All endpoint devices which are connected to the UBEX matrix got a
logical device ID generated by the MMU.
DEFINITION:
Logical device ID
means the MMU assigns a number
to the endpoints ordered by the discovery. For example the first
endpoint gets the 1 (appears as X1 under the DEVICEMAP), the
second one the 2 (appears as X2).
The stream ID is based on the logical device ID. The registered endpoint
can be transmitter, receiver, or transceiver. All transmitters have two
inputs, all receivers have two outputs, and all transceivers have one
input and one output. The first discovered endpoint gets the X1 logical
device ID, the HDMI port 1 of the endpoint is always the 01 number, the
HDMI port 2 is always the 02 number. If the endpoint has input port
(TX / TRX), it is signed with
S as Source
, if it has output port (RX / TRX),
it is signed with
D as Destination
. The formula is the following:
<Port_type><Logical_device_ID><Port_number>
Two endpoint devices cannot be assigned to the same logical device
ID. The number is always calculated for the endpoints independently
from the operation mode.
INFO:
The logical device ID (and the order of the endpoints) can
be changed by the LDC software (see the details in the
section) or by LW3 protocol command (see the details in the
Assigning an Endpoint to a Logical Device ID
section).
INFO:
The operation mode (TX, RX, or TRX) can be changed for any
endpoint. See the related LW3 protocol command in the
Example
The following table helps to clear up the calculation of the stream ID:
Stream ID
Operation mode Discovery order Port number
S101
TX
1.
HDMI in 1
S102
HDMI in 2
D201
RX
2.
HDMI out 1
D202
HDMI out 2
S302
TRX
3.
HDMI in 2
D301
HDMI out 1
Examples and explanations for stream IDs