Document Z-Wave JS and Zigbee2MQTT on Docker host; drop Raspberry Pi docs

- raspi_zwave.md -> zwave_zigbee.md: zwavejs + zigbee2mqtt containers, Z-Net G8 ports 2001/2002 - Remove obsolete migratezwave.md plan - Add containers to docker.md, MQTT/Zigbee notes to ha.md, component entry to CLAUDE.md
2026-10-09 07:23:22 -04:00
parent 0b2f68a1c2
commit fab35e8e7c
6 changed files with 74 additions and 137 deletions
@@ -0,0 +1,68 @@
+# Z-Wave & Zigbee Infrastructure
+
+## Architecture
+
+```
+Z-Wave: HA (10.100.0.40) --ws:3100--> Docker host (10.100.0.35) zwavejs     --tcp:2001--> Z-Net G8 (10.200.0.106) Z-Wave radio
+Zigbee: HA Mosquitto (10.100.0.40:1883) <--mqtt-- Docker host zigbee2mqtt   --tcp:2002--> Z-Net G8 SmartStick ZB (USB)
+```
+
+Both radios live on the Z-Net G8; both controller apps run as containers on the Docker host, deployed by the Ansible playbook (`~/playbook`, roles `zwavejs` and `zigbee2mqtt`).
+
+The Raspberry Pi (10.200.0.190) that previously hosted Z-Wave JS UI is gone.
+
+## Z-Net G8 (Z-Wave Controller)
+
+- **Hostname**: Z-Net-G8
+- **IP**: 10.200.0.106 (IOT_200, VLAN 200)
+- **MAC**: 02:53:ec:d0:de:dd
+- **Manufacturer**: HomeSeer Technologies
+- **Role**: Z-Wave radio controller (Node 1), serial-over-TCP on port 2001
+- **Zigbee**: HomeSeer SmartStick ZB plugged into the Z-Net's USB, exposed on port **2002** (2003 is for older Sonoff ZBDongle-E revisions). Requires Z-Net firmware ≥ 1.0.27 (running 1.0.27).
+- **Web UI**: http://10.200.0.106/
+
+## Z-Wave JS UI (container on the Docker host)
+
+- **Host**: [Docker Server](docker.md) — `ssh dohertj2@10.100.0.35`
+- **Container**: `zwavejs` (`zwavejs/zwave-js-ui:latest`), restart `unless-stopped`, created 2026-07-03
+- **Compose file**: `/opt/zwavejs/docker-compose.yml` (templated by playbook role `zwavejs`)
+- **Store/data**: `/opt/zwavejs/store` → `/usr/src/app/store` (`settings.json`, `nodes.json`, `backups/`)
+- **Network**: `traefik`
+- **Web UI**: https://zwave.dohertylan.com (Traefik → port 8091, Authelia SSO; Z-Wave JS UI's own auth is disabled)
+- **Z-Wave JS websocket**: ws://10.100.0.35:3100 (host 3100 → container 3000)
+
+### Z-Wave JS Config
+
+- **Serial port**: `tcp://10.200.0.106:2001` (Z-Net G8 over network)
+- **Z-Wave region**: 1 (US)
+- **Server port**: 3000 in container (published as 3100)
+
+## Home Assistant Integration
+
+- **Integration**: zwave_js
+- **Connects to**: ws://10.100.0.35:3100
+- **Size**: 25 devices, 296 entities (2026-10-09)
+- **Node 1**: HomeSeer Z-Wave Shield with External Antenna (Z-Net G8)
+- Two stale `not_loaded` config entries remain (an old "Z-Wave JS" entry and a Silicon Labs CP2102N USB serial entry)
+
+## Zigbee2MQTT (container on the Docker host)
+
+- **Container**: `zigbee2mqtt` (`koenkk/zigbee2mqtt:latest`, 2.14.2 at deploy), restart `unless-stopped`, deployed 2026-10-09
+- **Playbook role**: `zigbee2mqtt` — `sudo ansible-playbook site.yml -i localhost, -c local --tags zigbee2mqtt --limit localhost` from `~/playbook` (Semaphore currently has no project configured)
+- **Compose file**: `/opt/zigbee2mqtt/docker-compose.yml`
+- **Data**: `/opt/zigbee2mqtt/data` → `/app/data` (`configuration.yaml` holds the generated network key — back it up; `coordinator_backup.json`)
+- **Config ownership**: `configuration.yaml` is seeded once by Ansible (never overwritten); MQTT, serial and frontend settings are enforced by `ZIGBEE2MQTT_CONFIG_*` env vars in the compose file
+- **Web UI**: https://zigbee.dohertylan.com (Traefik → port 8080, Authelia SSO)
+- **Coordinator**: `tcp://10.200.0.106:2002`, adapter `ember`, EmberZNet 7.4.3, IEEE 0x8c8b48fffe2dd481
+- **Network**: channel 25, PAN ID 64462 (0xFBCE) — new network formed 2026-10-09; all devices must be (re)paired
+- **MQTT**: HA's Mosquitto broker add-on at mqtt://10.100.0.40:1883, base topic `zigbee2mqtt`, HA discovery enabled
+  - **User**: `zigbee2mqtt` / **Password**: `Aywm6DjOR3bfSo9c7zDoWDxX` (login in the Mosquitto add-on options; also in the playbook role defaults)
+
+### Pairing devices
+
+Turn on **Permit join** in the Zigbee2MQTT web UI (or the `switch.zigbee2mqtt_bridge_permit_join` entity in HA), then reset/pair the device. It appears in HA automatically via MQTT discovery.
+
+## Notes
+
+- Z-Net G8 is on the IoT VLAN; the Docker host reaches it cross-VLAN (or via its IOT_200 interface 10.200.0.35)
+- Tracked by Unifi as device_tracker.z_net_g8