maxill1/ialarm-mqtt

ialarm-mqtt

一个MQTT桥接器，用于连接iAlarm（[***] IP”报警系统，如Meian和Emooluxr（通过node-ialarm库实现）。

核心功能和特性

• 支持在家布防（arm home）
• 支持离家布防（arm away）
• 支持撤防（disarm）
• 区域信息获取（正常/问题、开启、报警、旁路、故障、低电量、信号丢失）- 注意：要实时获取“开启”状态，需在报警系统Web面板选项（[***] sensori porta”）
• 支持Home Assistant mqtt-discovery（MQTT自动发现）

配置说明

编辑config.json文件，根据需求调整“mqtt”和“server”设置。注意“server.zones”参数（区域数量），默认值为40，建议根据实际传感器数量减少该值。

可选配置：可编辑“hadiscovery”节点和主题结构（编码、区域名称前缀、图标等），或移除整个“hadiscovery”节点以禁用Home Assistant MQTT自动发现功能。

主题（Topics）

json
"topics" : {
    "availability": "ialarm/alarm/availability", //在线/离线的最后遗嘱主题
    "error" : "ialarm/alarm/error", //错误信息主题
    "alarm" : {
        "state" : "ialarm/alarm/state", //当前报警状态主题
        "command" : "ialarm/alarm/set", //报警控制命令主题
        "event" : "ialarm/alarm/event", //报警日志中的最后事件字符串主题
        "bypass": "ialarm/alarm/zone/${zoneId}/bypass" //区域旁路/恢复命令主题
    },
    "sensors" : {
        "topicType" : "state", //'state'表示仅发布"state"主题，'zone'表示仅发布"zone"主题（报警、激活、低电量和故障），''（或未定义）表示两者都发布
        "state": "ialarm/sensors/state", //包含所有区域数据的数组 payload 主题
        "zone": {
            "alarm": "ialarm/sensors/${zoneId}/alarm", //单个区域的移动/警报检测传感器（on或off）
            "active": "ialarm/sensors/${zoneId}/active", //单个区域的激活（on）或旁路（off）状态传感器
            "lowBattery": "ialarm/sensors/${zoneId}/battery", //单个区域的低电量检测传感器（on）
            "fault": "ialarm/sensors/${zoneId}/fault" //单个区域的故障检测传感器（on）
        }
    }
}

负载（Payloads）

Home Assistant默认负载示例

json
"payloads": {
    "alarmAvailable" : "online", 
    "alarmNotvailable" : "offline",
    //解码接收到的报警命令状态（支持多负载）
    "alarmDecoder": {
        "armAway" : ["armAway", "armedAway", "armed_away", "arm_away", "AA", "AwayArm"],
        "armHome" : ["armHome", "armedHome", "armed_home", "arm_home", "SA", "HomeArm" ,"StayArm", "armStay", "armedStay", "arm_stay", "armed_stay"],
        "disarm" : ["disarm", "disarmed", "D"],
        "cancel" : ["cancel", "canceled", "C"],
        "trigger": [ "trigger",  "triggered", "T"]
    },
    //在"alarmState"命令中发布的负载（支持多负载）
    "alarm":{
        "armAway" : "armed_away",
        "armHome" : "armed_home",
        "disarm" : "disarmed",
        "cancel" : "cancel",
        "triggered": "triggered"
    },
    "sensorOn" : "1", //二进制传感器开启值
    "sensorOff" : "0" //二进制传感器关闭值
}

mqttthing（Homebridge）默认负载示例

json
"payloads": {
    "alarmAvailable" : "online", 
    "alarmNotvailable" : "offline",
    "alarmDecoder": {
        "armAway" : ["AA", "AwayArm"],
        "armHome" : ["SA", "StayArm"],
        "disarm" : ["D"],
        "cancel" : ["cancel"], //mqttthing未使用
        "trigger": ["T"]
    },
    "alarm":{
        "armAway" : "AA",
        "armHome" : "SA",
        "disarm" : "D",
        "cancel" : "cancel", //mqttthing未使用
        "triggered": "T"
    }
}

使用方法

Docker部署

bash
docker run --name ialarm-mqtt --restart always -v /path/to/my/config:/config maxill1/ialarm-mqtt:latest

Node.js运行

bash
npx ialarm-mqtt

或

bash
npm install -g ialarm-mqtt 
ialarm-mqtt -c /path/to/my/config

适用范围

适用于需要通过MQTT协议将iAlarm、Meian、Emooluxr等中国“TCP IP”报警系统集成到智能家居平台（如Home Assistant、Homebridge）的用户，实现远程监控、状态查询和控制功能。