network/raspi_zwave.md

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)