API 通用数据类型

ID

节点标识符。 这是一个唯一的 64 位数字。 它由固定前缀 0xDECA, MCU 唯一芯片 ID 和 DW1000/DW3000 唯一部件 ID 按以下格式导出： 0xDECA + 28 位 MCU 唯一芯片 ID + 20 位 DW1000 唯一部件 ID。

id = 64 位整数

---

状态码

每条命令返回的状态码。

• ‘0’ (ok)

• ‘1’ (未知命令或 tlv 框架损坏)

• ‘2’ (内部错误)

• ‘3’ (无效参数)

• ‘4’ (忙)

• ‘5’ (不允许操作)

• ‘6’ (校验和值错误)

• ‘7’ (输入错误)

• ‘8’ (不支持)

• ‘9’ (需要重置并需要再次发送命令)

---

位置

节点（锚点或标签）的位置。

• In CARTESIAN coordinate, position = x, y, z, pqf (position coordinates)

  • x = 32 位整数 (单位：毫米)

  • y = 32 位整数(单位：毫米)

  • z = 32 位整数(单位：毫米)

  • pqf = 8位整数(位置质量因子，以百分比表示)

• In WGS84 coordinate, position = lat, lon, 0, pqf (position coordinates)

  • lat = 32-bit integer (WGS84 latitude x10^7)

  • lon = 32-bit integer (WGS84 latitude x10^7)

  • 0

  • pqf = 8位整数(位置质量因子，以百分比表示)

---

gpio_idx

通过输入 PX。Y 向用户提供的 GPIO 引脚的索引，其中：

• X: 端口编号

• Y: 引脚索引

请参考下面列表中特定设备的编号/索引。

• DWM1001: P0.08, P0.12, P0.13, P0.15, P0.23, P0.27

• DWM3001: P0.06, P0.12, P0.13, P0.17, P0.20, P0.21, P1.00, P1.01, P1.05, P1.09

• LC13/LC14 (2AB): P0.11, P0.12, P0.13, P0.14, P1.7, P1.14

---

fw_version

• fw_version = maj, min, patch, ver (固件版本)

  • maj = 8位数(MAJOR)

  • min = 8位数(MINOR)

  • patch = 8位数(PATCH)

  • ver = res, var

  • : res = 4位数字(RESERVED)

  • var = 4位数字(VARIANT)