用途:集中说明 RuView 部署中可调的各项配置,从单条 provisioning 参数到完整 mesh 与 Cognitum Seed 组合。
主要能力与用法:
- 固件构建时配置(sdkconfig):默认 8MB 变体用 firmware/esp32-csi-node/sdkconfig.defaults.template;4MB 用 sdkconfig.defaults.4mb(关闭显示、双 OTA 槽,partitions_4mb.csv 每槽约 1.856 MB);Heltec 用 sdkconfig.defaults.heltec_n16r2。切换方式为 cp 对应模板到 sdkconfig.defaults 后重新构建。不可在 mock 模式测试,Kconfig 阈值缺陷仅在真实 CSI 下暴露。
- 运行时设备配置(NVS,经 provision.py):通过串口写入 csi_cfg 命名空间,参数权威列表用 python firmware/esp32-csi-node/provision.py --help 查看(Windows 需设 PYTHONUTF8=1 PYTHONIOENCODING=utf-8)。参数分组包括 WiFi/sink(--ssid --password --target-ip --target-port 默认 5005 --node-id 0-255)、TDM mesh(--tdm-slot --tdm-total)、边缘处理(--edge-tier 0/1/2,对应关/统计/生命体征)、检测阈值(--pres-thresh 50、--fall-thresh 15000)、生命体征(--vital-win 300、--vital-int 1000、--subk-count 32)、信道/跳频(--channel、--filter-mac、--hop-channels、--hop-dwell)、Cognitum Seed(--seed-url --seed-token --zone)、Swarm(--swarm-hb、--swarm-ingest)、模式(--dry-run --baud 460800 --force-partial)。注意 NVS 命名空间为整体替换(issue #391),未在命令行传入的键会被清除,应始终传完整参数集;不确定时先读串口启动日志中的现有值。车队 provisioning 可用 scripts/generate_nvs_matrix.py。
- 传感服务器:在 v2 目录运行 cargo run -p wifi-densepose-sensing-server -- --help 查看模式,支持实时 sink、--pretrain、--train、--model ... --embed、--build-index 等。wifiscan 服务器(ADR-022)可将邻接 AP 作为雷达照射源。
- 边缘智能模块(ADR-041):运行于 ESP32 的 Rust/WASM 小程序,无需联网;每个模块声明 8 维 CSI 特征输入与 RVF 存储目标(Cognitum Seed),可在固件组件配置中选择打包、经 NVS 配置阈值。宿主机镜像脚本位于 scripts/ 下(如 apnea-detector.js、gait-analyzer.js 等)。
- 多节点 mesh:2 个以上节点可获得真实空间分辨率,各节点 provision 到同一 --target-ip;TDM 与跳频由 wifi-densepose-hardware 协调。
- Cognitum Seed 集成:物料约 $140,ESP32 流式 CSI 经 bridge 转发至 Seed,提供持久 RVF 记忆、环境 kNN 与 Ed25519 见证链;命令如 node scripts/rf-scan.js --port 5006 与 node scripts/snn-csi-processor.js --port 5006。
- 应用层:API 为 wifi-densepose-api(Axum),配置见 wifi-densepose-config crate 与 example.env/pyproject.toml;Docker 可 docker run -p 3000:3000 ruvnet/wifi-densepose:latest;Dashboard 服务在 :3000,nvsim dashboard(ADR-092)独立。
适用场景与限制:适用于调优 ESP32 CSI 节点、mesh 组网与边缘推理部署;具体硬件、模块参数与版本兼容性以 docs/adr/、CLAUDE.md、example.env 等仓库文档为准。部分内容(如各模块阈值明细、Docker 环境变量)资料中未完整给出,暂未提供。