audio
Параметры конфигурации аудиомодуля: Codec2 Enabled, PTT GPIO, Audio Bitrate/Codec Mode, I2S Word Select, I2S Data IN, I2S Data OUT и I2S Clock. Конфигурация аудиомодуля использует административное сообщение, отправляющее ConfigModule.Audio protobuf.
С этим экспериментальным модулем вы можете добавить цифровой I2S-микрофон и динамик к любому устройству на базе ESP32, оснащённому радио SX128x и работающему в диапазоне 2.4 ГГц ISM Band. Диапазоны Sub-1 ГГц недостаточно широки для поддержки непрерывных аудиопакетов в mesh-сети, даже в режимах Short и Fast. На данный момент поддерживаются только платы LilyGo TLora 2.1-1.8 и TLora T3S3. Модуль разработан для каналов с пропускной способностью 2 кбит/сек или выше.
Необходимое дополнительное оборудование:
- Max98357 - I2S 3W Class D Amplifier
- MSM261S4030H0 - I2S MEMS Low Noise Single Microphone
Значения конфигурации аудиомодуля
Codec2 Enabled
Включает аудиомодуль.
PTT GPIO
GPIO для использования кнопки Push-To-Talk. Значение по умолчанию — GPIO 39 на ESP32.
Audio Bitrate/Codec Mode
Битрейт для аудио. Значение по умолчанию — CODEC2_700B. Доступные варианты:
- CODEC2_DEFAULT
- CODEC2_3200
- CODEC2_2400
- CODEC2_1600
- CODEC2_1400
- CODEC2_1300
- CODEC2_1200
- CODEC2_700B
- CODEC2_700
I2S Word Select
GPIO для использования сигнала WS в интерфейсе I2S.
I2S Data IN
GPIO для использования сигнала SD в интерфейсе I2S.
I2S Data OUT
GPIO для использования сигнала DIN в интерфейсе I2S.
I2S Clock
GPIO для использования сигнала SCK в интерфейсе I2S.
:::info Что это такое? Эти пины составляют цифровой аудиоинтерфейс I2S. Meshtastic использует его в монофоническом режиме. Программное обеспечение использует логический стереоканал 'LEFT' для микрофона и логический стереоканал 'RIGHT' для динамика, поэтому настройте свои модули соответственно. Аудио работает в полудуплексном режиме, поэтому мы можем повторно использовать часть пинов для двунаправленной конфигурации. Нет значений по умолчанию для пинов, их настройка обязательна. :::
Доступность конфигурации аудиомодуля на клиенте
<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 точки в правом верхнем углу) > Конфигурация радио > Audio
:::
Apple
:::info Конфигурация аудиомодуля недоступна на iOS, iPadOS и macOS. :::
CLI
:::info
Все параметры конфигурации аудиомодуля доступны в CLI Python. Примеры команд ниже:
:::
| Параметр | Допустимые значения | По умолчанию |
|---|---|---|
| audio.codec2_enabled | true, false |
false |
| audio.ptt_pin | Номер GPIO-пина 1-39 | Значение 39 не задано |
| audio.bitrate | CODEC2_DEFAULT CODEC2_3200 CODEC2_2400 CODEC2_1600 CODEC2_1400 CODEC2_1300 CODEC2_1200 CODEC2_700B CODEC2_700 |
CODEC2_DEFAULT |
| audio.i2s_ws | Номер GPIO-пина 1-34 | Нет значения по умолчанию |
| audio.i2s_sd | Номер GPIO-пина 1-39 | Нет значения по умолчанию |
| audio.i2s_din | Номер GPIO-пина 1-34 | Нет значения по умолчанию |
| audio.i2s_sck | Номер GPIO-пина 1-34 | Нет значения по умолчанию |
:::tip
Поскольку устройство перезагрузится после каждой отправленной команды через CLI, при установке нескольких значений в разделе конфигурации рекомендуется объединять команды в одну цепочку.
```shell title="Example:" meshtastic --set audio.codec2_enabled true --set audio.bitrate CODEC2_1400
:::
```shell title="Enable / Disable Module"
meshtastic --set audio.codec2_enabled true
meshtastic --set audio.codec2_enabled false
```shell title="Set WS to GPIO pin number 7" meshtastic --set audio.i2s_ws 7
```shell title="Set DIN to GPIO pin number 28"
meshtastic --set audio.i2s_din 28
```shell title="Set PTT to GPIO pin number 37" meshtastic --set audio.ptt_pin 37
```shell title="Set Codec Bitrate"
meshtastic --set audio.bitrate CODEC2_DEFAULT
meshtastic --set audio.bitrate CODEC2_1400
Web
:::info Все параметры конфигурации аудиомодуля доступны в веб-интерфейсе. :::
:::warning
Доступ к GPIO принципиально опасен, поскольку неверные параметры могут физически повредить или уничтожить ваше оборудование. Убедитесь, что вы полностью понимаете схему вашего устройства, прежде чем пробовать это, поскольку мы не предоставляем гарантию. Используйте на свой страх и риск.
Этот модуль требует подключения периферийного аксессуара к устройству. Без него он не будет работать.
:::