Як зробити · 10 хв
Підключити пристрій через MQTT
Цей посібник веде від нового MQTT-джерела до першої телеметрії в Lab. Ви видасте облікові дані, підключитеся до брокера Lab через TLS і надішлете стан і телеметрію у власні топіки.
Що потрібно заздалегідь
Роль власника, адміністратора або розробника в робочому просторі. Пристрій або шлюз, який уміє MQTT через TLS 1.2 чи новіший і перевіряє сертифікат брокера та його ім’я хоста.
Брокер Lab ізольований від робочого середовища. Анонімного входу, відкритого тексту чи входу без перевірки сертифіката немає.
Lab — лише тестове середовище. Підключення до нього не дає доступу до робочого середовища, ринку чи реальних об’єктів Wesfin Flex.
Підключення крок за кроком
Додайте MQTT-джерело
У робочому просторі, на панелі «Підключити джерело», натисніть «Створити проєкт». Потім у блоці «Додайте джерело» оберіть тип активу BESS або «Кероване навантаження», тип підключення MQTT і натисніть «Додати джерело». EV / V2X Lab працює лише із симулятором.
Відкрийте розділ «Конектор»
На сторінці джерела панель «Налаштування вихідного конектора» показує брокер TLS (хост і порт), ідентифікатори Asset / Site / Edge, наступну дію і блокери. Використовуйте саме цей хост і порт. Якщо там «Не налаштований», брокер для цього Lab не задано, і видати облікові дані не вийде.
Видайте облікові дані
На панелі «Облікові дані конектора» залиште можливість OBSERVE, задайте термін дії від 60 до 604800 секунд (типово 86400, тобто доба) і натисніть «Видати дані один раз». Деталі — у посібнику про облікові дані.
Збережіть приватний файл
Натисніть «Завантажити приватний файл». У lab-credential.json є ім’я користувача, пароль, хост і порт брокера, ваші топіки та канонічні ідентифікатори. Пароль більше не показується. Потім натисніть «Закрити та очистити секрет».
Підключіться до брокера
Підключайтеся через TLS з ім’ям користувача і паролем із файлу. Клієнт має довіряти CA брокера Lab і перевіряти ім’я хоста.
Надішліть стан і телеметрію
Публікуйте канонічні контракти стану й телеметрії v1.0 (для керованого навантаження — v1.1) у свої топіки state і telemetry. Беріть ідентифікатори з налаштувань конектора. Не ставте прапорець retain.
Перевірте результат
На сторінці джерела в панелі «Телеметрія» з’являться спостереження, а в смузі вгорі «Дані» покаже свіжість. Якщо нічого немає, див. «Типові проблеми» нижче.
Ваші топіки
Кожні облікові дані мають власний набір топіків. Точні шляхи є у приватному файлі та в блоці «Теми цього конектора».
lab/v1/workspaces/{workspace_uuid}/assets/{canonical_asset_id}/credentials/{credential_uuid}/state
lab/v1/workspaces/{workspace_uuid}/assets/{canonical_asset_id}/credentials/{credential_uuid}/telemetry
lab/v1/workspaces/{workspace_uuid}/assets/{canonical_asset_id}/credentials/{credential_uuid}/hello
lab/v1/workspaces/{workspace_uuid}/assets/{canonical_asset_id}/credentials/{credential_uuid}/receipt
lab/v1/workspaces/{workspace_uuid}/assets/{canonical_asset_id}/credentials/{credential_uuid}/commands| Топік | Хто і що робить |
|---|---|
| state | Ви публікуєте стан пристрою. OBSERVE і CONTROL. |
| telemetry | Ви публікуєте телеметрію з видом мережі. OBSERVE і CONTROL. |
| hello | Ви публікуєте повідомлення про старт конектора. Можуть обидві, але право запису встановлює лише CONTROL. |
| receipt | Ви публікуєте квитанції виконання команд. Лише CONTROL. |
| commands | Ви підписуєтеся й отримуєте команди Lab. Лише CONTROL. |
Підписка на #, топіки іншого активу чи робочого простору і будь-які топіки робочого середовища заборонені.
Одиниці, знаки і час
| Величина | Правило |
|---|---|
| Потужність пристрою | кВт; плюс — розряд, мінус — заряд. |
| Потужність навантаження | Для керованого навантаження споживання від’ємне. |
| Потужність мережі | кВт; плюс — імпорт, мінус — експорт. |
| Енергія | кВт·год. |
| SOC / SOH | Відсотки. |
| timestamp | Не старше 30 секунд і не більше ніж на 2 секунди в майбутньому. |
Стан і телеметрія одного вимірювання мають однаковий час і однакові значення BESS. Порядок надходження не важливий. Точні повтори не створюють нового спостереження.
Підтвердження брокера (PUBACK) не означає, що Lab прийняв зразок. Дивіться на панель «Телеметрія».
Референсний локальний конектор
Замість власного клієнта можна запустити референсний конектор. Він потребує облікових даних CONTROL, локального журналу і CA-сертифіката брокера. Команду показує панель «Запуск локального конектора».
python -m services.platform.app.lab.local_cli \
--credential-file lab-credential.json \
--journal lab-journal.sqlite \
--ca-file lab-ca.crtФайл облікових даних на POSIX має мати права 0600. Локальний запис типово вимкнений; прапорець --allow-local-writes — окремий явний локальний дозвіл.
Додавайте --allow-local-writes лише після перевірки меж. Навіть тоді команди йдуть, тільки коли власник чи адміністратор окремо ввімкне обмежене керування в Lab. Референсні тести не кваліфікують фізичні пристрої.
Типові проблеми
| Що бачите | Що робити |
|---|---|
| LAB_BROKER_REQUIRED | Брокер Lab не налаштований. Облікові дані видати не можна; зверніться до адміністратора Lab. |
| TLS / CA | Перевірте CA-файл і те, що підключаєтеся саме до хоста з налаштувань конектора. |
| telemetry: 0 | Зразок відхилено. Перевірте годинник пристрою (30 с / 2 с), топік і ідентифікатори, одиниці, межі потужності, прапорець retain, дубльовані ключі JSON і NaN. |
| FRESH_CANONICAL_TELEMETRY_REQUIRED | Свіжих стану й телеметрії немає. Надсилайте їх регулярно, у межах свіжості. |
| active credential exists; explicitly rotate it | Активні дані вже є. Позначте ротацію або спершу відкличте старі. |
| Local Lab connector stopped (CREDENTIAL_EXPIRED) | Строк дії минув. Видайте нові облікові дані й перезапустіть конектор. |