dchesterton/texecom2mqtt

texecom2mqtt

概述

texecom2mqtt是一款通过MQTT协议与Texecom Premier Elite系列报警面板交互的应用程序。它要求使用搭载v4及以上固件的Premier Elite面板（非Premier系列），并配备ComIP或SmartCom模块。该应用支持Home Assistant自动发现功能，且可作为Home Assistant插件使用。

***支持

许多用户希望提供小额以表支持。如果您愿意，可以通过"Buy Me A Coffee"页面进行。请注意，***完全出于自愿——开发此应用是因为它对我和其他用户有用，而非为了经济收益——但任何形式的感谢都将受到诚挚的感谢🙂

应用运行方式

Home Assistant插件

如需将应用配置为Home Assistant插件，请按以下步骤操作：

1. 进入Home Assistant的"Supervisor"（超级管理员），然后选择"Add-on store"（插件商店）。
2. 点击右上角图标，添加仓库地址 https://github.com/dchesterton/texecom2mqtt-hassio。此时插件将显示在插件商店页面中。
3. 在插件商店页面点击"texecom2mqtt"，然后点击"Install"（安装）。
4. 在"Configuration"（配置）选项卡中填写Texecom面板和MQTT的详细信息（该插件可与任何MQTT服务器配合使用，但已预配置为兼容官方Mosquitto MQTT插件）。
5. 点击"Save"（保存）以保存配置。
6. 进入"Info"（信息）选项卡，勾选"Start on boot"（开机启动）和"Watchdog"（看门狗）选项，然后点击"Start"（启动）。
7. 应用启动后，可在"Log"（日志）选项卡中查看输出日志。

Docker

bash
docker run -d -v $PWD/config.yml:/app/config.yml --name texecom2mqtt dchesterton/texecom2mqtt:latest

Docker Compose

yaml
version: "3"
services:
    texecom2mqtt:
        container_name: texecom2mqtt
        image: dchesterton/texecom2mqtt:latest
        restart: unless-stopped
        volumes:
            - ./config.yml:/app/config.yml

配置文件（config.yml）

yaml
texecom:
    host: 192.168.0.1 # 必填：Texecom面板IP地址
    udl_password: "abcdef" # 可选：面板中设置的UDL密码。注意：这不是布防/撤防使用的密码（默认：1234）
    port: 10002 # 可选：连接面板的端口（默认：10001）

mqtt:
    host: 192.168.1.5 # 可选：MQTT代理URL或IP地址（默认：localhost）
    port: 1884 # 可选：代理端口（默认：1883，TLS连接时为8883）
    prefix: texecom2mqtt # 可选：主题前缀（默认：texecom2mqtt）
    username: my_user # 可选：代理用户名（默认：无）
    password: my_password # 可选：代理密码（默认：无）
    client_id: texecom2mqtt # 可选：客户端ID（默认：texecom2mqtt）
    keepalive: 30 # 可选：保活时间（秒）（默认：60）
    clean: true # 可选：清除会话（默认：true）
    retain: true # 可选：保留消息（默认：true）
    retain_log: false # 可选：保留日志消息（默认：false）
    qos: 2 # 可选：服务质量（默认：0）
    ca: /cert/ca.pem # 可选：TLS连接的CA证书（默认：无）
    cert: /cert/cert.pem # 可选：TLS连接的证书（默认：无）
    key: /cert/key.pem # 可选：TLS连接的私钥（默认：无）
    reject_unauthorized: true # 可选：若不为false，服务器证书将根据提供的CA列表验证。谨慎覆盖（默认：使用TLS时为true）

homeassistant:
    discovery: true # 可选：启用Home Assistant发现（默认：false）
    prefix: home-assistant # 可选：Home Assistant MQTT主题前缀（默认：homeassistant）

# 可选：仅当需要覆盖区域名称或设备类别时使用
zones:
    - id: front_door # 必填：区域编号或ID（例如：'front_door'或'4'）
      name: 前门传感器 # 可选：覆盖区域名称（默认：面板中的区域名称）
      device_class: motion # 可选：设置区域在Home Assistant中的设备类别（默认：应用根据区域名称和类型猜测）。参见https://www.home-assistant.io/integrations/binary_sensor/#device-class获取可用设备类别

    - id: ...
      name: ...

# 可选：仅用于Home Assistant映射
areas:
    - id: house # 必填：区域编号或ID（例如：'detached_garage'、'4A'或'2'）
      name: 房屋报警 # 可选：覆盖区域名称（默认：面板中的区域名称）
      full_arm: armed_away # 可选：Texecom布防类型到Home Assistant布防类型的映射（armed_away、armed_home、armed_night、armed_custom_bypass、armed_vacation），忽略不相关类型
      part_arm_1: armed_night
      part_arm_2: armed_home
      part_arm_3: armed_custom_bypass
      code_arm_required: false # 可选：参见https://www.home-assistant.io/integrations/alarm_control_panel.mqtt/#code_arm_required
      code_disarm_required: false # 可选：参见https://www.home-assistant.io/integrations/alarm_control_panel.mqtt/#code_disarm_required
      code: "123456" # 可选：参见https://www.home-assistant.io/integrations/alarm_control_panel.mqtt/#code
    - id: ...
      name: ...

cache: true # 可选：缓存面板数据而非每次加载。建议在使用较大面板或数据不变时启用（默认：false）
log: debug # 可选：日志级别（trace、debug、panel、info、warning或error，默认：info）

MQTT主题

texecom2mqtt/zone/[name]

表示区域当前状态的对象，示例：

json
{
    "name": "前门",
    "number": 5,
    "status": 1,
    "type": "Entry/Exit 1",
    "areas": ["A", "B", "C"]
}

texecom2mqtt/area/[name]

表示区域当前状态的对象，示例：

json
{
    "id": "A",
    "name": "房屋报警",
    "number": 1,
    "status": "disarmed",
    "last_active_zone": {
        "name": "前门",
        "number": 1
    }
}

status参数可能的值：

• disarmed（撤防）
• full_armed（全布防）
• part_armed_1（部分布防1）
• part_armed_2（部分布防2）
• part_armed_3（部分布防3）
• triggered（触发）
• in_entry（进入延时）
• in_exit（退出延时）

last_active_zone仅在status为triggered时可用。

texecom2mqtt/area/[name]/command

设置区域状态，payload必须为以下值之一：

• full_arm（全布防）
• part_arm_1（部分布防1）
• part_arm_2（部分布防2）
• part_arm_3（部分布防3）
• disarm（撤防）

texecom2mqtt/text

设置所有连接键盘的LCD文本，payload为显示字符串（最大32字符）。

texecom2mqtt/datetime

设置系统日期，payload应为ISO 8601格式字符串（可由https://moment.github.io/luxon/docs/manual/parsing.html%E8%A7%A3%E6%9E%90%EF%BC%89%E3%80%82

texecom2mqtt/status

应用运行状态，值为online（在线）或offline（离线）。

texecom2mqtt/power

当前功耗信息对象，示例：

json
{
    "battery_charging_current": 36,
    "battery_voltage": 13.42,
    "panel_current": 423,
    "panel_voltage": 13.49
}

battery_charging_current和panel_current单位为毫安。

texecom2mqtt/log

面板日志事件对象，示例：

json
{
    "type": "ArmFailed",
    "description": "布防失败",
    "timestamp": "2020-01-01T00:00:00+00:00",
    "areas": ["A"],
    "parameter": 8,
    "entity": {
        "zone_id": "front_door",
        "zone_name": "前门"
    }
}

parameter根据事件类型可能为区域编号、用户编号、扩展器编号或键盘编号。entity对"UserCode"事件为用户对象，对"ArmFailed"事件为区域对象。

日志事件类型包括：EntryExit1、EntryExit2、Guard、GuardAccess、TwentyFourHourAudible、TwentyFourHourSilent、PAAudible、PASilent、Fire、Medical、TwentyFourHourGas、Auxiliary、Tamper、ExitTerminator、MomentKey、LatchKey、Security、OmitKey、Custom、ConfirmedPAAudible、ConfirmedPASilent、KeypadMedical、KeypadFire、KeypadAudiblePA、KeypadSilentPA、DuressCodeAlarm、AlarmActive、BellActive、Rearm、VerifiedCrossZoneAlarm、UserCode、ExitStarted、ExitError、EntryStarted、PartArmSuite、ArmedWithLineFault、OpenClose、PartArmed、AutoOpenClose、AutoArmDeferred、OpenAfterAlarm、RemoteOpenClose、QuickArm、RecentClosing、ResetAfterAlarm、PowerOPFault、ACFail、LowBattery、SystemPowerUp、MainsOverVoltage、TelephoneLineFault、FailToCommunicate、DownloadStart、DownloadEnd、LogCapacityAlert、DateChanged、TimeChanged、InstallerProgrammingStart、InstallerProgrammingEnd、PanelBoxTamper、BellTamper、AuxiliaryTamper、ExpanderTamper、KeypadTamper、ExpanderTrouble、RemoteKeypadTrouble、FireZoneTamper、ZoneTamper、KeypadLockout、CodeTamperAlarm、SoakTestAlarm、ManualTestTransmission、AutomaticTestTransmission、UserWalkTestStartEnd、NVMDefaultsLoaded、FirstKnock、DoorAccess、PartArm1、PartArm2、PartArm3、AutoArmingStarted、ConfirmedAlarm、ProxTag、AccessCodeChangedDeleted、ArmFailed、LogCleared、iDLoopShorted、CommunicationPort、TAGSystemExitBatteryOK、TAGSystemExitBatteryLow、TAGSystemEntryBatteryOK、TAGSystemEntryBatteryLow、MicrophoneActivated、AVClearedDown、MonitoredAlarm、ExpanderLowVoltage、SupervisionFault、PAFromRemoteFOB、RFDeviceLowBattery、SiteDataChanged、RadioJamming、TestCallPassed、TestCallFailed、ZoneFault、ZoneMasked、FaultsOverridden、PSUACFail、PSUBatteryFail、PSULowOutputFail、PSUTamper、DoorAccess2、CIEReset、RemoteCommand、UserAdded、UserDeleted、ConfirmedPA、UserAcknowledged、PowerUnitFailure、BatteryChargerFault、ConfirmedIntruder、GSMTamper、RadioConfigFailure、QuickPartArm1、QuickPartArm2、QuickPartArm3、RemotePartArm1、RemotePartArm2、RemotePartArm3。

texecom2mqtt/config

应用配置信息对象，示例：

json
{
    "version": "1.0.41",
    "log_level": "debug",
    "model": "Premier Elite 48",
    "firmware_version": "V5.02.01LS1",
    "serial_number": "12345"
}

故障排除

• 应用无法正常工作

  • 确认config.yml中IP地址和端口正确（UDL/数字选项 - 设置模块 - 设置IP数据）
  • 确认ComIP/SmartCom已配置（UDL/数字选项 - 串口设置 - 将串口1/2/3设为"ComIP模块"）
  • 确认config.yml中UDL密码正确（UDL/数字选项 - UDL选项 - UDL密码）
  • 确认已禁用加密（UDL/数字选项 - 设置模块 - 加密端口）

• 官方Texecom应用与texecom2mqtt冲突

  • 每个物理连接（SmartCom/ComIP）仅支持一个并发应用。建议仅运行其中一个，或同时安装SmartCom和ComIP分别使用

Home Assistant集成问题

• 实体未显示

  • 确认Home Assistant的MQTT配置中启用"发现"（配置 - MQTT）
  • 若修改了默认前缀，确认config.yml中设置了正确前缀

• 报警面板卡片状态显示不全

  • 默认仅显示"离家布防"和"在家布防"，需编辑卡片并从"可用状态"下拉菜单选择其他状态