Home Automation¶

The home automation stack runs in the home-automation namespace and provides smart home control, Zigbee device management, Matter/Thread protocol support, and MQTT messaging. All components are pinned to worker-04, which has the required USB hardware attached.

Architecture¶

flowchart TD
    subgraph Devices
        ZD[Zigbee Devices]
        MD[Matter Devices]
        TD[Thread Devices]
    end

    subgraph Coordinators["Hardware Coordinators"]
        SLZB[SLZB-06<br/>Zigbee Coordinator<br/>tcp://slzb-06:6638]
    end

    subgraph Cluster["home-automation namespace"]
        Z2M[Zigbee2MQTT<br/>Port 8080]
        MOS[Mosquitto<br/>MQTT Broker<br/>Port 1883]
        HA[Home Assistant<br/>Port 8123]
        MS[Matter Server<br/>Port 5580]
        OTBR[OTBR<br/>Thread Border Router<br/>Port 80]
    end

    ZD <-->|Zigbee protocol| SLZB
    SLZB <-->|TCP| Z2M
    Z2M -->|Publish device state| MOS
    MOS -->|Subscribe to updates| HA
    HA <-->|WebSocket| MS
    MD <-->|Matter protocol| MS
    TD <-->|Thread protocol| OTBR
    OTBR --> HA

    classDef broker fill:#f59e0b,stroke:#d97706,color:#000
    classDef hub fill:#7c3aed,stroke:#5b21b6,color:#fff
    class MOS broker
    class HA hub

Application Summary¶

Node Pinning¶

All home automation components are pinned to worker-04 (an Acemagician AM06 node) using nodeSelector:

nodeSelector:
  kubernetes.io/hostname: worker-04

This is required because:

• The SLZB-06 Zigbee coordinator is accessible via TCP from this node's network segment
• Matter Server requires hostNetwork: true for mDNS discovery and must be co-located with Home Assistant
• OTBR needs access to /dev for Thread radio hardware

Protocol Stack¶