Recognizer; Enable The Recognizer; Set The Delimiter Hex; Set The Timeout - Lightware UMX-TPS-TX100 Series User Manual


  
7. LW3 Programmers' Reference
7.9. RS-232 Recognizer
ATTENTION! This feature is available only in UMX-TPS-TX140-Plus
and WP-UMX-TPS-TX130-US models.
This tool is able to recognize the incoming RS-232 message. It stores
the incoming serial data from the first bit, until the previously defined
string (delimiter) or the elapsing timeout after the last bit. The last
incoming serial string is saved in different formats (string, hex, and
hash).
7.9.1. Enable the Recognizer
SET·/MEDIA/UART/<port>.RecognizerEnable=<logical_value>
Î
pw·/MEDIA/UART/<port>.RecognizerEnable=<logical_value>
Í
Parameters
Parameter
Identifier
description
Recognizer enable/
<logical_value>
disable setting
Example
Î SET /MEDIA/UART/P1.RecognizerEnable=true
Í pw /MEDIA/UART/P1.RecognizerEnable=true
7.9.2. Set the Delimiter Hex
When the delimiter hex string is detected in the incoming serial data,
the device saves the RS-232 message data from the first bit, until the
delimiter (or the data between the two delimiter).
Delimiter (hex format: 3A)
... Password : Login name :
Stored string
Î SET·/MEDIA/UART/RECOGNIZER.DelimiterHex=<delimiter>
pw·/MEDIA/UART/RECOGNIZER.DelimiterHex=<delimiter>
Í
Parameters
<delimiter> It 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
7.9.3. Set the Timeout
When the set time is elapsed after the last received message, the
device saves the data. It can be applied, when there is no special or
easily defined delimiter string in the incoming serial data, but there is
a time gap between the messages.
SET·/MEDIA/UART/RECOGNIZER.TimeOut=<timeout>
Î
pw·/MEDIA/UART/RECOGNIZER.TimeOut=<timeout>
Í
Parameters
<timeout>
Example
Î SET /MEDIA/UART/RECOGNIZER.TimeOut=20
Í pw /MEDIA/UART/RECOGNIZER.TimeOut=20
Value Parameter value
7.9.4. Query the Last Recognized Serial Message in String Format
true Enabled
The recognized data is stored in string format. They are stored until
the next incoming message or until the RECOGNIZER:clear() method
false Disabled
is called.
TIPS AND TRICKS: When one of these properties are set as a
condition in the Event Manager, and the same strings follow each
other, the action will execute once.
Command and Response
Î GET·/MEDIA/UART/RECOGNIZER.Rx
Í pr·/MEDIA/UART/RECOGNIZER.Rx=
Parameters
<recognized _string>
...
Example
Î GET /MEDIA/UART/RECOGNIZER.Rx
Í pr /MEDIA/UART/RECOGNIZER.Rx=Login:
UMX-TPS-TX100 series – User's Manual
Timeout value in ms.; 0: disable the timeout; minimum
value: 10.
<recognized_string>
Max. 12 byte-long recognized data string.
7.9.5. Query the Last Recognized Serial Message in Hex Format
The recognized data is stored in hex format. They are stored until the
next incoming message or until the RECOGNIZER:clear() method is
called.
TIPS AND TRICKS: When one of these properties are set as a
condition in the Event Manager, and the same strings follow each
other, the action will execute once.
Command and Response
Î GET·/MEDIA/UART/RECOGNIZER.RxHex
Í pr·/MEDIA/UART/RECOGNIZER.RxHex=
Parameters
<recognized _hex> Recognized data in hex format.
Example
Î GET /MEDIA/UART/RECOGNIZER.RxHex
Í pr /MEDIA/UART/RECOGNIZER.RxHex=FF1F4C6F67696E3A
7.9.6. Query the Last Recognized Serial Message in Hash Format
The recognized data is stored in hash format. They are stored until
the next incoming message or until the RECOGNIZER:clear() method
is called.
TIPS AND TRICKS: When one of these properties are set as a
condition in the Event Manager, and the same strings follow each
other, the action will execute once.
Command and Response
Î GET·/MEDIA/UART/RECOGNIZER.Hash
Í pr·/MEDIA/UART/RECOGNIZER.Hash=
Parameters
<recognized _hash> Fingerprint code, Max. 32 bit-long recognized
data hash.
Example
Î GET /MEDIA/UART/RECOGNIZER.Hash
Í pr /MEDIA/UART/RECOGNIZER.Hash=997A659E
90
<recognized _hex>
<recognized _hash>