gandalf/secubox-openwrt
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
49a6090dcf
secubox-openwrt/package/secubox/secubox-app-zigbee2mqtt
History
CyberMind-FR eebc84d0b9 fix(zigbee2mqtt): Fix adapter type, config format, and add MQTT dependency 
The z2m 2.x breaking changes required three fixes discovered during
live deployment testing on the router:
- Adapter renamed from `ezsp` to `ember` in zigbee-herdsman 4.0.0
- Config format needs `version: 4` and nested `homeassistant.enabled`
- Start script needs `ZIGBEE2MQTT_DATA` env var for correct config path
- Add `mosquitto-nossl` as package dependency (MQTT broker required)
- Direct `/dev/ttyUSB0` passthrough works; socat TCP bridge does not

Also updates project planning files (HISTORY.md, TODO.md, WIP.md,
CLAUDE.md) and rebuilds bonus feed with latest IPKs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 19:29:59 +01:00
..
files fix(zigbee2mqtt): Fix adapter type, config format, and add MQTT dependency 2026-02-04 19:29:59 +01:00
Makefile fix(zigbee2mqtt): Fix adapter type, config format, and add MQTT dependency 2026-02-04 19:29:59 +01:00
README.md

README.md

SecuBox Zigbee2MQTT - Zigbee to MQTT Bridge

Docker-based Zigbee2MQTT bridge for OpenWrt. Connects Zigbee devices to your MQTT broker via a USB Zigbee adapter, enabling smart home integration without vendor cloud dependencies.

Installation

opkg install secubox-app-zigbee2mqtt

Configuration

UCI config file: /etc/config/zigbee2mqtt

uci set zigbee2mqtt.main.enabled='1'
uci set zigbee2mqtt.main.port='8099'
uci set zigbee2mqtt.main.serial_port='/dev/ttyACM0'
uci set zigbee2mqtt.main.mqtt_server='mqtt://localhost:1883'
uci commit zigbee2mqtt

Usage

zigbee2mqttctl start       # Start Zigbee2MQTT container
zigbee2mqttctl stop        # Stop Zigbee2MQTT container
zigbee2mqttctl status      # Show service status
zigbee2mqttctl logs        # View container logs
zigbee2mqttctl permit      # Open network for device pairing

Features

  • Web frontend for device management and pairing
  • USB Zigbee adapter support (CC2531, CC2652, SONOFF, etc.)
  • MQTT topic-based device control
  • OTA firmware updates for Zigbee devices
  • Docker container isolation

Dependencies

  • kmod-usb-acm
  • dockerd
  • docker
  • containerd

License

Apache-2.0