Initial commit: home network inventory and runbooks

2026-04-29 09:00:06 -04:00
commit 982ddc0e8f
15 changed files with 1181 additions and 0 deletions
@@ -0,0 +1,55 @@
+# Z-Wave Infrastructure
+
+## Architecture
+
+```
+HA (10.100.0.40) --ws:3000--> Raspberry Pi (10.200.0.190) --tcp:2001--> Z-Net G8 (10.200.0.106)
+                                 (Z-Wave JS UI)                          (Z-Wave radio controller)
+```
+
+## 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
+
+## Raspberry Pi (Z-Wave JS UI Host)
+
+- **Hostname**: zwave
+- **IP**: 10.200.0.190 (IOT_200, VLAN 200)
+- **MAC**: e4:5f:01:02:3c:26
+- **Hardware**: Raspberry Pi (Raspberry Pi Trading Ltd)
+- **SSH**: `ssh dohertj2@10.200.0.190` (passwordless)
+- **Web UI**: http://10.200.0.190:8091
+- **Z-Wave JS websocket**: ws://10.200.0.190:3000
+
+### Docker Containers
+
+| Container | Image | Ports |
+|-----------|-------|-------|
+| zwavejs2mqtt | zwavejs/zwave-js-ui:latest | 3000 (websocket), 8091 (web UI) |
+| zigbee2mqtt | koenkk/zigbee2mqtt:latest | — |
+| portainer_agent | portainer/agent:2.21.5 | 9001 |
+| ouroboros | pyouroboros/ouroboros | — |
+
+### 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 (websocket for HA)
+- **Status**: ready
+
+## Home Assistant Integration
+
+- **Integration**: zwave_js
+- **Connects to**: ws://10.200.0.190:3000
+- **Node 1**: HomeSeer Z-Wave Shield with External Antenna (Z-Net G8)
+
+## Notes
+
+- Both devices sit on the IoT VLAN (10.200.0.0/24)
+- HA connects cross-VLAN (LAN_100 -> IOT_200) to the Raspi websocket
+- The Raspi also runs Zigbee2MQTT (separate Zigbee network)
+- Tracked by Unifi as device_tracker.zwave (Raspi) and device_tracker.z_net_g8 (controller)