Adding a Device

API Function

This API is used to add a device that accesses the IoT platform through the gateway. After the device is connected to the IoT platform, the IoT platform will assign a unique logical ID to the device.

API Description

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

Parameter Description

Parameter	Mandatory or Optional	Type	Description
uiCookie	Optional	HW_UINT	The value ranges from 1 to 65535.
pstDeviceInfo	Mandatory	ST_IOTA_DEVICE_INFO structure	Specifies the device information. The value must end with \0.

Return Value

For details, see 4.2 Function Return Values.

Output

Broadcast Name	Broadcast Parameter	Member	Description
IOTA_TOPIC_HUB_ADDDEV_RSP	HW_MSG object	EN_IOTA_HUB_IE_TYPE	Specifies the device addition result. If the addition is successful, the device ID is returned.

Example

//Developers call this API to add a device.
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);

The device waits for the result.

//Developers call this API to register the function for subsequent processing after the device is added.
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;
}
//Bind the broadcast reception processing function HW_BroadCastReg ("IOTA_TOPIC_HUB_ADDDEV_RSP", Device_AddResultHandler).