Системи звукового оповіщення

PX4 визначає ряд стандартних мелодій/тем, які використовуються для забезпечення аудіо-повідомлень про важливі стани системи та проблеми (наприклад, запуск системи, успішне готування до роботи, попередження про заряд батареї і т. д.).

Мелодії вказуються за допомогою рядків (у форматі ANSI Music notation) та відтворюються за допомогою коду, використовуючи бібліотеку tunes. Бібліотека мелодій також містить список стандартних мелодій системи - див. lib/tunes/tune_definition.desc.

У PX4 також є модуль, який можна використовувати для відтворення (тестування) стандартних мелодій або користувацьких мелодій.

У цій темі наведено загальні вказівки щодо створення власних мелодій і додавання/заміни системних тонів/мелодій сповіщень.

Формування Звукових Повідомлень

Рядки мелодій визначаються за допомогою ANSI Music notation.

TIP

Більше інформації про формат можна знайти в QBasic PLAY statement (Wikibooks) та було відтворено в tune_definition.desc.

Найпростіший спосіб створити нову мелодію – скористатися музичним редактором. Це дозволяє редагувати музику та відтворювати її на вашому комп'ютері, а потім експортувати в формат, який можна відтворити за допомогою PX4.

Музика ANSI була популярною за часів систем ANSI BBS, тому найкращими інструментами редагування є утиліти DOS. У Windows одним із варіантів є використання Melody Master у Dosbox.

Кроки використання програмного забезпечення:

1. Завантажити DosBox і встановити додаток

2. Завантажити Майстер Мелодій та розпакувати в нову директорію

3. Відкрийте консоль Dosbox

4. Змонтуйте основний каталог мелодій у Dosbox, як показано нижче:

   mount c C:\<path_to_directory\Melody21

5. Запустіть Melody Master за допомогою таких команд

   c:
   start

6. Потім ви матимете можливість клацнути кілька екранів, а потім натиснути 1, щоб відобразити Master Melody:

   У нижній половині екрана надаються корисні поради щодо комбінацій клавіш для використання інструменту (стрілки для переміщення в ноті, цифри для вибору тривалості ноти тощо).

7. Коли ви будете готові зберегти музику:

   • Натисніть F2, щоб дати мелодії назву та зберегти її у підпапці /Music вашої інсталяції Melody Master.
   • Натисніть F7, прокрутіть список вихідних форматів праворуч, щоб перейти до ANSI. Файл буде експортовано в кореневий каталог каталогу Melody Master (з такою самою назвою та розширенням типу файлу).

8. Відкрийте файл. Результат може виглядати так:

   

9. Рядок, який можна відтворити в PX4, це біт між MNT і P64: 150L1O3DL16CL32<B>C<AEL16A

Тестування тунелів

Коли ви будете готові спробувати нову мелодію на PX4, скористайтеся бібліотекою tune_control. Наприклад, щоб перевірити мелодію, яку ми «створили» вище, ви повинні ввести таку команду на консолі чи оболонці (наприклад, MAVLink Shell):

tune_control play -m "150L1O3DL16CL32<B>C<AEL16A"

:::note За замовчуванням, tune_control присутній лише на реальному обладнанні (не у симуляторі). :::

Заміна існуючих звукових повідомлень

Мелодії визначаються в файлі tune_definition.desc.

Якщо вам потрібно лише замінити існуючу мелодію, ви можете замінити файл у власному репозиторії (fork) та оновити рядки мелодій, визначені в PX4_DEFINE_TUNE.

Додати нову мелодію

TBD.