Code: |
AS + 521 |
Symbolic: |
bccAlarmSList |
This command will query the complete alarm stack from the connected device: this is a standard download transfer sequence.
REQDATA structure is the following:
Offset |
Type |
Label |
Description |
|---|---|---|---|
0 |
U32 |
FLAGS |
Query flags: 0x00000001 Query for extra parameters (ALPx)(#2) 0x00000002 Query for original alarm text only 0x00000004 Disable query for alarm text 0x00000008 Enable LCID/CID verification 0x00000010 Query using extended alarm format 0x00000020 Query source text parameter index (#3) 0x00000040 Query source text in neutral language (#4) 0x00000080 Disable common prefixes for alarm text |
4 |
U32 |
LCID |
Local alarm stack content ID (#1) |
(#1) Information required only when LCID/CID verification is enabled.
(#2) When the extended format is required, parameters are always queried.
(#3) Query of the source text parameter index is available only with the extended format and apply both to system and user text parameters.
(#4) Query source text in neutral language is available only if query for original alarm text (0x2) is active.
ACKDATA structure is the following:
Offset |
Type |
Label |
Description |
|---|---|---|---|
0 |
U32 |
COUNT |
Transfer items count (see download transfer sequence) |
4 |
U32 |
ASCAP |
Alarm stack capacity (n. of alarms) |
8 |
U32 |
CID |
Alarm stack content ID |
If initial request fails, bccNack is received. Specific errors
NACK code |
Description |
Extra data |
|---|---|---|
nackIllegalArgs |
Illegal parameters |
U16 What illegal: 1=Flags |
nackSameData |
The CID value is the same as LCID, so the query is not needed (only when verification is required). |
|
ITEMDATA structure is the following (in case of normal alarm format):
Offset |
Type |
Label |
Description |
|---|---|---|---|
0 |
U32 |
ALIX |
Alarm index (1-ASCAP) |
4 |
U16 |
ALCODE |
Alarm code (0=none) |
6 |
U16 |
ALAXIS |
Alarm axis ID (0=none) |
8 |
DBL |
ALP1 |
Alarm extra parameter 1 |
16 |
DBL |
ALP2 |
Alarm extra parameter 2 |
24 |
DBL |
ALP3 |
Alarm extra parameter 3 |
32 |
U8[8] |
- |
Reserved |
40 |
STRZ |
TEXT |
Alarm text |
ITEMDATA structure is the following (in case of extended alarm format):
Offset |
Type |
Label |
Description |
|---|---|---|---|
0 |
U32 |
ALIX |
Alarm index (1-ASCAP) |
4 |
U16 |
ALCODE |
Alarm code (0=none) |
6 |
U16 |
ALAXIS |
Alarm axis ID (0=none) |
8 |
U8 |
NITEMS |
N. of alarm items |
9 |
.. |
ITEM0 |
Alarm item 0 |
... |
... |
ITEM1 |
Alarm item 1 |
... |
... |
ITEMn |
Alarm item N |
where every ITEMx structure is the following:
Offset |
Type |
Label |
Description |
|---|---|---|---|
+0 |
U8 |
TYPE |
Item type: 1 = Signed 8bit value (I8) 2 = Unsigned 8bit value (U8) 3 = Signed 16bit value (I16) 4 = Unsigned 16bit value (U16) 5 = Signed 32bit value (I32) 6 = Unsigned 32bit value (U32) 7 = Signed 64bit value (I64) 8 = Unsigned 64bit value (U64) 9 = Float value (FLT) 10 = Double value (DBL) 11 = String value (STRZ) 12 = Alarm text (STRZ) 13 = System source text parameter (I32) 14 = User source text parameter index (I32) |
+1 |
... |
DATA |
Item data (content and length according type) |
