position

Данные позиции от GPS предоставляются либо радио, либо вашим спаренным телефоном. Для использования Meshtastic это не обязательно, но расчёты времени требуют, чтобы хотя бы одно устройство в mesh имело GPS, RTC или подключение к интернету для NTP.

Конфигурация позиции использует административное сообщение для отправки protobuf Config.Position. Опции конфигурации позиции: Режим GPS, Интервал обновления GPS, Фиксированная позиция, Умная трансляция, Минимальное расстояние для умной трансляции, Минимальный интервал для умной трансляции, Интервал трансляции, Флаги пакета позиции и Пины GPIO RX/TX/EN для GPS.

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

Режим GPS

Настраивает, включена ли функциональность GPS, выключена или отсутствует на узле.

Допустимые значения: DISABLED, ENABLED и NOT_PRESENT.

В зависимости от устройства и его конфигурации это значение по умолчанию будет либо ENABLED, либо NOT_PRESENT.

Интервал обновления GPS

Как часто пытаться получать позицию GPS (в секундах), или ноль для значения по умолчанию — раз в 2 минуты, или очень большое значение (максимум int) для обновления только один раз при загрузке.

Фиксированная позиция

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

По умолчанию false

Если установлено, этот узел находится в фиксированной позиции. Устройство будет генерировать обновления GPS с регулярным интервалом обновления GPS, но использовать последние сохранённые значения lat/lon/alt для узла. Значения lat/lon/alt можно установить с помощью внутреннего GPS или с помощью GPS мобильного устройства.

Умная трансляция

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

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

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

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

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

Минимальное расстояние для умной трансляции

По умолчанию 0 — 100 метров

Минимальное расстояние в метрах, пройденное (с момента последней отправки), перед тем как мы сможем отправить позицию в mesh, если умная трансляция включена.

Минимальный интервал для умной трансляции

По умолчанию 0 — 30 секунд

Минимальное количество секунд (с момента последней отправки), перед тем как мы сможем отправить позицию в mesh, если умная трансляция включена.

Интервал трансляции

По умолчанию 0 — 15 минут

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

Обновления GPS будут отправляться через каждый интервал трансляции, либо с реальной локацией GPS, либо с пустой локацией, если фиксацию GPS достичь не удалось.

Флаги позиции

Определяет, какие опции отправляются в сообщениях POSITION. Значения хранятся как битовая маска булевых опций конфигурации (битовое ИЛИ PositionFlags).

Value	Description
UNSET	Required for compilation
ALTITUDE	Include an altitude value (if available)
ALTITUDE_MSL	Altitude value is MSL
GEOIDAL_SEPARATION	Include geoidal separation
DOP	Include the DOP value ; PDOP used by default, see below
HVDOP	If POS_DOP set, send separate HDOP / VDOP values instead of PDOP
SATINVIEW	Include number of "satellites in view"
SEQ_NO	Include a sequence number incremented per packet
TIMESTAMP	Include positional timestamp (from GPS solution)
HEADING	Include positional heading (from GPS solution)
SPEED	Include positional speed (from GPS solution)

GPIO RX/TX/EN для модуля GPS

Если ваше устройство не имеет встроенного чипа GPS, вы можете определить пины GPIO для RX, TX и EN модуля GPS.

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

      <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.

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

:::

Apple

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

CLI

:::info

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

:::

Setting	Acceptable Values	Default
position.gps_mode	`ENABLED`, `DISABLED`, `NOT_PRESENT`	`ENABLED` or `NOT_PRESENT`
position.gps_update_interval	`integer` (seconds)	Default `0` is 2 Minutes
position.fixed_position	`true`, `false`	`false`
position.position_broadcast_smart_enabled	`true`, `false`	`true`
position.broadcast_smart_minimum_distance	`integer` (meters)	Default of `0` is 100 Meters
position.broadcast_smart_minimum_interval_secs	`integer` (seconds)	Default of `0` is 15 Minutes
position.position_broadcast_secs	`integer` (seconds)	Default of `0` is 15 minutes
position.flags	`UNSET`, `ALTITUDE`, `ALTITUDE_MSL`, `GEOIDAL_SEPARATION`, `DOP`, `HVDOP`, `PDOP`, `SATINVIEW`, `SEQ_NO`, `TIMESTAMP`, `HEADING`, `SPEED`	`UNSET`
position.rx_gpio	`integer` (0-39)	`UNSET`
position.tx_gpio	`integer` (0-34)	`UNSET`

:::tip

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

```shell title="Example:" meshtastic --set position.fixed_position true --setlat 37.8651 --setlon -119.5383


:::

```shell title="Set GPS update interval (Default of 0 is 2 Minutes)"
meshtastic --set position.gps_update_interval 0
meshtastic --set position.gps_update_interval 45

```shell title="Set Fixed Position - Current Location" meshtastic --set position.fixed_position true


:::note
Устройство продолжит получать координаты GPS в соответствии с `gps_update_interval`, но будет использовать последние сохранённые координаты как фиксированную точку.
:::

```shell title="Set and Enable Fixed Position - User Defined"
meshtastic --setlat 37.8651 --setlon -119.5383

```shell title="Remove and Unset Fixed Position" meshtastic --remove-position


```shell title="Enable / Disable Smart position broadcast (Enabled by default)"
meshtastic --set position.position_broadcast_smart_enabled true
meshtastic --set position.position_broadcast_smart_enabled false

```shell title="Set Position Broadcast Interval (Default of 0 is 15 minutes)" meshtastic --set position.broadcast_secs 0 meshtastic --set position.broadcast_secs 60


:::note
Может потребоваться некоторое время, чтобы увидеть, что изменение вступило в силу. Локация GPS обновляется в соответствии со значением `gps_update_interval`, а mesh будет уведомлена о новой позиции в отношении значения `position_broadcast_secs`.
:::

```shell title="Set / Unset Position Flags"
meshtastic --pos-fields ALTITUDE ALTITUDE_MSL
meshtastic --pos-fields UNSET

Web

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