Перейти к содержанию

Пользовательские команды CLI

На этой странице описаны толко специфичные для MeshCoreTel-firmware команды CLI, добавленные в этой прошивке.

Она не пытается повторить весь интерфейс CLI оригинального MeshCore. Документацией по остальным командам смотрите на официальном сайте MeshCore:

Команды Repeater MQTT

Статус MQTT и маршрутизация

  • get mqtt.status: показывает состояние Wi-Fi, NTP, код IATA, статус конечных точек, статус публикации состояния и статус отправки.
  • get mqtt.statuscfg: показывает, включена ли периодическая отправка сообщений о состоянии, в виде простого значения on или off. Большинству пользователей достаточно get mqtt.status.
  • get mqtt.client_version: показывает строку client_version MQTT, публикуемую ретранслятором.
  • get mqtt.iata: показывает код IATA/локации, используемый в топиках MQTT.
  • set mqtt.iata <code>: устанавливает код IATA/локации, например MOW.
  • set mqtt.iata UNSET: помечает код IATA как ещё не настроенный. Пока он UNSET, включённые MQTT брокеры не подключаются, пока не будет сохранён реальный код.

Идентификация в MQTT

  • get mqtt.owner: показывает сохранённый публичный ключ владельца.
  • set mqtt.owner <64-символьный-шестнадцатеричный-публичный-ключ>: задаёт публичный ключ владельца, используемый в метаданных JWT.
  • mqtt.owner <64-символьный-шестнадцатеричный-публичный-ключ>: краткая форма для установки публичного ключа владельца.
  • get mqtt.email: показывает сохранённый email владельца.
  • set mqtt.email <email>: задаёт email владельца, используемый в метаданных JWT.
  • mqtt.email <email>: краткая форма для установки email владельца.

Управление сообщениями MQTT

  • get mqtt.packets: показывает, публикуются ли сообщения о пакетах.
  • set mqtt.packets on|off: включает или отключает публикацию пакетов.
  • get mqtt.raw: показывает, публикуются ли сырые данные пакетов.
  • set mqtt.raw on|off: включает или отключает отдельный топик raw в MQTT.
  • set mqtt.status on|off: включает или отключает периодическую публикацию статуса MQTT.
  • get mqtt.tx: показывает, включены ли передаваемые (TX) пакеты.
  • set mqtt.tx on|off: включает или отключает публикацию переданных пакетов.

Конечные точки MQTT

  • get mqtt.meshcoretel
  • set mqtt.meshcoretel on|off
  • get mqtt.letsmesh-eu
  • set mqtt.letsmesh-eu on|off
  • get mqtt.letsmesh-us
  • set mqtt.letsmesh-us on|off

Примечания:

  • новые установки MQTT ретранслятора по умолчанию имеют mqtt.iata = UNSET
  • letsmesh-eu и letsmesh-us по умолчанию выключены, если они уже не были настроены в сохранённых настройках
  • если mqtt.iata имеет значение UNSET, meshcoretel, letsmesh-eu и letsmesh-us не будут подключаться, даже если они включены

Также принимаются устаревшие псевдонимы с точкой:

  • mqtt.letsmesh.eu
  • mqtt.letsmesh.us

Настройки Wi-Fi для MQTT ретрансляторов

  • get wifi.status: показывает SSID, состояние подключения, код статуса Wi-Fi и IP-адрес при подключении.
  • get wifi.ssid: показывает настроенный SSID Wi-Fi.
  • set wifi.ssid <ssid>: задаёт SSID Wi-Fi.
  • set wifi.pwd <password>: задаёт пароль Wi-Fi.
  • get wifi.powersaving: показывает текущий режим энергосбережения Wi-Fi.
  • set wifi.powersaving none|min|max: задаёт режим энергосбережения Wi-Fi.

Управление веб-панелью

  • get web
  • get web.status: показывает, доступна ли локальная HTTPS панель.
  • get web.stats.status: показывает, включены ли страница /stats и подсистема истории, активна ли недавняя история, доступна ли история с поддержкой PSRAM и смонтирован ли архив на SD-карте. Если он включён, сбор истории теперь охватывает и поддерживаемую телеметрию окружения, а не только исходные ряды батареи/радио. Устройства с GPS также записывают ежесекундные данные о спутниках для представления истории в /stats.
  • set web on|off
  • set.web on|off: включает или отключает локальную HTTPS панель.
  • set web.stats on|off
  • set.web.stats on|off: включает или отключает страницу /stats и сбор исторической статистики.

Диагностика времени выполнения

  • memory: показывает использование heap и PSRAM.
  • stats-core: показывает батарею, время работы, число зафиксированных ошибок и глубину очереди исходящих сообщений.
  • stats-radio: показывает уровень собственных шумов радио, последний RSSI, последний SNR и эфирное время TX/RX.
  • stats-packets: показывает общее количество принятых/отправленных пакетов, разбивку на лавинные/прямые сообщения и ошибки приёма.

Если noise_floor сообщает 0, проверьте get agc.reset.interval; если он не равен 0, попробуйте выполнить set agc.reset.interval 0 и проверьте снова.

Отчёт о батарее устройства

  • В сборках repeater MQTT фоновый сбор данных о батарее, используемый для истории MQTT/статуса, ограничен примерно одним замером в минуту. Явные запросы статуса и телеметрии по-прежнему обновляют показания немедленно.

Управление вентилятором T-Beam 1W

Эти команды доступны только в сборках LilyGo_TBeam_1W_* ретранслятора.

  • get fan: показывает текущий режим вентилятора, его состояние и последнюю температуру устройства с NTC-датчика, если доступна.
  • set fan auto: возвращает вентилятор в автоматический режим и сохраняет этот режим после перезагрузки.
  • set fan on: принудительно включает вентилятор и сохраняет этот режим после перезагрузки.
  • set fan off: принудительно выключает вентилятор и сохраняет этот режим после перезагрузки.
  • set fan timeout <Ns>: изменяет время автоматической работы вентилятора после TX (в секундах) и сохраняет его после перезагрузки, например set fan timeout 45s.

Поведение автоматического режима:

  • принудительно включает вентилятор во время передачи и удерживает его включённым в течение заданного тайм-аута после TX
  • в остальное время включает вентилятор при 48°C
  • выключает при 42°C
  • оставляет вентилятор включённым, если показания NTC недоступны

Примечания:

  • режим вентилятора по умолчанию для ретранслятора: auto
  • тайм-аут после TX по умолчанию: 30s
  • режим и тайм-аут сохраняются в настройках ретранслятора и переживают перезагрузку
  • только сборки LilyGo_TBeam_1W_* ретранслятора используют эти сохранённые настройки вентилятора
  • допустимый диапазон: от 0s до 600s

Доступ к CLI через веб-панель

Когда веб-панель ретранслятора включена и вы аутентифицированы, CLI-панель в браузере может выполнять те же команды, которые принимает ретранслятор.

Примечания:

  • панель по-прежнему использует пароль администратора ретранслятора для доступа
  • команды выполняются с той же осторожностью, как если бы вы вводили их непосредственно в CLI ретранслятора
  • это предназначено для локального администрирования в доверенной сети
  • команда start ota освобождает локальный HTTP-редирект на порту 80, чтобы HTTP-приёмник OTA мог занять порт, не останавливая остальные службы ретранслятора, независимо от того, выполняется ли команда из веб-панели, последовательного CLI или удалённого компаньона/приложения