Home Assistant Integration

Prerequisites

• TOMMY Pro Edition instance running (Home Assistant add-on or Docker)
• Valid zone configuration (at least 2 devices on the same Wi-Fi band)
• Home Assistant with access to install custom integrations

Installation

Manual Installation

1. Download the latest release
2. Unpack the release and copy the custom_components/tommy directory into the config/custom_components directory of your Home Assistant installation
   • The directory structure should be config/custom_components/tommy
3. Restart Home Assistant
4. Configure the TOMMY integration (see Configuration below)

Installation using Home Assistant Community Store (HACS)

Coming soon

Configuration

1. Go to Settings → Devices & Services
2. Click "Add Integration"
3. Search for "TOMMY"
4. Fill out the details when prompted:
   • Enter the IP address of your Home Assistant instance (for Add-on) or the Docker container running TOMMY (for Docker)
   • Enter the MQTT Port assigned in your TOMMY configuration (Add-on configuration) or environment variables (Docker installation) (default: 1886)

Zones

You don't need to configure anything for zones to show up. Home Assistant will automatically stay in sync with zones in the dashboard when adding, removing, or renaming zones. For each zone, a motion sensor entity is exposed in Home Assistant.

Troubleshooting

Integration Not Found:

• Ensure the custom_components/tommy directory is in the correct location
• Restart Home Assistant after installation
• Check Home Assistant logs for installation errors

Connection Issues:

• Verify the IP address and MQTT port are correct
• Ensure TOMMY is running and accessible
• Check firewall settings if using Docker installation
• Review Home Assistant logs for connection errors

Zones Not Appearing:

• Verify motion detection is working in the TOMMY dashboard
• Confirm the integration is active in Home Assistant
• Check entity state in Developer Tools → States
• Restart the TOMMY integration if needed