-
Notifications
You must be signed in to change notification settings - Fork 46
Command 11 Acknowledge Alerts
Command $11 is the Acknowledge Alerts command. It has the following format:
OFF 1 2 3 4 5 6
11 05 NNNNNNNN MM
-
11(1 byte): Mtype value of $11 specifies an acknowledge alert command -
05(1 byte): The acknowledge alert command has a fixed length of05 -
NNNNNNNN(4 bytes): Nonce, the 32-bit validator (random looking numbers) -
MM(1 byte): bit mask of alert(s) to acknowledge (1 << alert #)
The alert #'s are those as set in $19 Configure Alerts command.
When a configured alert is triggered (i.e.,
the specified number of minutes has passed or
the reservoir has dropped to the requested level),
the current pod time is saved in a per alert array
and a flag is set marking this alert # as unacknowledged.
A Type 1 Pod Information Response
can be used by the PDM or controlling software
to retrieve the per alert array of saved alert trigger times.
The triggered and unacknowledged pod alerts #'s are returned
in the aaaaaaaa bits in the $1D Status Response
and in the TT byte in the Type 2 Pod Information Response.
The $11 Acknowledge Alerts command has a number of actions for each specified alert # bit in MM.
- Disables any programmed pod beeping if the alert # is currently triggered and unacknowledged
- Clears the triggered alert bit returned in the $1D Status Response and the Type 2 Pod Information Response
- Clears the saved triggerred pod alert time returned in the Type 1 Pod Information Response
- Deactivates the programmed alert for this alert # (to prevent subsequent retriggering)
To totally clear/cancel an programmed alert, the PDM also uses the
$19 Configure Alerts
command with I set to alert # to be cleared with the rest of
VXX, YYYY and 0J0K values as all 0's for certain alerts.
In this example from Reservoir almost empty (50U),
a Pod has dropped below its set 50U low reservoir alert limit and returns a
$1D Status Response with low reservoir alert bit set.
This causes the PDM to display a low reservoir alarm
and to press OK to cancel the alarm.
Upon clicking OK, the PDM sends the following $11 Acknowledge Alerts command
which will cancel the pod beeping and the underlying configured alert.
11 05 NNNNNNNN MM
11 05 2f9b5b2f 10
In this example, MM is $10 or 1 << 4
and thus alert #4 is acknowledged and cancelled.
Alert #4 corresponds to the alert that is
used for the low reservoir alert as configured during
Pod startup and low reservoir alert configuration
with an $19 command IVXX value of $4c00 which has
alert # == '4', 'a' == 1 (active), 'b' == 1 (reservoir).
In this particular example,
the PDM does a Type 1 Status Request
to capture the actual alert trigger time
(in this example, alert 4's pod time was 0043 or 67 minutes)
before doing the 0x11 Acknowledge Alerts Command
which will clear this pod trigger time information for this alert
and the configured alert itself (so that it will not
retrigger with the reservoir now below the programmed 50U limit).
This command can only be used when the current Pod Progress State is between 3 and 12.