4 常量定义
4.1 错误码
对应的常量定义类: ErrorCode
码值 |
引用常量 |
说明 |
描述 |
|---|---|---|---|
0xFFFF(-1) |
ERR_UNKNOWN |
未知错误 |
设备端推送未定义的错误码 |
0x0000(0) |
ERR_NONE |
操作成功 |
执行操作成功 |
0x0001(1) |
ERR_FAILED |
操作失败 |
执行操作失败 |
0x0002(2) |
ERR_INVALID_PARAM |
参数无效 |
输入参数无效 |
0x0003(3) |
ERR_IN_OPERATION |
正在操作 |
当前操作正在进行中，请勿重复开始。 |
0x0004(4) |
ERR_DEVICE_IS_BUSY |
设备繁忙 |
设备处于繁忙状态，不能在开始复杂流程。
如文件传输，数据传输等
|
0x0005(5) |
ERR_INSUFFICIENT_MEMORY |
内存不足 |
设备端没有足够的空间存储文件 |
0x0006(6) |
ERR_UNKNOWN_COMMAND |
未知命令 |
未定义的命令码 |
0x0007(7) |
ERR_RESPONSE_LEN_OVER |
回复数据长度溢出 |
说明请求的参数过长 |
0x0100(256) |
ERR_CANCEL |
操作中止 |
执行操作被中止 |
0x0101(257) |
ERR_TIMEOUT |
操作超时 |
执行操作超时 |
0x0102(258) |
ERR_NOT_ALLOW_OP |
不允许的操作 |
|
0x0103(259) |
ERR_UNSUPPORTED_FEATURE |
不支持的功能 |
|
0x0200(512) |
ERR_DEVICE_IS_DISCONNECTED |
设备未连接 |
设备端未连接或未初始化完成 |
0x0201(513) |
ERR_DEVICE_IN_CALL |
设备处于通话状态 |
设备端处于通话状态，不能进行复杂流程 |
0x0202(514) |
ERR_DEVICE_IN_OTA |
设备处于升级状态 |
设备端处于升级状态，不能进行其他操作 |
0x0203(515) |
ERR_OBJECT_NOT_INIT |
对象未初始化 |
|
0x0300(768) |
ERR_INSUFFICIENT_DATA |
数据不足 |
所需数据不足，解析不到命令内容 |
0x0301(769) |
ERR_WRONG_DATA |
错误数据 |
不符合协议格式的数据 |
0x0302(770) |
ERR_SEND_DATA_FAILED |
发送数据失败 |
发送数据失败 |
0x0303(771) |
ERR_WAITING_RESPONSE_TIMEOUT |
等待回复命令超时 |
等待回复命令超过限制时间 |
0x0304(772) |
ERR_LOSE_SEND_DATA |
丢失发送数据 |
丢失待发送的数据 |
0x0305(773) |
ERR_NO_DATA_HANDLER |
没有数据处理线程 |
设备未初始化 |
0x0306(774) |
ERR_REPLY_BAD_STATUS |
设备回复失败的状态 |
设备回复了一个失败的状态 |
0x0307(775) |
ERR_PARSE_DATA |
解析数据失败 |
解析不到正确的命令数据 |
0x0308(776) |
ERR_READ_DATA |
读取数据失败 |
读取不到数据, 需要检查参数是否正确，存储数据是否存在 |
0x0309(777) |
ERR_LOSE_DATA |
丢失数据 |
接收到的数据放到数据处理线程时操作失败，导致数据丢失 |
0x0400(1024) |
ERR_WRONG_FILE |
错误文件 |
文件数据不正确 |
0x0401(1025) |
ERR_IO_EXCEPTION |
IO异常 |
保存文件发送异常 |
0x0402(1026) |
ERR_WRITE_DATA |
写数据失败 |
写入数据异常，需要检查设备写入数据是否成功 |
0x0403(1027) |
ERR_DATA_CRC |
数据CRC校验失败 |
数据校验失败，需要检查设备收取数据是否完整 |
0x0404(1028) |
ERR_WAITING_DATA_TIMEOUT |
等待数据超时 |
长时间接收不到读取数据的指令触发。默认是20秒 |
4.2 连接状态
对应的类名：DfuConstant
码值 |
说明 |
常量引用 |
|---|---|---|
0 |
未连接/已断开 |
STATE_DISCONNECT |
1 |
已连接 |
STATE_CONNECTED |
2 |
连接中 |
STATE_CONNECTING |
4.3 设备状态
对应的类名：DfuConstant
码值 |
说明 |
常量引用 |
|---|---|---|
0 |
未初始化/初始化失败状态 |
STATUS_UNINITIALIZED |
1 |
初始化成功状态 |
STATUS_INIT_SUCCESSFUL |
4.4 分发器DFU状态
对应的类名：DfuState
码值 |
说明 |
常量引用 |
|---|---|---|
0 |
空闲状态 |
STATE_IDLE |
1 |
准备传输升级文件状态 |
STATE_FILE_TRANSFER_START |
2 |
正在传输升级文件状态 |
STATE_FILE_TRANSFER_WORKING |
3 |
已传输升级文件状态 |
STATE_FILE_TRANSFERRED |
4 |
已添加文件信息状态 |
STATE_ADDED_SLOT |
5 |
已添加目标设备状态 |
STATE_ADDED_TARGET |
6 |
DFU升级开始状态 |
STATE_UPGRADE_START |
7 |
DFU升级中状态 — 文件传输中 |
STATE_TRANSFERRING |
8 |
DFU升级中状态 — 文件传输完成 |
STATE_TRANSFER_SUCCESS |
9 |
DFU升级中状态 — 新程序生效中 |
STATE_APPLYING |
10 |
DFU升级结束状态 |
STATE_UPGRADE_STOP |
4.5 目标设备DFU状态
对应的类名：DfuStatus
码值 |
说明 |
常量引用 |
|---|---|---|
0 |
空闲状态 |
TARGET_STAGE_IDLE |
1 |
BLOB传输失败 |
TARGET_STAGE_TRANSFER_FAILED |
2 |
BLOB传输中 |
TARGET_STAGE_TRANSFERRING |
3 |
数据校验中 |
TARGET_STAGE_DATA_VERIFYING |
4 |
数据校验成功 |
TARGET_STAGE_DATA_VERIFICATION_SUCCESSFUL |
5 |
数据校验失败 |
TARGET_STAGE_DATA_VERIFICATION_FAILED |
6 |
新程序正在应用 |
TARGET_STAGE_APPLYING |
7 |
传输取消 |
TARGET_STAGE_TRANSFER_CANCEL |
8 |
新程序应用成功 |
TARGET_STAGE_APPLY_SUCCESSFUL |
9 |
新程序应用失败 |
TARGET_STAGE_APPLY_FAILED |
10 |
未知的升级状态 |
TARGET_STAGE_UNKNOWN |