Remote Control; General Command Syntax; The Tcp/Ip Remote Control Interface - SatService sat-nms ACU-RMU User Manual

7 Remote Control

T he sat-nms ACU may be controlled remotely by a monitoring and control application either through the
TCP/IP interface or through a serial RS232 interface (RS232 not yet implemented in ACU19 and ACU-
RMU). Both communication methods use the same commands and parameters. However, there are different
frames around each message depending communication method used.
Controlling the device from the web interface, the TCP/IP remote control interface or via the serial interface
is completely equal, commands may sent to any interface at any time, the ACU will use the parameter it
receives last.

7.1 General command syntax

The ACU knows a number of parameters, each identified by a parameter name. To set a certain parameter
to a new value, a message:
name=value
has to be sent to the ACU. The ACU interprets this command, checks the range of value, sets the internal
parameter and then answers:
name=value
The value in the reply is the value actually recognized by the ACU. For instance, if the requested value was
out of range, the replied (and internally used) value is limited to the applicable minimum or maximum.
To read a parameter from the ACU, instead of a new parameter value a question mark is sent:
name=?
The ACU replies the actual value in a complete message:
name=value
A complete list of the parameter the ACU knows is shown later in this document in chapter
Below, some common rules applying to the remote control message syntax are summarized.
Parameter names always are of lower case letters, most of them are four characters long.
Non-numeric parameter values always are written in upper case.
Numeric (floating point) values may be specified with an arbitrary precision, however the device will
reply only a fixed number of places. The ACU recognizes a decimal point ('.'), numbers must not
contain any commas.
There must not be any whitespace in front or after the '=' in a message.
If the command/query is not of the form name=value or name=?, the ACU replies the message ?
SYNTAX.
If the message syntax is OK, but contains an unknown parameter name is used, the reply is ?
UNKNOWN
Numeric parameters are cut to the limits defined for this particular parameter.
Misspelled choice values cause the ACU to set the first value of the choice list.
Assigning a value to a read-only parameter will cause no fault, however the ACU will overwrite this
parameter immediately or some seconds later with the actual value.

7.2 The TCP/IP remote control interface

(C) 2017, SatService GmbH www.satnms.com
Parameter list.
ACU-RMU-UM-1707 Page 52/80