🧩

LoRaWAN декодер данных

Разбор Base64 payload и сохранение схемы по модели устройства
Зачем нужен декодер
Многие LoRaWAN устройства передают только компактный бинарный payload. В таком виде система не знает, где температура, где влажность, а где состояние батареи. Декодер позволяет описать структуру payload и превратить бинарные данные в понятные параметры устройства.

Когда открывать декодер

Откройте декодер, если:

  • LoRaWAN устройство уже отправляет uplink сообщения;
  • в окне выбора параметров не появились расшифрованные поля;
  • для этой модели ещё нет готовой схемы;
  • нужно переделать существующую схему декодирования.

Что вы увидите в декодере

  • Base64 payload — исходная строка, пришедшая от устройства.
  • HEX — тот же payload в шестнадцатеричном виде.
  • Таблица полей — описание структуры сообщения.
  • Device model — модель устройства, к которой будет привязана схема.

Как описывается схема

Для каждого поля задаются:

  • Имя — как параметр будет называться в системе.
  • Тип данных — например uint8, uint16, int16, uint32, float32, bool.
  • Порядок байтов — Big Endian или Little Endian.
  • Масштаб — коэффициент для преобразования значения.
  • Смещение — дополнительная корректировка после чтения.
Например, если температура приходит как 254, а реальное значение должно быть 25.4, задайте масштаб 0.1.

Режимы работы

  • Автоматический режим — поля рассчитываются подряд по их типам и длинам.
  • Ручной режим — вы сами определяете структуру схемы и порядок полей.

Ручной режим нужен, если документация устройства задаёт нестандартную структуру или часть payload нужно интерпретировать отдельно.

Откуда брать структуру полей

Схема почти всегда берётся из документации производителя устройства:

  • datasheet;
  • protocol specification;
  • пример uplink payload;
  • описание формата байтов по позициям.
Декодер не угадывает физический смысл байтов. Он лишь применяет ту структуру, которую вы задали.

Сохранение схемы

После настройки нажмите Сохранить схему. Схема сохраняется для выбранной модели устройства.

  • последующие payload этой модели будут декодироваться автоматически;
  • расшифрованные поля появятся в свойствах устройства и в окне выбора параметров;
  • их можно будет использовать на рабочем поле, в истории, аналитике и сценариях.

Переделка и блокировка схемы

Если схема оказалась неправильной, её можно временно переделать.

  • откройте устройство с проблемным payload;
  • запустите декодер повторно;
  • при необходимости переделайте схему и сохраните новую версию.

Во время переделки старая схема может быть временно заблокирована, чтобы не мешать редактированию.

Практический порядок работы

  1. Убедитесь, что uplink уже приходит от LoRaWAN устройства.
  2. Скопируйте или дождитесь Base64 payload.
  3. Откройте декодер и укажите модель устройства.
  4. Опишите поля по документации производителя.
  5. Проверьте, что итоговые значения выглядят правдоподобно.
  6. Сохраните схему.
  7. Вернитесь в свойства устройства и выберите нужные параметры.

Типичные ошибки

  • Выбрана неправильная модель устройства.
  • Перепутан порядок байтов.
  • Неверно задан масштаб.
  • Часть payload пропущена или описана полем неправильной длины.
  • Проблема не в декодере, а в том, что устройство вообще не передаёт uplink.

✅ Декодер настроен правильно, когда

значения в таблице выглядят правдоподобно, схема сохранена для модели устройства, а после этого параметры появляются в свойствах и на рабочем поле.

← Назад к справке