device

Параметры конфигурации устройства: Role, Rebroadcast Mode, GPIO для пользовательской кнопки, GPIO для PWM-жужжалки, Node Info Broadcast Seconds, Double Tap as Button Press, Disable Triple Click, Timezone Definition и LED Heartbeat Disabled. Конфигурация устройства использует административное сообщение, отправляющее protobuf Config.Device.

Значения конфигурации устройства

Роли

[^4]: Эта роль устарела начиная с версии прошивки 2.7.11 :::tip Всё ещё не уверены, какую роль выбрать? Ознакомьтесь с нашей статьёй в блоге: Choosing the Right Device Role :::

Ищете ROUTER_CLIENT? Эта роль устарела в прошивке 2.3.15. Подробнее в примечаниях к выпуску 2.3.15

Сравнение ролей

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

[^1]: Awake Only означает, что повторные трансляции происходят нормально, но не во время сна между интервалами передачи.

[^2]: Роль ROUTER включает Power Saving по умолчанию (только ESP32). При необходимости обновления ROUTER через BLE рекомендуется использовать административный канал для временного изменения роли, чтобы обновить, а затем вернуть обратно.

[^3]: Favorites Only означает, что CLIENT_BASE будет отдавать приоритет пакетам от или к любым избранным узлам. С вашего CLIENT_BASE вы должны добавить в избранное все ваши другие узлы, которые обычно находятся в зоне действия лучше расположенной базовой станции CLIENT_BASE.

Заметки о энергосбережении + поведении роли

Только платформа ESP32

Все роли, кроме TRACKER и SENSOR, способны к традиционному поведению сна с использованием настройки power.is_power_saving. Когда узел засыпает, в общем случае отключаются последовательная консоль, периферия, GPS и радиомодули WiFi/Bluetooth для экономии энергии. Процессор перейдёт в низкоэнергетическое состояние (light sleep или deep sleep на ESP32). Радио LoRa останется в режиме ожидания для приёма пакетов, которые разбудят устройство для возобновления служб и ответа.

Конфигурации таймаутов display.screen_on_secs (таймаут экрана), power.min_wake_secs (минимальное время до сна) и power.wait_bluetooth_secs (таймаут Bluetooth) задержат переход узла в состояние сна. Таймауты и последующий переход в состояние сна также могут быть сброшены внешними событиями или действиями, такими как приём пакета, нажатие кнопки или подключение клиента через последовательный порт или другие средства.

Для роли ROUTER поведение power.is_power_saving сна включено автоматически и не может быть отключено.

Платформы ESP32 и NRF52

В ролях TRACKER и SENSOR предусмотрены специальные режимы сна при использовании вместе с power.is_power_saving. Для TRACKER устройство переходит в спящий режим на время position.position_broadcast_secs, а после пробуждения отправляет пакет с позицией, когда GPS предоставляет действительное местоположение, и повторяет цикл. Для SENSOR устройство переходит в спящий режим на время telemetry.environment_update_interval, а после пробуждения собирает данные окружающей среды, отправляет телеметрический пакет и повторяет цикл. Для обеих этих ролей LoRa-радио не остаётся в режиме ожидания для приёма пакетов и пробуждения устройства. Режим сна ограничен соответствующими интервалами передачи.

Режим повторной трансляции

Эта настройка определяет поведение устройства при повторной трансляции сообщений.

GPIO для кнопки пользователя

Это номер вывода GPIO, который будет использоваться для кнопки пользователя, если ваше устройство не оснащено предопределённой кнопкой пользователя.

GPIO для ШИМ-звукоподражателя

Это номер вывода GPIO, который будет использоваться для ШИМ-звукоподражателя, если ваше устройство не оснащено предопределённым звукоподражателем.

Секунды трансляции Node Info

Это количество секунд между трансляциями сообщений NodeInfo (содержащих, в частности, длинное и короткое имя) от устройства. Устройство по-прежнему будет отвечать ad-hoc на сообщения NodeInfo, если требуется ответ. Когда устройство обнаруживает любой пакет от неизвестного узла, оно автоматически отправит свой NodeInfo и запросит ответ.

Двойное касание как нажатие кнопки

Эта опция позволит трактовать двойное касание как нажатие кнопки при подключённом поддерживаемом акселерометре.

Отключить тройное нажатие

Отключает тройное нажатие кнопки пользователя для включения или отключения GPS.

TZDEF (Определение часового пояса)

Настройка tzdef позволяет задать локальное смещение для устройства. Она использует формат TZ Database для отображения правильного местного времени на дисплее устройства и в его журналах.

Для установки часового пояса используйте строку POSIX TZ Database для соответствующего региона. Вот список поддерживаемых часовых поясов. Например, если ваш регион America/Los_Angeles, введите PST8PDT,M3.2.0,M11.1.0 в качестве часового пояса.

Отключён heartbeat светодиода

Если true, отключить стандартное мигание светодиода (LED_PIN) на устройстве.

Доступность конфигурации устройства для клиентов

      <Icon icon="mdi:android" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Android
    </>
  ),
  value: "android",
},
{
  label: (
    <>
      <Icon icon="mdi:apple" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Apple
    </>
  ),
  value: "apple",
},
{
  label: (
    <>
      <Icon icon="mdi:terminal" height="1.5rem" style={{ marginRight: "0.25rem" }} /> CLI
    </>
  ),
  value: "cli",
},
{
  label: (
    <>
      <Icon icon="mdi:internet" height="1.5rem" style={{ marginRight: "0.25rem" }} /> Web
    </>
  ),
  value: "web",
},

]}>

Android

:::info

Конфигурация устройства доступна для Android.

1. Откройте приложение Meshtastic
2. Перейдите в: Вертикальное многоточие (3 точки в правом верхнем углу) > Конфигурация радио > Устройство

:::

Apple

:::info Все опции конфигурации устройства, кроме NTP Server, доступны в iOS, iPadOS и macOS по пути Settings > Device Configuration > Device. :::

CLI

:::info

Все опции конфигурации устройства доступны в CLI Python. Примеры команд приведены ниже:

:::

:::tip

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

```shell title="Пример:" meshtastic --set device.role CLIENT --set device.tzdef UTC0

:::

```shell title="Установка роли клиента"
meshtastic --set device.role CLIENT

shell title="Установка tzdef" meshtastic --set device.tzdef UTC0

Web

:::info Все опции конфигурации устройства доступны в веб-интерфейсе. :::