node-red-contrib-alarm-ultimate 0.1.2

Alarm System node for Node-RED.

npm install node-red-contrib-alarm-ultimate

node-red-contrib-alarm-ultimate

Alarm System Ultimate nodes + web panel for Node-RED.

Includes:

• AlarmSystemUltimate (BETA): full alarm control panel node (zones, entry/exit delays, bypass, chime, 24h/fire/tamper, siren, event log).
• AlarmUltimateInputAdapter: translates incoming messages into zone messages for AlarmSystemUltimate using built-in or user-defined presets.
• Output-only helper nodes: AlarmUltimateState, AlarmUltimateZone, AlarmUltimateSiren.
• Web tools: Zones JSON mapper + web Alarm Panel (embeddable in Node-RED Dashboard).

Note: AlarmSystemUltimate is currently BETA.

Table of contents

• Install
• Screenshots
• Nodes
• Web tools
• Examples
• Permissions and endpoints
• Development

Install

• Palette Manager: Menu → Manage palette → Install → search alarm ultimate
• NPM:

npm i node-red-contrib-alarm-ultimate

Screenshots

Alarm Panel (web)

Flow overview

Nodes

Alarm System Ultimate (BETA)

Main node that:

• Receives control commands on msg.topic === controlTopic
• Receives sensor messages on any other topic and matches them to a configured zone

It emits events and state updates on multiple outputs (see the node help in the editor for full details).

Output-only helper nodes

These nodes have no input and emit the current Alarm state (and changes) for one configured AlarmSystemUltimate:

• Alarm State (AlarmUltimateState): msg.payload = "armed"|"disarmed"
• Alarm Zone (AlarmUltimateZone): msg.payload = true|false for a selected zone
• Alarm Siren (AlarmUltimateSiren): msg.payload = true|false when the siren is on/off

Input Adapter

AlarmUltimateInputAdapter translates incoming messages (from arbitrary sources) into the format expected by the Alarm zones.

• Built-in presets are shipped with the package.
• A single user preset (custom JavaScript) can be created/edited inside the node and is stored in the node configuration.

Web tools

These pages are served via the Node-RED admin HTTP endpoint:

• Zones JSON Mapper: /alarm-ultimate/alarm-json-mapper
• Alarm Panel: /alarm-ultimate/alarm-panel

The Alarm Panel supports:

• Preselect node: /alarm-ultimate/alarm-panel?id=<alarmNodeId>
• Embed mode (for Dashboard iframes): /alarm-ultimate/alarm-panel?embed=1&id=<alarmNodeId>

The Zones JSON Mapper supports:

• Sample message mapping (e.g. KNX Ultimate): map topic/payload fields and generate a zone template.
• ETS Group Addresses export (TSV): paste the exported table and generate zones in batch (boolean datapoints only).

Examples

• examples/alarm-ultimate-basic.json: ready-to-import flow with AlarmSystemUltimate, injects and debug nodes.
• examples/alarm-ultimate-dashboard.json: Node-RED Dashboard example embedding the Alarm Panel in a ui_template iframe.
• examples/alarm-ultimate-dashboard-controls.json: Node-RED Dashboard example with the embedded panel plus command buttons (and a small sensor simulator).
• examples/alarm-ultimate-dashboard-v2.json: Dashboard 2.0 example for @flowfuse/node-red-dashboard (Alarm Panel + basic controls + status).

See examples/README.md.

Development

Run tests:

npm test

Permissions and endpoints

When Node-RED authentication is enabled, the admin endpoints use these permissions (if available):

• AlarmSystemUltimate.read
• AlarmSystemUltimate.write
• AlarmUltimateInputAdapter.read

HTTP admin endpoints:

• GET /alarm-ultimate/alarm/nodes
• GET /alarm-ultimate/alarm/:id/state
• GET /alarm-ultimate/input-adapter/presets
• POST /alarm-ultimate/alarm/:id/command
• GET /alarm-ultimate/alarm-json-mapper
• GET /alarm-ultimate/alarm-panel