Message Recognizer; Enable The Recognizer; Set The Delimiter Hex; Set The Timeout - Lightware UMX-TPS-TX120 User Manual


  
7. LW3 Programmers' Reference
7.19. RS-232 Message Recognizer
DIFFERENCE:
This feature is available only in UMX-TPS-TX140K and UMX-TPS-TX140-Plus models from
FW package v1.3.0b11.
This tool can be used to recognize messages coming from the RS-232 port. The message can be used as a
Condition in Event manager and define an Action for it.
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 been elapsed 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.19.1. Enable the Recognizer
Command and Response
SET·/MEDIA/UART/<serial_port>.RecognizerEnable=<recognizer_enable>
ç
pw·/MEDIA/UART/<serial_port>.RecognizerEnable=<recognizer_enable>
æ
Parameters
Parameter Parameter description
<serial_port> Serial port number
<recognizer_enable> Recognizer mode
Example
ç SET /MEDIA/UART/P1.RecognizerEnable=true
æ pw /MEDIA/UART/P1.RecognizerEnable=true
#recognizer #rs232recognizer
MESSAGE ActiveProperty
ActiveRx property is cleared
saved in ActiveRx property
Timeout
MESSAGE ActiveProperty
ActiveRx property is cleared
saved in ActiveRx property Timeout
Values Value description
P1, P2
Recognizer is enabled
true
Recognizer is disabled
false
#rs-232recognizer
Applied firmware packages: (UMX-TPS): v1.5.0b4 | (WP-UMX-TPS): v1.4.0b8 | (FP-UMX-TPS): v1.4.0b8 | LDC software: v2.5.6b2
UMX-TPS-TX100 series – User's Manual
7.19.2. Set 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·/MEDIA/UART/RECOGNIZER.DelimiterHex=<delimiter>
ç
pw·/MEDIA/UART/RECOGNIZER.DelimiterHex=<delimiter>
æ
Parameters
The <delimiter> parameter can be max. 8-character long (or 16 hex digit) in hex format.
Example
ç SET /MEDIA/UART/RECOGNIZER.DelimiterHex=3a
æ pw /MEDIA/UART/RECOGNIZER.DelimiterHex=3a
Time
7.19.3. Set the Timeout
When the set time is elapsed after the last received message and delimiter was not detected, the device
saves the data into the Rx, RxHex, Hash properties. The timeout setting is useful if there is no special or easily
defined delimiter in the incoming data, but there is a time gap between the messages.
Command and Response
SET·/MEDIA/UART/RECOGNIZER.TimeOut=<timeout>
ç
pw·/MEDIA/UART/RECOGNIZER.TimeOut=<timeout>
æ
Parameters
The <timeout> parameter sets the timeout value in milliseconds: 0 means the timeout is disabled, min.
value is 10.
Example
ç SET /MEDIA/UART/RECOGNIZER.TimeOut=20
æ pw /MEDIA/UART/RECOGNIZER.TimeOut=20
Delimiter (hex format: 3A)
... Password : Login name : ...
Stored string
133