Skip to content
CC2 Device Documentation

Duress App Overview

The Duress App provides a personal safety alert system for CC2 device wearers. When a wearer pulls the safety switch, a notification is sent to nearby devices so colleagues can respond.

Portal URL: https://duress.infrafon.club/

The complete flow

Section titled “The complete flow”

  1. Trigger – Wearer pulls the duress switch on their badge. The device publishes an MQTT uplink with "alerting": true and "origin": 2 (duress button).

  2. Portal receives the uplink – The Duress Management Portal’s MQTT handler detects the alert, identifies the originating device, and determines the best location and user name to include in the notification.

  3. Nearby devices selected – The portal compares the originating device’s location (zone or stored location) with all other managed devices and picks the closest ones (by site → building → floor → room).

  4. Notification sent – The portal publishes an MQTT downlink command to each selected device. This command updates the duress Device View with a new alert entry.

  5. Recipient sees the alert – The receiving device’s duress DV shows the alert in its alerts msglist. Tapping the alert opens a detail page with the subject’s name, location, and responder count.

Key data sources

Section titled “Key data sources”
What the recipient seesWhere it comes from
Subject name (subj)Portal’s Associated User field for the originating device
Location (location)Best available location: BLE zone name → stored portal location → device’s raw location
Responder count (resp)Portal sets initially to 0, increments as others acknowledge

Important: The portal’s “Associated User” is completely independent of the device’s own user_name widget. Changing the device’s vname does not change the notification name.

Section titled “Related”