Learn more about Matter here
Each release of an Apple operating system, or developer preview release may bring a new SHA from this repository, which can be helpful for determining which changes are present in the release for testing.
Listed are the Current SHAs:
iOS/iPadOS/tvOS 16.1: 33f6a910cd9a8a0cfdd7088e2f43efd2f7f566a7
iOS/iPadOS/tvOS 16.2 and 16.3: c279578c5bc37f117335aa96cec6c5552f070cc0
Matter is supported by iOS/tvOS/iPadOS/watchOS/HomePod/AppleTV starting with 16.1
To test your Matter device with Apple's platforms, all you need is a device with a supported OS
Pairing via QR Code or Setup Code is supported directly from the Home App
Please proceed to this section if you're developing a new device
Please provide feedback to Apple if you encounter any issues
For Context: This is a mapping of platform to OS
To develop a Matter Application, learn more about how to develop with Matter on Apple's platforms here
Download the Matter Developer Profile
Email the profile to an account that is configured on your device running iOS/iPadOS 16.1 (or greater)
Selecting the profile in Mail on your iOS/iPadOS 16.1 (or greater) device will present an option to install the profile
(Optional) You may be prompted if you want to install it on other devices. Follow the prompts to install on the HomePod, Apple TV, etc., where you have the described issue and reproduce it.
Restart the device
enables other useful developer tools
To enable developer mode, please follow the instructions here
Pairing Matter Accessory using Open Source Matter Darwin chip-tool and iOS chip-tool will require installing the Bluetooth Central Matter Client Developer mode profile on MacOS or iOS/iPadOS.
Download the Bluetooth Central Matter Client Developer Mode profile and install it on a iOS/iPadOS 16.1 beta 3 and MacOS 13.1 beta 3 or later system.
Restart your system
Compile chip-tool for macOS or CHIP Tool for iOS
c279578c5bc37f117335aa96cec6c5552f070cc0: $ git checkout c279578c5bc37f117335aa96cec6c5552f070cc0In order to work with iOS/iPadOS/tvOS 16.1 or greater, device types as defined in the Matter Device Library spec are used to determine accessory categories. Ensure the right device type is set for each endpoint.
all-clusters-app as an example, this can be set in FIXED_DEVICE_TYPES, FIXED_DEVICE_TYPE_OFFSETS, and FIXED_DEVICE_TYPE_LENGTHS in endpoint_config.hall-clusters-app (feel free to search for more in the tree by looking for the above keys)Example:
// Array of device types
#define FIXED_DEVICE_TYPES
{
{ 0x0016, 1 }, { 0x0100, 1 }, { 0x0100, 1 }, { 0xF002, 1 }
}
// Array of device type offsets
#define FIXED_DEVICE_TYPE_OFFSETS
{
0, 1, 2, 3
}
// Array of device type lengths
#define FIXED_DEVICE_TYPE_LENGTHS
{
1, 1, 1, 1
}
| Type | Decimal | HEX |
|---|---|---|
| Lightbulb | 256 | 0100 |
| Lightbulb + Dimmer | 257 | 0101 |
| Switch | 259 | 0103 |
| Contact Sensor | 21 | 0015 |
| Door Lock | 10 | 000A |
| Light Sensor | 262 | 0106 |
| Occupancy Sensor | 263 | 0107 |
| Outlet | 266 | 010A |
| Color Bulb | 268 | 010C |
| Window Covering | 514 | 0202 |
| Thermostat | 769 | 0301 |
| Temperature Sensor | 770 | 0302 |
| Flow Sensor | 774 | 0306 |
all-clusters-app on an ESP32-based M5Stack, however can be generalised to work on most platforms (more listed below)Checkout and setup Matter repo as per the instructions above.
Follow these instructions initialize your development environment, compile the firmware and flash your hardware.
sysdiagnose logs for iPhone / iPad with the timestamp / time frame of the issuesysdiagnose logs for all the Home Hubs (HomePod mini / HomePod / Apple TV) with the timestamp / timeframe of the issuePlease refer to the iOS/iPadOS 16.1 Release Notes for currently known issues.
Please refer to the iOS/iPadOS 16.2 beta 3 Release Notes for currently known issues
An issues related to Apple Home integration should be reported feedback as described in this section
Any issues related to the Matter SDK should be reported to the project here