ESP32 Matter 压力传感器设备开发指南基于 arduino-esp32 的 MatterPressureSensor 示例深度解析【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文以 libraries/Matter/examples/MatterPressureSensor 示例为主线讲解如何在 arduino-esp32 平台上创建一个 Matter 兼容的压力传感器设备覆盖支持的目标芯片、commissioning 配网机制、Wi-Fi/Thread 双协议栈选型、传感器数据模拟与上报、智能家居生态Apple Home / Amazon Alexa / Google Home集成以及恢复出厂设置等完整流程。读完本文你将掌握MatterPressureSensor端点的使用方法并能将其替换为真实气压传感器如 BMP280/BME280接入任意 Matter 生态中枢。示例概览一个开箱即用的 Matter 压力传感器节点MatterPressureSensor是 arduino-esp32 仓库libraries/Matter中提供的一个完整示例它的核心目标是用一块 ESP32 系列开发板模拟出一台符合 Matter 标准协议的压力传感器设备。示例源码位于 MatterPressureSensor.ino主要演示了三个关键能力Matter commissioning配网通过 QR 码或手动配对码将设备加入智能家居中枢传感器数据上报周期性地把压力读数单位 hPa上报给 Matter 网络压力读数自动模拟内置 9501100 hPa 的模拟数据源无需真实传感器即可完成全链路验证。从代码结构看示例仅依赖两个核心对象MatterPressureSensor SimulatedPressureSensorMatter 压力传感器端点和MatterMatter 节点管理器其余为按钮消抖、串口日志等辅助逻辑结构非常精简适合作为学习 Matter 设备开发的入门模板。支持的目标芯片与配网方式示例对不同的 ESP32 系列 SoC 支持情况不同关键在于BLE commissioning 能力与Wi-Fi/Thread 网络栈的差异SoCWi-FiThreadBLE Commissioning状态ESP32✅❌❌完全支持ESP32-S2✅❌❌完全支持ESP32-S3✅❌✅完全支持ESP32-C3✅❌✅完全支持ESP32-C5❌✅✅支持仅 ThreadESP32-C6✅❌✅完全支持ESP32-H2❌✅✅支持仅 Thread配网注意事项ESP32 与 ESP32-S2不支持 BLE commissioning。由于无法通过蓝牙完成配网必须在草图代码中直接写入 Wi-Fi 凭据ssid/password设备上电后自行连接你的网络。ESP32-C6虽然硬件具备 Thread 能力但 arduino-esp32 的 Matter 库当前以Wi-Fi only方式预编译。若要配置为纯 Thread 运行需要改用Arduino as ESP-IDF Component的方式构建工程并禁用 Matter 的 Wi-Fi Station 功能。ESP32-C5的情况正好相反硬件支持 2.4 GHz 与 5 GHz Wi-Fi但预编译的 Matter 库仅启用Thread。若要使用 Wi-Fi同样需要以 ESP-IDF Component 方式构建关闭 Thread 网络、仅保留 Wi-Fi Station。源码中对这一逻辑的体现见 MatterPressureSensor.ino通过宏CONFIG_ENABLE_CHIPOBLE判断当前芯片是否使用 BLE commissioning——当 BLE 配网不可用即!CONFIG_ENABLE_CHIPOBLE时才会包含WiFi.h并手动启动 Wi-Fi#if !CONFIG_ENABLE_CHIPOBLE // if the device can be commissioned using BLE, WiFi is not used - save flash space #include WiFi.h #endif #if !CONFIG_ENABLE_CHIPOBLE // WiFi is manually set and started const char *ssid your-ssid; // Change this to your WiFi SSID const char *password your-password; // Change this to your WiFi password #endif这里「BLE 配网可用时不再使用 Wi-Fi 以节省 Flash 空间」是示例自带的设计取舍也可作为你自己项目裁剪功能的参考。功能特性清单该示例实现的功能可归纳如下其中标注(*)的 Thread 支持需要额外构建条件Matter 协议实现的压力传感器设备端点同时支持 Wi-Fi 与 Thread*两种网络连接压力测量值以hPa百帕为单位上报自动模拟压力读数范围 950–1100 hPa每5 秒周期性更新传感器数据用户按键支持恢复出厂设置decommission支持 QR 码或手动配对码两种 Matter commissioning 方式可接入 Apple HomeKit、Amazon Alexa、Google Home 生态。硬件需求与引脚配置硬件方面只需要两块东西一块上表中列出的 ESP32 系列开发板一个用于恢复出厂设置的用户按键默认复用开发板上的BOOT 按键。如需接入真实气压传感器BMP280、BME280、BMP388 等可自行连接 I2C/SPI 引脚并替换模拟函数。示例中唯一需要关注的引脚是按键引脚定义在 MatterPressureSensor.ino// set your board USER BUTTON pin here - decommissioning button const uint8_t buttonPin BOOT_PIN; // Set your pin here. Using BOOT Button.BOOT_PIN默认对应开发板上的 BOOT 按键GPIO 0。如果你希望使用其他 GPIO只需把buttonPin改为目标引脚编号并确保该引脚外接了一个一端接 GND 的按键代码中以INPUT_PULLUP模式读取按下为低电平见setup()中的pinMode(buttonPin, INPUT_PULLUP);。软件环境准备开始之前需要准备安装Arduino IDE 2.0 或更新版本安装支持 Matter 的ESP32 Arduino Core即当前仓库对应的核心版本在 Arduino IDE 的库管理器中安装以下库MatterWi-Fi仅 ESP32 与 ESP32-S2 需要因为这两颗芯片必须手动连接 Wi-Fi构建前的三处配置1. Wi-Fi 凭据ESP32 / ESP32-S2 必填不使用 BLE 配网时必须修改 MatterPressureSensor.ino 中的两行const char *ssid your-ssid; // Change this to your WiFi SSID const char *password your-password; // Change this to your WiFi password2. 按键引脚可选默认使用 BOOT 按键GPIO 0触发恢复出厂设置如需更换引脚修改buttonPin即可。3. 真实传感器接入可选示例通过getSimulatedPressure()返回一个float类型的压力值单位 hPa。要使用真实传感器只需替换该函数的实现例如使用 Adafruit BMP280 库#include Adafruit_BMP280.h Adafruit_BMP280 bmp; float getSimulatedPressure() { return bmp.readPressure() / 100.0; // Convert Pa to hPa }注意readPressure()返回的是帕斯卡Pa因此要除以 100 换算为 hPa。原文档中提到的 BMP280、BME280、BMP388 等传感器均适用同样的替换思路。构建与烧录步骤按照以下步骤在 Arduino IDE 中编译烧录打开 MatterPressureSensor.ino 草图在Tools Board菜单中选择你的 ESP32 开发板型号在Tools Partition Scheme菜单中选择Huge APP (3MB No OTA/1MB SPIFFS)在Tools菜单中启用Erase All Flash Before Sketch Upload选项用 USB 线连接开发板与电脑点击Upload按钮编译并烧录。选择 Huge APP 分区方案的原因在 ci.yml 中也有印证——该示例的 CI 配置明确使用了fqbn_append: PartitionSchemehuge_app并声明编译前提CONFIG_ESP_MATTER_ENABLE_DATA_MODELy。Matter 协议栈基于 esp-matter / CHIP 实现体积较大默认分区方案放不下这是所有 Matter 示例的通用要求。串口输出解读从配网到数据上报烧录完成后打开115200波特率的串口监视器。Wi-Fi 连接日志仅在 ESP32 / ESP32-S2 上出现因为只有这两款需要手动连 Wi-Fi其余芯片会通过 Matter CHIPoBLE 自动建立 IP 网络。典型输出如下Connecting to your-wifi-ssid ....... Wi-Fi connected IP address: 192.168.1.100 Matter Node is not commissioned yet. Initiate the device discovery in your Matter environment. Commission it to your Matter hub with the manual pairing code or QR code Manual pairing code: 34970112332 QR code URL: https://project-chip.github.io/connectedhomeip/qrcode.html?dataMT%3A6FCJ142C00KA0648G00 Matter Node not commissioned yet. Waiting for commissioning. Matter Node not commissioned yet. Waiting for commissioning. ... Matter Node is commissioned and connected to the network. Ready for use. Current Pressure is 900.00hPa Current Pressure is 950.00hPa Current Pressure is 960.00hPa ... Current Pressure is 1100.00hPa Current Pressure is 950.00hPa这段日志对应的源码逻辑在 MatterPressureSensor.inoMatter.begin()之后代码通过Matter.isDeviceCommissioned()轮询配网状态未配网时打印Matter.getManualPairingCode()手动配对码与Matter.getOnboardingQRCodeUrl()QR 码 URL并以 5 秒为周期持续等待配网成功后输出 Ready for use.。这两个获取配网信息的 API 定义在 Matter.h 中由ArduinoMatter类提供且仅在Matter.begin()之后才返回有效值。设备使用与按键控制手动控制长按恢复出厂设置用户按键默认 BOOT 按键提供恢复出厂功能长按超过 5 秒触发 factory resetdecommission设备从 Matter 网络中移除等待重新配网。对应实现见 MatterPressureSensor.ino包含完整的按键消抖与计时逻辑// Check if the button has been pressed if (digitalRead(buttonPin) LOW !button_state) { button_time_stamp millis(); // record the time while the button is pressed. button_state true; // pressed. } ... uint32_t time_diff millis() - button_time_stamp; if (button_state time_diff decommissioningTimeout) { // 5000ms Serial.println(Decommissioning Pressure Sensor Matter Accessory. It shall be commissioned again.); Matter.decommission(); }decommissioningTimeout 5000毫秒即 5 秒阈值Matter.decommission()由 Matter.h 声明。传感器模拟逻辑模拟压力传感器的工作规律如下初始值 900 hPa仅在端点初始化时上报一次循环遍历 950 到 1100 hPa 区间每次步进 10 hPa每 5 秒更新一次达到 1100 hPa 后重置回 950 hPa。对应 getSimulatedPressure() 的实现float getSimulatedPressure() { static float simulatedPressureHWSensor 950; simulatedPressureHWSensor simulatedPressureHWSensor 10; if (simulatedPressureHWSensor 1100) { simulatedPressureHWSensor 950; } return simulatedPressureHWSensor; }模拟数据源被loop()每 5 秒读取一次并写入 Matter 端点见 MatterPressureSensor.inoif (!(timeCounter % 10)) { // delaying for 500ms x 10 5s Serial.printf(Current Pressure is %.02fhPa\r\n, SimulatedPressureSensor.getPressure()); SimulatedPressureSensor.setPressure(getSimulatedPressure()); }这里delay(500)× 10 次循环构成 5 秒周期先打印当前值再更新新值。如需调整上报频率修改loop()末尾的delay(500)或取模除数10即可。智能家居生态集成设备配网成功后即可通过 Matter 兼容的中枢如 Apple HomePod、Google Nest Hub、Amazon Echo将其加入家庭网络。注意配网动作由中枢发起而非设备端——你需要先在串口日志中拿到手动配对码或 QR 码 URL然后在对应的手机 App 中扫描/输入。Apple Home家庭 App在 iOS 设备上打开「家庭」App点击右上角「」「添加配件」扫描串口日志中 QR 码 URL 对应的二维码或点击「我没有或无法扫描代码」并输入手动配对码按提示完成设置设备将以「压力传感器」形式出现在家庭 App 中可实时查看压力读数并基于压力水平创建自动化例如天气监测场景。Amazon Alexa打开 Alexa App依次点击More Add Device Matter选择「扫描二维码」或「手动输入代码」完成设置流程压力传感器将出现在 Alexa App 中可查看压力读数并根据压力变化创建 routine例程。Google Home打开 Google Home App点击「」「设置设备」「新设备」选择「Matter 设备」扫描二维码或输入手动配对码按提示完成设置可查看压力读数并基于压力变化创建自动化。代码结构纵深解析示例由三个主要部分组成结合源码可进一步拆解1.setup()硬件初始化 端点创建 等待配网在 MatterPressureSensor.ino 中依次完成按键引脚初始化INPUT_PULLUP→ 串口初始化115200→ 需要时连接 Wi-Fi → 创建 Matter 压力传感器端点并设置初始值 900 hPa →Matter.begin()启动 Matter 栈 → 轮询等待 commissioning。其中端点创建的调用链值得关注示例中的SimulatedPressureSensor.begin(900.00)最终进入 MatterPressureSensor.cpp 的实现——它先调用ArduinoMatter::_init()然后构造pressure_sensor::config_t配置measured_value设为初始压力min/max_measured_value为nullptr再调用 esp-matter 的pressure_sensor::create()创建标准 Pressure Sensor 设备类型端点bool MatterPressureSensor::begin(int16_t _rawPressure) { ArduinoMatter::_init(); if (getEndPointId() ! 0) { log_e(Matter Pressure Sensor with Endpoint Id %u device has already been created., getEndPointId()); return false; } pressure_sensor::config_t pressure_sensor_config; pressure_sensor_config.pressure_measurement.measured_value _rawPressure; pressure_sensor_config.pressure_measurement.min_measured_value nullptr; pressure_sensor_config.pressure_measurement.max_measured_value nullptr; endpoint_t *endpoint pressure_sensor::create(node::get(), pressure_sensor_config, ENDPOINT_FLAG_NONE, (void *)this); ... }从 MatterPressureSensor.h 可以看到MatterPressureSensor继承自MatterEndPoint基类端点 ID、属性读写等能力由基类统一提供见 MatterEndPoint.h 中的getEndPointId()、setEndPointId()、getAttributeVal()、updateAttributeVal()等方法。2.loop()数据上报 按键处理 Matter 事件轮询见 MatterPressureSensor.ino每 5 秒读取并上报一次压力值同时完成按键消抖与 5 秒长按的 decommission 检测。3.getSimulatedPressure()硬件传感器模拟如前述返回 950–1100 hPa 的循环步进值。替换此函数即可接入真实传感器。源码级原理压力值的内部表示与更新机制要理解为什么压力值用 hPa 且内部是整型需要看 MatterPressureSensor.h 的实现细节// implementation keeps pressure in hPa int16_t rawPressure 0; bool setRawPressure(int16_t _rawPressure); bool begin(int16_t _rawPressure);Matter 协议的 Pressure Measurement 集群内部以int16_t存储压力值单位 hPa这就是 README 故障排查一节提到的压力值以 uint16_t 形式存储于协议内部的来历端点实现中实际为带符号的int16_t。setPressure(double)通过static_castint16_t(pressure)将浮点 hPa 值截断为整型再交给setRawPressure()处理。setRawPressure()的更新逻辑在 MatterPressureSensor.cpp 中先比较新旧值若没有变化则直接返回避免无效上报有变化时通过getAttributeVal()读取 Pressure Measurement 集群的MeasuredValue属性再调用updateAttributeVal()写回新值实现 Matter 网络上的属性广播。这就是智能家居中枢能实时收到压力变化的底层机制。此外端点还提供了属性变更回调 attributeChangeCB()当外部控制器修改属性时会触发该回调示例中仅打印日志应用可按需覆写以实现自定义行为。MatterPressureSensor还重载了operator与operator double()见 MatterPressureSensor.h因此你可以直接写SimulatedPressureSensor 1013.25;来更新压力值或用double p SimulatedPressureSensor;读取代码更简洁。故障排查配网时设备不可见确认 Wi-Fi 或 Thread 连接配置正确ESP32/ESP32-S2 需确认已写入正确的 SSID 与密码。压力读数不更新检查getSimulatedPressure()是否被正确调用使用真实传感器时检查接线与库的初始化如 BMP280 的bmp.begin()。压力值超出预期范围确认上报单位是 hPa。Matter 协议内部以整型存储压力值海平面典型大气压约 950–1050 hPa。状态不变化模拟传感器每 5 秒步进 10 hPa若读数一直不变可能是真实传感器接线/初始化问题。配网失败优先长按按键恢复出厂设置或通过 Arduino IDE 的Tools Erase All Flash Before Sketch Upload: Enabled擦除 Flash也可直接使用命令行esptool.py --port PORT erase_flash擦除。无串口输出检查波特率是否为 115200以及 USB 连接是否正常。相关仓库资源示例源码与构建配置MatterPressureSensor.ino、ci.yml压力传感器端点实现MatterPressureSensor.h、MatterPressureSensor.cppMatter 端点基类MatterEndPoint.hMatter 节点管理 API配网码、decommission、连接状态查询Matter.hMatter 相关技术文档位于仓库 docs/en/matter 目录许可本示例遵循 Apache License, Version 2.0 许可协议发布。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESP32 Matter 压力传感器设备开发指南：基于 arduino-esp32 的 MatterPressureSensor 示例深度解析
ESP32 Matter 压力传感器设备开发指南基于 arduino-esp32 的 MatterPressureSensor 示例深度解析【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文以 libraries/Matter/examples/MatterPressureSensor 示例为主线讲解如何在 arduino-esp32 平台上创建一个 Matter 兼容的压力传感器设备覆盖支持的目标芯片、commissioning 配网机制、Wi-Fi/Thread 双协议栈选型、传感器数据模拟与上报、智能家居生态Apple Home / Amazon Alexa / Google Home集成以及恢复出厂设置等完整流程。读完本文你将掌握MatterPressureSensor端点的使用方法并能将其替换为真实气压传感器如 BMP280/BME280接入任意 Matter 生态中枢。示例概览一个开箱即用的 Matter 压力传感器节点MatterPressureSensor是 arduino-esp32 仓库libraries/Matter中提供的一个完整示例它的核心目标是用一块 ESP32 系列开发板模拟出一台符合 Matter 标准协议的压力传感器设备。示例源码位于 MatterPressureSensor.ino主要演示了三个关键能力Matter commissioning配网通过 QR 码或手动配对码将设备加入智能家居中枢传感器数据上报周期性地把压力读数单位 hPa上报给 Matter 网络压力读数自动模拟内置 9501100 hPa 的模拟数据源无需真实传感器即可完成全链路验证。从代码结构看示例仅依赖两个核心对象MatterPressureSensor SimulatedPressureSensorMatter 压力传感器端点和MatterMatter 节点管理器其余为按钮消抖、串口日志等辅助逻辑结构非常精简适合作为学习 Matter 设备开发的入门模板。支持的目标芯片与配网方式示例对不同的 ESP32 系列 SoC 支持情况不同关键在于BLE commissioning 能力与Wi-Fi/Thread 网络栈的差异SoCWi-FiThreadBLE Commissioning状态ESP32✅❌❌完全支持ESP32-S2✅❌❌完全支持ESP32-S3✅❌✅完全支持ESP32-C3✅❌✅完全支持ESP32-C5❌✅✅支持仅 ThreadESP32-C6✅❌✅完全支持ESP32-H2❌✅✅支持仅 Thread配网注意事项ESP32 与 ESP32-S2不支持 BLE commissioning。由于无法通过蓝牙完成配网必须在草图代码中直接写入 Wi-Fi 凭据ssid/password设备上电后自行连接你的网络。ESP32-C6虽然硬件具备 Thread 能力但 arduino-esp32 的 Matter 库当前以Wi-Fi only方式预编译。若要配置为纯 Thread 运行需要改用Arduino as ESP-IDF Component的方式构建工程并禁用 Matter 的 Wi-Fi Station 功能。ESP32-C5的情况正好相反硬件支持 2.4 GHz 与 5 GHz Wi-Fi但预编译的 Matter 库仅启用Thread。若要使用 Wi-Fi同样需要以 ESP-IDF Component 方式构建关闭 Thread 网络、仅保留 Wi-Fi Station。源码中对这一逻辑的体现见 MatterPressureSensor.ino通过宏CONFIG_ENABLE_CHIPOBLE判断当前芯片是否使用 BLE commissioning——当 BLE 配网不可用即!CONFIG_ENABLE_CHIPOBLE时才会包含WiFi.h并手动启动 Wi-Fi#if !CONFIG_ENABLE_CHIPOBLE // if the device can be commissioned using BLE, WiFi is not used - save flash space #include WiFi.h #endif #if !CONFIG_ENABLE_CHIPOBLE // WiFi is manually set and started const char *ssid your-ssid; // Change this to your WiFi SSID const char *password your-password; // Change this to your WiFi password #endif这里「BLE 配网可用时不再使用 Wi-Fi 以节省 Flash 空间」是示例自带的设计取舍也可作为你自己项目裁剪功能的参考。功能特性清单该示例实现的功能可归纳如下其中标注(*)的 Thread 支持需要额外构建条件Matter 协议实现的压力传感器设备端点同时支持 Wi-Fi 与 Thread*两种网络连接压力测量值以hPa百帕为单位上报自动模拟压力读数范围 950–1100 hPa每5 秒周期性更新传感器数据用户按键支持恢复出厂设置decommission支持 QR 码或手动配对码两种 Matter commissioning 方式可接入 Apple HomeKit、Amazon Alexa、Google Home 生态。硬件需求与引脚配置硬件方面只需要两块东西一块上表中列出的 ESP32 系列开发板一个用于恢复出厂设置的用户按键默认复用开发板上的BOOT 按键。如需接入真实气压传感器BMP280、BME280、BMP388 等可自行连接 I2C/SPI 引脚并替换模拟函数。示例中唯一需要关注的引脚是按键引脚定义在 MatterPressureSensor.ino// set your board USER BUTTON pin here - decommissioning button const uint8_t buttonPin BOOT_PIN; // Set your pin here. Using BOOT Button.BOOT_PIN默认对应开发板上的 BOOT 按键GPIO 0。如果你希望使用其他 GPIO只需把buttonPin改为目标引脚编号并确保该引脚外接了一个一端接 GND 的按键代码中以INPUT_PULLUP模式读取按下为低电平见setup()中的pinMode(buttonPin, INPUT_PULLUP);。软件环境准备开始之前需要准备安装Arduino IDE 2.0 或更新版本安装支持 Matter 的ESP32 Arduino Core即当前仓库对应的核心版本在 Arduino IDE 的库管理器中安装以下库MatterWi-Fi仅 ESP32 与 ESP32-S2 需要因为这两颗芯片必须手动连接 Wi-Fi构建前的三处配置1. Wi-Fi 凭据ESP32 / ESP32-S2 必填不使用 BLE 配网时必须修改 MatterPressureSensor.ino 中的两行const char *ssid your-ssid; // Change this to your WiFi SSID const char *password your-password; // Change this to your WiFi password2. 按键引脚可选默认使用 BOOT 按键GPIO 0触发恢复出厂设置如需更换引脚修改buttonPin即可。3. 真实传感器接入可选示例通过getSimulatedPressure()返回一个float类型的压力值单位 hPa。要使用真实传感器只需替换该函数的实现例如使用 Adafruit BMP280 库#include Adafruit_BMP280.h Adafruit_BMP280 bmp; float getSimulatedPressure() { return bmp.readPressure() / 100.0; // Convert Pa to hPa }注意readPressure()返回的是帕斯卡Pa因此要除以 100 换算为 hPa。原文档中提到的 BMP280、BME280、BMP388 等传感器均适用同样的替换思路。构建与烧录步骤按照以下步骤在 Arduino IDE 中编译烧录打开 MatterPressureSensor.ino 草图在Tools Board菜单中选择你的 ESP32 开发板型号在Tools Partition Scheme菜单中选择Huge APP (3MB No OTA/1MB SPIFFS)在Tools菜单中启用Erase All Flash Before Sketch Upload选项用 USB 线连接开发板与电脑点击Upload按钮编译并烧录。选择 Huge APP 分区方案的原因在 ci.yml 中也有印证——该示例的 CI 配置明确使用了fqbn_append: PartitionSchemehuge_app并声明编译前提CONFIG_ESP_MATTER_ENABLE_DATA_MODELy。Matter 协议栈基于 esp-matter / CHIP 实现体积较大默认分区方案放不下这是所有 Matter 示例的通用要求。串口输出解读从配网到数据上报烧录完成后打开115200波特率的串口监视器。Wi-Fi 连接日志仅在 ESP32 / ESP32-S2 上出现因为只有这两款需要手动连 Wi-Fi其余芯片会通过 Matter CHIPoBLE 自动建立 IP 网络。典型输出如下Connecting to your-wifi-ssid ....... Wi-Fi connected IP address: 192.168.1.100 Matter Node is not commissioned yet. Initiate the device discovery in your Matter environment. Commission it to your Matter hub with the manual pairing code or QR code Manual pairing code: 34970112332 QR code URL: https://project-chip.github.io/connectedhomeip/qrcode.html?dataMT%3A6FCJ142C00KA0648G00 Matter Node not commissioned yet. Waiting for commissioning. Matter Node not commissioned yet. Waiting for commissioning. ... Matter Node is commissioned and connected to the network. Ready for use. Current Pressure is 900.00hPa Current Pressure is 950.00hPa Current Pressure is 960.00hPa ... Current Pressure is 1100.00hPa Current Pressure is 950.00hPa这段日志对应的源码逻辑在 MatterPressureSensor.inoMatter.begin()之后代码通过Matter.isDeviceCommissioned()轮询配网状态未配网时打印Matter.getManualPairingCode()手动配对码与Matter.getOnboardingQRCodeUrl()QR 码 URL并以 5 秒为周期持续等待配网成功后输出 Ready for use.。这两个获取配网信息的 API 定义在 Matter.h 中由ArduinoMatter类提供且仅在Matter.begin()之后才返回有效值。设备使用与按键控制手动控制长按恢复出厂设置用户按键默认 BOOT 按键提供恢复出厂功能长按超过 5 秒触发 factory resetdecommission设备从 Matter 网络中移除等待重新配网。对应实现见 MatterPressureSensor.ino包含完整的按键消抖与计时逻辑// Check if the button has been pressed if (digitalRead(buttonPin) LOW !button_state) { button_time_stamp millis(); // record the time while the button is pressed. button_state true; // pressed. } ... uint32_t time_diff millis() - button_time_stamp; if (button_state time_diff decommissioningTimeout) { // 5000ms Serial.println(Decommissioning Pressure Sensor Matter Accessory. It shall be commissioned again.); Matter.decommission(); }decommissioningTimeout 5000毫秒即 5 秒阈值Matter.decommission()由 Matter.h 声明。传感器模拟逻辑模拟压力传感器的工作规律如下初始值 900 hPa仅在端点初始化时上报一次循环遍历 950 到 1100 hPa 区间每次步进 10 hPa每 5 秒更新一次达到 1100 hPa 后重置回 950 hPa。对应 getSimulatedPressure() 的实现float getSimulatedPressure() { static float simulatedPressureHWSensor 950; simulatedPressureHWSensor simulatedPressureHWSensor 10; if (simulatedPressureHWSensor 1100) { simulatedPressureHWSensor 950; } return simulatedPressureHWSensor; }模拟数据源被loop()每 5 秒读取一次并写入 Matter 端点见 MatterPressureSensor.inoif (!(timeCounter % 10)) { // delaying for 500ms x 10 5s Serial.printf(Current Pressure is %.02fhPa\r\n, SimulatedPressureSensor.getPressure()); SimulatedPressureSensor.setPressure(getSimulatedPressure()); }这里delay(500)× 10 次循环构成 5 秒周期先打印当前值再更新新值。如需调整上报频率修改loop()末尾的delay(500)或取模除数10即可。智能家居生态集成设备配网成功后即可通过 Matter 兼容的中枢如 Apple HomePod、Google Nest Hub、Amazon Echo将其加入家庭网络。注意配网动作由中枢发起而非设备端——你需要先在串口日志中拿到手动配对码或 QR 码 URL然后在对应的手机 App 中扫描/输入。Apple Home家庭 App在 iOS 设备上打开「家庭」App点击右上角「」「添加配件」扫描串口日志中 QR 码 URL 对应的二维码或点击「我没有或无法扫描代码」并输入手动配对码按提示完成设置设备将以「压力传感器」形式出现在家庭 App 中可实时查看压力读数并基于压力水平创建自动化例如天气监测场景。Amazon Alexa打开 Alexa App依次点击More Add Device Matter选择「扫描二维码」或「手动输入代码」完成设置流程压力传感器将出现在 Alexa App 中可查看压力读数并根据压力变化创建 routine例程。Google Home打开 Google Home App点击「」「设置设备」「新设备」选择「Matter 设备」扫描二维码或输入手动配对码按提示完成设置可查看压力读数并基于压力变化创建自动化。代码结构纵深解析示例由三个主要部分组成结合源码可进一步拆解1.setup()硬件初始化 端点创建 等待配网在 MatterPressureSensor.ino 中依次完成按键引脚初始化INPUT_PULLUP→ 串口初始化115200→ 需要时连接 Wi-Fi → 创建 Matter 压力传感器端点并设置初始值 900 hPa →Matter.begin()启动 Matter 栈 → 轮询等待 commissioning。其中端点创建的调用链值得关注示例中的SimulatedPressureSensor.begin(900.00)最终进入 MatterPressureSensor.cpp 的实现——它先调用ArduinoMatter::_init()然后构造pressure_sensor::config_t配置measured_value设为初始压力min/max_measured_value为nullptr再调用 esp-matter 的pressure_sensor::create()创建标准 Pressure Sensor 设备类型端点bool MatterPressureSensor::begin(int16_t _rawPressure) { ArduinoMatter::_init(); if (getEndPointId() ! 0) { log_e(Matter Pressure Sensor with Endpoint Id %u device has already been created., getEndPointId()); return false; } pressure_sensor::config_t pressure_sensor_config; pressure_sensor_config.pressure_measurement.measured_value _rawPressure; pressure_sensor_config.pressure_measurement.min_measured_value nullptr; pressure_sensor_config.pressure_measurement.max_measured_value nullptr; endpoint_t *endpoint pressure_sensor::create(node::get(), pressure_sensor_config, ENDPOINT_FLAG_NONE, (void *)this); ... }从 MatterPressureSensor.h 可以看到MatterPressureSensor继承自MatterEndPoint基类端点 ID、属性读写等能力由基类统一提供见 MatterEndPoint.h 中的getEndPointId()、setEndPointId()、getAttributeVal()、updateAttributeVal()等方法。2.loop()数据上报 按键处理 Matter 事件轮询见 MatterPressureSensor.ino每 5 秒读取并上报一次压力值同时完成按键消抖与 5 秒长按的 decommission 检测。3.getSimulatedPressure()硬件传感器模拟如前述返回 950–1100 hPa 的循环步进值。替换此函数即可接入真实传感器。源码级原理压力值的内部表示与更新机制要理解为什么压力值用 hPa 且内部是整型需要看 MatterPressureSensor.h 的实现细节// implementation keeps pressure in hPa int16_t rawPressure 0; bool setRawPressure(int16_t _rawPressure); bool begin(int16_t _rawPressure);Matter 协议的 Pressure Measurement 集群内部以int16_t存储压力值单位 hPa这就是 README 故障排查一节提到的压力值以 uint16_t 形式存储于协议内部的来历端点实现中实际为带符号的int16_t。setPressure(double)通过static_castint16_t(pressure)将浮点 hPa 值截断为整型再交给setRawPressure()处理。setRawPressure()的更新逻辑在 MatterPressureSensor.cpp 中先比较新旧值若没有变化则直接返回避免无效上报有变化时通过getAttributeVal()读取 Pressure Measurement 集群的MeasuredValue属性再调用updateAttributeVal()写回新值实现 Matter 网络上的属性广播。这就是智能家居中枢能实时收到压力变化的底层机制。此外端点还提供了属性变更回调 attributeChangeCB()当外部控制器修改属性时会触发该回调示例中仅打印日志应用可按需覆写以实现自定义行为。MatterPressureSensor还重载了operator与operator double()见 MatterPressureSensor.h因此你可以直接写SimulatedPressureSensor 1013.25;来更新压力值或用double p SimulatedPressureSensor;读取代码更简洁。故障排查配网时设备不可见确认 Wi-Fi 或 Thread 连接配置正确ESP32/ESP32-S2 需确认已写入正确的 SSID 与密码。压力读数不更新检查getSimulatedPressure()是否被正确调用使用真实传感器时检查接线与库的初始化如 BMP280 的bmp.begin()。压力值超出预期范围确认上报单位是 hPa。Matter 协议内部以整型存储压力值海平面典型大气压约 950–1050 hPa。状态不变化模拟传感器每 5 秒步进 10 hPa若读数一直不变可能是真实传感器接线/初始化问题。配网失败优先长按按键恢复出厂设置或通过 Arduino IDE 的Tools Erase All Flash Before Sketch Upload: Enabled擦除 Flash也可直接使用命令行esptool.py --port PORT erase_flash擦除。无串口输出检查波特率是否为 115200以及 USB 连接是否正常。相关仓库资源示例源码与构建配置MatterPressureSensor.ino、ci.yml压力传感器端点实现MatterPressureSensor.h、MatterPressureSensor.cppMatter 端点基类MatterEndPoint.hMatter 节点管理 API配网码、decommission、连接状态查询Matter.hMatter 相关技术文档位于仓库 docs/en/matter 目录许可本示例遵循 Apache License, Version 2.0 许可协议发布。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考