LinArt IoT · Руководства · LoRa Gateway
← Все руководства
📡 LoRa Gateway
Дальнобойный шлюз на Heltec ESP32-S3 (LoRa + WiFi + GPS + OLED). Собирает узлы по LoRa и отдаёт их в облако; работает как ретранслятор там, где нет интернета.
Роли HOME и CAMP
- HOME — у шлюза есть интернет (WiFi). Публикует в облако и себя, и «детей», принятых по LoRa (через TB gateway API).
- CAMP — интернета нет. Находит HOME по LoRa и ретранслирует свою телеметрию через него. Роль выбирается автоматически (с гистерезисом), команда
mode показывает/меняет её.
Имя устройства — полный MAC: LoRaGW_<12 hex>. Короткий LoRa-адрес — последние 4 hex (напр. 2C70).
Быстрый старт
- Прошейте из браузера — см. Прошивка из браузера.
- Задайте WiFi:
wifi add <ssid> <pass>.
- Проверьте облако:
tb status, при необходимости tb provision. См. Подключение и токены.
- Привяжите устройство к аккаунту в панели (claim по коду MAC).
Справочник команд
Помимо общих команд (Консоль: help, identify, sys info, reboot, wifi …):
Облако / связь
| Команда | Что делает |
|---|
tb status | Токен, провижининг, состояние аплинка |
tb token <ACCESS_TOKEN> | Вписать токен вручную (применяется к HTTPS+MQTT без перезагрузки) |
tb provision | Запросить провижининг |
tb host [<host>|default] | Хост ThingsBoard (сохраняется) |
tb publish | Форсировать публикацию телеметрии |
tb clear | Стереть токен из NVS |
tb nettest | Проверка TCP-доступности сервера |
mqtt status｜on｜off｜reconnect | Состояние/включение MQTTS-аплинка |
mqtt host <host> <port> | Задать брокер (напр. mqtt.crm-iot.com 8883) |
WiFi и LoRa
| Команда | Что делает |
|---|
wifi scan | Сканировать WiFi-сети |
wifi add <ssid> <pass> · wifi rm <ssid> · wifi list | Управление сетями |
wifi off [sec] | Отключить WiFi на N сек (тест резервного LoRa-аплинка) |
lora status | Состояние LoRa-линка |
lora scan | Сканировать эфир LoRa |
lora send | Отправить тестовый пакет |
lora rf <…> | Радиопараметры (частота/SF и т.п.) |
lora bridge on｜off | Приём удалённых консольных команд по LoRa (bridge) |
ble scan | Сканировать BLE-эфир вокруг устройства |
Узлы, соседи, диагностика линка
| Команда | Что делает |
|---|
node list | Список принятых узлов (LAN/релейных) |
range list | Список LoRa-соседей (JSON: адрес, имя, RSSI, когда виден) |
range ping <addr> [count] | Тест связи с соседом; range stat — результат |
trace <hexAddr> | Многохоповый traceroute до узла; повторно trace — опрос маршрута |
peer fav｜unfav <addr> | Отметить/снять «избранное» для соседа |
peers | Позиции группы (присутствие) в JSON |
GPS, навигация, точки, трек
| Команда | Что делает |
|---|
wpt list｜json | Путевые точки |
wpt here [type] [name] | Добавить точку в текущей позиции (нужен GPS-фикс) |
wpt add <lat> <lon> [type] [name] · wpt del <id> | Добавить/удалить точку |
nav status｜here｜home｜clear | Навигация: статус/цель здесь/домой/сброс |
nav set <lat> <lon> [name] · nav to <wptId> · nav peer <addr> | Задать цель навигации |
track start｜stop｜status｜list｜export | Запись трека (GPX-экспорт) |
loc send [target] · loc beacon [sec｜off] | Отправить/маячить своё местоположение |
Чат и экран
| Команда | Что делает |
|---|
chat status · chat seen [epoch] | Состояние LoRa-чата |
tab next｜prev | Переключить «скин»/экран OLED |
mode | Показать/сменить роль HOME/CAMP |
sys info · sys reboot | Сводка системы / перезагрузка |
Токен потерян, а устройство уже в облаке? Провижининг вернёт
FAILURE (имя занято). Восстановите токен через панель (кнопка 🔑) или USB — см.
Подключение и токены. CAMP-шлюз без токена может получить его от HOME по LoRa автоматически.