Home Assistant Integration

Prerequisites

• TOMMY instance running (Home Assistant add-on or Docker)
• Valid zone configuration (at least 2 devices on the same Wi-Fi band)
• Matter integration installed in Home Assistant

Setting Up Matter Integration

Install Matter Integration

If not already installed:

1. Go to Settings → Devices & Services
2. Click "Add Integration" and search for "Matter"
3. Follow the setup wizard to install
4. Verify the Matter integration appears in your integrations list

For detailed instructions, see the Home Assistant Matter Integration guide.

Adding TOMMY Motion Sensors

Generate Pairing Codes

1. Open your TOMMY dashboard
2. Select the zone you want to integrate
3. Click the "Integration" button in the Motion Detector section
4. Choose "Home Assistant" from the dropdown
5. TOMMY will generate QR and setup codes for pairing

Pairing Process

Method 1: QR Code (First-time pairing)

1. Navigate to Settings → Devices & Services
2. Click "Matter" in the "Configured" list
3. Click "Add device" and select "No. It's new." when asked if your device is already added to another Matter controller
4. Scan the QR code displayed in the TOMMY dashboard
5. Follow the Home Assistant pairing wizard

Method 2: Setup Code (Subsequent pairings)

1. Navigate to Settings → Devices & Services
2. Click "Matter" in the "Configured" list
3. Click "Add device" and select "Yes. It's already in use." when asked if your device is already added to another Matter controller
4. Enter the setup code from the TOMMY dashboard
5. Follow the Home Assistant pairing wizard

Important Notes

QR Code Limitations:

• QR codes can only be used the first time a device is added to the network
• Use the setup code for additional pairings or re-pairings
• Generate new codes if needed through the TOMMY dashboard

Certification Warnings:

• You may see a warning that the device has not been certified
• This is normal for development devices and can be safely ignored
• All features work normally despite certification warnings

Troubleshooting

Pairing Fails:

• Try manual setup code instead of QR code
• Restart both TOMMY and Home Assistant Matter integration
• Review Home Assistant logs for Matter-related errors
• Ensure no firewall is blocking Matter communication

Sensor Not Updating:

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