CT-BOX User’s Manual
45
2.3
Advanced Commands
The advanced functionalities of the CT-BOX are described in the following
chapters.
2.3.1
ALARM Command
The CT-BOX allows to detect when the measured current is outside of a desired
current range. The command that sets this functionality is called ALARM command.
The alarm checks are performed at the selected acquisition frequency, so they depend
over the:
•
TS setting in the Oscilloscope mode of operation,
•
FREQ setting in the Data-Logger mode of operation.
The command “ALARM:ON
\
r
” is used to enable the alarm check functionality,
otherwise the command “ALARM:OFF
\
r
” is used to disable it. The command used to
read the actual ALARM configuration is: “ALARM:?
\r
”. The reply to the read
command is in the following form: “
alarm_status
\r\n
”, where
alarm_status
is “ON” if
the alarm status is enabled or “OFF” if it is disabled.
Whenever the Alarm condition occurs the “Alarm flag” bit is set and latched in
the Status register. It stays set also when the alarm condition is removed. The command
“ALARM:CLR
\
r
” clears the Alarm condition and so also the “Alarm flag” bi in the
Status register.
ALARM Command:
(ALARM:
parameter
\r)
Parameter
Command description
Type of
command
Return value
ON
Enable the Alarm check functionality
Set
ACK
OFF
Disable the Alarm check functionality
Set
ACK
CLR
Clear the Alarm
Set
ACK
?
Read the Alarm check setting
Read
ON – if the alarm functionality is enabled
OFF – if alarm functionality is disabled
Table 21:
ALARM command
The command “ALARM:ULIM:
current_threshold
\
r
” sets the upper alarm
threshold, and the “ALARM:LLIM:
current_threshold
\
r
” sets the lower alarm
threshold, where
current_threshold
is the upper or lower limit expressed in Ampere
[A]. If the parameter is correctly elaborated the CT-BOX replies with an acknowledge
(“ACK
\r\n
”).
The commands used to read the threshold limits are: “ALARM:ULIM:?
\
r
” for
the upper limit and “ALARM:LLIM:?
\
r
” for the lower limit. Both command generate
the reply in the following form: “
current_threshold
\r\n
”, where
current_threshold
is
the upper or lower limit expressed in Ampere [A].