设备授权 相关接口

API 列表

函数	说明
Ql_iotDBindcodeSet()	上报绑定信息
Ql_iotDBindcodeGet()	获取设备绑定码
Ql_iotRst()	重置设备

API 详情

Ql_iotDBindcodeSet

该函数用于触发设备可被绑定。在 App 通过短距网络（包括 TCP/IP 局域网、BLE 等）绑定设备时有效，需要设备上报与 App 相同的 bindcode 到平台才能完成实际绑定动作。

函数原型

qbool Ql_iotDBindcodeSet(const char *bindcode, quint32_t timeout)

参数说明

• 输入参数
  • quint8_t *  bindcode：设备绑定码；字符范围：0~9，A~F，为NULL时系统随机生成(长度固定为16节)。
  • quint32_t timeout: 可绑定时间，范围：0-3600(单位：秒)，0为取消绑定。

返回值

• True：  函数执行成功。
• False：函数执行失败。

备注

• 2.10.3及以上版本支持

---

调用示例

qbool ret = Ql_iotDBindcodeSet("1234567891234567", 120);

---

Ql_iotDBindcodeGet

该函数用于获取设备绑定码。

函数原型

quint32_t Ql_iotDBindcodeGet(char **bindcode)

参数说明

• 输入参数
  • quint8_t **  bindcode：设备绑定码。

返回值

设备绑定剩余超时时长。

备注

• 2.10.3及以上版本支持

---

调用示例

quint8_t *bindcode = NULL;
quint32_t timeout = Ql_iotDBindcodeGet(&bindcode);

---

Ql_iotRst

该函数用于重置设备bindCode与设备秘钥。

函数原型

void Ql_iotRst(void)

参数说明

无。

返回值

• True：函数执行成功。
• False： 函数执行失败。

备注

• 2.10.0及以上版本支持

---

调用示例

qbool ret = Ql_iotRst();

---