Smart Home Integration

Matter Integration

TOMMY zones can be integrated with any Matter-compatible smart home platform as motion sensor devices. This provides universal compatibility with major smart home ecosystems including Apple HomeKit, Google Home, Samsung SmartThings, and more.

Prerequisites

  • TOMMY instance running (Home Assistant add-on or Docker)
  • Valid zone configuration (at least 2 devices on the same Wi-Fi band)
  • Matter-compatible platform with Matter support enabled
  • Network connectivity between TOMMY and your Matter controller

Certification Warning

You may encounter a certification warning stating "This device has not been certified" with a safety prompt. This is normal for development devices, and you can safely continue with the pairing process.

Setting Up Matter Integration

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 "Matter" from the dropdown
  5. TOMMY will generate QR and setup codes for pairing

Platform-Specific Setup

Apple HomeKit

  1. Launch the Home app on your iPhone, iPad, or Mac
  2. Tap the "+" icon and select "Add Accessory"
  3. Use "Scan QR Code" or select "More Options" for manual code entry
  4. Scan the QR code or enter the setup code from the TOMMY dashboard if QR scanning fails
  5. Follow the Home app prompts to finish pairing
  6. Assign the sensor to a room

Google Home

  1. Launch the Google Home app
  2. Tap "+" and select "Set up device"
  3. Select "Works with Google" and then "Matter"
  4. Scan the QR code or enter the setup code from the TOMMY dashboard if QR scanning fails
  5. Follow Google Home prompts to finish pairing
  6. Assign the sensor to a room

Samsung SmartThings

  1. Launch the SmartThings app
  2. Tap "+" and select "Add device"
  3. Use "Scan QR code" option
  4. Scan the QR code or enter the setup code from the TOMMY dashboard if QR scanning fails
  5. Follow SmartThings prompts to finish pairing
  6. Assign the sensor to a room

Generic Matter Setup

For other Matter-compatible platforms:

  1. Launch your Matter-compatible application
  2. Find "Add Device" or "Add Accessory" option
  3. Choose Matter/Thread device type if prompted
  4. Scan the QR code or enter the setup code from the TOMMY dashboard if QR scanning fails
  5. Follow your platform's prompts to finish pairing
  6. Assign the sensor to a room

Pairing Code Information

QR Code:

  • First-time pairing only (cannot be reused after successful pairing)
  • Quick setup with camera-enabled devices

Setup Code (Manual Pairing Code):

  • Can be used for initial pairing and subsequent re-pairings
  • Manual entry when QR scanning isn't available
  • Always available as fallback method