Документация по радиомодулям
Как подключить USB Radio, установить и запрограммировать встраиваемый радиомодуль, выбрать частоту и мощность 868 МГц и проверить связь на объекте.
| Задача | Инструкция |
|---|---|
| Подключить USB Radio и передать первый пакет | USB Radio: подключение и первый обмен |
| Написать свой клиент для USB Radio на ПК | Протокол UnitX Radio |
| Установить радиомодуль на свою плату | Встраиваемый радиомодуль: подключение к плате |
| Написать программу для радиомодуля: прямой обмен или mesh | uLua на радиомодуле: радио и mesh |
| Подключить реле, выходы и входы RFbase-1 и написать программу | Радиоконтроллер RFbase-1: подключение и программа |
| Понять, какие устройства слышат друг друга | Совместимость устройств UnitX Radio |
| Проверить мощность и полосу | Частота и мощность 868 МГц |
| Проверить связь в месте установки | Как проверить радиоканал на объекте |
| Обработать ответ, таймаут и повтор | Отправлено, принято, выполнено |
Устройства
- USB-радиоадаптер UnitX USB Radio — подключает программу на ПК к радиоканалу через виртуальный COM-порт.
- Встраиваемый радиомодуль с uLua — программируемый контроллер с радиоканалом для платы изделия, работает по вашей программе на uLua.
- Радиоконтроллер RFbase-1 — контроллер в корпусе с реле, транзисторным и оптронным выходами и двумя входами; работает по программе на uLua.
Модуль связывается с USB Radio, если в программе заданы та же скорость и тот же канал, что у адаптера. По умолчанию оба работают на канале 10 — 868,9 МГц. Обзор линейки и выбор по задаче — на странице «Радиомодули UnitX Radio».
Модульный радиоконтроллер, RFID-считыватель с радиоканалом и радиопульт на 2 или 4 кнопки пока в разработке. Для них уже есть предварительные описания.
Передача через промежуточные узлы
USB Radio передаёт пакеты в прямом канале: две точки должны слышать друг
друга. Если прямой связи не хватает, сообщения передают через промежуточные
радиомодули. Программа uLua на них запускает сеть
net: она добавляет адреса, подтверждения
соседей, повторы, фильтры и поиск маршрутов. Пример для трёх модулей есть в
руководстве по uLua на
радиомодуле.
Компьютер с USB Radio подключается к такой сети оконечным узлом. Адаптер сам подтверждает кадры для своего адреса, а программа на ПК отправляет и принимает сообщения и ищет маршруты. Чужие сообщения компьютер не пересылает. Команда для этого описана в протоколе UnitX Radio.
Путь сообщения по сети описан на странице «Как сообщение проходит по UnitX Mesh», а ориентиры по дальности собраны в разделе «Дальность и размещение».
Поддержка
С вопросами по подключению, протоколу и программам пишите инженеру. Укажите устройство и его исполнение, а также версию протокола USB Radio из ответа на запрос статуса или версию прошивки радиомодуля.

USB Radio: подключение и первый обмен
COM-порт в Windows, Linux и macOS, первый пакет между двумя адаптерами, выбор радиопрофиля, диагностика и ограничения.
Протокол UnitX Radio
Кадр и CRC, команды и ответы с примерами байтов, радиопрофили и каналы, формат пакета в эфире, узел сети uLua и клиент на Python.
Отправлено, принято, выполнено: что подтверждает радиоустройство
Ответ об отправке, прикладное подтверждение, номер сообщения, повторы без двойного срабатывания, таймаут и безопасное состояние.
Встраиваемый радиомодуль: подключение к плате
Распиновка и имена выводов в uLua, питание, антенна, HARD_RESET, UART и USB.
uLua на радиомодуле: радио и mesh
Как запустить программу на радиомодуле, передать пакет и соединить узлы через net.
Радиоконтроллер RFbase-1: подключение и программа
Клеммы и имена выводов, питание, входы и выходы, загрузка программы и пример обмена по радио.
Совместимость устройств UnitX Radio
Какие устройства слышат друг друга, что для этого настроить и как выбрать исполнение.
Частота и мощность 868 МГц: работа без разрешения и регистрации
В каких полосах около 868 МГц устройства работают без разрешения и регистрации и какой предел мощности действует.
Как проверить радиоканал на объекте
Серия пакетов, доля принятых и RSSI в разных состояниях объекта: как убедиться, что канал работает с запасом.