hub
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",
"nicknames": [
"Smart controller",
"Intelligent 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",
},
}