telemetry

Модуль телеметрии предоставляет четыре типа данных через mesh: метрики устройства (уровень заряда батареи, напряжение, использование канала и время в эфире) с вашего устройства Meshtastic, метрики окружающей среды, метрики качества воздуха и метрики здоровья (частота сердечных сокращений, насыщение кислородом и температура тела).

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

Поддерживаемые типы датчиков

Значения конфигурации модуля

Включена телеметрия окружающей среды

Включить телеметрию окружающей среды (датчики).

Интервал обновления метрик окружающей среды

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

По умолчанию 1800 секунд (30 минут).

Интервал обновления метрик устройства

Как часто отправлять метрики устройства через mesh.

По умолчанию 1800 секунд (30 минут).

Метрики устройства в подключенное клиентское приложение всегда отправляются раз в минуту, независимо от этой настройки.

Включен экран окружающей среды

Показывать данные телеметрии окружающей среды на дисплее устройства.

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

Отображать в Фаренгейтах

Датчик всегда считывается в Цельсиях, но пользователь может выбрать отображение в Фаренгейтах (только на дисплее устройства) с помощью этой настройки.

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

Включено качество воздуха

Эта опция используется для включения/отключения отправки метрик качества воздуха с подключенного поддерживаемого датчика через mesh-сеть.

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

Интервал качества воздуха

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

По умолчанию 1800 секунд (30 минут).

Включены метрики питания

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

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

Интервал метрик питания

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

Включена телеметрия здоровья

Эта опция используется для включения/отключения отправки данных здоровья с подключенного поддерживаемого датчика через mesh-сеть.

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

Интервал телеметрии здоровья

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

По умолчанию 1800 секунд (30 минут).

Доступность конфигурации телеметрии в клиентах

      <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 Все опции конфигурации модуля телеметрии доступны в iOS, iPadOS и macOS в Настройки > Конфигурация модуля > Телеметрия (датчики).

:::

CLI

:::info

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

:::

Настройки

:::tip

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

```shell title="Example:" meshtastic --set telemetry.device_update_interval 0 --set telemetry.environment_update_interval 0

:::

```shell title="Set module update intervals (Default of 0 is 5 Minutes)"
meshtastic --set telemetry.device_update_interval 0
// Device Metrics Two Minutes
meshtastic --set telemetry.device_update_interval 0
// Environment Metrics Two Minutes
meshtastic --set telemetry.environment_update_interval 120
     ```
```shell title="Enable/Disable Environment Module"
meshtastic --set telemetry.environment_measurement_enabled true
meshtastic --set telemetry.environment_measurement_enabled false

```shell title="Enable/Disable on device screen" meshtastic --set telemetry.environment_screen_enabled true meshtastic --set telemetry.environment_screen_enabled false

```shell title="Enable / Disable Display Fahrenheit"
meshtastic --set telemetry.environment_display_fahrenheit true
meshtastic --set telemetry.environment_display_fahrenheit false

Веб

:::info

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

:::

Примеры

RAK 4631 с датчиком окружающей среды BME680

Настройка RAK 4631 с датчиком окружающей среды

Требования:

• RAK4631
• Датчик окружающей среды

Шаги:

• настройте устройство:

meshtastic --set telemetry.environment_measurement_enabled true --set telemetry.environment_screen_enabled true --set telemetry.environment_display_fahrenheit true

:::tip

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

:::

• Устройство перезагрузится после отправки команды.
• При следующей загрузке устройство должно отобразить "Telemetry" и, возможно, данные датчика
• Если это не оказывает никакого эффекта, выполните:

meshtastic --noproto

И изучите серийные логи на наличие диагностической информации о телеметрии.

Поддержка дополнительных датчиков

Метрики окружающей среды

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

• Температура
• Относительная влажность
• Барометрическое давление
• Сопротивление газа (AQI)
• Напряжение
• Ток

Поддержка других типов датчиков

Для других интересных типов датчиков и сценариев использования необходимо добавить portnum для более общих пакетов телеметрии, и потребуется второй MCU для взаимодействия с датчиком и обработки данных для отправки по mesh. Эти данные не будут храниться в nodedb на устройстве.

 ```