ym88659208ym87991671
Devices configuration transmission (config) | Documentation for developers

Devices configuration transmission (config)

Last updated on May 17, 2023

Direction: controller → cloud.

The agent app installed on the controller provides Sber Smart Home with configurations of devices.

Use case example:

  1. On the controller, the user changes a characteristic of one or more devices: name, firmware version or something else.
  2. The agent receives from the controller the current device configuration and sends a message indicating it. The message can be sent independently or as a response to the Smart Home's message: sberdevices/v1/<username>/down/config_request.
  3. The Smart Home updates the list of devices and correctly displays them in the Salute app, on SberPortal, SberBox and other devices with Salute assistants.

Message format

Topic:

sberdevices/v1/<username>/up/config
ParameterTypeMandatory?Description
usernamestring✔︎Login for connection to the Sber MQTT server (see "Having your controller authorized" for integrators and DIY enthusiasts)

Message body:

FieldTypeMandatory?Description
devicesdict<string object>✔︎List of devices (see User device (device)), the configuration of which is transmitted
{
"devices": [
{
"id": string,
"name": string,
"default_name": string
// ...
},
{
"id": string,
"name": string,
"default_name": string
// ...
}
]
}

Message example

The agent app installed on the controller notifies Sber Smart Home of the fact that the user's smart lamp has been updated.

Topic:

sberdevices/v1/1234567/up/config

Message body:

{
"devices": [
{
"id": "ABCD_005",
"name": "Night light",
"default_name": "Smart lamp"
}
]
}
Sber process cookies only to personalize services according to Cookies Usage Policy. You can prevent the processing of cookies in your browser settings.