connectedhomeip-skill

Build, commission, and customize Matter device firmware on ESP32 and ESP32-C3.

28|3|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/JasonYANG170/esp-dev-skill --skill connectedhomeip-skill-jasonyang170
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connectedhomeip-skill
Source: https://github.com/JasonYANG170/esp-dev-skill/tree/main/repos/connectedhomeip
Command: npx skills add https://github.com/JasonYANG170/esp-dev-skill --skill connectedhomeip-skill-jasonyang170

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Developing Matter (CHIP) firmware on Espressif chips requires navigating a complex fork of project-chip/connectedhomeip with strict initialization order, Kconfig-driven commissioning modes, and ZCL cluster callbacks. This Skill grounds every API, Kconfig symbol, and build step in the repository's real examples and headers, preventing hallucinated APIs and failed builds. ## Core Features & Use Cases - Scenario-driven recipes: Build and flash ESP32 examples, commission over BLE/Wi-Fi/Bypass, drive devices with chip-tool or the python controller, and bind OnOff/DoorLock/LevelControl/TemperatureMeasurement clusters to hardware. - Real API and config references: Verified signatures for CHIPDeviceManager, InitServer, emberAfWriteAttribute, plus sdkconfig.defaults, partition tables, and Rendezvous mode mappings. - Pitfall prevention: 15 documented failure patterns (init order, NimBLE config, mDNS restart, partition size, submodule setup) with wrong-vs-correct code comparisons. - Use Case: You want a Matter door lock on ESP32-C3. The Skill walks you through idf.py build, BLE commissioning with default credentials (3840/20202021), implementing ActivateDoorLockCallback, and validating with chip-tool doorlock commands. ## Quick Start Ask the AI to build and flash the lock-app Matter example on an ESP32 and commission it over BLE using chip-tool.

Frequently Asked Questions about connectedhomeip-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and flash a Matter example on ESP32?

Use ESP-IDF v4.3 with idf.py, not GN/ninja. Run idf.py set-target esp32, configure Rendezvous mode via idf.py menuconfig, then idf.py build and idf.py -p /dev/ttyUSB0 flash monitor. Initialize submodules first with git submodule update --init --recursive.

How do I commission a Matter device over BLE with chip-tool?

Build chip-tool with GN and ninja, then run chip-tool pairing ble 20202021 3840 using the examples' default setup pin and discriminator. After pairing, send cluster commands like chip-tool onoff on 1 with an endpoint between 1 and 240.

Which chips does the Espressif connectedhomeip fork support?

The ESP32 device examples support ESP32 (Xtensa) and ESP32-C3 (RISC-V). Device type options include ESP32-DevKitC, ESP32-WROVER-KIT_V4.1, M5Stack, and ESP32C3-DevKitM, selected via menuconfig.

Why does my Matter device get an IP but the commissioner cannot find it?

The mDNS server was not restarted after the IP address changed. Call chip::app::Mdns::StartServer() inside the kInterfaceIpAddressChanged event handler in your DeviceEventCallback implementation.

How do I implement a DoorLock cluster server instead of mapping OnOff to a relay?

Implement emberAfPluginDoorLockServerActivateDoorLockCallback to handle LockDoor and UnlockDoor commands, and write LockState with emberAfWriteServerAttribute using ZCL_DOOR_LOCK_CLUSTER_ID. PIN and RFID verification go through emberAfPluginDoorLockServerApplyPin and ApplyRfid.

When should I not use this connectedhomeip fork?

Avoid it for non-ESP platforms like EFR32, nRF, or K32W, since only ESP32 examples are deeply covered. It is also unsuitable for general ESP-IDF questions unrelated to Matter, hardware design, or Apple HomeKit stacks outside the Matter data model.