lora

The LoRa config options are: Region, Use Preset, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Frequency Slot, Ignore Incoming Array, Ignore MQTT, Override Duty Cycle Limit, SX126x RX Boosted Gain, Override Frequency и PA Fan Disabled. Конфигурация LoRa использует административное сообщение, отправляющее protobuf Config.LoRa.

:::note Чтобы устройства в mesh-сети могли полностью взаимодействовать, они должны иметь одинаковые настройки для Region и Modem Preset или одинаковые пользовательские настройки модема. :::

Значения конфигурации LoRa

:::note Вы должны установить настройку lora.region вашего устройства. Это обеспечит соблюдение законных ограничений для вашего региона. :::

Region

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

Use Preset

При включении будут использоваться поля Modem Preset, иначе значения Bandwidth/Spread Factor/Coding Rate будут взяты из соответствующих вручную заданных полей.

Modem Preset

По умолчанию unset, что эквивалентно LONG_FAST. Пресеты — это предопределённые настройки модема (полоса пропускания, коэффициент расширения спектра и скорость кодирования), которые влияют на скорость сообщений и дальность. Значение по умолчанию обеспечивает хороший баланс скорости и дальности для большинства пользователей.

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

В mesh-сети много устройств или сообщения отправляются очень часто. Более высокая скорость (и, следовательно, меньшее время радиоэфира на устройство) помогает справиться с перегрузкой mesh-сети.
Требуется максимальная дальность для сценариев большой дальности, где задержка в несколько секунд при получении сообщения допустима (например, отправка сообщений из города на далёкую вершину горы).

Доступные пресеты следующие и следуют линейной последовательности от Самый быстрый \<--> Самый медленный и от Самая короткая дальность \<--> Самая длинная дальность:

SHORT_TURBO (Самый быстрый, наибольшая полоса пропускания, наименьшее время в эфире, наименьшая дальность. Не разрешен во всех регионах из-за полосы пропускания 500 кГц.)
SHORT_FAST
SHORT_SLOW
MEDIUM_FAST
MEDIUM_SLOW
LONG_FAST (По умолчанию)
LONG_MODERATE
LONG_SLOW
VERY_LONG_SLOW (Самый медленный, наименьшая полоса пропускания, наибольшее время в эфире, наибольшая дальность. Не рекомендуется для регулярного использования, так как плохо формирует mesh-сети и ненадёжен)

Max Hops

Максимальное количество ретрансляций. Не может быть больше 7. По умолчанию 3, что подходит для большинства приложений. На самом деле, 3 — это нормально.

Hop Count

Transmit Power

Если равно нулю, используется максимальная законная непрерывная мощность по умолчанию (т. е. такая, которая не выведет из строя аппаратное обеспечение радио).

В большинстве случаев используйте здесь ноль. Единицы — dBm.

Bandwidth

Некоторые значения полосы пропускания являются «специальными» и будут преобразованы прошивкой устройства в соответствующее значение с плавающей запятой:

Special Value	Interpreted As
31	31.25 кГц
62	62.5 кГц
200	203.125 кГц
400	406.25 кГц
800	812.5 кГц
1600	1625.0 кГц

Обратите внимание, что значения < 62.5 кГц могут требовать TCXO на некоторых аппаратных устройствах.

Spread Factor

Число от 7 до 12. Указывает количество чирпов на символ как 1[\<\<]spread_factor.

Coding Rate

Знаменатель скорости кодирования. Например, для 4/5 значение равно 5. Для 4/8 значение равно 8.

Frequency Offset

Этот параметр предназначен для продвинутых пользователей с профессиональным тестовым оборудованием, мы не рекомендуем его использовать большинству пользователей.

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

Transmit Enabled

Позволяет включать и выключать передачу (TX) с LoRa-радио. Полезно для горячей замены антенн и других тестов.

По умолчанию true.

Frequency Slot

Эта настройка контролирует фактическую аппаратную частоту передачи радио, представленную слотом частоты от 1 до NUM_SLOTS (максимум для текущего региона и пресета модема). Если установлено в 0/UNSET, устройство возвращается к старому алгоритму на основе хэша имени канала для определения слота частоты.

Ignore Incoming Array

Для тестирования иногда полезно заставить узел игнорировать определённые другие узлы (имитируя выход радио из зоны действия). Все номера узлов, перечисленные в массиве ignore_incoming, будут иметь свои пакеты отброшенными при получении (router.cpp).

Ignore MQTT

Установка этого параметра в 'true' означает, что устройство будет игнорировать любые сообщения, полученные по LoRa, которые прошли через MQTT по пути к устройству. Обратите внимание, что это работает только при прошивке версии не ниже 2.2.19 на вашем устройстве и узле MQTT.

OK to MQTT

Допустимые значения: true, false

По умолчанию false. При установке в true эта конфигурация указывает, что пользователь разрешает отправку своих пакетов на MQTT-брокеры. Если false, узлы, получающие ваши пакеты, просят не пересылать пакеты на MQTT. Эта конфигурация применяется только к каналам, настроенным с ключами defaultpsk и eventpsk в прошивке Meshtastic; каналы с пользовательскими ключами игнорируют эту настройку.

Важно: Это не криптографическое решение, а вежливая просьба, enforced в официальной прошивке.

Override Duty Cycle Limit

Установка этого параметра в 'true' означает, что устройство будет игнорировать часовой лимит цикла работы в Европе. Это может привести к нарушению регуляций, если устройство передаёт слишком много. По умолчанию 'false', устройство прекратит отправку данных при достижении лимита и возобновит, когда это будет разрешено.

SX126x RX Boosted Gain

Эта опция специфична для серии чипов SX126x и позволяет чипу потреблять немного дополнительной мощности для повышения чувствительности RX.

Override Frequency

Этот параметр предназначен для продвинутых пользователей и лицензированных радиолюбителей HAM. При включении расчёт канала будет игнорироваться, и вместо него будет использоваться заданная частота (смещение частоты всё равно применяется). Это позволит использовать частоты вне диапазона. Пожалуйста, соблюдайте местные законы и регуляции. Если вы лицензированный оператор HAM, включите режим HAM и отключите шифрование.

PA Fan Disabled

Если true, отключить встроенный вентилятор PA с использованием пина, определённого в RF95_FAN_EN.

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

      <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

Опции конфигурации LoRa доступны на Android.

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

:::

Apple

:::info Все опции конфигурации LoRa доступны в iOS, iPadOS и macOS в Настройки > Конфигурация радио > LoRa. :::

CLI

:::info

Команды конфигурации LoRa доступны в python CLI. Примеры команд ниже:

:::

Setting	Acceptable Values	Default
lora.modem_preset	`LONG_FAST`, `LONG_SLOW`, `VERY_LONG_SLOW`, `MEDIUM_SLOW`, `MEDIUM_FAST`, `SHORT_SLOW`, `SHORT_FAST`, `SHORT_TURBO`	`LONG_FAST`
lora.use_preset	`false`, `true`	`false`
lora.region	`UNSET`, `US`, `EU_433`, `EU_868`, `CN`, `JP`, `ANZ`, `ANZ_433`, `KR`, `TW`, `RU` ,`IN`, `NZ_865`, `TH`, `LORA_24`, `UA_433`, `UA_868`, `MY_433`, `MY_919`, `SG_923`, `KZ_433`, `KZ_863`, `BR_902`, `NP_865`	`UNSET`
lora.bandwidth	`31`, `62`, `125`, `250`, `500`	`250`
lora.spread_factor	`7`, `8`, `9`, `10`, `11`, `12`	`12`
lora.coding_rate	`5`, `6`, `7`, `8`	`8`
lora.frequency_offset	`0` to `1000000`	`0`
lora.hop_limit	`1`,`2`,`3`,`4`,`5`,`6`,`7`	`3`
lora.tx_power	`0` to `30`	`0`
lora.tx_enabled	`false`, `true`	`true`
lora.channel_num	`0`, `1` to `NUM_CHANNELS`	`0`
lora.ignore_mqtt	`false`, `true`	`false`
lora.config_ok_to_mqtt	`true`, `false`	`false`
lora.override_duty_cycle	`false`, `true`	`false`
lora.sx126x_rx_boosted_gain	`false`, `true`	`false`
lora.override_frequency	Любая поддерживаемая частота, на которую способно LoRa-радио. Пожалуйста, соблюдайте местные правила и регуляции	`0`

:::tip

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

```shell title="Пример:" meshtastic --set lora.region US --set lora.modem_preset LONG_FAST


:::

```shell title="Установить пресет модема"
meshtastic --set lora.modem_preset LONG_FAST
meshtastic --set lora.modem_preset MEDIUM_FAST

```shell title="Установить регион" meshtastic --set lora.region US meshtastic --set lora.region EU_433


```shell title="Установить лимит хопов"

meshtastic --set lora.hop_limit 2

shell title="Переопределить цикл скважности" meshtastic --set lora.override_duty_cycle true meshtastic --set lora.override_duty_cycle false

Веб

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