Apple Home conformance test 1.1

This test suite is used for testing the functionality of Matter accessories with Apple Home. Conformance testing and verification of all use cases ensure that accessories are compatible with Apple Home, and are required in order to use the Works with Apple Home badge on product packaging and marketing communications.

Get started

To test that your accessory works with Apple Home, you’ll need the following devices:

  • An iPhone running the latest version of iOS
  • One of the following home hub devices running the latest software:
    • HomePod mini
    • Apple TV 4K (3rd generation) Wi-Fi + Ethernet
    • HomePod (2nd generation)
  • A WiFi router with your devices connected to the network

After you’ve set up your devices, add a new home in the Apple Home app on your iPhone that’s connected to a home hub device. Then perform the following steps outlined in each of the following test cases.

Test cases

TCBG001: Accessory discovery

  1. Put the accessory in pairing mode.
  2. In the Home app, tap “Add Accessory”, then tap “More options…”.
  3. Verify that the accessory appears in the discoverable list and the tile reflects the correct device type.

TCBG002: Pair via manual code (11 digit, 21 digit)

  1. Retrieve the 11- or 21-digit manual code from the accessory.
  2. In the Home app, tap the add button (+) then tap “Add Accessory”, “More options…”, “My accessory isn’t shown here”, and “Enter code…”.
  3. Enter the manual code from step 1 and tap “Continue”.
  4. Add the accessory to a room and complete any additional setup.
  5. Verify that the accessory was added to the home and doesn't show the message “No Response”.
  6. Trigger a write to the accessory.

TCBG003: Pair via QR code

  1. In the Home app, tap the add button (+), then tap “Add Accessory” and scan the accessory’s QR setup code.
  2. Verify that the device type of your accessory appears correctly on the first pairing screen.
  3. Add the accessory to a room and complete any additional setup.
  4. Verify that the accessory was added to the home and doesn't show the message “No Response”.
  5. Trigger a write to the accessory.

TCBG004: Accessory information and attestation

  1. Pair the Matter accessory with the Home app.
  2. Verify that the “Uncertified” message doesn't appear during pairing.
  3. Verify that the proper Manufacturer is listed in the accessory details.
  4. Verify that the proper Model is listed in the accessory details.
  5. Verify that the proper Firmware is listed in the accessory details.
  6. Verify that the proper Serial Number is listed in the accessory details. (Optional)

TCBG005: Device enumeration

  1. Pair the Matter accessory with the Home app.
  2. Verify that the accessory type shown in the Home app matches the device’s expected type. For example, if the accessory is a light bulb, the Home app should show it as a light bulb.
  3. Verify that all (Home-applicable) accessory clusters can be discovered and controlled/represented. For example, if the light bulb supports RGB color and dimming, ensure that those features are available in the Home app.
  4. Set each writeable attribute to the maximum and minimum values via the Home app and ensure that the light bulb operates and appears correctly in the Home app UI.
  5. If the paired accessory is a bridge, ensure that all supported endpoints to the bridge display as desired in the Home app.

TCBG006: Control accessory

  1. Pair the accessory with the Home app.
  2. Test all of the accessory’s features and functionality that can be controlled from the Home app and verify that the accessory responds appropriately. For example, test the on/off switches for the light bulb and try adjusting the brightness and color.

TCBG007: Stress: read/write operations

  1. Pair the accessory with the Home app.
  2. Test all of the accessory's features and functionality that can be controlled from within the Home app and verify that the accessory responds appropriately. For example, test the on/off switches for the light bulb, and try adjusting the brightness and color.
  3. Repeat steps 1 through 3 twenty times to verify a 100% pass rate.
  4. Verify that the iPhone used for commissioning and control is at 100% battery, in idle mode, and unplugged from power with the screen off.
  5. Leave the accessory connected for 12 hours, then repeat steps 2 through 4.
  6. Verify that the iPhone used for commissioning has more than 80% battery power.

TCBG008: Notifications (subscriptions)

  1. Pair the accessory with the Home app.
  2. Verify that the accessory doesn't show the message “No Response”.
  3. With the Home app open, trigger a status change on the accessory hardware.
  4. Verify that the notification is received on the iOS controller and that the Home app reflects the correct state without having to be relaunched.
  5. Repeat steps 1 through 4 to test all possible status changes on the accessory, and confirm that you receive a notification for each.

TCBG009: Power cycle the accessory

  1. Pair the Matter accessory with the Home app and verify that it can be discovered and controlled.
  2. Power down the accessory, wait five minutes, then power it up again.
  3. Once the accessory is back online, verify that it can be controlled and/or the status changes on the accessory are reflected in the Home app.

TCBG010: Stress: pairing/unpairing a factory-reset accessory

  1. Restore the accessory to its factory settings.
  2. Pair the accessory with the Home app.
  3. Test all of the accessory's features and functionality that can be controlled from within the Home app and verify that the accessory responds appropriately. For example, test the on/off switches for the light bulb, and try adjusting the brightness and color.
  4. Repeat steps 1 through 3 twenty times to verify a 100% pass rate.

TCBG011: Full setup with automation/scenes

  1. Pair the accessory with the Home app.
  2. From the Home app's Home Screen, tap the add button (+), then tap "Add Scene".
  3. Run the scene you just created.
  4. Validate that all accessories in the scene from step 3 perform correctly based on the scene you created.
  5. From the Home app's Home Screen, tap the add button (+), then tap "Add Automation".
  6. Trigger the automation you created in step 5.
  7. Validate that the accessory added in step 5 is controlled as desired.

TCBG012: Identify the accessory

  1. Start pairing the accessory to the Home app.
  2. Perform the identify actions shown on the pairing screens.
  3. Verify that the accessory responds appropriately and is able to be identified.

TCBG013: Bridge endpoints - adding and removing

  1. Add a Matter bridge to the Home app.
  2. Add an endpoint to your bridge.
  3. Verify that the accessory appears in the Home app and is controllable/readable.
  4. Remove an endpoint from your bridge.
  5. Verify that the accessory disappears from the Home app and is NOT controllable/readable.

TCBG014: Functionality without an internet connection

  1. Disconnect the internet connection from the test network’s WiFi router.
  2. Add the accessory to the Home app.
  3. Test all of the accessory's features and functionality that can be controlled from within the Home app and verify that the accessory responds appropriately. For example, test the on/off switches for the light bulb, and try adjusting the brightness and color.

TCBG15: Pair via nearby accessory list

  1. Put the accessory in pairing mode.
  2. From the Home app, tap “Add Accessory”, then tap “More options…”.
  3. Verify that the accessory appears in the discoverable list with the expected name and device type icon.
  4. Select the accessory, enter the setup code, then tap “Continue” or scan the accessory's QR setup code.
  5. Add the accessory to a room and complete any additional setup.
  6. Verify that the accessory was added to the home and doesn't show the message “No Response”.
  7. Add the accessory to a room and complete any additional setup.
  8. Trigger a write to the accessory.

TCBG16: Out-of-box pairing

  1. Power on a new, out-of-box (OOB) accessory. (Don't factory reset.)
  2. From the Home app, tap “Add Accessory”, then tap “More options…”.
  3. Verify that your accessory appears in the discoverable list with the expected name and device type icon.
  4. Select the accessory, enter the setup code, then tap “Continue” or scan the accessory's QR setup code.
  5. Add the accessory to a room and complete any additional setup.
  6. Verify that the accessory was added to the home and doesn't show the message “No Response”.
  7. Trigger a write to the accessory.