Agent Skills › ruvnet/RuView › provision-node

provision-node

GitHub

用于构建、烧录和配置 ESP32 CSI 传感节点,支持多平台固件校验与写入,完成 WiFi 及硬件参数设置并验证数据流。

harness/ruview/.claude/skills/provision-node/SKILL.md ruvnet/RuView

触发场景

需要为 ESP32 设备烧录固件 初始化或重新配置 IoT 传感器节点

安装

npx skills add ruvnet/RuView --skill provision-node -g -y
更多选项

非标准路径

npx skills add https://github.com/ruvnet/RuView/tree/main/harness/ruview/.claude/skills/provision-node -g -y

不安装直接使用

npx skills use ruvnet/RuView@provision-node

指定 Agent (Claude Code)

npx skills add ruvnet/RuView --skill provision-node -a claude-code -g -y

安装 repo 全部 skill

npx skills add ruvnet/RuView --all -g -y

预览 repo 内 skill

npx skills add ruvnet/RuView --list

SKILL.md

Frontmatter
{
    "name": "provision-node",
    "description": "Build, flash, and provision an ESP32-S3\/C6 CSI node for RuView — firmware variant choice, cross-platform checksum-verified esptool flashing, NVS\/WiFi\/channel\/MAC-filter overrides, boot-log evidence."
}

provision-node

Bring an ESP32 sensing node online.

1. Pick a firmware variant

  • s3-8mb (display build) — ESP32-S3 N16R8 / 16MB; AMOLED optional. The display-detect fix (#1000) means a bare board still captures CSI (MGMT+DATA).
  • s3-4mb (no-display) — ESP32-S3 4MB; dual-OTA, display disabled.
  • c6 — ESP32-C6 + Seeed MR60BHA2 (60 GHz mmWave + WiFi CSI). The mmwave probe requires a validated MR60 header (#1107) so an empty UART never false-detects.

Prebuilt binaries: GitHub release v0.8.1-esp32 (hardware-validated on S3 QFN56 rev v0.2).

2. Flash

Use a release flash bundle (or release_bins/<variant>, or an ESP-IDF build/). The harness flashes on Windows, macOS, and Linux through python -m esptool:

npx @ruvnet/ruview doctor --group python,serial,firmware   # esptool, pyserial, ports, bundle checksums
npx @ruvnet/ruview flash-plan --port <PORT> --bundle <dir> --variant s3-8mb
npx @ruvnet/ruview flash --port <PORT> --bundle <dir> --variant s3-8mb --confirm

flash verifies SHA256SUMS, refuses a chip that does not match the variant (esptool chip_id), writes 0x0 / 0x8000 / 0xf000 / 0x20000 (NVS preserved), then captures a boot log. hardwareValidated: true requires CSI callbacks in that log. Over MCP, ruview_node_flash needs the hardware-write grant and confirm: true.

Building from source still uses ESP-IDF v5.4 (Docker or the Windows subprocess flow; Git Bash/MSYS is unsupported, so strip MSYSTEM* env vars).

3. Provision

python firmware/esp32-csi-node/provision.py --port <PORT> \
  --ssid "<SSID>" --password "<secret>" --target-ip <server-ip> --target-port 5005
# optional ADR-060 overrides:
python firmware/esp32-csi-node/provision.py --port <PORT> --channel 6 --filter-mac AA:BB:CC:DD:EE:FF

Never echo or commit the WiFi password.

4. Confirm CSI is flowing

ruview_node_monitor {port} — PASS criteria: serial shows CSI cb #... callbacks and (on a bare board) CSI filter upgraded to MGMT+DATA. No callbacks → the node isn't capturing; do not proceed to calibration.

版本历史

  • a1ca023 当前 2026-10-20 00:00

    新增跨平台 esptool 自动化烧录流程,增加 SHA256 校验、芯片 ID 预检及启动日志捕获功能。

  • a3b6e1d 2026-08-20 13:11

同 Skill 集合

.claude/skills/agentdb-advanced/SKILL.md
.claude/skills/agentdb-learning/SKILL.md
.claude/skills/agentdb-memory-patterns/SKILL.md
.claude/skills/agentdb-optimization/SKILL.md
.claude/skills/agentdb-vector-search/SKILL.md
.claude/skills/browser/SKILL.md
.claude/skills/github-code-review/SKILL.md
.claude/skills/github-multi-repo/SKILL.md
.claude/skills/github-project-management/SKILL.md
.claude/skills/github-release-management/SKILL.md
.claude/skills/github-workflow-automation/SKILL.md
.claude/skills/hooks-automation/SKILL.md
.claude/skills/pair-programming/SKILL.md
.claude/skills/reasoningbank-agentdb/SKILL.md
.claude/skills/reasoningbank-intelligence/SKILL.md
.claude/skills/skill-builder/SKILL.md
.claude/skills/sparc-methodology/SKILL.md
.claude/skills/stream-chain/SKILL.md
.claude/skills/swarm-advanced/SKILL.md
.claude/skills/swarm-orchestration/SKILL.md
.claude/skills/v3-cli-modernization/SKILL.md
.claude/skills/v3-core-implementation/SKILL.md
.claude/skills/v3-ddd-architecture/SKILL.md
.claude/skills/v3-integration-deep/SKILL.md
.claude/skills/v3-mcp-optimization/SKILL.md
.claude/skills/v3-memory-unification/SKILL.md
.claude/skills/v3-performance-optimization/SKILL.md
.claude/skills/v3-security-overhaul/SKILL.md
.claude/skills/v3-swarm-coordination/SKILL.md
.claude/skills/verification-quality/SKILL.md
harness/homecore/.claude/skills/explore/SKILL.md
harness/homecore/.claude/skills/migrate/SKILL.md
harness/homecore/.claude/skills/operate-server/SKILL.md
harness/homecore/.claude/skills/secure-plugin/SKILL.md
harness/homecore/.claude/skills/verify/SKILL.md
harness/ruview/.claude/skills/calibrate-room/SKILL.md
harness/ruview/.claude/skills/device-access/SKILL.md
harness/ruview/.claude/skills/onboard/SKILL.md
harness/ruview/.claude/skills/train-pose/SKILL.md
harness/ruview/.claude/skills/verify/SKILL.md
harness/wifi-densepose-sar/.claude/skills/evolve/SKILL.md
harness/wifi-densepose-sar/.claude/skills/plan-change/SKILL.md
plugins/ruview/skills/ruview-advanced-sensing/SKILL.md
plugins/ruview/skills/ruview-applications/SKILL.md
plugins/ruview/skills/ruview-cli-api/SKILL.md
plugins/ruview/skills/ruview-configure/SKILL.md
plugins/ruview/skills/ruview-hardware-setup/SKILL.md
plugins/ruview/skills/ruview-mmwave/SKILL.md
plugins/ruview/skills/ruview-model-training/SKILL.md

元信息

文件数
0
版本
a1ca023
Hash
13dd6c35
收录时间
2026-08-20 13:11

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 16:28
浙ICP备14020137号-1