ESP32-C6 固件性能基准实测解读ESPectre 四前端 × 双检测器的真实运行表现与通过标准【免费下载链接】espectreWi-Fi CSI motion sensing for ESP32. C SDK, ESPHome, Native, and Matter frontends, browser tools, and a CLI for the full device lifecycle. GPLv3 and commercial licensing.项目地址: https://gitcode.com/GitHub_Trending/es/espectre本篇技术指南围绕 docs/performance/ESP32-C6.md 这份由tools/benchmark_firmware.py自动生成的固件性能报告展开系统解读 ESP32-C6 上 Native、ESPHome、Matter 三种 C 前端各含 Lightweight 与 High Accuracy 两种检测器以及 Micro-ESPectreLightweight共 7 个组合的实测指标并结合仓库源码说明每项指标的采集原理、判定阈值与复现方法。读完本文你将掌握如何读懂这类运行期基准报告、如何在自己设备上复现同一套基准以及报告中的二进制体积、CSI 占用率、堆稳定性、CPU 负载与检测时序等指标分别验证了什么。报告生成信息速览由tools/benchmark_firmware.py --chip c6 --port serial-port生成Git 修订ed014256dbf6运行开始于2026-09-05T03:33:3202:00选定监控时长 60 秒总体结果 PASS运行期间源指纹稳定Source consistency: stable。报告属于自动生成文件!-- Generated file. Do not edit manually. --内容由基准工具渲染任何对源码的修改都应在下一轮基准中体现。报告定位这是一份运行期固件基准不是仿真报告头部的 Benchmark mode: runtime 表明全部 7 个用例都是在真实硬件上完成构建build→ 烧录flash→ 部署/配网 → 运行监控monitor→ 通过 Direct v1 接口采样的完整流程。可以从 tools/lib/firmware_benchmark/models.py 的CASES定义看到基准矩阵的固定组成Frontend检测器组合NativeLightweight、High AccuracyESPHomeLightweight、High AccuracyMatterLightweight、High AccuracyMicro-ESPectreLightweight其中 Matter 前端只支持这两个 C 检测器组合Micro-ESPectre 仅部署 LightweightMicro 是 MicroPython 运行时只支持轻量检测器这与报告头部 Detector coverage 的说明一致。报告还特别提示--update或--resume保留的旧用例可能来自更早的运行精确的用例来源应以每次运行单独生成的 artifacts 为准见 tools/lib/firmware_benchmark/report.py 的 Snapshot scope 说明。需要说明的是本报告衡量的是固件在真实 Wi-Fi 环境下的运行期行为包率、CSI 占用率、堆、CPU 负载而检测器在录制数据上的识别精度Recall / FP Rate / F1由另一份报告 docs/performance/README.md 给出本文最后会横向引用其 ESP32-C6 数据作为补充。摘要矩阵7 个用例一目了然报告第一个核心表格是 Summary 矩阵聚合了每个用例最重要的 6 项结果指标Frontend检测器结果CSI 占用率二进制体积分区剩余CPU 负载最小空闲堆NativeLightweightPASS88.83%1.32 MiB564.9 KiB (29.0%)6.78%218.7 KiBNativeHigh AccuracyPASS86.53%1.32 MiB564.9 KiB (29.0%)9.20%218.7 KiBESPHomeLightweightPASS92.93%1.10 MiB662.5 KiB (37.0%)6.73%220.7 KiBESPHomeHigh AccuracyPASS91.68%1.10 MiB662.5 KiB (37.0%)9.93%220.7 KiBMatterLightweightPASS87.58%1.85 MiB1.96 MiB (52.0%)6.91%155.8 KiBMatterHigh AccuracyPASS84.35%1.85 MiB1.96 MiB (52.0%)9.73%153.6 KiBMicro-ESPectreLightweightPASS93.85%1.46 MiB552.0 KiB (28.0%)70.23%96.9 KiB几个值得注意的横向对比点二进制体积Matter 前端最大1.85 MiB因为它内嵌 Matter 协议栈ESPHome 前端最小1.10 MiB同一前端的 Lightweight 与 High Accuracy 共用同一份固件镜像检测器在运行时切换而非编译期二选一所以体积完全一致。CSI 占用率Micro-ESPectre 最高93.85%ESPHome 次之92.93%Matter 最低84.35%全部显著高于 70% 的detector-ready门槛该门槛来源见下文 Pass Criteria 解读。CPU 负载三个 C 前端在 6.7%9.9% 之间High Accuracy 普遍比 Lightweight 高出 23 个百分点Micro-ESPectre 达 70.23%这与它是 MicroPython 解释执行、且为无 RTOS 的循环运行时直接相关。最小空闲堆Matter 前端约 155.8/153.6 KiBMicro-ESPectre 约 96.9 KiB其余前端在 218221 KiB 量级。详细指标分组解读每个数值背后验证了什么报告对每个用例给出完整指标表| Metric | Value |。下面以 Native Lightweight 与 Micro-ESPectre Lightweight 两个代表性用例为例分组解读。完整数值请直接查阅 docs/performance/ESP32-C6.md 正文。1. 构建与部署阶段构建/烧录/监控时长、镜像与分区Native Lightweight 为例Build 28.3s、Flash 12.8s、Monitor 2m 36.1s固件二进制 1,387,600 bytes1355.1 KiB应用分区使用 1,387,600 bytes、剩余 578,480 bytes564.9 KiB。Matter 前端构建最久4m 27.4s且有独立 Deploy 阶段9.7s。Micro-ESPectre 特殊之处在于同时上报 Firmware binary1,531,872 bytes1496.0 KiB与Deployed Python source169,086 bytes165.1 KiB因为它是 MicroPython 部署方式——固件里还包含 Python 源码。分区剩余比例的意义在 ESP32-C6 上为未来的 OTA 双分区方案留出空间。报告渲染逻辑在 tools/lib/firmware_benchmark/report.py 的format_summary_partition_free中实现先换算 MiB 再附百分比。2. 网络与 CSI 采集质量包率、CSI 占用率、Direct 控制这是运行期基准的核心直接决定 Wi-Fi 感知的上层数据质量Packet rate已准入 CSI 包率Native Lightweight 88.75 pps 均值7296标准差 6.01ESPHome 92.77 pps8698标准差仅 2.04最稳定Matter 87.45 ppsMicro 93.83 pps9296标准差 1.19。注意这是准入后的包率csi_admitted_pps见 tools/lib/firmware_benchmark/analysis.py 中analyze_direct_evidence对csi_admitted_pps字段的解析。CSI occupancy占用率Lightweight 88.83%、High Accuracy 86.53%Native。它由 tools/lib/temporal_csi_sampler.py 与 src/cpp/core/temporal_csi_sampler.h 共同定义的固定网格准入机制衡量以目标速率把时间窗口切成槽位每个槽位至多准入一个 CSI 包占用率即已占用槽位数 / 总槽位数。C 与 Python 两端常量一致TEMPORAL_CSI_MINIMUM_COVERAGE_NUMERATOR 7U、DENOMINATOR 10U保证固件与主机端回放口径统一。Direct control attempts所有 C 前端均为120/120 succeeded、censored failures 0Direct diagnostics samples 60/60 expected——验证通过 Direct v1 HTTP 接口的控制面与诊断面在整个计分窗口内始终可用。Status cadence1.00 s 均值、最大间隔 1.011.02 sStatus gaps over tolerance 为 0——诊断采样节奏稳定无超限间隙C 前端容差 500 ms见 tools/lib/firmware_benchmark/settings.py 的RUNTIME_STATUS_GAP_TOLERANCE_MS。Motion samples各前端均收到 234235 个运动事件远高于最低要求的 5 个MIN_MOTION_SAMPLES 5证明 Direct SSE 事件流真实有效。3. 资源稳定性堆与堆稳定性Heap stability报告比较启动宽限后的两个连续 10 秒窗口的中位数HEAP_STABILITY_WINDOW_SECONDS 10要求最终窗口中位数较前一窗口下降不超过 5%HEAP_STABILITY_MAX_DECLINE_PERCENT 5.0。本例中 Native Lightweight 为 0 bytes / 0.00%Micro 为 0 bytesMatter 为 -21 bytes / -0.01%均无泄漏或持续增长迹象。Minimum free heap / Last largest heap block堆水位与最大连续块用于判断是否存在严重碎片化Matter 前端最小空闲堆 153.6155.8 KiB在三个 C 前端中最低但稳定。4. 检测器运行时开销检测时序Runtime loadCPU 负载由设备侧累计的空闲/忙碌统计得到Lightweight 6.73%6.91%High Accuracy 9.20%9.93%差异与检测器每包/每帧计算量一致。Detection average / minimum / maximumLightweight 检测均值约 766919 usHigh Accuracy 约 31013907 us最小值普遍在 028 us命中快速路径最大值在 1.37.2 ms 之间这些时序来自RuntimeMetrics.detection_*字段见 tools/lib/firmware_benchmark/models.py。Loop average / maximum主循环平均 7141782 usMatter Lightweight 的 Loop maximum 高达 123609 us与其协议栈偶发长任务相关但不影响整体通过判定通过判定不基于单次循环峰值。5. Matter 前端的配网验证BSSID 证据链Matter 用例的指标表包含一组 BSSID 配网证据字段Frontend setup final BSSID requested / applied through Direct / already associated / reassociation exercised / association verified全部为 yes。这些字段由 tools/lib/firmware_benchmark/report.py 的_bssid_provisioning_evidence从transport_evidence[bssid_provisioning]渲染用于证明 Matter 前端在通过 CHIP Tool 完成 BLE Wi-Fi 配网后能够经由 Direct 接口对目标 BSSID 完成请求—应用—重关联—验证的完整链路。ESPHome 用例中already associated为 no 而reassociation exercised为 yes说明其走了实际的重关联路径Native 用例为 already associatedyes说明设备在采样前已关联目标 AP重关联被实际执行reassociation exercisedyes以验证链路。Pass Criteria一套可编程的判定契约报告的通过标准不是人工主观判断而是由 tools/lib/firmware_benchmark/report.py 的render_report根据本次运行的用例集合程序化生成的每条都对应源码中的常量或分析函数。ESP32-C6 报告逐条列出核心条款包括所有必需的构建、烧录、部署全部成功Native、ESPHome、Matter、Micro-ESPectre 在整个计分窗口内协商Direct v1并采样规范化诊断数据Native 与 ESPHome 使用规范化固件默认值、烧录时清除全部设备数据、并通过Improv Serial配网Matter 清除全部设备数据、通过版本兼容的 CHIP Tool 控制器经 BLE 与 Wi-Fi 完成配网并到达其 Direct 端点各前端上报 Lightweight 检测、配置的内部受管流量、运行期变更前100 pps 目标对应 tools/lib/firmware_benchmark/settings.py 的MINIMUM_BENCHMARK_CSI_TARGET_PPS 100Native 保持未配置 MQTT隔离 MQTT 变量验证 Direct 路径独立性传感前端通过 Direct SSE 收到至少 5 个规范化运动事件MIN_MOTION_SAMPLES启动宽限后空闲堆提供两个完整的连续 10 秒窗口且最终窗口中位数相对前一窗口下降不超过 5%计分窗口内设备 uptime 不发生重启对应 tools/lib/firmware_benchmark/analysis.py 中device_reboots检测Direct 诊断节奏保持在运行期间隙容差内运动事件保持实时全部 7 个运行期用例的CSI 占用率均值 ≥ 70% 的 admitted-slot detector-ready 下限——该值由MINIMUM_OCCUPANCY_PERCENT 100.0 * MINIMUM_COVERAGE_NUMERATOR / MINIMUM_COVERAGE_DENOMINATOR计算即100 * 7 / 10 70%与 C 端 src/cpp/core/temporal_csi_sampler.h 的 7/10 常量一一对应检测器时序数据存在detector timing is presentDirect 发送失败与意外拒绝连接数不增长当前端暴露相应计数器时Micro-ESPectre 运行期启动器在整个 Direct 采集期间保持活跃。如何在你的 ESP32-C6 上复现这套基准前置准备Wi-Fi 与可选 Matter 配置基准需要真实 Wi-Fi 环境运行前必须提供 SSID/密码。仓库提供了模板 tools/benchmark_firmware.local.env.example复制为tools/benchmark_firmware.local.env后填写ESPECTRE_BENCHMARK_WIFI_SSIDYour Wi-Fi SSID ESPECTRE_BENCHMARK_WIFI_PASSWORDYour Wi-Fi password ESPECTRE_BENCHMARK_WIFI_BSSID ESPECTRE_BENCHMARK_WIFI_CHANNEL0 # ESPECTRE_BENCHMARK_CHIP_TOOL/path/to/chip-tool # ESPECTRE_BENCHMARK_DIRECT_TIMED_NONPERSISTENT0 # ESPECTRE_BENCHMARK_CHIP_TOOL_REVISIONconnectedhomeip git revision # ESPECTRE_BENCHMARK_MATTER_COMMISSIONING_TIMEOUT_SECONDS180 # ESPECTRE_BENCHMARK_MATTER_COMMISSIONING_ATTEMPTS2注意两点约束见 tools/lib/firmware_benchmark/settings.py 的require_benchmark_prerequisitesSSID 与密码为必填若设置了ESPECTRE_BENCHMARK_WIFI_CHANNEL则必须同时设置ESPECTRE_BENCHMARK_WIFI_BSSID以便基准钉住并验证单个接入点。运行 Matter 用例还需要ESPECTRE_BENCHMARK_CHIP_TOOL指向可用的 CHIP Tool。运行完整基准python tools/benchmark_firmware.py --chip c6 --port /dev/ttyUSB0--chip c6是必选参数可用芯片集合SUPPORTED_CHIPS由 ESPHome 配置与 Native 目标的交集推导--port指向串口。全部 7 个用例按 Native → ESPHome → Matter → Micro-ESPectre 顺序执行任一用例失败会立即终止并保留部分报告BenchmarkCaseFailed处理逻辑见 tools/benchmark_firmware.py。常用进阶参数参数作用--frontend {esphome,micro,native,matter}只运行某个前端的用例--detector {lightweight,high_accuracy}只运行某个检测器的用例--duration SECONDS每个计分窗口的监控时长默认 60 秒MONITOR_DURATION_SECONDS--update保留报告中已有用例仅替换本轮重跑的用例结果--resume保留已 PASS 的用例只重跑失败或缺失的用例--artifacts-dir PATH将原始日志与结构化证据写入指定目录其中--update/--resume涉及旧用例的来源问题——这正是报告头部 Snapshot scope 特别提示使用 per-run artifacts 追溯精确来源的原因。默认 artifacts 目录位于data/untracked/firmware_benchmarks/下每个运行目录包含各用例的build/deploy/flash/monitor日志.log、逐行事件流.jsonl、analysis.json结构化指标与manifest.json运行元数据与源指纹。运行期间工具会两次计算仓库状态repository_state()对比 Git 修订与BENCHMARK_SOURCE_PATHS含src/cpp、src/python/espectre_cli、src/python/micro_espectre、tools/benchmark_firmware.py、tools/lib/firmware_benchmark等的源指纹。若运行中修订发生变化结果会被标记 FAILbenchmark source provenance is invalid仅源文件变化则输出 WARNING 但结果仍有效——这保证了报告的可追溯性。横向补充ESP32-C6 检测器精度数据报告运行期基准回答固件跑得稳不稳识别精度则由 docs/performance/README.md数据来源data/dataset_info.json评估视图HT20/HT-LTF回答。其中 ESP32-C6 在正常 Wi-Fi 信号下的结果LightweightRecall 100.0%、Precision 98.9%、FP Rate 0.6%、F1-Score 99.4%、有效误报 1 次High AccuracyRecall 100.0%、Precision 100.0%、FP Rate 0.0%、F1-Score 100.0%、有效误报 0 次。弱 Wi-Fi 信号reserved selection holdout 录音下Lightweight Recall 99.7%、FP Rate 0.6%High Accuracy Recall 99.7%、FP Rate 0.0%均满足弱信号下 High Accuracy 的 Recall90%、FP10% 要求。两份报告互补使用精度报告回答检测器算法好不好本固件报告回答在真实芯片与真实 Wi-Fi 环境中检测所需的 CSI 数据流是否完整、稳定、及时。阅读建议与结论若关注资源占用优先看 Summary 矩阵的 Binary size、Min free heap 与 CPU load 三列若关注感知数据质量重点看 Packet rate 与 CSI occupancy并对照 70% 的 detector-ready 门槛若关注长期稳定性看 Heap stability 两窗口中位数差值与 Device uptime restarts若关注配网与控制链路看 Direct control attempts、Direct diagnostics samples 与 BSSID 证据链字段。本报告的全部判定均由 tools/lib/firmware_benchmark 下的模型、分析、报告三件套程序化完成任意指标低于契约即触发对应 failure reason 并输出到报告与 artifacts因此这份 ESP32-C6 报告既是开发自检工具也是一份可审计、可复现、可追溯到具体 Git 修订的固件质量证据。【免费下载链接】espectreWi-Fi CSI motion sensing for ESP32. C SDK, ESPHome, Native, and Matter frontends, browser tools, and a CLI for the full device lifecycle. GPLv3 and commercial licensing.项目地址: https://gitcode.com/GitHub_Trending/es/espectre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESP32-C6 固件性能基准实测解读：ESPectre 四前端 × 双检测器的真实运行表现与通过标准
ESP32-C6 固件性能基准实测解读ESPectre 四前端 × 双检测器的真实运行表现与通过标准【免费下载链接】espectreWi-Fi CSI motion sensing for ESP32. C SDK, ESPHome, Native, and Matter frontends, browser tools, and a CLI for the full device lifecycle. GPLv3 and commercial licensing.项目地址: https://gitcode.com/GitHub_Trending/es/espectre本篇技术指南围绕 docs/performance/ESP32-C6.md 这份由tools/benchmark_firmware.py自动生成的固件性能报告展开系统解读 ESP32-C6 上 Native、ESPHome、Matter 三种 C 前端各含 Lightweight 与 High Accuracy 两种检测器以及 Micro-ESPectreLightweight共 7 个组合的实测指标并结合仓库源码说明每项指标的采集原理、判定阈值与复现方法。读完本文你将掌握如何读懂这类运行期基准报告、如何在自己设备上复现同一套基准以及报告中的二进制体积、CSI 占用率、堆稳定性、CPU 负载与检测时序等指标分别验证了什么。报告生成信息速览由tools/benchmark_firmware.py --chip c6 --port serial-port生成Git 修订ed014256dbf6运行开始于2026-09-05T03:33:3202:00选定监控时长 60 秒总体结果 PASS运行期间源指纹稳定Source consistency: stable。报告属于自动生成文件!-- Generated file. Do not edit manually. --内容由基准工具渲染任何对源码的修改都应在下一轮基准中体现。报告定位这是一份运行期固件基准不是仿真报告头部的 Benchmark mode: runtime 表明全部 7 个用例都是在真实硬件上完成构建build→ 烧录flash→ 部署/配网 → 运行监控monitor→ 通过 Direct v1 接口采样的完整流程。可以从 tools/lib/firmware_benchmark/models.py 的CASES定义看到基准矩阵的固定组成Frontend检测器组合NativeLightweight、High AccuracyESPHomeLightweight、High AccuracyMatterLightweight、High AccuracyMicro-ESPectreLightweight其中 Matter 前端只支持这两个 C 检测器组合Micro-ESPectre 仅部署 LightweightMicro 是 MicroPython 运行时只支持轻量检测器这与报告头部 Detector coverage 的说明一致。报告还特别提示--update或--resume保留的旧用例可能来自更早的运行精确的用例来源应以每次运行单独生成的 artifacts 为准见 tools/lib/firmware_benchmark/report.py 的 Snapshot scope 说明。需要说明的是本报告衡量的是固件在真实 Wi-Fi 环境下的运行期行为包率、CSI 占用率、堆、CPU 负载而检测器在录制数据上的识别精度Recall / FP Rate / F1由另一份报告 docs/performance/README.md 给出本文最后会横向引用其 ESP32-C6 数据作为补充。摘要矩阵7 个用例一目了然报告第一个核心表格是 Summary 矩阵聚合了每个用例最重要的 6 项结果指标Frontend检测器结果CSI 占用率二进制体积分区剩余CPU 负载最小空闲堆NativeLightweightPASS88.83%1.32 MiB564.9 KiB (29.0%)6.78%218.7 KiBNativeHigh AccuracyPASS86.53%1.32 MiB564.9 KiB (29.0%)9.20%218.7 KiBESPHomeLightweightPASS92.93%1.10 MiB662.5 KiB (37.0%)6.73%220.7 KiBESPHomeHigh AccuracyPASS91.68%1.10 MiB662.5 KiB (37.0%)9.93%220.7 KiBMatterLightweightPASS87.58%1.85 MiB1.96 MiB (52.0%)6.91%155.8 KiBMatterHigh AccuracyPASS84.35%1.85 MiB1.96 MiB (52.0%)9.73%153.6 KiBMicro-ESPectreLightweightPASS93.85%1.46 MiB552.0 KiB (28.0%)70.23%96.9 KiB几个值得注意的横向对比点二进制体积Matter 前端最大1.85 MiB因为它内嵌 Matter 协议栈ESPHome 前端最小1.10 MiB同一前端的 Lightweight 与 High Accuracy 共用同一份固件镜像检测器在运行时切换而非编译期二选一所以体积完全一致。CSI 占用率Micro-ESPectre 最高93.85%ESPHome 次之92.93%Matter 最低84.35%全部显著高于 70% 的detector-ready门槛该门槛来源见下文 Pass Criteria 解读。CPU 负载三个 C 前端在 6.7%9.9% 之间High Accuracy 普遍比 Lightweight 高出 23 个百分点Micro-ESPectre 达 70.23%这与它是 MicroPython 解释执行、且为无 RTOS 的循环运行时直接相关。最小空闲堆Matter 前端约 155.8/153.6 KiBMicro-ESPectre 约 96.9 KiB其余前端在 218221 KiB 量级。详细指标分组解读每个数值背后验证了什么报告对每个用例给出完整指标表| Metric | Value |。下面以 Native Lightweight 与 Micro-ESPectre Lightweight 两个代表性用例为例分组解读。完整数值请直接查阅 docs/performance/ESP32-C6.md 正文。1. 构建与部署阶段构建/烧录/监控时长、镜像与分区Native Lightweight 为例Build 28.3s、Flash 12.8s、Monitor 2m 36.1s固件二进制 1,387,600 bytes1355.1 KiB应用分区使用 1,387,600 bytes、剩余 578,480 bytes564.9 KiB。Matter 前端构建最久4m 27.4s且有独立 Deploy 阶段9.7s。Micro-ESPectre 特殊之处在于同时上报 Firmware binary1,531,872 bytes1496.0 KiB与Deployed Python source169,086 bytes165.1 KiB因为它是 MicroPython 部署方式——固件里还包含 Python 源码。分区剩余比例的意义在 ESP32-C6 上为未来的 OTA 双分区方案留出空间。报告渲染逻辑在 tools/lib/firmware_benchmark/report.py 的format_summary_partition_free中实现先换算 MiB 再附百分比。2. 网络与 CSI 采集质量包率、CSI 占用率、Direct 控制这是运行期基准的核心直接决定 Wi-Fi 感知的上层数据质量Packet rate已准入 CSI 包率Native Lightweight 88.75 pps 均值7296标准差 6.01ESPHome 92.77 pps8698标准差仅 2.04最稳定Matter 87.45 ppsMicro 93.83 pps9296标准差 1.19。注意这是准入后的包率csi_admitted_pps见 tools/lib/firmware_benchmark/analysis.py 中analyze_direct_evidence对csi_admitted_pps字段的解析。CSI occupancy占用率Lightweight 88.83%、High Accuracy 86.53%Native。它由 tools/lib/temporal_csi_sampler.py 与 src/cpp/core/temporal_csi_sampler.h 共同定义的固定网格准入机制衡量以目标速率把时间窗口切成槽位每个槽位至多准入一个 CSI 包占用率即已占用槽位数 / 总槽位数。C 与 Python 两端常量一致TEMPORAL_CSI_MINIMUM_COVERAGE_NUMERATOR 7U、DENOMINATOR 10U保证固件与主机端回放口径统一。Direct control attempts所有 C 前端均为120/120 succeeded、censored failures 0Direct diagnostics samples 60/60 expected——验证通过 Direct v1 HTTP 接口的控制面与诊断面在整个计分窗口内始终可用。Status cadence1.00 s 均值、最大间隔 1.011.02 sStatus gaps over tolerance 为 0——诊断采样节奏稳定无超限间隙C 前端容差 500 ms见 tools/lib/firmware_benchmark/settings.py 的RUNTIME_STATUS_GAP_TOLERANCE_MS。Motion samples各前端均收到 234235 个运动事件远高于最低要求的 5 个MIN_MOTION_SAMPLES 5证明 Direct SSE 事件流真实有效。3. 资源稳定性堆与堆稳定性Heap stability报告比较启动宽限后的两个连续 10 秒窗口的中位数HEAP_STABILITY_WINDOW_SECONDS 10要求最终窗口中位数较前一窗口下降不超过 5%HEAP_STABILITY_MAX_DECLINE_PERCENT 5.0。本例中 Native Lightweight 为 0 bytes / 0.00%Micro 为 0 bytesMatter 为 -21 bytes / -0.01%均无泄漏或持续增长迹象。Minimum free heap / Last largest heap block堆水位与最大连续块用于判断是否存在严重碎片化Matter 前端最小空闲堆 153.6155.8 KiB在三个 C 前端中最低但稳定。4. 检测器运行时开销检测时序Runtime loadCPU 负载由设备侧累计的空闲/忙碌统计得到Lightweight 6.73%6.91%High Accuracy 9.20%9.93%差异与检测器每包/每帧计算量一致。Detection average / minimum / maximumLightweight 检测均值约 766919 usHigh Accuracy 约 31013907 us最小值普遍在 028 us命中快速路径最大值在 1.37.2 ms 之间这些时序来自RuntimeMetrics.detection_*字段见 tools/lib/firmware_benchmark/models.py。Loop average / maximum主循环平均 7141782 usMatter Lightweight 的 Loop maximum 高达 123609 us与其协议栈偶发长任务相关但不影响整体通过判定通过判定不基于单次循环峰值。5. Matter 前端的配网验证BSSID 证据链Matter 用例的指标表包含一组 BSSID 配网证据字段Frontend setup final BSSID requested / applied through Direct / already associated / reassociation exercised / association verified全部为 yes。这些字段由 tools/lib/firmware_benchmark/report.py 的_bssid_provisioning_evidence从transport_evidence[bssid_provisioning]渲染用于证明 Matter 前端在通过 CHIP Tool 完成 BLE Wi-Fi 配网后能够经由 Direct 接口对目标 BSSID 完成请求—应用—重关联—验证的完整链路。ESPHome 用例中already associated为 no 而reassociation exercised为 yes说明其走了实际的重关联路径Native 用例为 already associatedyes说明设备在采样前已关联目标 AP重关联被实际执行reassociation exercisedyes以验证链路。Pass Criteria一套可编程的判定契约报告的通过标准不是人工主观判断而是由 tools/lib/firmware_benchmark/report.py 的render_report根据本次运行的用例集合程序化生成的每条都对应源码中的常量或分析函数。ESP32-C6 报告逐条列出核心条款包括所有必需的构建、烧录、部署全部成功Native、ESPHome、Matter、Micro-ESPectre 在整个计分窗口内协商Direct v1并采样规范化诊断数据Native 与 ESPHome 使用规范化固件默认值、烧录时清除全部设备数据、并通过Improv Serial配网Matter 清除全部设备数据、通过版本兼容的 CHIP Tool 控制器经 BLE 与 Wi-Fi 完成配网并到达其 Direct 端点各前端上报 Lightweight 检测、配置的内部受管流量、运行期变更前100 pps 目标对应 tools/lib/firmware_benchmark/settings.py 的MINIMUM_BENCHMARK_CSI_TARGET_PPS 100Native 保持未配置 MQTT隔离 MQTT 变量验证 Direct 路径独立性传感前端通过 Direct SSE 收到至少 5 个规范化运动事件MIN_MOTION_SAMPLES启动宽限后空闲堆提供两个完整的连续 10 秒窗口且最终窗口中位数相对前一窗口下降不超过 5%计分窗口内设备 uptime 不发生重启对应 tools/lib/firmware_benchmark/analysis.py 中device_reboots检测Direct 诊断节奏保持在运行期间隙容差内运动事件保持实时全部 7 个运行期用例的CSI 占用率均值 ≥ 70% 的 admitted-slot detector-ready 下限——该值由MINIMUM_OCCUPANCY_PERCENT 100.0 * MINIMUM_COVERAGE_NUMERATOR / MINIMUM_COVERAGE_DENOMINATOR计算即100 * 7 / 10 70%与 C 端 src/cpp/core/temporal_csi_sampler.h 的 7/10 常量一一对应检测器时序数据存在detector timing is presentDirect 发送失败与意外拒绝连接数不增长当前端暴露相应计数器时Micro-ESPectre 运行期启动器在整个 Direct 采集期间保持活跃。如何在你的 ESP32-C6 上复现这套基准前置准备Wi-Fi 与可选 Matter 配置基准需要真实 Wi-Fi 环境运行前必须提供 SSID/密码。仓库提供了模板 tools/benchmark_firmware.local.env.example复制为tools/benchmark_firmware.local.env后填写ESPECTRE_BENCHMARK_WIFI_SSIDYour Wi-Fi SSID ESPECTRE_BENCHMARK_WIFI_PASSWORDYour Wi-Fi password ESPECTRE_BENCHMARK_WIFI_BSSID ESPECTRE_BENCHMARK_WIFI_CHANNEL0 # ESPECTRE_BENCHMARK_CHIP_TOOL/path/to/chip-tool # ESPECTRE_BENCHMARK_DIRECT_TIMED_NONPERSISTENT0 # ESPECTRE_BENCHMARK_CHIP_TOOL_REVISIONconnectedhomeip git revision # ESPECTRE_BENCHMARK_MATTER_COMMISSIONING_TIMEOUT_SECONDS180 # ESPECTRE_BENCHMARK_MATTER_COMMISSIONING_ATTEMPTS2注意两点约束见 tools/lib/firmware_benchmark/settings.py 的require_benchmark_prerequisitesSSID 与密码为必填若设置了ESPECTRE_BENCHMARK_WIFI_CHANNEL则必须同时设置ESPECTRE_BENCHMARK_WIFI_BSSID以便基准钉住并验证单个接入点。运行 Matter 用例还需要ESPECTRE_BENCHMARK_CHIP_TOOL指向可用的 CHIP Tool。运行完整基准python tools/benchmark_firmware.py --chip c6 --port /dev/ttyUSB0--chip c6是必选参数可用芯片集合SUPPORTED_CHIPS由 ESPHome 配置与 Native 目标的交集推导--port指向串口。全部 7 个用例按 Native → ESPHome → Matter → Micro-ESPectre 顺序执行任一用例失败会立即终止并保留部分报告BenchmarkCaseFailed处理逻辑见 tools/benchmark_firmware.py。常用进阶参数参数作用--frontend {esphome,micro,native,matter}只运行某个前端的用例--detector {lightweight,high_accuracy}只运行某个检测器的用例--duration SECONDS每个计分窗口的监控时长默认 60 秒MONITOR_DURATION_SECONDS--update保留报告中已有用例仅替换本轮重跑的用例结果--resume保留已 PASS 的用例只重跑失败或缺失的用例--artifacts-dir PATH将原始日志与结构化证据写入指定目录其中--update/--resume涉及旧用例的来源问题——这正是报告头部 Snapshot scope 特别提示使用 per-run artifacts 追溯精确来源的原因。默认 artifacts 目录位于data/untracked/firmware_benchmarks/下每个运行目录包含各用例的build/deploy/flash/monitor日志.log、逐行事件流.jsonl、analysis.json结构化指标与manifest.json运行元数据与源指纹。运行期间工具会两次计算仓库状态repository_state()对比 Git 修订与BENCHMARK_SOURCE_PATHS含src/cpp、src/python/espectre_cli、src/python/micro_espectre、tools/benchmark_firmware.py、tools/lib/firmware_benchmark等的源指纹。若运行中修订发生变化结果会被标记 FAILbenchmark source provenance is invalid仅源文件变化则输出 WARNING 但结果仍有效——这保证了报告的可追溯性。横向补充ESP32-C6 检测器精度数据报告运行期基准回答固件跑得稳不稳识别精度则由 docs/performance/README.md数据来源data/dataset_info.json评估视图HT20/HT-LTF回答。其中 ESP32-C6 在正常 Wi-Fi 信号下的结果LightweightRecall 100.0%、Precision 98.9%、FP Rate 0.6%、F1-Score 99.4%、有效误报 1 次High AccuracyRecall 100.0%、Precision 100.0%、FP Rate 0.0%、F1-Score 100.0%、有效误报 0 次。弱 Wi-Fi 信号reserved selection holdout 录音下Lightweight Recall 99.7%、FP Rate 0.6%High Accuracy Recall 99.7%、FP Rate 0.0%均满足弱信号下 High Accuracy 的 Recall90%、FP10% 要求。两份报告互补使用精度报告回答检测器算法好不好本固件报告回答在真实芯片与真实 Wi-Fi 环境中检测所需的 CSI 数据流是否完整、稳定、及时。阅读建议与结论若关注资源占用优先看 Summary 矩阵的 Binary size、Min free heap 与 CPU load 三列若关注感知数据质量重点看 Packet rate 与 CSI occupancy并对照 70% 的 detector-ready 门槛若关注长期稳定性看 Heap stability 两窗口中位数差值与 Device uptime restarts若关注配网与控制链路看 Direct control attempts、Direct diagnostics samples 与 BSSID 证据链字段。本报告的全部判定均由 tools/lib/firmware_benchmark 下的模型、分析、报告三件套程序化完成任意指标低于契约即触发对应 failure reason 并输出到报告与 artifacts因此这份 ESP32-C6 报告既是开发自检工具也是一份可审计、可复现、可追溯到具体 Git 修订的固件质量证据。【免费下载链接】espectreWi-Fi CSI motion sensing for ESP32. C SDK, ESPHome, Native, and Matter frontends, browser tools, and a CLI for the full device lifecycle. GPLv3 and commercial licensing.项目地址: https://gitcode.com/GitHub_Trending/es/espectre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考