Протокол¶
Оглавление¶
Схема классов¶
deviceapis/device/v1/deviceapis_device_system_v1.proto¶
Сервис управления системными настройками устройства
SystemService¶
Сервис управления системными настройками устройства
| Название метода | Описание | Тип запроса | Тип ответа |
|---|---|---|---|
| PostSystemReboot | Метод удаленной перезагрузки | deviceapis.device.v1.PostSystemRebootRequest | deviceapis.device.v1.PostSystemRebootResponse |
| GetSystemInfo | Метод получения общей информации об устройстве | deviceapis.device.v1.GetSystemInfoRequest | deviceapis.device.v1.GetSystemInfoResponse |
DeviceInfo¶
Общая информация об устройстве
| Поле | Описание | Тип | Признак |
|---|---|---|---|
| firmware_version | Версия программного обеспечения | string | |
| hardware_version | Версия аппаратного обеспечения | string | |
| model | Модель | string | |
| mac_address | MAC-адрес. Диапазон: 17..17. Паттерн: /^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$/ | string | |
| ip | IP адрес. Диапазон: 7..15. Паттерн: /^((25[0-5] | 2[0-4][0-9] | [01]?[0-9][0-9]?).){3}(25[0-5] |
| serial_number | Серийный номер | string | |
| uptime | Время работы в секундах. Диапазон: 0..2147483647 | int32 | |
| mc_firmware_version | Версия программного обеспечения микроконтроллера | string |
GetSystemInfoRequest¶
Запрос получения общей информации об устройстве
GetSystemInfoResponse¶
Ответ на запрос получения общей информации об устройстве
| Поле | Описание | Тип | Признак |
|---|---|---|---|
| data | Общая информация об устройстве | optional deviceapis.device.v1.DeviceInfo |
PostSystemRebootRequest¶
Запрос удаленной перезагрузки
PostSystemRebootResponse¶
Ответ на запрос удаленной перезагрузки
Скалярные типы значений¶
| .proto Type | Примечание | Python | Go | Ruby | C# | C++ | Java | PHP |
|---|---|---|---|---|---|---|---|---|
| double | float | float64 | Float | double | double | double | float | |
| float | float | float32 | Float | float | float | float | float | |
| int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int | int32 | Bignum or Fixnum (as required) | int | int32 | int | integer |
| int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int/long | int64 | Bignum | long | int64 | long | integer/string |
| uint32 | Uses variable-length encoding. | int/long | uint32 | Bignum or Fixnum (as required) | uint | uint32 | int | integer |
| uint64 | Uses variable-length encoding. | int/long | uint64 | Bignum or Fixnum (as required) | ulong | uint64 | long | integer/string |
| sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int | int32 | Bignum or Fixnum (as required) | int | int32 | int | integer |
| sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int/long | int64 | Bignum | long | int64 | long | integer/string |
| fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | int | uint32 | Bignum or Fixnum (as required) | uint | uint32 | int | integer |
| fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | int/long | uint64 | Bignum | ulong | uint64 | long | integer/string |
| sfixed32 | Always four bytes. | int | int32 | Bignum or Fixnum (as required) | int | int32 | int | integer |
| sfixed64 | Always eight bytes. | int/long | int64 | Bignum | long | int64 | long | integer/string |
| bool | boolean | bool | TrueClass/FalseClass | bool | bool | boolean | boolean | |
| string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | str/unicode | string | String (UTF-8) | string | string | String | string |
| bytes | May contain any arbitrary sequence of bytes. | str | []byte | String (ASCII-8BIT) | ByteString | string | ByteString | string |