Tcp Message Recognizer; Setting The Ip Address Of The Tcp Server; Setting The Tcp/Ip Port Number Of The Tcp Server; Connecting To A Tcp Server - Lightware MMX4x2 Series User Manual

   
7. LW3 Programmers' Reference
7.16. TCP Message Recognizer
DIFFERENCE:
This feature and the commands below are available from firmware v1.6.0b19.
This tool can be used to recognize messages coming from a TCP server. You can link an immediate
event Action that is run when a message is recognized, but you can also use it in Event manager.
#tcprecognizer #message
Preparation
Step 1. Set a TCP client in the Lightware device (three TCP clients can be run at the same time), set the
properties of the target TCP server.
Step 2. Set the DelimiterHex and the TimeOut settings for the proper message processing.
Step 3. Make sure the TCP/IP port is opened in the target device (think about Firewall settings in the network).
Step 4. Connect to the TCP server.
Working Method
A message got recognized from the incoming data if one of the following occurs:
▪ The set DelimiterHex is detected in the message, or
▪ The set TimeOut has passed since receiving the last data bit.
MESSAGE
with delimiter Delimiter
MESSAGE
saved in Rx property
MESSAGE
with timeout
TimeOut
MESSAGE
saved in Rx property
*
no timeout,
MESSAGE
no delimiter
* In that case, the not-recognized data is kept in the memory (up to 128 bytes). If the DelimiterHex is detected
later, or the TimeOut parameter is set meanwhile, the data appears in the Rx, RxHex, Hash and ActiveRx,
ActiveRxHex, ActiveRxHash properties.
7.16.1. Setting the IP Address of the TCP Server
Command and Response
ç SET·/CTRL/TCP/C<loc>.ServerIP(<IP_address>)
æ pw·/CTRL/TCP/C<loc>.ServerIP(<IP_address>)
Parameters
The <loc> parameter can be 1, 2 or 3 as at most three TCP connections can be established at the same time.
Example
ç SET /CTRL/TCP/C1.ServerIP(192.168.1.14)
æ pw /CTRL/TCP/C1.ServerIP(192.168.1.14)
ActiveProperty
MESSAGE
ActiveRx property is cleared
saved in ActiveRx property Timeout
MESSAGE ActiveProperty
ActiveRx property is cleared
saved in ActiveRx property
Timeout
Applied firmware package: v1.6.0b19 | LDC software: v2.5.13b5
MMX4x2 series – User's Manual
7.16.2. Setting the TCP/IP Port Number of the TCP Server
Command and Response
ç SET·/CTRL/TCP/C<loc>.ServerPort(<port_no>)
æ pw·/CTRL/TCP/C<loc>.ServerPort(<port_no>)
Example
ç SET /CTRL/TCP/C1.ServerPort(4999)
æ pw /CTRL/TCP/C1.ServerPort(4999)
7.16.3. Connecting to a TCP Server
Command and Response
ç CALL·/CTRL/TCP/C<loc>:connect()
æ mO·/CTRL/TCP/C<loc>:connect
Example
ç CALL /CTRL/TCP/C1:connect()
æ mO /CTRL/TCP/C1:connect
7.16.4. Disconnecting from a TCP Server
Command and Response
ç CALL·/CTRL/TCP/C<loc>:disconnect()
æ mO·/CTRL/TCP/C<loc>:disconnect
Example
Time
ç CALL /CTRL/TCP/C1:disconnect()
æ mO /CTRL/TCP/C1:disconnect
7.16.5. Setting the Delimiter Hex
This property stores the delimiter that is between the messages (e.g. Cr, Lf,
Space). The value has to be in hex format (e.g.0D, 0A, 20).
Command and Response
SET·/CTRL/TCP/C<loc>.DelimiterHex=<delimiter>
ç
pw·/CTRL/TCP/C<loc>.DelimiterHex=<delimiter>
æ
Parameters
The <delimiter> parameter can be max. 8-characters long (16 digits) in hex format.
Example
ç SET /CTRL/TCP/C1.DelimiterHex=00
æ pw /CTRL/TCP/C1.DelimiterHex=00
117
Delimiter Delimiter
...00PWR_0100...
Stored string