Skip to content

Alarm color and blink conventions (SCADA-008)

The alarm objects follow the alarm-state model of ANSI/ISA-18.2 and IEC 62682 (Management of alarm systems for the process industries). The colors also follow common ISA-101 HMI practice. These standards do not require specific colors. They ask for colors that are consistent, reserved for alarms, and backed up by non-color cues (text, shape). This library follows that approach. The defaults below are CSS custom properties, so you can adapt them to your site's HMI philosophy.

States (AlarmIndicator.value)

State Meaning Visual Blink
normal condition inactive, nothing to acknowledge grey shape, text NORMAL none
active_unacknowledged condition active, operator not yet acknowledged shape filled with the priority color, thick border in the priority color, text ACTIVE · UNACK, ACK button fast (0.8 s period)
active_acknowledged condition active, acknowledged shape filled with the priority color, text ACTIVE · ACK none (steady)
cleared_unacknowledged condition returned to normal before acknowledgement shape outlined in the priority color, text CLEARED · UNACK, ACK button slow (2 s period)

Transitions: activate() (normal/cleared → active unack), clear() (active unack → cleared unack, active ack → normal) and acknowledge() (active unack → active ack, cleared unack → normal). An acknowledgement from the front end calls the on_acknowledge callbacks with the alarm_id (SCADA-007).

Priorities (AlarmIndicator.priority)

Priority Label Default color (--awi-prio-*) Redundant shape
critical P1 red #d10000 diamond
high P2 orange #f27b00 triangle
medium P3 yellow #e6c700 square
low P4 cyan #00a4c7 circle

Numeric alarm levels (alarm_level)

Level Default color Text badge
lo, hi amber (--awi-alarm-lo, --awi-alarm-hi) LO, HI
lolo, hihi red, bold (--awi-alarm-lolo, --awi-alarm-hihi) LOLO, HIHI

With deadband, the level doesn't drop back until the value has moved back past the limit by at least the deadband (ALARM-003).

Reduced motion (A11Y-005)

When the user agent requests reduced motion (prefers-reduced-motion: reduce), blinking is turned off. Instead, the alarm shapes (and blinking LEDs) get a steady dashed outline, so an unacknowledged alarm still looks different from an acknowledged one.