7. LW3 Programmers’ Reference
UMX-HDMI-140 series– User's Manual
108
Applied firmware package: v1.3.0b5 | LDC software: v2.5.6b2
7.13.
Ethernet Message Sending
The device can be used for sending a message to a certain IP:port address. The three different commands
allow controlling the connected (third-party) devices.
7.13.1.
Sending a TCP Message (ASCII-format)
The command is for sending a command message in ASCII-format. This method allows escaping the control
characters. For more information see the
Command and Response
ç
CALL·/MEDIA/ETHERNET:tcpMessage(
<IP_address>
:
<port_no>
=
<message>
)
æ
mO·/MEDIA/ETHERNET:tcpMessage
Example
ç
CALL /MEDIA/ETHERNET:tcpMessage(192.168.0.103:6107=C00)
æ
mO /MEDIA/ETHERNET:tcpMessage
The 'C00' message is sent to the indicated IP:port address.
Example with HEX codes
ç
CALL /MEDIA/ETHERNET:tcpMessage(192.168.0.20:5555=C00\x0a\x0d)
æ
mO /MEDIA/ETHERNET:tcpMessage
The 'C00' message with CrLf (Carriage return and Line feed) is sent to the indicated IP:port address.
The \x sequence indicates the HEXA code; see more information in the
7.13.2.
Sending a TCP Text (ASCII-format)
The command is for sending a text message in ASCII-format. This method
does not allow
escaping or inserting
control characters.
Command and Response
ç
CALL·/MEDIA/ETHERNET:tcpText(
<IP_address>
:
<port_no>
=
<text>
)
æ
mO·/MEDIA/ETHERNET:tcpText
Example
ç
CALL /MEDIA/ETHERNET:tcpText(192.168.0.103:6107=pwr_on)
æ
mO /MEDIA/ETHERNET:tcpText
The 'pwr_on' text is sent to the indicated IP:port address.
7.13.3.
Sending a TCP Binary Message (HEX-format)
The command is for sending a binary message in Hexadecimal format. This method
does not require
escaping
the control and non-printable characters.
Command and Response
ç
CALL·/MEDIA/ETHERNET.tcpBinary(
<IP_address>
:
<port_no>
=
<HEX_message>
)
æ
mO·/MEDIA/ETHERNET:tcpBinary
Example
ç
CALL /MEDIA/ETHERNET:tcpBinary(192.168.0.103:6107=0100000061620000cdcc2c40)
æ
mO /MEDIA/ETHERNET:tcpBinary
The '0100000061620000cdcc2c40' message is sent to the indicated IP:port address.
INFO:
There is no need to insert a space or other separator character between the binary messages.
7.13.4.
Sending a UDP Message (ASCII-format)
The command is for sending a UDP message in ASCII-format. This method allows escaping the control characters.
For more information see the
Command and Response
ç
CALL·/MEDIA/ETHERNET:udpMessage(
<IP_address>
:
<port_no>
=
<message>
)
æ
mO·/MEDIA/ETHERNET:udpMessage
Example
ç
CALL /MEDIA/ETHERNET:udpMessage(192.168.0.103:6107=C00)
æ
mO /MEDIA/ETHERNET:udpMessage
The 'C00' message is sent to the indicated IP:port address.
Example with HEX codes
ç
CALL /MEDIA/ETHERNET:udpMessage(192.168.0.20:9988=C00\x0a\x0d)
æ
mO /MEDIA/ETHERNET:udpMessage
The 'C00' message with CrLf (Carriage return and Line feed) is sent to the indicated IP:port address. The \x
sequence indicates the HEXA code; see more information in the
section.