Zigbee2MQTT 配置 Inswift 协调器

Zigbee2MQTT 对设备暴露通常比 ZHA 更细。Inswift 有 TI 与 Silicon Labs 两套芯片，配置差在 adapter 和端口写法。同一个协调器不要同时开 ZHA 和 Zigbee2MQTT。

速查

产品	芯片	连接	adapter	端口
ETH-52P / ETH-52P7	TI CC2652P / TI CC2652P7	以太网 / Wi-Fi / USB	`zstack`	网络：`tcp://dongle.local:6638` 或 `tcp://网关IP:6638`；USB：by-id
ETH-MG21 / ETH-MG24（含 POE）	EFR32MG21 / EFR32MG24	以太网 / Wi-Fi / USB	`ember` / `ezsp`	同上
ZBT-1P	EFR32MG21	USB	`ember` / `ezsp`	`/dev/serial/by-id/...`
ZBM-MG21 / ZBM-MG24	EFR32MG21 / EFR32MG24	USB	`ember` / `ezsp`	`/dev/serial/by-id/...`

ETH 网关 Zigbee TCP 端口默认 6638
mDNS 主机名默认 dongle.local
USB 波特率常见 115200

ember 与 ezsp（Silicon Labs）

芯科协调器的 adapter 同时看 Zigbee2MQTT 版本 和 NCP 固件（EZSP 协议）：

条件	用哪个
Z2M 1.35 及更早	`ezsp`
Z2M 1.36.0 起（含 2.x）	优先 `ember`
固件 EmberZNet 7.4.x 及以上（EZSP v13+，含 8.x / 9.x）	`ember`
固件 EmberZNet 7.4 之前（EZSP v12 及以下）	`ezsp`

ember 从 Z2M 1.36.0 引入，现为官方推荐；ezsp 已弃用，只留给旧固件。日志出现 Adapter EZSP protocol version (12) is not supported by Host 13-16 时：当前 Z2M 在用 ember，但固件还是 EZSP v12——升级协调器固件到 7.4 以上，或暂时改回 ezsp。

以太网 / Wi-Fi（Proxmox、远程 HA 建议走网络）

网关网页里可以直接复制 USB 或 TCP 配置。下图是 ETH 网页的 Zigbee2MQTT 页（Silabs 示例，adapter 为 ember；TI 请改成 zstack）。

ETH 网关网页中的 USB / TCP 配置

优先用 dongle.local。Docker、VLAN 或禁止组播 DNS 时，改成网关的局域网 IP。网页控制台：http://dongle.local/ 或 http://网关IP/。指示灯绿色常亮通常表示已经连上 Z2M。

HA 附加组件走远程 TCP 时，把 socat.enabled 设为 false。

TI：ETH-52P / ETH-52P7

serial:
  port: tcp://dongle.local:6638
  # port: tcp://网关IP:6638
  adapter: zstack
socat:
  enabled: false

Silabs：ETH-MG21 / ETH-MG24（含 POE）

serial:
  port: tcp://dongle.local:6638
  # port: tcp://网关IP:6638
  adapter: ember
  # adapter: ezsp
socat:
  enabled: false

ETH-MG 若刷的是 Zigbee Router 固件，它不是协调器，不能当 Z2M 的 serial.port。调试走网页 Logs & Debug，见 ETH-MG Router 网页 CLI 调试。网页 CLI 和 Z2M / ZHA 用的 Zigbee TCP 6638 不是同一件事。

USB

优先用稳定的 by-id 路径（Home Assistant → 设置 → 系统 → 硬件，或 ls -l /dev/serial/by-id/）。不要只写 /dev/ttyUSB0 / /dev/ttyACM0，重启后编号可能变。

权限不够时，把 HA 用户加入 dialout 组，或在容器 / 附加组件里映射设备。

Silabs USB：ZBT-1P、ZBM-MG21、ZBM-MG24

serial:
  port: /dev/serial/by-id/usb-XXXX_YYYY-if00-port0
  baudrate: 115200
  adapter: ember

EZSP 版本对不上时见上文「ember 与 ezsp」，或常见问题 FAQ。

TI 走 USB（ETH 网关当 USB 串口用时）

serial:
  port: /dev/serial/by-id/usb-XXXX_YYYY-if00-port0
  baudrate: 115200
  adapter: zstack

MQTT（第一次启动）

先配好 serial，再让 MQTT 与已经装好的 Mosquitto 一致：

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://homeassistant.local:1883
  user: 你的MQTT用户名
  password: 你的MQTT密码

Mosquitto 和 Zigbee2MQTT 要一起跑。一台主机通常只保留一个 Z2M。

常见问题

TI 和 Silabs 对换后 adapter 不对： 删掉旧的 coordinator backup，或卸掉附加组件再装，见常见问题 FAQ
找不到 fullchain.pem： 本机 Mosquitto 一般不用 TLS，删掉 mqtt 里的 cert / key
网页 Connection refused： 把 frontend.enabled 设为 true，见 FAQ
EZSP protocol version 不匹配： 见上文「ember 与 ezsp」

刷机：USB dongle 固件烧录 · ETH dongle USB 刷主机 · ETH-52P / ETH-52P7 web本地升级ESP32 / Zigbee

ETH-52P / ETH-52P7 从其它 TI 协调器迁网、复制 IEEE：ETH-52P / ETH-52P7修改IEEE(协调器迁移)

ETH-MG 从其它芯科协调器迁网、网页改 IEEE：ETH-MG web修改 IEEE（协调器迁移）