ORTEC digiBASE-E, Руководство пользователя

Страница: 44 / 72

digiBASE-E ™ High-Performance Power-over-Ethernet Multichannel Analyzer / PMT Base for Scintillation Detectors
38
5.1.3. Dollar Response Records
SHOW and STEP commands respond with a single dollar response record followed immediately
by a percent response record. All valid dollar response records for each command are listed in
the command dictionary.
The following list provides the general form of each dollar response record for the MCB API. In
this list, lower case letters represent numeric values. The letters “ccc” always represent an 8-bit
unsigned checksum of all characters on the record up to but not including the checksum
characters, and <CR> represents the ASCII carriage return character.
$Axxxccc<CR> xxx is a single 8-bit unsigned number.
$Cxxxxxccc<CR> xxxxx is a single 16-bit unsigned number.
$Dxxxxxyyyyyccc<CR> xxxxx and yyyyy are 16-bit unsigned numbers.
$Exxxxxccc<CR> xxxxx is a single 16-bit alarm mask.
$Fssss...<CR> ssss... is a variable length ASCII character sequence (no
checksum is sent with this record).
$Gxxxxxxxxxxccc<CR> xxxxxxxxxx is a single 32-bit unsigned number.
$IT<CR> True response to a SHOW command (no checksum).
$IF<CR> False response to a SHOW command (no checksum).
$Jxxxxxyyyyy...ccc<CR> Response to SHOW_CONFIGURATION command.
$Mxxxxxxxxxx...ccc<CR> Response to SHOW_STATUS command.
$Nxxxyyyzzzccc<CR> xxx, yyy, and zzz are 8-bit unsigned numbers.
5.1.4. Command Catalog
This section lists each command with a description of its operation. The descriptions include a
list of any unusual responses that may result. As described in previous sections, the usual
response from a command is a %000000069<CR> response, which represents a macro error
code of 0 and a micro error code of 0 (no errors).
All execution error responses, if any, are listed for each command. Though syntax and
communication error responses may result from any command, in practice, these error responses
rarely occur on systems with reliable communication hardware running debugged software.
Refer to Section 5.1.2 for information about error responses.
In the following catalog, the commands are listed in alphabetical order, each starting with a
command prototype line. Upper-case letters, numeric digits, blank spaces, and special symbols
such as the underscore ( _ ) and comma ( , ) in the prototype line are literal text to be sent to the
MCB exactly as they appear. Lower-case letters in the prototype line represent numeric values as
described in the accompanying text and should not be sent literally to the MCB but should be
replaced by an appropriate numeric value. Lower-case letters enclosed in quotes represent