设备验证快速开始

本页给出最短的真机验证流程。详细说明见网络发现与设备验证。

1. 确认设备

设备与测试电脑应连接同一局域网。测试只走 STA，不要让电脑连接设备 AP；STA 失败时查看串口或路由器 DHCP 列表，记录原因后跳过该设备。

串口	环境	STA 地址
COM4	esp32c3-F4R0	<device-ip>
COM11	esp32c6-F4R0	<device-ip>
COM15	esp32s3-F16R8	<device-ip>
COM16	esp32-F4R0	<device-ip>
COM7	esp32s3-F8R0	<device-ip>

<device-ip> 必须在测试当次从串口启动日志或路由器 DHCP 客户端表确认；仓库不记录会随租约变化的实验室地址。

2. 执行单机冒烟

cd D:\project\gitee\FastBee-Arduino

powershell -ExecutionPolicy Bypass -File scripts\smoke-test-device.ps1 `
  -BaseUrl http://<device-ip> -Profile unified -RequireNetworkConnected

powershell -ExecutionPolicy Bypass -File scripts\device-web-smoke.ps1 `
  -BaseUrl http://<device-ip> -Rounds 2 -DelayMs 1000 `
  -TimeoutSec 15 -MaxElapsedMs 5000 `
  -ReportPath test\reports\c3-web-smoke.csv

替换地址即可检查其他设备。4MB 设备请保留请求间隔，避免测试流量本身制造内存压力。

3. 执行五机冒烟

cd D:\project\gitee\FastBee-Arduino

powershell -ExecutionPolicy Bypass -File scripts\run-device-fleet-tests.ps1 `
  -DeviceConfig scripts\device-fleet.example.json `
  -Ssid <expected-ssid> -BrowserTests:$false

需要浏览器交互回归时，将 -BrowserTests 改为 $true。五台设备的配置文件各不相同，部署和验证时必须保持串口、环境、配置来源一一对应。

4. 判定结果

• 所有命令退出码为 0，对应 JSON、CSV 报告中没有失败项。
• 页面巡检的 16 个资源均返回 HTTP 200，且响应时间不超过命令中的阈值。
• 401 通常表示会话未登录或已失效；重新登录后复测，不应直接判定为设备网络失败。
• STA 地址不可达时不要改连 AP，先确认 DHCP 地址和串口日志。
• 冒烟通过只代表当前时刻可用；正式长稳验收仍按稳定性与发布检查清单执行。