Введение

Обзор

В данном документе в основном описывается функция голосового самотестирования продукта.
Голосовое самотестирование — это проверка динамика и микрофона устройства, также известная как эхо-тест. Принцип работы заключается в том, что устройство воспроизводит звук через динамик и записывает его с помощью микрофона, чтобы определить исправность аудиокомпонентов. Данная функция широко используется для удаленной проверки работоспособности динамика и микрофона оборудования. Ниже подробно описан порядок проведения голосового самотестирования на промышленных устройствах.

Поддерживаемые модели

i12, i11, i16V, i18S, i20S, i30, i32V, i33V, i16SV, i10SV, PA3 и PA2S.

Принцип работы голосового самотестирования

Устройство воспроизводит аудиофрагмент через динамик, а микрофон записывает звук и определяет процент принятого сигнала. Если полученное значение превышает установленный порог — тест считается успешным. При значении ниже порогового показателя тест завершается с ошибкой. Принцип работы представлен на Рисунке 1:

                                                                                Рисунок 1 Схема принципа голосового самотестирования

Сферы применения голосового самотестирования

Функция голосового самотестирования активно используется для удаленного обслуживания оборудования. Для экономии времени и повышения эффективности проверок операторы могут запускать удаленную диагностику из диспетчерской при отсутствии трансляции или внезапном прекращении звукового оповещения.

                                                                               Рисунок 2 Сценарий применения голосового самотестирования

Необходимое оборудование и инструменты

① Устройство серии переговорных систем (в примере используется модель i12), PoE-коммутатор (источник постоянного тока) и сервер Yunyi. Подключите устройство к коммутатору.
② Компьютер для настройки и сервер. Подключите ПК к тому же коммутатору, чтобы обеспечить стабильную сеть между устройствами.

Схема подключения устройства и ПК

① Подключите i12, сервер и настроочный компьютер к общему сетевому коммутатору, обеспечив взаимную доступность в сети. Схема подключения представлена на Рисунке 3:

                              Рисунок 3 Схема подключения устройства и ПК

Инструкция по эксплуатации

Существует несколько способов запуска эхо-теста, каждый из которых описан ниже подробно.

Метод активного URI

Активный URI — это отправка HTTP GET-запроса с удаленной консоли. Встроенный веб-сервер устройства обрабатывает полученную команду и отправляет ответ, реализуя удаленное управление оборудованием.
(1) Формат самотестирования: http://device_ip/cgi-bin/ConfigManApp.com?key=ECHO_TEST；
① device_ip: сетевой адрес тестируемого устройства (пример: 172.18.8.15)；
② Результат ответа: при исправном подключении динамика и микрофона отображается значение success; при обрыве соединения или повреждении компонентов — Failure；
(2) Пример: введите адрес в адресную строку браузера. При корректной работе аудиосистемы будет возвращен ответ success, как показано на Рисунке 4.

                                                                               Рисунок 4 Схема голосового самотестирования через активный URI

Метод HTTP API

HTTP API — интерфейс для интеграции со сторонними приложениями и системами управления. Устройство выступает в роли HTTP-сервера и предоставляет доступ к API по адресу http://ip/xmlservice. Стороннее ПО отправляет POST-запросы с данными в формате XML.
Формат запроса HTTP API:
(1) Запрос клиента к серверу:
（?xml version="1.0" encoding="UTF-8" ?）
（FanvilPhoneExecute beep=”yes” ）
（ExecuteItem>URI="cmd:echo_test"（/FanvilPhoneExecute）
cmd:audio_play: идентификатор команды эхо-теста；
(2) Ответ сервера клиенту:
（?xml version="1.0" encoding="UTF-8"?）
（FanvilPhoneExecute）
（ExecuteItem>URI="cmd:echo_test"）
（RetCode>0）
（info）
（![CDATA[success]]）
（/info）
（/FanvilPhoneExecute）
(3) Итог проверки: исправное оборудование — success, неисправное — Failure；
(4) Пример: тестирование выполняется через Postman или ApiPost. Отправьте POST-запрос на адрес http://device_ip/xmlservice, заполните тело запроса и нажмите “Отправить” для получения результата (Рисунок 5).

                                                                               Рисунок 5 Схема голосового самотестирования через HTTP API

Метод временного расписания

В настройках временного планирования можно добавить задачу голосового самотестирования. Устройство автоматически выполнит диагностику в заданное время и отправит отчет по URL-адресу действия.
(1) Войдите в веб-интерфейс устройства, откройте раздел “Настройки переговорной связи” — “Временное расписание” — “Правила расписания” для создания задачи (Рисунок 6):
① Тип задачи: выберите “Голосовое самотестирование”；
② Время выполнения: укажите период для автоматического запуска проверки.

                                                                                Рисунок 6 Схема голосового самотестирования по расписанию

(2) После сохранения настроек правило появится в списке расписаний. По наступлению указанного времени устройство запустит самодиагностику автоматически.

Метод SIP-сообщений

Метод SIP-сообщений используется в сетях общего пользования. Сервер отправляет управляющую команду через SIP-сообщение, устройство отвечает кодом 200 OK, затем отправляет отчет о проверке на платформу, которая также подтверждает прием ответом 200 OK.
(1) Зарегистрируйте учетную запись устройства на сервере.
(2) Создайте задачу диагностики на сервере Yunyi: авторизуйтесь в веб-интерфейсе, перейдите в раздел “Задачи самотестирования&rdquo> — “Добавить”.
(3) Выберите созданную задачу и нажмите «Выполнить». При исправной аудиосистеме проверка завершится успешно, в противном случае отобразится ошибка. Результаты диагностики доступны в разделе “Результат самотестирования”.

                                                                                Рисунок 7 Схема голосового самотестирования через SIP-сообщения
(4) Также результат проверки можно отследить через захват сетевых пакетов. Перед запуском теста откройте в веб-интерфейсе устройства раздел “Система&rdquo> — “Вспомогательные инструменты&rdquo> — “Захват сетевых пакетов&rdquo> и нажмите “Запустить&rdquo>.

                                                                                                                          Рисунок 8 Схема захвата пакетов устройства
По окончании самотестирования остановите захват данных, откройте файл в Wireshark и отфильтруйте трафик по полю “sip”. Наличие метки “Success” подтверждает успешную проверку, а метки “Fail” или “Failure” указывают на ошибку.

                                                  Рисунок 9 Схема результатов захвата пакетов

Устранение ошибок голосового самотестирования

При эксплуатации оборудования возможны сбои голосового самотестирования, вызванные различными факторами. Для диагностики неполадок выполните следующие проверки:
(1) Проверка подключений
При ошибке теста осмотрите надежность подключения динамика и микрофона. Отключенный динамик обычно вызывает сбой, однако шумное окружение может привести к ложному положительному результату. Отключенный микрофон гарантированно приведет к ошибке проверки.
(2) Проверка комплектующих
При корректном подключении, но повторяющемся сбое теста проверьте аудиокомпоненты на физические повреждения. Если оборудование исправно — обратитесь в техническую поддержку.
(3) Проверка шумового фона окружения
Самотестирование основано на воспроизведении и приеме звукового сигнала частотой 1 кГц. Наличие подобного шума в окружающей среде нарушает точность диагностики. Например, неисправный динамик может быть определен как исправный из-за внешнего звукового фона.