Telemetry Module MT-021 User Manual

causes module to write value 1234 to holding register 10 and send back SMS with text:
>1234
Both read and write commands can be expanded by adding a prefix, which defines data
format (notation). Prefix should be placed between '#' mark (command start) and
register symbol, and should contain one (or more) characters ended with a dot. For
example, to read an input register 4 in hexadecimal format, one should use a command:
#H.IR4
and module's answer will be:
>1FC8
Prefixes can also be used with write commands.
Command can operate on more than one register. Register count can be included in
prefix, after character denoting data format (which is then mandatory). For example,
command:
#D2.HR2=123456
causes write 123456 to two registers, HR2 and HR3 (32-bit variable).
Full list of available prefixes is enclosed below.
User can define in MTManager own symbolic names in module's config and assign them
to registers. Then, such names can be used instead of register symbols. It allows user to
define "friendly" names for registers and to erase access to bit values. For example, if
user has defined symbolic name "output" and assigned it to bit 321 of internal registers
space (which is equal to bit of HR20 register), then sending a command:
#output=1
causes module to write 1 to bit 1 of HR20 register. There are several predefined
(internal) symbolic names.
Apart from symbolic names, user can define macros. A macro is defined as a name and
a text assigned to this name. Parsing of received message begins with macro expansion.
Parser looks for words beginning with '*' sign and replaces such names with assigned
strings. Once macro expansions ends, new message text is being interpreted and
commands executed. It allows user to place both commands and symbolic names in
macro text. Furthermore, macros can contain another macro names ("nested" macros),
but only those defined higher in macro list. For example, if configuration contains
following macros (in order shown):
No. Macro name Macro text
1 counter *mtime: input 0 counter: #D2.HR0
2 mtime #date #time
3 state *mtime: inputs - #B8.IB64, #IR19 SMS sent
then macro *mtime used in macro number 3 (*state) will be correctly expanded and
SMS text:
*state
after macro expansion (before executing commands) will be changed to:
81