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
• 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 Matter Controller
• 3. Matter Certification
  • 3.1 Introduction to Test Harness (TH)
  • 3.2 Matter Factory Partition Binary
  • 3.3 Matter OTA Image Generation
  • 3.4 PICS files
  • 3.5 Route Information Option (RIO) notes
  • 3.6 FW/SDK configuration notes
  • 3.7 Appendix FAQs
• 4. Production Considerations
  • 4.1 Prerequisites
  • 4.2 Over-the-Air (OTA) Updates
  • 4.3 Manufacturing
• 5. Security Considerations
  • 5.1 Overview
  • 5.2 Platform Security
  • 5.3 Product Security
  • 5.4 More Security Considerations
  • 5.5 Security Policy
• 6. RAM and Flash Optimizations
  • 6.1 Overview
  • 6.2 Configurations
  • 6.3 References for futher optimizations
• 7. API Reference
  • Endpoint/Device Type
  • Cluster
  • Attribute
  • Command
  • Core Low Level
  • Event
  • Client
• 8. Integration with esp-insights
• 9. Application User Guide
  • 9.1. Delegate Implementation
• A1 Appendix FAQs
  • A1.1 Compilation errors
  • A1.2 Device commissioning using chip-tool
  • A1.3 Device crashing
  • A1.4 Device not crashed but not responding
  • A1.5 QR code not rendering
  • A1.6 Onboard LED not working
  • A1.7 Using Rotating Device Identifier
  • A1.8 ModuleNotFoundError: No module named ‘lark’
  • A1.9 Why does free RAM increase after first commissioning
  • A1.10 How to generate Matter Onboarding Codes (QR Code and Manual Pairing Code)
  • A1.11 Chip stack locking error … Code is unsafe/racy
  • A1.12 Firmware Version Number
  • A1.13 Stuck at “Solving dependencies requirements …..”
  • A1.14 ESP32-C2 log garbled, unable to perform Matter commissioning and other abnormal issues
  • A1.15 Generating Matter Onboarding Codes on the device itself