installation

Библиотека Python для Meshtastic

Эта библиотека предоставляет интерфейс командной строки (CLI) для управления пользовательскими настройками узлов Meshtastic и простой API для отправки и получения сообщений через mesh-радио. События доставляются с использованием модели публикации-подписки, и вы можете подписаться только на те типы сообщений, которые вас интересуют.

Репозиторий Meshtastic-python является отличным источником информации. Если вы хотите просмотреть код или внести вклад в разработку библиотеки Python или интерфейса командной строки, пожалуйста, посетите страницу Meshtastic Python на GitHub.

Предварительные требования

Перед установкой убедитесь, что ваша система соответствует следующим требованиям:

Драйверы последовательного порта: Ваш компьютер должен иметь установленные необходимые драйверы последовательного порта для CP210X USB to UART bridge или CH9102 (для некоторых новых плат).
Python: На вашей системе должен быть установлен Python 3. Проверьте с помощью python3 -V и установите, если необходимо.
pip: Установщик пакетов Python pip должен быть установлен. Проверьте с помощью pip3 -V и установите, если необходимо.

После обеспечения выполнения требований следуйте инструкциям по установке для вашей операционной системы в разделенной вкладками секции ниже.

Инструкции по установке

Чтобы установить CLI Meshtastic, выберите вкладку для вашей операционной системы и следуйте пошаговым инструкциям по установке через pip. Только для Ubuntu вы можете альтернативно установить автономную версию, если предпочитаете.

      <Icon icon="mdi:linux" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Linux
    </>
  ),
  value: "linux",
},
{
  label: (
    <>
      <Icon icon="mdi:apple" height="1.5rem" style={{ marginRight: "0.25rem" }} /> macOS
    </>
  ),
  value: "macos",
},
{
  label: (
    <>
      <Icon icon="mdi:microsoft" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Windows
    </>
  ),
  value: "windows",
},
{
  label: (
    <>
      <Icon icon="mdi:terminal" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Termux for Android
    </>
  ),
  value: "termux",
},

]}>

Linux

Проверьте, что на вашем компьютере установлены необходимые драйверы последовательного порта
Подключите устройство Meshtastic к USB-порту
Используйте команду shell lsusb
Вы должны увидеть что-то вроде:
- ID 10c4:ea60 Silicon Labs CP210x UART Bridge для CP210X
- ID 1a86:55d4 QinHeng Electronics USB Single Serial для CH9102
- Если не отображается последовательное устройство, соответствующее используемому вами устройству, пожалуйста, ознакомьтесь со страницей Установка драйверов последовательного порта перед продолжением.
Проверьте, что на вашем компьютере установлен Python 3.
Используйте команду shell python3 -V
Если это не возвращает версию, установите python shell sudo apt-get update sudo apt-get install python3
Pip обычно установлен, если вы используете версию python 3 >= 3.4
Проверьте, установлен ли pip, с помощью этой команды shell pip3 -V
Если это не возвращает версию, установите pip shell sudo apt-get install python3-pip
Необязательно: используйте виртуальную среду Python (в противном случае перейдите к шагу «Установка pytap2»)
Установите python-virtualenvwrapper (пример для дистрибутивов на базе arch) shell sudo pacman -Syu python-virtualenvwrapper
Создайте виртуальную среду shell source /usr/bin/virtualenvwrapper.sh mkvirtualenv meshtastic workon meshtastic
Установите pytap2 shell pip3 install --upgrade pytap2
Установите meshtastic: shell pip3 install --upgrade "meshtastic[cli]" (суффикс [cli] устанавливает несколько необязательных зависимостей, соответствующих старым версиям CLI)
В качестве альтернативы pip3 используйте pipx, если возникает ошибка externally-managed-environment shell sudo apt install pipx && pipx install "meshtastic[cli]"
- При использовании pipx может потребоваться обновить $PATH, запустив: shell pipx ensurepath

macOS

Проверьте, что на вашем компьютере установлены необходимые драйверы последовательного порта
Подключите устройство Meshtastic к USB-порту
Перейдите в Apple Menu  > About This Mac > System Report... > Hardware > USB
Вы должны увидеть что-то вроде CP210X USB to UART Bridge Controller
- Если не отображается последовательное устройство, соответствующее используемому вами устройству, пожалуйста, ознакомьтесь со страницей Установка драйверов последовательного порта перед продолжением.
Проверьте, что на вашем компьютере установлен Python 3.
Используйте команду shell python3 -V
Если это не возвращает версию, установите python
- Ниже используется Homebrew для установки python3, который включает pip3.
- Проверьте, установлен ли Homebrew, с помощью следующей команды shell brew -v Если он не установлен, следуйте инструкциям на сайте Homebrew перед продолжением.
- Установите Python3 shell brew install python3
Pip обычно установлен, если вы используете версию python 3 >= 3.4
Проверьте, установлен ли pip, с помощью этой команды shell pip3 -V
Если это не возвращает версию, установите pip
Установите pipx shell brew install pipx pipx ensurepath
Установите meshtastic: shell pipx install "meshtastic[cli]" (суффикс [cli] устанавливает несколько необязательных зависимостей, соответствующих старым версиям CLI)

Windows

Проверьте, что на вашем компьютере установлены необходимые драйверы последовательного порта
Подключите устройство Meshtastic к USB-порту
Откройте Диспетчер устройств
В разделе Ports (COM & LPT) вы должны увидеть что-то вроде Silicon Labs CP210X USB to UART Bridge (COM5)
- Если не отображается последовательное устройство, соответствующее используемому вами устройству, пожалуйста, ознакомьтесь со страницей Установка драйверов последовательного порта перед продолжением.
Проверьте, что на вашем компьютере установлен Python 3.
Используйте команду powershell py -V
Если это не возвращает версию, установите python

:::info При установке Python обязательно выберите опцию «Добавить Python в PATH» или отметьте галочку «Добавить Python в переменные среды». Если вы пропустили это во время установки, вы можете вручную добавить Python в системный PATH после установки. Непринятие этого может привести к ошибкам при попытке использовать команды Python или pip. :::

Pip обычно установлен, если вы используете версию python 3 >= 3.4
Проверьте, установлен ли pip, с помощью этой команды powershell pip3 -V
Если это не возвращает версию, установите pip
Установите pytap2 powershell pip3 install --upgrade pytap2
Установите meshtastic: powershell pip3 install --upgrade "meshtastic[cli]" (суффикс [cli] устанавливает несколько необязательных зависимостей, соответствующих старым версиям CLI)

Termux

Установите Termux из F-Droid или Github Releases. Версия из Google Play устарела.
Загрузите Termux и обновите список пакетов shell pkg update
Обновите установленные пакеты shell pkg upgrade
Установите python shell pkg install python
Обновите pip и установите meshtastic вместе с некоторыми его зависимостями shell pip install --upgrade pip pygatt pytap2 wheel "meshtastic[cli]" (суффикс [cli] устанавливает несколько необязательных зависимостей, соответствующих старым версиям CLI)

:::note Обратите внимание, что CLI Meshtastic не может управлять узлами через USB в termux, но вы можете управлять устройствами через WiFi, используя опцию --host x.x.x.x с IP-адресом устройства (только ESP32 или Pico W). Подключение по WiFi в настоящее время разрабатывается и может работать некорректно. Если вы хотите предоставить обратную связь или протестировать эту функцию, пожалуйста, присоединяйтесь к нашему серверу Discord для получения дополнительной информации. :::

Возможно, вам потребуется закрыть и переоткрыть CLI. Переменные путей могут или не могут обновиться для текущей сессии при установке.

Автономная установка (только для Ubuntu)

Скачайте исполняемый файл meshtastic_ubuntu со страницы Releases.
Выполните следующую команду, чтобы сделать файл исполняемым и переименовать его в meshtastic:

chmod +x meshtastic_ubuntu && mv meshtastic_ubuntu meshtastic

Чтобы запустить CLI:

./meshtastic

:::tip Скопируйте (или переместите) этот бинарный файл куда-нибудь в ваш PATH. :::