数据业务交互 相关接口

API 列表

函数	说明
Qth.sendTrans()	发送透传数据
Qth.sendTsl()	发送物模型数据
Qth.ackTsl()	应答物模型读取请求
Qth.ackTslServer()	应答物模型服务请求

API 详情

Qth.sendTrans

该函数用于设备发送透传数据到IOT平台。

函数原型

Qth.sendTrans(mode, value)

参数说明

• 输入参数

  • mode：发送模式，具体取值见下表：

    取值	描述
    0	消息仅发送一次，不需要确认或重传。可能会丢失或重复
    1	消息至少发送一次，直到收到确认。可能会重复

  • value：透传数据。

• 输出参数

  • 无。

• 返回值

  • 成功：返回 True。
  • 失败：返回 False。

调用示例

Qth.sendTrans(1, "hello world")

---

Qth.sendTsl

该函数用于设备发送物模型数据到IOT平台。

函数原型

Qth.sendTsl(mode, value)

参数说明

• 输入参数

  • mode：发送模式，具体取值见下表：

    取值	描述
    0	消息仅发送一次，不需要确认或重传。可能会丢失或重复
    1	消息至少发送一次，直到收到确认。可能会重复

  • value：物模型数据，字典格式。

• 输出参数

  • 无。

• 返回值

  • 成功：返回 True。
  • 失败：返回 False。

调用示例

Qth.sendTsl(1, {1:10,2:'hello'})

---

Qth.ackTsl

当IOT平台读取设备物模型数据时，该函数用于设备应答物模型数据。

函数原型

Qth.ackTsl(mode, value, pkgId)

参数说明

• 输入参数

  • mode：发送模式，具体取值见下表：

    取值	描述
    0	消息仅发送一次，不需要确认或重传。可能会丢失或重复
    1	消息至少发送一次，直到收到确认。可能会重复

  • value：物模型数据，字典格式。

  • pkgId：数据包ID，整型格式。

• 输出参数

  • 无。

• 返回值

  • 成功：返回 True。
  • 失败：返回 False。

调用示例

def App_cmdReadTslCb(ids, pkgId):
    print('readTsl:', ids, pkgId)
    value = {1:10,2:'hello'}
    Qth.ackTsl(0, value, pkgId)

---

Qth.ackTslServer

当IOT平台下发设备物模型服务时，该函数用于设备应答物模型服务请求。

函数原型

Qth.ackTslServer(mode, serverId, value, pkgId)

参数说明

• 输入参数

  • mode：发送模式，具体取值见下表：

    取值	描述
    0	消息仅发送一次，不需要确认或重传。可能会丢失或重复
    1	消息至少发送一次，直到收到确认。可能会重复

  • serverId：物模型服务ID，整型格式。

  • value：物模型数据，字典格式。

  • pkgId：数据包ID，整型格式。

• 输出参数

  • 无。

• 返回值

  • 成功：返回 True。
  • 失败：返回 False。

调用示例

def App_cmdRecvTslServerCb(serverId, value, pkgId):
    print('recvTslServer:', serverId, value, pkgId)
    Qth.ackTslServer(1, serverId, value, pkgId)