Перейти к основному содержимому

Web Client и Python CLI

Web Client​

Веб‑клиент удобен, когда нужно:

  • смотреть сеть/ноды в браузере;
  • быстро менять базовые настройки;
  • работать с нодой без установки приложения на телефон.

Способы подключения​

В зависимости от браузера и железа, веб‑клиент может подключаться:

  • Bluetooth (Web Bluetooth) - чаще всего работает в Chromium‑браузерах.
  • Serial по USB (Web Serial) - поддержка зависит от ОС и браузера, часто требует драйверов и “правильного” кабеля.
  • По сети (HTTP/HTTPS) - обычно только для ESP32‑устройств, когда у ноды настроен Wi‑Fi или Ethernet.
подсказка

Если веб‑клиент не видит ноду, проблема почти всегда в BLE/USB/драйверах/кабеле, а не “в веб‑клиенте”. Начните с USB‑драйверов и Bluetooth‑диагностики.

Важный нюанс про HTTPS и сертификаты ноды​

Если вы подключаетесь к ноде по Wi‑Fi через браузер, ноды часто используют самоподписанный сертификат. Иногда сначала нужно открыть страницу ноды напрямую (например, https://IP_НОДЫ/) и подтвердить исключение, а уже потом подключаться через веб‑клиент.

Python CLI: зачем и как пользоваться​

Python CLI полезен для:

  • диагностики (прочитать конфигурацию/статус, посмотреть качество связи);
  • автоматизации (скрипты, интеграции, логирование);
  • управления нодой через терминал.

Практичный старт:

  • установите инструменты Meshtastic (обычно через pip);
  • проверьте, что CLI запускается и показывает справку;
  • подключитесь к ноде по BLE или через последовательный порт.
подсказка

В CLI сначала ориентируйтесь на --help и примеры команд в выводе. Синтаксис может меняться между версиями.

Python CLI: быстрые команды (самые полезные)​

Ниже короткая “шпаргалка” по типовым сценариям. Точные опции зависят от версии CLI, поэтому при сомнениях используйте meshtastic --help.

Посмотреть доступные параметры и текущие настройки​

  • Показать список настраиваемых параметров (приём “списком”): meshtastic --get all
  • Получить конкретный раздел: meshtastic --get power (пример)

Поменять настройку​

Пример: продлить время удержания BLE‑подключения:

meshtastic --set power.wait_bluetooth_secs 28800

Каналы и ключи​

CLI умеет менять параметры каналов (имя, PSK и т.п.). Важно помнить: “ссылка/QR” канала может содержать ключ.

Примеры:

  • meshtastic --ch-index 1 --ch-set name mychan --info
  • meshtastic --ch-index 0 --ch-set psk random --info (новый случайный ключ основного канала)
  • meshtastic --ch-index 0 --ch-set psk default --info (вернуть “известный” ключ по умолчанию)
  • meshtastic --ch-index 0 --ch-set psk none --info (отключить шифрование на канале)

BLE: найти устройства​

meshtastic --ble-scan

Serial‑лог (как “простой терминал”)​

В некоторых версиях CLI есть режим “просто показать серийный вывод” без использования протокола управления (удобно для отладки). Он обычно работает только при физическом подключении по USB‑serial.

Что делать, если проблемы в Windows​

Самые частые причины:

  • USB‑кабель “только зарядка” (нет данных);
  • не появился COM‑порт (драйвер USB‑UART не установлен);
  • конфликт драйверов/старые драйверы;
  • недостаточное питание через USB‑порт/хаб.

Проверьте раздел: USB‑драйверы и общий алгоритм: Решение проблем.