User Manual

Query History Commands
Advanced Digital Motor Controller User Manual 255
Reply: VNM=nn
Syntax Scripting: nn = GetValue(_TSL)
Result: Value Type: Unsigned 32-bit
Where:
nn = Version number
Query History Commands
Every time a Real Time Query is received and executed, it is stored in a history buffer
from which it can be recalled. The buffer will store up to 16 queries. If more than 16 que-
ries are received, the new one will be added to the history buffer while the firsts are re-
moved in order to fit the 16 query buffer.
Queries can then be called from the history buffer using manual commands, or automati-
cally, at user selected intervals. This feature is very useful for monitoring and telemetry.
Additionally, the history buffer can be loaded with a set of user selected queries at power
on so that the controller can automatically issue operating values immediately after power
up. See “TELS - Telemetry String” configuration command for details on how to set up
the startup Telemetry string. “Another feature is the streams. In this case the data can be
printed after a prefix and separated with a delimiter. In order to enable a stream, the spe-
cial character “/” needs to be typed in front of the first query.
A command set is provided for managing the history buffer. These special commands
start with a “#” character.
TABLE 15-18. Query History Commands
Command Description
# Send the next value. Stop automatic sending
# C Clear buffer history
# nn Start automatic sending
# xx nn Start automatic sending for specific stream
/”<prefix>”,”<delimiter>”?Q cc Create data streams
//? Dump the streams’ prefixes and delimiters
# - Send Next History Item / Stop Automatic Sending
A # alone will call and execute the next query in the buffer. If the controller was in the
process of automatically sending queries from the buffer, then receiving a # will cause the
sending to stop.
When a query is executed from the history buffer, the controller will only display the que-
ry result (e.g. A=10:20). It will not display the query itself.