Command Types; Prefix Summary; Error Messages; Escaping - Lightware UBEX-MMU-X200 User Manual

 
     
9. Programmer's Reference 9. Programmer's Reference
9.3.3. Command Types
GET command
The GET command can be used to get the child nodes, properties and methods of a specific node. It can also
be used to get the value of a property. Use the dot character (.) when addressing a property:
ç GET /.SerialNumber
æ pr /.SerialNumber=87654321
GETALL command
The GETALL command can be used to get all child nodes, properties and methods of a node with one
command.
ç GETALL /SYS
æ n- /SYS/EB
æ n- /SYS/CECU
æ n- /SYS/ENDPOINTS
æ m- /SYS:factoryDefaults
æ m- /SYS:softReset
æ m- /SYS:reset
SET command
The SET command can be used to modify the value of a property. Use the dot character (.) when addressing
the property:
ç SET /MEDIA/STREAMS/VIDEO/S301.SourceName=My4K60Video
æ pw /MEDIA/STREAMS/VIDEO/S301.SourceName=My4K60Video
CALL command
A method can be invoked by the CALL command. Use the colon character (:) when addressing the method:
ç CALL /MEDIA/XP/VIDEO:switch(S101:D102)
æ mO /MEDIA/XP/VIDEO:switch
MAN command
The manual is a human readable text that describes the syntax and provides a hint for how to use the
primitives. For every node, property and method in the tree there is a manual, type the MAN command to get
the manual:
ç MAN /MEDIA/STREAMS/VIDEO/D201/PORT.Output5vMode
æ pm /MEDIA/STREAMS/VIDEO/D201/PORT.Output5vMode ["Auto" | "AlwaysOn" | "AlwaysOff"]
Applied F-series endpoint firmware package: v1.5.4 | Applied R-series endpoint firmware package: v1.5.4 | Applied MMU firmware package: v1.3.3 | LDC software: v2.4.2b4
series – Matrix Application Mode – User's Manual series – Matrix Application Mode – User's Manual
9.3.4. Prefix Summary
DEFINITION:

The following prefixes are defined in the LW3 protocol:
Prefix
n- a node
nE an error for a node
nm a manual for a node
pr a read-only property
pw read-write property
pE an error for the property
9.3.5. Error Messages
There are several error messages defined in the LW3 protocol, all of them have a unique error number.
ç CALL /MEDIA/XP/VIDEO:switch(SA:D1)
æ mE /MEDIA/XP/VIDEO:switch %E004:Invalid value
9.3.6. Escaping

DEFINITION:
inside a character or string literal, but is translated into another character or a sequence of characters.
Property values and method parameters can contain characters which are used as control characters in the
protocol. They must be escaped. The escape character is the backslash ('\') and escaping means injecting
a backslash before the character that should be escaped (like in C language).
Control characters are the following: \ { } # % ( ) \r \n \t
The original message:
The escaped message:
The prefix is a 2-character long code that describes the type of the response.
Description Prefix
pm a manual for the property
m- a method
mO a response after a success method execution
mF a response after a failed method execution
mE an error for a method
mm a manual for a method
An escape sequence is a sequence of characters that does not represent itself when used
CALL /MEDIA/CONTROL/UART/P101/PORT:sendMessage(Set(01))
CALL /MEDIA/CONTROL/UART/P101/PORT:sendMessage(Set\(01\))
132 132
Description