channels

The Channels config options are: Index, Roles, and Settings. Channel config uses an admin message sending a Channel protobuf which also consists of a ChannelSettings or ModuleSettings protobuf.

:::info Channel Settings (как описано на этой странице) не следует путать с Modem Preset Settings.

Modem Preset Settings содержат конфигурацию модема (настройки частоты, коэффициент расширения спектра, полосу пропускания и т. д.), используемую для LoRa-радио. Эти настройки одинаковы для всех каналов и не могут быть уникальными для каждого канала.

Channel Settings содержат информацию для разделения групп сообщений, настройки опционального шифрования и включения или отключения обмена сообщениями через интернет-шлюзы. Эти настройки уникальны и настраиваемы для каждого канала. :::

Channel Config Values

Index

Индекс канала начинается с 0 и заканчивается 7.

Indexing нельзя изменить.

Index	Channel	Default Role	Purpose
0	1	`PRIMARY`	Используется как канал `default`
1	2	`DISABLED`	Определяется пользователем
2	3	`DISABLED`	Определяется пользователем
3	4	`DISABLED`	Определяется пользователем
4	5	`DISABLED`	Определяется пользователем
5	6	`DISABLED`	Определяется пользователем
6	7	`DISABLED`	Определяется пользователем
7	8	`DISABLED`	Определяется пользователем

:::note Нельзя иметь каналы DISABLED между активными каналами, такими как PRIMARY и SECONDARY. Активные каналы должны быть последовательными. :::

Role

Каждому каналу назначается одна из 3 ролей:

PRIMARY или 1
Это первый канал, который создается для вас при начальной настройке.
Может существовать только один основной канал, и его нельзя отключить.
По умолчанию периодические широковещательные передачи, такие как позиция и телеметрия, отправляются по этому каналу.
SECONDARY или 2
Можно изменить ключ шифрования (PSK).
DISABLED или 0
Канал больше недоступен для использования.
Настройки канала сбрасываются на значения по умолчанию.

:::note Хотя можно иметь разный основной канал PRIMARY и общаться по вторичным каналам SECONDARY с тем же именем и PSK, хеш имени основного канала PRIMARY определяет слот частоты LoRa, который определяет фактическую частоту передачи в диапазоне. Чтобы устройства с разными именами основного канала PRIMARY передавали на одной и той же частоте, необходимо явно установить слот частоты LoRa. :::

Channel Settings Values

Параметры настроек канала: Name, PSK, Downlink Enabled и Uplink Enabled. Настройки канала встроены в protobuf Channel как protobuf ChannelSettings и отправляются как административное сообщение.

Name

Короткий идентификатор канала. (< 12 байт)

Reserved Name	Purpose
`""` (default)	Если оставить пустым на основном канале, это обозначает канал `default`.
`admin`	На вторичных каналах имя `admin` (с учетом регистра) обозначает канал `admin`, используемый для администрирования узлов в сети. Обратите внимание, что это устаревшая функция, см. Remote Admin для деталей.

:::note

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

:::

PSK

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

Шестнадцатеричный байт 0x01 для основного канала default.

Должен быть либо 0 байт (без криптографии), 16 байт (AES128) или 32 байта (AES256).

:::note

Для общения по одному и тому же каналу с другими устройствами требуются совпадающие PSK. Пример: если ваше устройство использует канал с PSK по умолчанию AQ==, то устройство, с которым вы пытаетесь общаться, также должно иметь соответствующий канал с тем же PSK.

:::

Downlink Enabled

Если включено, сообщения, захваченные из публичного интернет-шлюза, будут перенаправлены в локальную mesh-сеть.

По умолчанию установлено в false для всех каналов.

Uplink Enabled

Если включено, сообщения из mesh-сети будут отправлены в публичный интернет через настроенный шлюз любого узла.

По умолчанию установлено в false для всех каналов.

Channel Module Settings

Параметры модульных настроек канала: position precision. Модульные настройки канала встроены в protobuf Channel как protobuf ModuleSettings и отправляются как административное сообщение.

Position Precision

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

Значение position_precision — целое число от 0 до 32:

Значение 0 означает, что данные о местоположении никогда не отправляются по указанному каналу.
Значение 32 означает, что данные о местоположении отправляются с полной точностью.
Значения между ними указывают количество бит точности для отправки, что соответствует точности позиции из таблицы ниже.
Публичный MQTT-сервер фильтрует точные позиции, см. здесь для получения дополнительной информации.

Клиентские приложения реализуют разные уровни точности, предоставляя пользователю практический диапазон выбора. Установка по всему диапазону целых чисел может быть выполнена через Python CLI. См. Setting Position Precision для примеров установки разных уровней точности с помощью CLI.

Channel Config Client Availability

      <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. ::: Android Menu Tabs

Вкладка Radio Configuration может использоваться для общих задач:

Просмотр QR-кода и URL текущей конфигурации канала.[^1]
Быстрое создание или изменение основного канала.
Выбор пресета модема для всех каналов, например Long Range / Fast.

[^1]:

См. Android App Usage для получения дальнейших инструкций по настройке основного канала.

Нажмите "Edit", чтобы открыть меню канала:

Добавление, удаление или изменение вторичных каналов
Создание или изменение ключей шифрования
Включение uplink и downlink для отдельных каналов
Position enabled
Precise location (если position включен)
Position precision (если precise location отключен)

Apple

:::info

Редактор каналов доступен в приложениях для iOS, iPadOS и macOS в разделе Settings > Radio Configuration > Channels.

:::

CLI

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

:::tip

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

```shell title="Example:" meshtastic --ch-set name "My Channel" --ch-set psk random --ch-set uplink_enabled true --ch-index 4


:::

##### Name

```shell title="Set channel name for the PRIMARY channel"
# without spaces
meshtastic --ch-set name MyChannel --ch-index 0
# with spaces
meshtastic --ch-set name "My Channel" --ch-index 0

PSK

Если вы используете Meshtastic для обмена сообщениями, которые не должны видеть другие люди, используйте настройку random. Выбор default или любого из значений simple из следующей таблицы будет использовать публично известные ключи шифрования. Они поставляются с исходным кодом Meshtastic, и поэтому любой может прослушивать сообщения, зашифрованные ими. Они подходят для тестирования и публичных каналов.

Setting	Behavior
`none`	Disable Encryption
`default`	Default Encryption (use the weak encryption key)
`random`	Generate a secure 256-bit encryption key. Use this setting for private communication.
`simple0`- `simple254`	Использует кодировку одним байтом для шифрования

```shell title="Установить шифрование по умолчанию на PRIMARY канале" meshtastic --ch-set psk default --ch-index 0


```shell title="Установить случайное шифрование на PRIMARY канале"
meshtastic --ch-set psk random --ch-index 0

```shell title="Установить шифрование одним байтом на PRIMARY канале" meshtastic --ch-set psk simple15 --ch-index 0


```shell title="Установить своё собственное ключевое слово на PRIMARY канале"
meshtastic --ch-set psk 0x1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b1a1a1a1a2b2b2b2b --ch-index 0

```shell title="Установить своё собственное ключевое слово на PRIMARY канале (закодировано в Base64)" meshtastic --ch-set psk base64:puavdd7vtYJh8NUVWgxbsoG2u9Sdqc54YvMLs+KNcMA= --ch-index 0


:::tip
Используйте это для копирования и вставки ключа, закодированного в `base64` (для одного канала), из команды `meshtastic --info`. Пожалуйста, не используйте код omnibus (для всех каналов) здесь, это недействительный ключ.
:::

```shell title="Отключить шифрование на PRIMARY канале"
meshtastic --ch-set psk none --ch-index 0

Uplink / Downlink

Для настройки шлюзов, пожалуйста, смотрите MQTT

```shell title="Включить/Отключить Uplink на PRIMARY канале" meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set uplink_enabled false --ch-index 0


```shell title="Включить/Отключить Downlink на SECONDARY канале"
meshtastic --ch-set downlink_enabled true --ch-index 1
meshtastic --ch-set downlink_enabled false --ch-index 5

Настройка точности позиции

:::info

Это настройка на канал. Параметр --ch-index должен быть указан для установки точности позиции для конкретного канала, напр., --ch-index 0 для основного канала или --ch-index 1 для вторичного канала 1.

:::

```shell title="Установить точность позиции в 13 бит (примерно ±3 км)" meshtastic --ch-set module_settings.position_precision 13 --ch-index 0


```shell title="Установить полную точность позиции (32 бита)"
meshtastic --ch-set module_settings.position_precision 32 --ch-index 1

Веб

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