检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台提供了Agent Lite SDK，帮助设备快速连接到物联网平台。支持TCP/IP协议栈的设备在集成Agent Lite SDK后，可以直接与物联网平台通信。不支持TCP/IP协议栈的设备例如蓝牙设备、ZigBee设备等，
接收设备命令 接口功能 注册设备命令接收广播来接收处理平台下发的控制命令。 接口描述 1 IOTA_TOPIC_SERVICE_COMMAND_RECEIVE/{deviceId}; 参数说明 枚举项 枚举值 类型 描述 EN_IOTA_DATATRANS_IE_RESULT 0
广播机制 Agent Lite提供了一套广播机制给第三方开发者，用来接收Agent Lite上报的消息。 订阅广播 1 HW_BroadCastReg(HW_CHAR *pcTopic ,PFN_HW_BROADCAST_RECV pfnReceiver); 广播接收处理函数原型
非直连设备管理 当开发设备为网关设备时，设备需要管理所有非直连设备（传感器设备）的接入与删除，并且记录这些设备ID与对应设备的映射关系。 添加设备 更新设备状态 删除设备 父主题： 设备侧Agent Lite API参考(C)（联通用户专用）
绑定配置 接口功能 配置Agent Lite相关参数。 接口描述 1 2 HW_INT IOTA_ConfigSetStr(HW_INT iItem, HW_CHAR *pValue) HW_INT IOTA_ConfigSetUint(HW_INT iItem, HW_UINT
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口，对应参数配置为EN_IOTA_CFG_IOCM_ADDR和EN_IOTA_CFG_IOCM_PORT
数据类型说明 常用数据类型 类型名称 类型原型 HW_INT int HW_UINT unsigned int HW_CHAR char HW_UCHAR unsigned char HW_BOOL int HW_ULONG unsigned long HW_USHORT unsigned
删除设备 接口功能 当有新设备需要从网关移除时，通过调用设备删除接口将非直连设备从物联网平台删除。 接口描述 1 HW_INT IOTA_HubDeviceRemove(HW_UINT uiCookie, const HW_CHAR *pcDeviceId); 参数说明 字段 必选
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
设备登录 接口功能 设备在第一次绑定后，或者在设备重启后需要进行登录的流程。 接口描述 1 HW_INT IOTA_Login(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功，并不说明登录成功，登录成功需要收到IOTA_TOPIC_CONNECTED_NTY
设备登出 接口功能 断开与物联网平台的连接。 接口描述 1 HW_INT IOTA_Logout(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功。 示例 1 2 // 开发者调用设备登出接口： IOTA_Logout(); 父主题
登录参数配置 接口功能 在登录前配置登录所需要的参数。 接口描述 1 2 HW_INT IOTA_ConfigSetStr(HW_INT iItem, HW_CHAR *pValue) HW_INT IOTA_ConfigSetUint(HW_INT iItem, HW_UINT
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *
释放Agent Lite资源 接口功能 调用此函数，Agent Lite会释放申请的所有动态资源（内存、线程等等）。 接口描述 1 IOTA_VOID IOTA_Destroy(); 接口返回值 参见函数标准返回值 示例 1 2 // 开发者调用该接口销毁Agent Lite资源
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令，开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源，下一次重启后需要重新进行绑定。 接口描述 1 IOTA_TOPIC_CMD_UNBIND_RECEIVE; 示例 1 2 3
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态
初始化Agent Lite资源 接口功能 初始化Agent Lite资源。 接口描述 1 HW_INT IOTA_Init(const HW_CHAR *pcWorkPath, const HW_CHAR *pcLogPath); 参数说明 字段 必选/可选 类型 描述 pcWorkPath
登录信息的加密算法配置（可选） 接口功能 在登录前配置敏感信息加密算法类型，业务可以根据安全级别选择合适的加密算法类型。 接口描述 1 HW_UINT HW_SetAlgType(HW_UINT uiAlgType); 参数说明 字段 必选/可选 类型 描述 uiAlgType
Agent Lite SDK使用指南（C）（联通用户专用） 非联通用户请查看设备接入服务。 按照本文档的指导，开发者可以体验直连设备通过集成Agent Lite快速接入平台，体验“数据上报”、“命令接收”、“添加非直连设备”等功能。 Agent Lite以SDK的形式嵌入第三方软件中
产品模型（联通用户专用） 概述 产品模型（也称Profile）用于描述设备具备的能力和特性。开发者通过定义Profile，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息，如颜色、开关等。当定义完一款产品模型后，在进行设备注册时，就可以选择已在控制台上导入的产品模型
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
