Help Center> ROMA Connect> Developer Guide> Developer Guide for Device Integration> MQTT Topic Specifications> Adding a Gateway Subdevice
View PDF

Adding a Gateway Subdevice

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 uppercase and lowercase letters, digits, hyphens (-), and number signs (#).

description

Optional

String

Device description.

The value length cannot exceed 200 characters.

manufacturerId

Mandatory

String

Manufacturer ID.

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.

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
}