7. LW3 Programmers’ Reference
MMX4x2 series – User's Manual
114
Applied firmware package: v1.6.0b19 | LDC software: v2.5.13b5
7.13.5.
Powering on a Computer over Ethernet (Wake-on-LAN)
The well-known wake-on-lan feature (sending magic Packet to the target PC) is available by the following
command:
Command and Response
ç
CALL·/MEDIA/ETHERNET:wakeOnLan(
MAC_address
)
æ
mO·/MEDIA/ETHERNET:wakeOnLan
Example
ç
CALL /MEDIA/ETHERNET:wakeOnLan(AA:BB:CC:22:14:FF)
æ
mO /MEDIA/ETHERNET:wakeOnLan
Please make sure the feature is enabled in the target PC and it is powered (but switched off).
7.13.6.
Setting the Host Name
DIFFERENCE:
This command is available only from FW package v1.6.0b19.
The host name is a property that can be used instead of the IP address when connecting to the device. It is
also suitable for finding in the Device Discovery window of the LDC, see more details in the
section. Furthermore, it can be used to open the The Built-in Miniweb. If the IP address of the device
is changing, the host name can be used as a fixed property.
Command and Response
ç
SET·/MANAGEMENT/NETWORK.HostName=
<unique_name>
æ
pw·/MANAGEMENT/NETWORK.HostName=
<unique_name>
Parameters
The <unique_name> can be 1-64 characters long and the following are allowed for naming: the elements of
the English alphabet and numbers. Hyphen (-) and dot (.) is also accepted, except as last character.
Example
ç
SET /MANAGEMENT/NETWORK.HostName=mtg-room1
æ
pw /MANAGEMENT/NETWORK.HostName=mtg-room1
7.14.
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.14.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
section.
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
section.
7.14.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.