设备添加

接口功能

当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。

接口描述

1	HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);

参数说明

字段	必选/可选	类型	描述
uiCookie	可选	HW_UINT	Cookie有效值为1-65535。
pstDeviceInfo	必选	ST_IOTA_DEVICE_INFO结构体	设备信息，pstDeviceInfo结构体中的成员变量必须带结束符‘\0'。

接口返回值

参见2. 函数标准返回值

返回结果

广播名称	广播参数	成员	描述
IOTA_TOPIC_HUB_ADDDEV_RSP	HW_MSG对象	EN_IOTA_HUB_IE_TYPE	返回设备添加结果，如果添加成功则返回设备ID。

示例

// 开发者调用该接口进行设备添加 
ST_IOTA_DEVICE_INFO stDeviceInfo 
stDeviceInfo.pcNodeId = “SN Number”; 
stDeviceInfo.pcManufacturerId = “Huawei”; 
stDeviceInfo.pcDeviceType = “Camera”; 
stDeviceInfo.pcModel = “HW_CAM101”; 
stDeviceInfo.pcProtocolType = “ONVIF”;

IOTA_HubDeviceAdd(29011, &stDeviceInfo);

结果处理：

// 开发者注册该函数进行设备添加后的处理 
HW_iNT Device_AddResultHandler(HW_UiNT uiCookie, HW_MSG pstMsg) 
{
    uiResult = HW_MsgGetUint(pstMsg, EN_IOTA_HUB_IE_RESULT);
    if (EN_IOTA_HUB_RESULT_SUCCESS != uiResult) 
    {
        // retry with uiCookie 
        return 0;
    }
    return 0;
}
//绑定广播接收处理函数 HW_BroadCastReg(“IOTA_TOPIC_HUB_ADDDEV_RSP”, Device_AddResultHandler);