davidvtwout/esp_matter

Readme

# Espressif's SDK for Matter

[![Docker Image](https://github.com/espressif/esp-matter/actions/workflows/docker-image.yml/badge.svg)](https://github.com/espressif/esp-matter/actions/workflows/docker-image.yml)
 
[![Launchpad Deployment](https://github.com/espressif/esp-matter/actions/workflows/pages.yml/badge.svg)](https://github.com/espressif/esp-matter/actions/workflows/pages.yml)
##### Tools
[![Try With Launchpad](https://img.shields.io/badge/Try_With-ESP_Launchpad-0066CC?logo=espressif)](https://espressif.github.io/esp-launchpad/?flashConfigURL=https://espressif.github.io/esp-matter/launchpad.toml)
 
[![Try DMV](https://img.shields.io/badge/Try-Data_Model_Validator_Tool-0066CC?logo=espressif)](https://espressif.github.io/esp-matter-tools/dmv_tool)
##### Documentation
[![Programming Guide](https://img.shields.io/badge/ESP--Matter-Programming_Guide-6F42C1?logo=readthedocs)](https://docs.espressif.com/projects/esp-matter/en/latest/)
 
[![Matter Blog Series](https://img.shields.io/badge/Espressif's_Matter-Blog_Series-6F42C1?logo=espressif)](https://blog.espressif.com/matter-38ccf1d60bcd)
 
[![Matter Specification](https://img.shields.io/badge/Matter-Specification-6F42C1)](https://csa-iot.org/developer-resource/specifications-download-request/)

---
## Introduction

Espressif's SDK for Matter is the official Matter development framework for ESP32 series SoCs. It is built on top of the [open source Matter SDK](https://github.com/project-chip/connectedhomeip/), and provides simplified APIs, commonly used peripherals, tools and utilities for security, manufacturing and production accompanied by exhaustive documentation. It includes rich production references, aimed to simplify the development process of Matter products and enable the users to go to production in the shortest possible time.

[Supported Device Types](SUPPORTED_DEVICE_TYPES.md)

## Espressif Matter Services

Beyond the SDK, Espressif offers production services to help you take a Matter product to mass production:

- Matter Pre-Provisioning Service — secure provisioning of device identity (DAC, PAI, and unique commissioning data), offered in three flavours:
  - Espressif factory — ready-to-use modules pre-provisioned on our line
  - Customer factory — provision on your own line using Espressif's factory tool
  - In the field — deliver DACs to already-deployed devices over the air

- Certification Assistance — help taking your product through CSA Matter certification

See [Espressif Matter Services](https://docs.espressif.com/projects/esp-matter/en/latest/esp32/espressif_services.html)
for details, or contact matter-pki@espressif.com / sales@espressif.com.

## Supported Matter specification versions

|                                              Matter Specification Version                                              |                               Supported Branch                                |
| :--------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------: |
|                                                          v1.4                                                          |   [release/v1.4](https://github.com/espressif/esp-matter/tree/release/v1.4)   |
|                                                         v1.4.2                                                         | [release/v1.4.2](https://github.com/espressif/esp-matter/tree/release/v1.4.2) |
| v1.5 ([a51f624](https://github.com/espressif/esp-matter/tree/a51f624f0735aefd0a9cfe1e0039d68de8ce24e2)), v1.5.1 (HEAD) |   [release/v1.5](https://github.com/espressif/esp-matter/tree/release/v1.5)   |
|                                                          v1.6                                                          |   [release/v1.6](https://github.com/espressif/esp-matter/tree/release/v1.6)   |
|                                                         v1.6.1                                                         | [release/v1.6.1](https://github.com/espressif/esp-matter/tree/release/v1.6.1)   |
|                                                 v1.7 (Ongoing effort)                                                  |           [main](https://github.com/espressif/esp-matter/tree/main)           |

## Getting the repositories

For efficient cloning of the ESP-Matter repository, please refer
[Getting the Repositories](https://docs.espressif.com/projects/esp-matter/en/latest/esp32/developing.html#getting-the-repositories)
section in the ESP-Matter Programming Guide.

## Supported ESP-IDF and connectedhomeip versions

- This SDK currently works with commit [11911e2245](https://github.com/project-chip/connectedhomeip/tree/11911e2245) of connectedhomeip.
- For Matter projects development with this SDK, it is recommended to utilize ESP-IDF [v6.0.2](https://github.com/espressif/esp-idf/tree/v6.0.2).
- For ESP32S31, ESP32H21, and ESP32H4, it is recommended to utilize ESP-IDF commit [e9da155](https://github.com/espressif/esp-idf/tree/e9da155).

## Documentation

For a simplified explanation of Matter concepts and internals, please check out the [Espressif's Matter blog series](https://blog.espressif.com/matter-38ccf1d60bcd).

Refer the [Programming Guide](https://docs.espressif.com/projects/esp-matter/en/latest/) for the latest version of the documentation.

## Matter Specifications
Download the Matter specification from [CSA's official site](https://csa-iot.org/developer-resource/specifications-download-request/)