错误码参考
HFLinkDriver 公开 API 以整数返回码报告结果:HFLINK_OK(0)表示成功,负数为错误码。
HFLinkCLI 的 flash 子命令失败时会在 stderr 打印 result=、primary=、cleanup= 三个驱动错误码,
可对照本表。
通用(-1 .. -14)
宏 |
值 |
含义 |
|---|---|---|
|
0 |
成功 |
|
-1 |
通用错误 |
|
-2 |
未初始化或参数为空 |
|
-3 |
未知设备型号 |
|
-4 |
无可用传输 |
|
-5 |
设备正忙 |
|
-6 |
通信错误(USB 传输失败、JTAG 链访问失败等) |
|
-7 |
命令未执行(批量传输中该条目被前序错误抑制) |
|
-8 |
DAP 响应 ACK 故障(非 OK/WAIT) |
|
-14 |
DAP 在重试次数耗尽后仍返回 WAIT;驱动已尝试发送 DAPABORT |
CMSIS-Pack(-9 .. -13)
宏 |
值 |
含义 |
|---|---|---|
|
-9 |
已安装的 CMSIS-Pack 中未找到指定芯片 |
|
-10 |
多个已安装 CMSIS-Pack 匹配指定芯片 |
|
-11 |
Pack 注册表或 Database 文件格式无效 |
|
-12 |
Pack 注册表或 Database schema 版本不受支持 |
|
-13 |
当前构建或探针不支持请求的规范能力 |
Lua 脚本(-20 .. -23)
宏 |
值 |
含义 |
|---|---|---|
|
-20 |
Lua 代码存在语法错误 |
|
-21 |
Lua 代码执行期间发生错误 |
|
-22 |
Lua 运行时内存分配失败 |
|
-23 |
Lua 脚本文件无法打开或读取 |
拓扑与 Flash(-30 .. -35)
宏 |
值 |
含义 |
|---|---|---|
|
-30 |
物理拓扑中没有满足 Pack 约束的目标 |
|
-31 |
物理拓扑中有多个目标满足 Pack 约束,无法唯一选择 |
|
-32 |
Flash 镜像格式或校验无效 |
|
-33 |
Flash bank、算法、地址空间或执行核心选择冲突 |
|
-34 |
调试或 Flash 操作超时 |
|
-35 |
目标在算法执行期间进入 Fault 或意外停止 |
HSS 高速采样(-36 .. -39)
宏 |
值 |
含义 |
|---|---|---|
|
-36 |
HSS 会话未启动采样(需先 |
|
-37 |
HSS 采样块数或总字节数超出单批能力上限 |
|
-38 |
HSS 参数无效(周期/块大小/地址对齐等) |
|
-39 |
当前探针(如第三方 DAP)或固件能力不满足 HSS 请求 |
退出码映射
HFLinkCLI 进程退出码与驱动错误码相互独立:0 = 成功,1 = 运行失败(错误详情见 stderr 打印的
驱动错误码),2 = 命令行解析错误。详见 HFLinkCLI 使用指南。