Home Assistant Integration

Prerequisites

• Valid zone configuration (at least 2 devices on the same Wi-Fi band)
• Home Assistant with access to install custom integrations

Installation

Installation using Home Assistant Community Store (HACS)

1. Follow the HACS guide for custom repositories
2. When prompted for the repository, enter: https://github.com/tommy-sense/homeassistant-integration
3. Select Integration as the category
4. Click Add
5. Search for tommy in the store
6. Click on it and press Download
7. Restart Home Assistant
8. Configure the TOMMY integration (see Configuration below)

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)

Enabling the Integration

The Home Assistant integration is enabled per zone and is disabled by default:

1. Open your TOMMY dashboard
2. Open the zone you want to expose to Home Assistant (from Zones in the sidebar, or the Zones page)
3. Under Network Configuration, toggle the Home Assistant switch in Integrations. The switch only affects the selected zone, so repeat this for every zone you want to expose.

Only zones with the switch enabled show up in Home Assistant. Turning the switch off removes the zone's motion sensor entity again.

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 App) or the Docker container running TOMMY (for Docker)
   • Enter the MQTT Port assigned in your TOMMY configuration (App configuration) or environment variables (Docker installation) (default: 1886)

Zones

Once a zone has the Home Assistant integration enabled, no further configuration is needed for it to show up. Home Assistant will automatically stay in sync with zones in the dashboard when adding, removing, or renaming zones. For each enabled 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:

• Make sure the Home Assistant switch is enabled for the zone under Network Configuration → Integrations
• Verify presence 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