cli-script

:::caution Убедитесь, что вы не включаете радио без предварительного подключения антенны! Вы можете повредить чип радио! :::

Перед прошивкой вашего устройства начните с проверки связи с прошиваемым устройством. Ниже приведены шаги, которые можно предпринять для проверки связи и, при необходимости, установки соответствующих драйверов. Если вам придется устанавливать драйверы, обязательно перезагрузите компьютер после этого, чтобы убедиться, что установка завершена.

:::note Плата T-Beam 0.7 является ранней версией платы T-Beam, и из-за изменений в дизайне в последующих итерациях эта плата использует специальный файл прошивки, отличный от других плат T-Beam.

firmware-tbeam0.7-X.X.X.xxxxxxx.bin — правильная прошивка. firmware-tbeam-X.X.X.xxxxxxx.bin несовместима. Для всех остальных плат T-Beam ознакомьтесь с разделом ресурсов для правильного выбора. :::

Инструкции по интерфейсу командной строки

Установка необходимого ПО

      <Icon icon="mdi:tux" 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",
},

]}>

Linux

Проверьте, установлены ли у вас python3 и pip, с помощью следующей команды

python3 --version
pip3 --version

Если python3 не установлен, установите с помощью

sudo apt-get update
sudo apt-get install python3

Если pip не установлен, установите с помощью

sudo apt-get install python3-pip

macOS

OS X поставляется с установленным Python 2.7, но без pip. Ниже используется Homebrew для установки python3, который включает pip3. В macOS вы будете использовать pip3 вместо pip.

:::note Проверьте, установлен ли Homebrew, с помощью следующей команды

brew -v

Если он не установлен, следуйте инструкциям на сайте Homebrew перед продолжением. :::

Проверьте, установлены ли у вас python3 и pip, с помощью следующей команды

python3 --version
pip3 --version

Если python3 не установлен, установите с помощью Установите Python3

brew install python3

Подтвердите, что pip3 был установлен вместе с python3

pip3 -v

Windows

Скачайте и установите Python. При установке обязательно нажмите Add Python X.Y to PATH.
Скачайте и установите Gitbash (или другую подходящую оболочку) и выполняйте все последующие команды из этой оболочки.

:::note Подтвердите установку python и pip с помощью следующих команд.

py --version

pip --version

:::

Установка `esptool`

pip3 install --upgrade esptool

Подтверждение связи с чипом

      <Icon icon="mdi:tux" 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",
},

]}>

Linux

:::important В Linux может потребоваться явно указать esptool как скрипт .py. Используйте esptool.py chip_id. :::

macOS

:::important В macOS может потребоваться явно указать esptool как скрипт .py. Используйте esptool.py chip_id. :::

Windows

:::important В Windows необходимо явно указать esptool как скрипт .py. Используйте esptool.py chip_id. :::

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

```shell title="Command" esptool chip_id


```shell title="Expected Output"
# You should see a result similar to this:
mydir$ esptool chip_id
esptool.py v2.6
Found 2 serial ports
Serial port /dev/ttyUSB0
Connecting....
Detecting chip type... ESP32
Chip is ESP32D0WDQ6 (revision 1)
Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
MAC: 24:6f:28:b5:36:71
Uploading stub...
Running stub...
Stub running...
Warning: ESP32 has no Chip ID. Reading MAC instead.
MAC: 24:6f:28:b5:36:71
Hard resetting via RTS pin...

Загрузка прошивки

Перейдите на страницу загрузок Meshtastic, чтобы скачать последнюю прошивку.
Прокрутите вниз до раздела Firmware и выберите один из следующих вариантов в зависимости от ваших предпочтений:
Download Stable: Для стабильных, хорошо протестированных выпусков.
Download Alpha: Для новых экспериментальных выпусков с последними функциями.
После перенаправления на страницу релиза GitHub прокрутите вниз до раздела «Assets» и разверните его. Определите правильную прошивку для вашего устройства по архитектуре (например, firmware-esp32s3 для устройств на базе ESP32-S3, таких как Heltec V3).
Скачайте файл и запомните место загрузки на вашей системе (обычно в папке ~/Downloads).

Переход в директорию с прошивкой

Откройте терминал и перейдите (cd) в директорию, куда была скачана прошивка. Имя папки обычно соответствует архитектуре и версии прошивки из zip-файла. Например:

```shell title="Example" cd ~/Downloads/firmware-esp32s3-X.X.X.xxxxxxx/


:::note
Обязательно замените `esp32s3` и номер версии на те, что соответствуют скачанному вами файлу.
:::

### Установка/обновление прошивки

Теперь следуйте инструкциям ниже для вашей операционной системы, чтобы установить или обновить прошивку для вашей конкретной платы:

:::caution
Будьте очень осторожны при выборе правильного файла прошивки для вашей платы. В частности, популярное радио 'T-BEAM' от TTGO не называется 'TTGO-Lora' (это другая плата). Поэтому не устанавливайте сборку 'TTGO-Lora' на TBEAM, это не будет работать корректно. Если вы прошьете неправильную прошивку устройства, процесс может показаться успешным, но устройство обычно станет неответчивым, отображая пустой экран (если он есть). Попробуйте прошить правильную версию. Обратите внимание, что хотя эти устройства довольно устойчивы и повреждения не всегда вероятны, существует возможность повреждения встроенного радио и периферийных устройств из-за неправильного направления GPIO-пинов
:::

          <Icon icon="mdi:tux" 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",
    },
  ]}>

#### Linux

##### Установка

```shell title="Command"
./device-install.sh -f firmware-BOARD-VERSION.bin

Обновление

```shell title="Command" ./device-update.sh -f firmware-BOARD-VERSION-update.bin





#### macOS

##### Установка

```shell title="Command"
./device-install.sh -f firmware-BOARD-VERSION.bin

Обновление

```shell title="Command" ./device-update.sh -f firmware-BOARD-VERSION-update.bin





#### Windows

##### Установка

```shell title="Command"
device-install.bat -f firmware-BOARD-VERSION.bin

Обновление

shell title="Command" device-update.bat -f firmware-BOARD-VERSION-update.bin

Используйте опцию --web, чтобы включить встроенный Web Client при установке прошивки.

Подключение и настройка устройства

После прошивки устройства прошивкой Meshtastic вы можете приступить к начальной настройке.

Подключить и настроить устройство

cli-script

Инструкции по интерфейсу командной строки

Установка необходимого ПО

Linux

macOS

Windows

Установка esptool

Подтверждение связи с чипом

Linux

macOS

Windows

Загрузка прошивки

Переход в директорию с прошивкой

Обновление

Обновление

Обновление

Подключение и настройка устройства

Установка `esptool`