flash

使用通用构建运行器 ${COCO_PLUGIN_ROOT}/trae_build_runner.py 的 flash 子命令，对 ${workspaceFolder} 仓库进行烧录/读/复位（调用 Telink bdt.exe / Cmd_download_tool.exe）。

参数路由

根据 $ARGUMENTS 构造一条 python 命令并用 Bash 工具执行：

• 第一个参数视为 bdt 命令（wf/rf/rst/ac/lf/wc/rc/wa/ra/wo/ro/pc/sws/help），用 --command 传递。
• 其余参数原样透传给 runner 的 flash 子命令。

常用调用

# 烧录最新固件（自动取 build_variants 下最新 .bin）
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command wf

# 烧录并验证 + 失败重试 3 次 + 烧前预检（产线推荐组合）
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command wf --pre-check --verify --retry 3

# 指定芯片和输入文件烧录
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command wf --chip TC122X --input build_variants/app.bin --erase

# 多设备：用 SN 精确定位
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command wf --device-id 61174f1a603

# 读 flash 前 16 字节
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command rf --address 0 --size 16 --output read.bin

# 复位
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command rst

# 预览命令不执行
python "${COCO_PLUGIN_ROOT}/trae_build_runner.py" --project "${workspaceFolder}" flash --command wf --dry-run

选项速查

选项	说明
--chip	bdt 芯片名（TL721X/B80/TC321X；空=builder.json flash.default_chip 或从预设推断）
--command	bdt 命令（默认 wf）
--address	地址，十进制（默认 0）
--input	-i 输入文件（wf 空=最新 .bin）
--output	-o 输出文件（rf/rc/ro）
--size	-s 大小（如 512k）
--erase	-e 写前擦除
--device-id	BDT 设备 id：数字(1,2) 或 SN 十六进制串；空=配置默认(1)
--verify	wf 后读回前 64 字节与文件对比
--retry N	wf 失败时重试 N 次，每次先跑恢复序列(ac→rst→ac→lf)
--pre-check	wf 前先 ac 探测芯片是否连接（仅 EVK 模式）
--timeout	覆盖超时秒数
--dry-run	只打印 bdt 命令不执行

汇报规范

解析 runner 的 JSON 输出后向用户汇报：

• 成功：status、chip、device_id、耗时、attempts（重试次数）；若有 verify，报告 verify_detail（match/mismatch）
• 失败：exit_code、error_reason（结构化诊断，如 "chip not found"、"address out of range"）、attempts
• dry-run：展示完整 bdt 命令（含 cwd 提示：Cmd_download_tool.exe 需在自身目录执行）