hub

Last updated on October 28, 2025

The hub is the smart home management center. It sends information with regard to its status (online or offline) to Sber Smart Home. This is how Sber Smart Home understands whether devices connected through the hub are available: if the hub is offline, then all connected devices will have the same status.

For devices connected to the smart home through a hub, the parent_id field must be filled in. It must contain the hub ID in the vendor's system.

Please note that if the hub is not only capable of connecting devices to the Smart Home bust also has smart device functions itself, e.g. is a lamp or a socket, the hub needs to be described through the structure of this device: light, socket, etc. If the hub only connects devices or its additional functions are not yet supported by Sber Smart Home, it shall be described by the hub structure.

Available device functions

Function	Mandatory?	Description
online	✔︎	Device availability: offline or online

Hub model description example

The model shall be described in accordance with the model structure. The described hub can only connect other devices to a smart home.

{
    "id": "QWERTY124",
    "manufacturer": "Xiaqara",
    "model": "SM1123456789",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "description": "Xiaqara smart hub",
    "category": "hub",
    "features": [
        "online",
    ]
}

User's hub description example

The device shall be describe in accordance with the device structure. The example contains no hub model description as we believe that models are described independently and the model ID will be enough (in this case, QWERTY124).

{
    "id": "ABCD_004",
    "name": "My hub",
    "default_name": "Smart hub",
    "home": "My home",
    "room": "Living room",
    "groups": [
      "Control",
      "Lighting",
    ],
    "model_id": "QWERTY124",
    "hw_version": "3.1",
    "sw_version": "5.6",
    "partner_meta": {
        "internal-id": 1234,
        "specificity": "microchip 2A",
    },
}