Espressif's SDK for Matter Choose target... Choose version... 1. Introduction 2. Developing with the SDK 3. Matter Controller 4. Matter Certification 5. Production Considerations 6. Security Considerations 7. RAM and Flash Optimizations 8. API Reference 9. Integration with esp-insights 10. Application User Guide 11. Copyrights and Licenses Appendix FAQs Espressif's SDK for Matter Programming Guide Edit on GitHub Programming Guide Matter is a unified IP-based connectivity protocol that is designed to connect and build open, reliable and secure IoT ecosystems. This new technology and connectivity standard enables communication among a wide range of smart devices. Matter supports IP connectivity over Wi-Fi, Thread and Ethernet. Espressif’s SDK for Matter is the official Matter development framework for Espressif’s ESP32 series SoCs. We have put together a series of blog posts that introduces various aspects of Matter. We recommend that you go through this Espressif Matter Blog. Table of Contents 1. Introduction 1.1. Espressif Matter Solutions 1.2. Try it yourself 1.3. 3. Try Data Model Validator 2. Developing with the SDK 2.1. ESP-IDF Setup 2.2. ESP Matter Setup 2.3. Commissioning and Control 2.4. Device console 2.5. Developing your Product 2.6. Factory Data Providers 2.7. Using esp_secure_cert partition 2.8. Matter OTA 2.9. Mode Select 2.10. Custom Cluster 3. Matter Controller 3.1. Controller features 3.2. Commissioner features 3.3. Production Considerations 4. Matter Certification 4.1. Firmware Development 4.2. Preparation of Files Required for Certification Testing 4.3. Testing Environment Setup and Testing Methods 4.4. Submitting Certification Application Online 4.5. Filling in Certified Product Information on DCL Website 4.6. Other notes for some certification test cases 4.7. FW/SDK configuration notes 5. Production Considerations 5.1. Prerequisites 5.2. Over-the-Air (OTA) Updates 5.3. Manufacturing 6. Security Considerations 6.1. Overview 6.2. Platform Security 6.3. Product Security 6.4. More Security Considerations 6.5. Security Policy 7. RAM and Flash Optimizations 7.1. Overview 7.2. Configurations 7.3. References for further optimizations 8. API Reference 8.1. Data Model 8.2. Generated Data Model 8.3. Endpoint/Device Type 8.4. Cluster 8.5. Attribute 8.6. Command 8.7. Core Low Level 8.8. Event 8.9. Client 9. Integration with esp-insights 10. Application User Guide 10.1. Delegate Implementation 11. Copyrights and Licenses 11.1. Software Copyrights Appendix FAQs Next © Copyright 2022 - 2026, Espressif Systems (Shanghai) Co., Ltd. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF Espressif's SDK for Matter Choose target... Choose version... 1. Introduction 2. Developing with the SDK 3. Matter Controller 4. Matter Certification 5. Production Considerations 6. Security Considerations 7. RAM and Flash Optimizations 8. API Reference 8.1. Data Model 8.2. Generated Data Model 8.3. Endpoint/Device Type 8.4. Cluster 8.5. Attribute 8.6. Command 8.7. Core Low Level 8.8. Event 8.9. Client 9. Integration with esp-insights 10. Application User Guide 11. Copyrights and Licenses Appendix FAQs Espressif's SDK for Matter 8. API Reference Edit on GitHub 8. API Reference 8.1. Data Model 8.2. Generated Data Model 8.3. Endpoint/Device Type 8.4. Cluster 8.5. Attribute 8.6. Command 8.7. Core Low Level 8.8. Event 8.9. Client Previous Next © Copyright 2022 - 2026, Espressif Systems (Shanghai) Co., Ltd. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF Espressif's SDK for Matter Choose target... Choose version... 1. Introduction 1.1. Espressif Matter Solutions 1.1.1. Espressif Matter Platforms 1.1.2. Espressif’s SDK for Matter 1.1.3. Matter and ESP RainMaker Integration 1.2. Try it yourself 1.3. 3. Try Data Model Validator 2. Developing with the SDK 3. Matter Controller 4. Matter Certification 5. Production Considerations 6. Security Considerations 7. RAM and Flash Optimizations 8. API Reference 9. Integration with esp-insights 10. Application User Guide 11. Copyrights and Licenses Appendix FAQs Espressif's SDK for Matter 1. Introduction Edit on GitHub 1. Introduction 1.1. Espressif Matter Solutions Espressif’s Matter Solutions consist of: A full spectrum of Matter device platforms Production ready SDK for Matter Matter and ESP RainMaker integration 1.1.1. Espressif Matter Platforms Espressif platform solutions are as shown below: The Wi-Fi-enabled SoCs and modules, such as ESP32, ESP32-C and ESP32-S series can be used to build Matter Wi-Fi devices. SoCs and modules(ESP32-H series, ESP32-C5, and ESP32-C6) with 802.15.4 can be used to build Matter Thread devices. By efficiently combining ESP32-H and our Wi-Fi SoCs, a Thread Border Router can be built to connect the Thread network with the Wi-Fi network. We provide hardware devkits, reference designs and production-ready SDK, which supports the latest Thread 1.3 feature for Matter. We also provide Matter-Zigbee and Matter-BLE Mesh bridge solutions that enable non-Matter devices based on Zigbee, Bluetooth LE Mesh and other protocols to connect to the Matter ecosystem. A Matter-Zigbee Bridge uses ESP32-H and another Wi-Fi SoC, while a Matter-BLE Mesh Bridge can be done on a single SoC with both Wi-Fi and Bluetooth LE interfaces. 1.1.2. Espressif’s SDK for Matter Espressif’s SDK for Matter is built on top of the open source Matter SDK, 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. In addition, the SDK also integrates ESP RainMaker and ESP Insights for cloud services and remote diagnostics. 1.1.3. Matter and ESP RainMaker Integration Espressif’s AIoT cloud platform ESP RainMaker can provide remote control and enable cloud-based device management for Matter devices. By combining the above-mentioned Matter hardware and software solutions with ESP RainMaker, this one-stop Matter ecosystem solution provides a full-fledged cloud deployment through your own private account with advanced device management features. 1.2. Try it yourself If you want to test Matter on Espressif devices without any additional setup: 1.3. 3. Try Data Model Validator Espressif provides a web UI tool to validate the data model of the Matter devices. It is available at https://espressif.github.io/esp-matter-tools/. Previous Next © Copyright 2022 - 2026, Espressif Systems (Shanghai) Co., Ltd. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF Espressif's SDK for Matter Choose target... Choose version... 1. Introduction 2. Developing with the SDK 3. Matter Controller 4. Matter Certification 5. Production Considerations 5.1. Prerequisites 5.1.1. Vendor ID and Product ID 5.1.2. Certificates 5.1.3. Certification Declaration (CD) 5.1.4. Setup Passcode, Discriminator and Onboarding Payload 5.1.5. Manufacturing Partition 5.2. Over-the-Air (OTA) Updates 5.3. Manufacturing 5.3.1. Mass Manufacturing Utility 5.3.2. Pre-Provisioned Modules 5.3.3. The esp-matter-mfg-tool Example 5.3.4. Recommended Providers to Use 6. Security Considerations 7. RAM and Flash Optimizations 8. API Reference 9. Integration with esp-insights 10. Application User Guide 11. Copyrights and Licenses Appendix FAQs Espressif's SDK for Matter 5. Production Considerations Edit on GitHub 5. Production Considerations 5.1. Prerequisites All Matter examples use certain test or evaluation values that enables you to quickly build and test Matter. As you get ready to go to production, these must be replaced with the actual values. These values are typically a part of the manufacturing partition in your device. 5.1.1. Vendor ID and Product ID A Vendor Identifier (VID) is a 16-bit number that uniquely identifies a particular product manufacturer or a vendor. It is allocated by the Connectivity Standards Alliance (CSA). Please reach out to CSA for this. A Product Identifier (PID) is a 16-bit number that uniquely identifies a product of a vendor. It is assigned by the vendor (you). A VID-PID combination uniquely identifies a Matter product. 5.1.2. Certificates A Device Attestation Certificate (DAC) proves the authenticity of the device manufacturer and the certification status of the device’s hardware and software. Every Matter device must have a DAC and corresponding private key, unique to it. The device should also have a Product Attestation Intermediate (PAI) certificate that was used to sign and attest the DAC. The PAI certificate in turn is signed and attested by Product Attestation Authority (PAA). The PAA certificate is an implicitly trusted self-signed root certificate. Please reach out to your Espressif representative for the details about how to procure the DAC. 5.1.3. Certification Declaration (CD) A Certification Declaration (CD) is a cryptographic document that allows a Matter device to assert its protocol compliance. Once your product is certified, the CSA creates a CD for that device. The CD should then be included in the device firmware by the device manufacturer. 5.1.4. Setup Passcode, Discriminator and Onboarding Payload The unique setup passcode serves as the proof of possession and is also used to compute the shared secret during commissioning. The corresponding SPAKE2+ verifier of the passcode is installed on the device and not the actual passcode. The discriminator is used to easily distinguish between devices to provide a seamless experience during commissioning. The onboarding payload is the QR code and the manual pairing code that assists a commissioner (like a phone app) to allow onboarding a device into the Matter network. The QR code and/or the manual pairing code are generally printed on the packaging of the device. 5.1.5. Manufacturing Partition Espressif’s SD