Smart Home Hub Setup

1) ESP32 Quick Setup

• Flash ESP32 firmware with WebSocket/MQTT support
• Configure Wi-Fi SSID/password and static LAN IP
• Map relay pins for light/fan/switch circuits

Relay Wiring (reference)

• GPIO 23 → Relay 1 (lights)
• GPIO 22 → Relay 2 (fan)
• GPIO 21 → Relay 3 (AC trigger)
• Common/GND as per relay module isolation requirements

2) MQTT Broker Setup

HiveMQ Cloud

1. Create cluster and WebSocket endpoint
2. Create credentials
3. Add broker URL to .env.local
4. Set topic prefix: fantom/{projectId}/devices/{deviceId}

Local Mosquitto

• Install Mosquitto
• Enable WebSocket listener (default 9001)
• Add username/password and TLS where possible

3) Matter/Thread Bridge

• Use Home Assistant + Matter server + Thread border router
• Commission devices to Thread fabric
• Expose bridged endpoints to Fantom Interio via simulator/bridge adapters

4) Multi-Hub Networking

• Segment hubs by room/floor
• Use consistent topic naming and project prefixes
• Keep command and state channels separated

5) Security Best Practices

• Use TLS (wss://) for MQTT when available
• Rotate auth tokens regularly
• Restrict broker ACLs by project/topic
• Isolate IoT VLAN from main user devices
• Log command origin and timestamps