Tasmota Matter 1.4/1.4.1 差距分析：从 Matter 1.2 到 1.4 的演进路径与实现缺口

Tasmota Matter 1.4/1.4.1 差距分析从 Matter 1.2 到 1.4 的演进路径与实现缺口【免费下载链接】TasmotaAlternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at项目地址: https://gitcode.com/GitHub_Trending/ta/TasmotaTasmota 的 Matter 实现基于 Berry 脚本语言覆盖 PASE/CASE 会话安全、配网流程、交互模型IM、mDNS 服务发现以及按设备类型组织的插件体系。本篇技术指南以lib/libesp32/berry_matter/MATTER_1.4_GAP_ANALYSIS.md为骨架结合仓库内 Berry 源码系统梳理 Tasmota 当前 Matter 实现的版本基线、已支持设备类型与集群清单、Matter 1.4/1.4.1 新特性的差距以及会话安全、配网、Fabric 管理、交互模型等底层实现细节并给出可执行的改进路线图。一、文档定位与实现基线本仓库中的 MATTER_1.4_GAP_ANALYSIS.md 是一份针对 Tasmota Matter Berry 实现与 Matter 1.4/1.4.1 规范之间的功能差距分析文档分析日期标注为 2026 年 1 月。它回答的核心问题是Tasmota 的 Matter 实现目前处于规范的哪个版本水位距离 Matter 1.4 还有多远。其姊妹文档还包括MATTER_1.4.1_DETAILED_GAP_ANALYSIS.md —— 包含实现要求、代码示例与路线图的详细差距分析MATTER_CLASS_HIERARCHY.md —— 插件类层级结构MATTER_SESSION_ARCHITECTURE.md —— PASE/CASE 会话建立过程MATTER_ICD_IMPLEMENTATION.md —— ICD 集群实现细节。版本指示器Version Indicators文档给出的版本判断依据来自三个可被 Matter 控制器直接读到的元数据DataModelRevision返回17对应 Basic Information 集群属性0x0000表明数据模型基线为 Matter 1.2InteractionModelRevision返回11在交互模型IM消息中携带同样对应 Matter 1.2Cluster Revisions各集群修订号不一范围 17。需要指出的是仓库源码中的实现已经进一步演进在 Matter_Plugin_1_Root.be 的注释中DataModelRevision 已更新为18Matter 1.3, compatible with 1.4.1而 Matter_IM_Data.be 中的 InteractionModelRevision 也已更新为1212 Matter 1.4 Interaction Model revision。也就是说分析文档记录的基线是 1.2但当前源码已向 1.4 方向演进——阅读时应注意文档与源码之间的时间差这也正是差距分析文档的价值所在它是持续跟踪规范进度的活文档。二、当前已支持设备类型与集群全景已支持的设备类型文档列出的已支持设备类型如下括号内为 Matter 设备类型 ID设备类型ID说明Root Node0x0016根节点Aggregator0xFF00桥接模式BridgeOn/Off Light0x0100开关灯Dimmable Light0x0101可调光Color Temperature Light0x010C色温灯Extended Color Light0x010D全彩灯On/Off Plug-in Unit0x010A插座Temperature Sensor0x0302温度传感器Humidity Sensor0x0307湿度传感器Pressure Sensor0x0305压力传感器Illuminance Sensor0x0106照度传感器Occupancy Sensor0x0107占用传感器Contact Sensor0x0015门磁/接触传感器Flow Sensor0x0306流量传感器Window Covering0x0202窗帘/百叶Shutter/TiltFan0x002B风扇Generic Switch0x000F按键/通用开关Air Quality Sensor—空气质量传感器Rain Sensor—雨量传感器Water Leak Detector—漏水探测器这一清单与源码中的插件文件一一对应。在 lib/libesp32/berry_matter/src/embedded/ 目录下可以看到成体系的插件实现Matter_Plugin_1_Root.be、Matter_Plugin_1_Aggregator.be、Matter_Plugin_1_Device.be—— 根节点、聚合器桥与设备基类Matter_Plugin_2_*—— Light0开关灯、Fan、Shutter、Thermostat、各传感器Matter_Plugin_3_*—— OnOff、Light1、传感器温湿度、压力、流量、照度、占用、接触、雨量、漏水、空气质量、布尔状态等Matter_Plugin_4_Light2/Light3—— 高级灯光Matter_Plugin_8_Bridge_*—— 桥接模式下的各类设备Matter_Plugin_9_Virt_*、Matter_Plugin_9_Zigbee_*—— 虚拟设备与 Zigbee 桥接设备。注意一个细节文档的差距清单将 Thermostat 列为未实现但仓库中已存在 Matter_Plugin_2_Thermostat.be 插件见后文差距修订一节说明该差距在源码演进中已被部分补齐。已支持集群清单集群ID状态备注Descriptor0x001D✅Access Control0x001F✅Basic Information0x0028✅OTA Software Update Requestor0x002A⚠️ 部分桩实现Localization Configuration0x002B✅Time Format Localization0x002C✅General Commissioning0x0030✅Network Commissioning0x0031⚠️ 部分属性有限Diagnostic Logs0x0032⚠️ 桩无属性General Diagnostics0x0033✅Software Diagnostics0x0034⚠️ 桩无属性Time Synchronization0x0038⚠️ 部分仅基础时间Administrator Commissioning0x003C✅Node Operational Credentials0x003E✅Group Key Management0x003F⚠️ 桩TODOOn/Off0x0006✅Level Control0x0008✅Color Control0x0300✅Window Covering0x0102✅Fan Control0x0202✅Temperature Measurement0x0402✅Pressure Measurement0x0403✅Flow Measurement0x0404✅Humidity Measurement0x0405✅Occupancy Sensing0x0406✅Illuminance Measurement0x0400✅Boolean State0x0045✅Generic Switch0x003B✅这些集群在 Matter_Plugin_1_Root.be 中集中实现文件头部对每个集群的修订号、属性表、命令表都有规范级注释例如 Basic Information 集群标注 Cluster Revision: 3 (Matter 1.4.1)并在read_attribute/write_attribute中以elif cluster 0xXXXX的分支逐一处理。三、Matter 1.4 新特性差距分析1.4 新增设备类型均未实现设备类型集群 ID状态优先级Battery Storage电池储能—❌ 未实现中Solar Power太阳能—❌ 未实现中Home Router家庭路由器—❌ 未实现低Water Heater热水器0x0094❌ 未实现中Heat Pump热泵—❌ 未实现中Enhanced EV Charger增强型电动车充电桩0x0099❌ 未实现低1.4 新增集群均未实现集群ID说明Electrical Power Measurement电功率测量0x0090实时功率监控Electrical Energy Measurement电能测量0x0091能耗追踪Device Energy Management设备能源管理0x0098能源优化Device Energy Management Mode能源管理模式0x009F能源模式Power Topology电力拓扑0x009C配电结构Water Heater Management热水器管理0x0094热水器控制Water Heater Mode热水器模式0x009E热水器模式1.4/1.4.1 协议增强特性状态影响Thread 1.3.1 支持❌ 未实现Thread 边界路由器改进NFC 入网1.4.1❌ 未实现简化配网多设备批量设置1.4.1❌ 未实现批量配网增强型 CASE 会话恢复✅ 已实现会话恢复可用ICD间歇连接设备✅ 已实现SIT 模式支持LIT 部分支持其中ICD 支持是 1.4 周期内 Tasmota 完成度最高的新特性详见下文专项分析。安全更新特性状态备注PASESPAKE2✅ 合规使用 CHIP 上下文前缀CASESigma✅ 合规完整实现会话恢复Session Resumption✅ 合规可用消息计数器校验✅ 合规窗口大小 32AES-CCM 加密✅ 合规16 字节认证标签四、高优先级差距详解差距 1能源测量集群缺失HIGHTasmota 本身拥有非常强大的电能计量能力通过 PZEM、HLW8012、CSE7766、BL0937 等驱动仓库中 tasmota/tasmota_xnrg_energy/ 目录收录了从xnrg_01_hlw8012.ino到xnrg_30_dummy.ino的 30 个电能计量驱动。但这些数据目前无法通过 Matter 暴露给智能家居控制器——而 Matter 1.4 恰恰新增了电能集群这是一个显著的错位。缺失集群Electrical Power Measurement0x0090—— 实时功率Electrical Energy Measurement0x0091—— 累计电能文档建议新建两个插件类型Matter_Plugin_Sensor_Power.beMatter_Plugin_Sensor_Energy.be从源码结构看新增插件只需仿照 Matter_Plugin_3_Sensor_Temp.be 等现有传感器插件的模式声明CLUSTERS、TYPES、实现read_attribute并维护 shadow 状态即可复用整个 Matter 栈。差距 2恒温器集群HIGH文档指出集群修订表引用了 Thermostat0x0201但分析当时没有插件实现它导致 Tasmota 的恒温器功能无法暴露给 Matter 控制器。现状修订源码已部分填补仓库中已出现 Matter_Plugin_2_Thermostat.be实现的是 Matter 1.4.1 设备规范中的 Thermostat0x0301集群0x0201Thermostat属性包括LocalTemperature0x0000、OccupiedCoolingSetpoint0x0011、OccupiedHeatingSetpoint0x0012、ControlSequenceOfOperation0x001B、SystemMode0x001C、ThermostatRunningState0x0029类型注册TYPES { 0x0301: 4 }Matter 1.4.1 设备库修订 4特征映射thermostat_feature_map()返回0x23即 HEAT COOL AUTOSystemMode 枚举0Off、1Auto、3Cool、4Heat、7Fan only、8Dry采用 shadow 状态模式先维护本地影子值子类可发布原生命令Local shadow state only; subclasses can publish native commands温度以 0.01°C 为单位如shadow_local_temperature int(config.find(local_temp, nil)) * 100默认可调范围min_temp160016.00°C到max_temp300030.00°C提供set_system_mode、set_cooling_setpoint、set_heating_setpoint等方法更新后通过attribute_updated()触发订阅推送。此外还有Matter_Plugin_9_Virt_HVAC.be、Matter_Plugin_9_Virt_HVAC_Option.be等虚拟 HVAC 插件。因此这一差距可以标记为分析后已进入实现阶段。五、中低优先级差距详解差距 3ICD间歇连接设备—— 已实现SIT 基础模式状态✅ 已实现。ICD Management Cluster0x0046始终启用采用基础 SITShort Idle Time短空闲时间模式适配市电供电的 WiFi 设备。已实现属性对应规范 9.17.6 节属性ID值说明IdleModeDuration0x00001 秒规范允许的最小值ActiveModeDuration0x0001300ms规范默认值ActiveModeThreshold0x0002300ms规范默认值未实现属性依赖可选特性ICDCounter、ClientsSupportedPerFabric、RegisteredClients—— 依赖 CIP 特性OperatingMode—— 依赖 LITS 特性UserActiveModeTriggerHint/Instruction—— 依赖 UAT 特性。集群配置修订号 3Matter 1.4.1Feature Map 为 0x00无可选特性。源码中 Matter_Plugin_0.be 与 Matter_Plugin_1_Root.be 可交叉印证前者定义 ICD 集群 Feature Map0x00与修订号3后者在read_attribute中实现了0x0000/0x0001/0x0002三个属性的返回。mDNS 通告SII500ms、SAI300ms规范默认值不通告 ICD key规范规定仅 LITS 能力设备需要。影响控制器知道该设备始终可达使用标准 MRP消息重传协议时序即可无需特殊节电处理。差距 4Power Source 集群缺失未实现 Power Source 集群0x002F。该集群对以下场景重要电池电量上报电源类型指示有线/电池供电状态。对便携设备、电池供电的 Tasmota 设备而言这是后续值得补的集群。差距 5OTA 更新集群不完整桩实现当前 OTA Software Update Requestor0x002A只是桩# 返回空列表并声称无法更新 return TLV.Matter_TLV_array() # empty list for now TODO return tlv_solo.set(TLV.BOOL, 0) # we claim that update is not possible即向控制器返回空列表、宣称无法更新。源码 Matter_Plugin_1_Root.be 中 0x002A 分支也仍是占位实现。补齐后可实现基于 Matter 的固件升级流程。差距 68三个空壳集群elif cluster 0x003F # Group Key Management Cluster 11.2 p.572 # TODO elif cluster 0x0032 # Diagnostic Logs Cluster 11.10 p.637 # no attributes elif cluster 0x0034 # Software Diagnostics Cluster 11.12 p.654 # no mandatory attributes - to be added later (maybe)Group Key Management0x003F代码中标记 TODO不过 Matter_Plugin_0.be 已将其修订号登记为2Clarify KeySetWrite validation and behavior on invalid epoch key lengths且 Root 插件已在0x003F: [0]暴露属性 0。文档也指出 Group Key DerivationIPK 组密钥在 Fabric 层是正常工作的因此该集群只是属性暴露层面不完整。Diagnostic Logs0x0032无属性实现。Software Diagnostics0x0034规范本身无强制属性注释为待以后可能添加。六、会话与安全实现分析PASEPassword-Authenticated Session Establishment✅ 合规 —— 完整的 SPAKE2 实现。一个关键互操作细节在 Matter_Commissioning_Context.be 中# static Matter_Context_Prefix Matter PAKE V1 Commissioning # spec is wrong static var Matter_Context_Prefix CHIP PAKE V1 Commissioning # from CHIP code即虽然规范文本写的是Matter PAKE V1 Commissioning但实际互操作必须以 CHIPMatter 官方参考实现使用的CHIP PAKE V1 Commissioning为准。这是文档列出的可接受偏差之一反而是保证与主流控制器互通的前提。PASE 密钥派生在 Matter_z_Commissioning.be 中通过crypto.PBKDF2_HMAC_SHA256().derive(passcode, root_salt, self.PBKDF_ITERATIONS, 80)完成迭代次数取最小值 1000——合规但属于最低安全要求。CASECertificate-Authenticated Session Establishment✅ 合规 —— 完整的 Sigma1/Sigma2/Sigma3 协议实现包含证书链校验ECDH 密钥交换基于 HKDF 的会话密钥派生会话恢复支持文档明确Enhanced CASE Resumption ✅ Implemented。已知偏差可接受上下文前缀使用CHIP PAKE V1 Commissioning而非规范的Matter PAKE V1 Commissioning——这是保证互操作性的正确做法PBKDF2 迭代次数使用最小值 1000——合规但安全边际较低。七、配网Commissioning与 Fabric 管理配网实现Matter_z_Commissioning.be特性状态备注PASE 窗口管理✅默认 10 分钟超时QR 码生成✅完整 MT: 格式支持be_matter_qrcode.c Matter_Base38.be手动配对码✅11 位含 Verhoeff 校验和be_matter_verhoeff.cppmDNS PASE 通告✅_matterc._udp带子类型mDNS 运营通告✅按 Fabric 的_matter._tcpOpenCommissioningWindow✅增强配网窗口OpenBasicCommissioningWindow✅基础配网窗口RevokeCommissioning✅关闭窗口Fabric 管理Matter_Fabric.be特性状态备注最大 CASE 会话数5每 Fabric 上限组密钥派生✅IPK 组密钥Fabric 压缩✅压缩 Fabric ID多 Fabric✅支持多个控制器Fabric 标签✅用户自定义标签Fabric 父级追踪✅嵌套配网交互模型Matter_IM.beOpcode名称状态0x01Status Response✅0x02Read Request✅已优化0x03Subscribe Request✅0x04Subscribe Response❌设备模式0x05Report Data❌设备模式0x06Write Request✅0x07Write Response❌设备模式0x08Invoke Request✅已优化0x09Invoke Response❌设备模式0x0ATimed Request✅注标记为设备模式的 opcode 是控制器侧操作Matter 设备端无需实现。mDNS 服务记录配网_matterc._udpVPVendorProductDDiscriminatorCMCommissioning ModeTTCP 支持 0SII/SAI睡眠间隔子类型_Ldiscriminator、_Sshort、_Vvendor、_CM1。运营_matter._tcp实例名compressed_fabric-device_id子类型_Icompressed_fabric。八、兼容性结论与路线图建议兼容性文档明确当前实现完全兼容 Matter 1.0/1.1 控制器对已支持的设备类型也能在 Matter 1.4 控制器下工作。差距主要影响三类能力Matter 1.4 新增设备类型不支持能源监控特性未通过 Matter 暴露高级诊断实现最少。因此Apple Home、Google Home、Amazon Alexa 等主流控制器对现有受支持设备类型均可正常联动。改进路线图按优先级立即高价值新增能源测量插件复用 tasmota/tasmota_xnrg_energy/ 中已有的电能驱动实现集群 0x0090电功率与 0x0091电能对智能家居能源监控价值最高恒温器插件实现集群 0x0201 并映射到 Tasmota 恒温器命令注源码已出现 Matter_Plugin_2_Thermostat.be此工作已在进行。短期启用 ICD 支持文档写作时 ICD 集群代码存在但被禁用源码已改为默认启用 SIT 模式对电池设备重要添加 Power Source 集群上报电池/有线状态对便携设备重要。长期完成 OTA 集群启用基于 Matter 的固件更新热水器支持Matter 1.4新设备类型。实现质量评估优势架构清晰——Session、Fabric、Commissioning、IM 关注点分离优化路径——常见操作有快速通道处理持久化稳健——基于 JSON 的 Fabric/会话存储见 Matter_Session_Store.be日志完善——全面的调试输出桥接支持——远程设备聚合Aggregator/Bridge 模式。待改进能源集群——对 Tasmota 能源监控而言是高价值缺口恒温器——Tasmota 已具备恒温器能力而 Matter 侧长期缺失现已补上ICD——文档写作时代码存在但被禁用现已默认启用诊断——实现最少。九、结论Tasmota 的 Matter 实现正沿着 Matter 1.2 → 1.3 → 1.4/1.4.1 的路线稳步前进安全性PASE/CASE与核心会话机制完全合规设备类型覆盖面广1.4 周期的 ICD 特性已经落地而能源集群、新增设备类型与诊断类集群仍是主要缺口。对于开发者而言这份差距分析文档配合 src/embedded/ 下的插件源码既是理解 Tasmota Matter 架构的入口也是参与补齐 1.4 特性的实现清单。后续可重点跟进 MATTER_1.4.1_DETAILED_GAP_ANALYSIS.md 中的详细实现要求与代码示例将本文的高优先级差距逐项转化为实际插件代码。【免费下载链接】TasmotaAlternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at项目地址: https://gitcode.com/GitHub_Trending/ta/Tasmota创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考