MAS7.1 Supplemental Guide, Rev 1.1, 9/28/07
9
MAS7.1 Command Reference
The MAS7.1 Command Set
Examples are given for many of the ways a command can be issued. Most commands have a ‘set’ mode for
changing a parameter value, and a ‘query’ mode for reading the current value.
If the command has a query mode, the associated response string, it will be listed.
As described in the section on the K.I.S.S.™ protocol, whitespaces and commas are optional in many cases.
The format used here includes a single space after the command and commas, with no spaces, between
parameters. The format given here does not show the optional checksum or CRC-8 checkcodes that may be
appended to all commands, nor does it show the required <CR> that terminates all commands.
The response strings are the strings returned from MAS7.1, which use the same format as described above.
The format does not show the optional checksum or CRC-8 checkcodes that may be appended to all response
strings if enabled, nor does it show the <CR><LF> that terminates all Response Strings.
Error Response Codes
The following are the Error Response codes that can be returned by the MAS7.1:
!1
Unrecognized command.
!2
A parameter was out of range.
!3
Syntax error, a badly formed command.
!4
Checksum or CRC-8 error.
!5
Too many or too few parameters.
!6
Device busy, cannot process command.
!7
Buffer overflow.
And some more detailed descriptions of their meanings:
Error 1: The command given was not recognized as a MAS7.1 command. Commands are case sensitive and
in the MAS7.1, all commands are upper case.
Error 2: One of the parameters given was too large, or too small, the command will be ignored.
Error 3: Something was wrong with the command's syntax. There was possibly extra data at the end of the line,
or non-decimal data as part of a parameter. There cannot be whitespace before or after a checksum or CRC-8
checkcode, or this error will be returned.
Error 4: The ';' or ':' character was used to indicate a Checksum or CRC-8 Checkcode was appended to the
command string, but the Checksum or CRC-8 Checkcode did not match the calculated one. The command will
be ignored.
Error 5: The number of parameters given does not match the number allowed by this command.
Error 6: To prevent conflicts between the front panel Setup Mode and the serial port settings, when the MAS7.1
is in the Setup Mode, many parameters become read only and any attempt at writing them will return Error 6.
Issuing the “Button Emulation” command with button code ‘0’ can be used to exit the Setup Mode, at which
point the command can be re-issued without an Error 6 response.
Error 7: An internal buffer has overflowed, for instance more than 16 button codes were sent as part of the
“Button Emulation” command.