digiBASE-E ™ High-Performance Power-over-Ethernet Multichannel Analyzer / PMT Base for Scintillation Detectors
36
An optional checksum may be added to the end of any command sent to MCB API. The
checksum is a 1-byte unsigned integer sum of all of the characters in a command, treated as
unsigned integers, up to and including the comma or space(s) that separates the checksum from
the command. The checksum simply appears as an extra parameter added to the end of the
command parameter list. For commands that do not normally have parameters, the checksum
appears as the only parameter separated from the header by one or more spaces. All optional
parameters must be included in a command if a checksum is to be provided so that the checksum
is not mistaken by the MCB API as a parameter. For example, the SET_WINDOW command
must include the two optional parameters, start and length, if the checksum is provided (e.g.,
SET_WINDOW 0,1024,209).
5.1.2. Percent Response Records
The MCB API responds to all commands with a percent response record that signifies the
completion of the command. Percent response records contain two error code numbers and
a 1-byte checksum as follows:
%aaabbbccc<CR>
where % represents the ASCII % character, aaa represents the macro error code, bbb represents
the micro error code, ccc represents the checksum and <CR> represents the ASCII carriage
return character signifying the end of the record. The macro error code represents the general
class of error with 0 meaning no error, and the micro error code represents the sub-class of error
with 0 meaning no error. Following is a list of all percent responses for the digiBASE-E:
Unconditional Success:
%000000069<CR>
No errors detected. Command executed as specified.
%000005074<CR>
Device already started or stopped. The START or STOP
command was ignored.
%000006075<CR>
Device preset already exceeded. The START command was
ignored.
%000016076<CR>
START requested but amplifier not pole-zeroed since last power-
up. START was attempted anyway.
%000032074<CR>
START requested but high voltage not enabled. START was
attempted anyway.
%000064079<CR>
Specified parameter was rounded to the closest legal value.
Note that the above responses can be combined to indicate a combination of warnings such as:
%000048081<CR>
Amplifier was not pole-zeroed nor was high voltage enabled. The
START was attempted anyway.
%000037079<CR>
Device already started and high voltage not enabled. The
command was ignored.
Summary of Contents for digiBASE-E
Page 6: ...vi...
