j6-board-monitor

Board Monitor

通过 SSH 在 J6 开发板上执行 BPU 占用率、DDR 带宽、内存使用的实时监控。支持三种场景：

• Scenario A：CV 模型在受控帧率推理期间同步采集资源数据（使用 hrt_model_exec）
• Scenario B：独立监控板端硬件资源（无推理负载）
• Scenario C：LLM 模型在循环推理期间同步采集资源数据（使用 simple_demo_request）

适用场景

• 在指定帧率（如 10Hz）推理时监控 BPU 占用率、DDR 带宽、内存使用
• 独立监控板端硬件资源（无推理负载）
• LLM 模型板端推理期间的 BPU/DDR/内存监控（循环推理 + 同步采集）
• 评估模型在实车设计帧率下的资源消耗
• 对比不同模型/配置的板端资源占用

触发关键词：BPU 监控、DDR 带宽、内存使用、资源监控、设定帧率、10Hz 推理、LLM 推理监控、LLM 资源、simple_demo_request、hrt_ucp_monitor、hrut_ddr

部署前预检：部署模型到板端前，先阅读 board-preflight.md 检查 ION 内存容量、L2M 配置和模型-板端兼容性。

工作流程

严格按照以下 8 步顺序执行，不可跳步。

前置条件

开始工作流之前，确认以下条件满足：

1. .horizon/.env.board 必须存在：读取该文件获取 BOARD_IP、BOARD_TYPE、BOARD_WORKDIR。如果文件不存在或不完整，先触发 board-detection skill 完成板卡检测，再继续。
2. SSH 免密登录：本 skill 的所有 SSH/SCP 命令假设已配置免密登录（密钥认证）。如果 SSH 连接要求输入密码，提示用户先配置密钥认证或提供密码，然后在所有 ssh/scp 命令中通过 sshpass -p <password> 前缀传递。
3. OE 工具链可用：hrt_ucp_monitor、hrut_ddr、hrt_model_exec 须已部署到板端。Step 2 会验证这一点。

Step 1：收集信息

从 .env.board 和用户输入收集以下信息。优先从 .env.board 读取，仅在文件中缺少时才询问用户。

项目	必填	默认值/来源	说明
板端 IP	是	.env.board → BOARD_IP	优先从文件读取
SSH 用户名	是	root
认证方式	是	密钥（免密）	见前置条件第 2 条
板端工作目录	是	.env.board → BOARD_WORKDIR	优先从文件读取
模型文件路径	Scenario A 必填	-	板端路径或本地路径（本地路径需 SCP 上传）
目标帧率 (FPS)	Scenario A 必填	-	如 10Hz、30Hz
监控时长 (秒)	否	30	采集持续时间
监控目标	否	bpu,ddr,memory	选择监控项

场景自动检测：

• 用户提供了 CV 模型（.hbm 较小、有明确 FPS 需求） → Scenario A（受控推理 + 同步监控）
• 用户仅提供监控需求 → Scenario B（独立监控，无推理负载）
• 用户提供了 LLM/VLM 模型（.hbm 较大、无 FPS 控制需求） → Scenario C（循环推理 + 同步监控）

Scenario A vs C 判断依据：

• 模型文件 > 500MB 或用户明确提到 LLM/VLM → Scenario C
• 模型文件 < 500MB 且有明确帧率要求（如 10Hz） → Scenario A

Step 2：检查板卡连通性与平台

1. 读取 .horizon/.env.board，获取 BOARD_TYPE、BOARD_IP、BOARD_WORKDIR
2. SSH 连通性检查：ssh -o ConnectTimeout=5 root@<IP> "echo ok"
3. 平台检测（决定 hrut_ddr 参数）：

# 读取平台类型
BOARD_TYPE=$(grep '^BOARD_TYPE=' .horizon/.env.board | head -1 | cut -d= -f2)

if echo "$BOARD_TYPE" | grep -q "nash-p"; then
  # J6P: 4 BPU cores, hrut_ddr 需要 per-core 参数
  DDR_TYPE="bpu_p0"
  BPU_CORES=4
else
  # J6E: 1 BPU core, hrut_ddr 使用统一参数
  DDR_TYPE="bpu"
  BPU_CORES=1
fi