Adding a Gateway Subdevice

This topic is intended solely for adding a new child device to the gateway and cannot be used to bind an existing child device to it.

Topic

Topic	/v1/devices/{gatewayId}/topo/add
Publisher	Edge device
Subscriber	IoT platform

Parameter Description

Field	Mandatory/Optional	Type	Description
mid	Mandatory	Integer	Command ID.
deviceInfos	Mandatory	List<DeviceInfos>	Subdevice information list. The list contains 1 to 100 records.

DeviceInfos struct description

Field	Mandatory/Optional	Type	Description
nodeId	Mandatory	String	Device identifier. The value must contain 2 to 64 characters and can consist of only uppercase and lowercase letters, digits, and hyphens (-).
name	Optional	String	Device name. The value must contain 2 to 64 characters and can consist of only letters, digits, hyphens (-), and number signs (#).
description	Optional	String	Device description. The value length cannot exceed 200 characters.
manufacturerId	Mandatory	String	Manufacturer ID, which belongs to the same integration application as the gateway. The product type is common product. The value must contain 2 to 50 characters and can consist of only uppercase and lowercase letters, digits, hyphens (-), and underscores (_).
model	Mandatory	String	Product model, which corresponds to the manufacturer ID. The value must contain 2 to 50 characters and can consist of only uppercase and lowercase letters, digits, hyphens (-), and underscores (_).

Example

{
       "deviceInfos": [{
              "manufacturerId": "Test_n",
              "model": "A_n",
              "nodeId": "n-device"
       }],
       "mid": 7
}

Parent topic: MQTT Topic Specifications

Previous topic: Gateway Login

Next topic: Response for Adding a Gateway Subdevice