Help Center/ ROMA Connect/ Developer Guide/ Developer Guide for Device Integration/ MQTT Topic Specifications/ Adding a Gateway Subdevice
Updated on 2026-01-16 GMT+08:00
View PDF
Share

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
}