Синапс X-Media Драйвер ALSA¶

• Table of contents
• Синапс X-Media Драйвер ALSA
  • • Описание
    • Экземпляр и обновление ПО
    • Установка
    • Настройка
    • Эксплуатация
      • Запуск и остановка Программы
      • Команды для ALSA-драйвера
      • Логи Программы

Описание¶

Аннотация: «Синапс X-Media Драйвер Синапс» реализует подключение к серверам Синапс, а также прием и передачу звуковых потоков между сервером Синапс и любым из других аудио-драйверов, поддерживаемых ПО «Синапс X-Media».

• ПО «Синапс X-Media Драйвер Синапс» является составной частью ПО «Синапс X-Media» и работает под его управлением.
• «Синапс X-Media Драйвер Синапс» является абонентским устройством Синапс, что позволяет серверам Синапс работать с ПО «Синапс X-Media» также как с другими абонентскими устройствами Синапс.

Функции ПО: 

• X-Media Драйвер Синапс позволяет устанавливать соединение и обмениваться звуковыми потоками с сервером Синапс. К серверу X-Media Драйвер Синапс подключается как абонентское устройство Синапс, которое способно отдавать и отдавать звуковой поток из/в сервер Синапс.
• Также как любое абонентское устройство Синапс, X-Media Драйвер Синапс поддерживает постоянное соединение с серверами Синапс по двум независимым сетям IP.
• X-Media Драйвер Синапс позволяет обмениваться звуковыми потоками с серверами Синапс с использованием протоколов TCP/RTP. Звуковые потоки могут передаваться в формате PCM, а также с использованием сжатия звука по стандарту OPUS;
• X-Media Драйвер Синапс позволяет получать настройки параметров звуковых потоков и каналов связи от сервера Синапс.
• X-Media Драйвер Синапс организует обмен звуковыми потоками с другими драйверами, работающими внутри сервиса X-Media.
• X-Media Драйвер Синапс имеет собственный встроенный веб-сервер, работающий в составе сервиса Синапс X-Media, что позволяет подключаться к драйверу по протоколу HTTP для осуществления настройки конфигурации ПО, а также контроля работоспособности драйвера из веб-браузера.

Прочие данные о ПО:

• Системные требования: Процессор – от 2 ГГц, Оперативная память – от 4 Гб, Свободное место постоянного запоминающего устройства – от 4 Гб, Сетевой интерфейс от 100 Мбит/сек
• Объем внутренней памяти: Оперативная память – от 4 Гб, свободное место постоянного запоминающего устройства – от 4 Гб
• Тип реализующей ЭВМ: ЭВМ, построенные на платформе с процессорной архитектурой x86-64
• Язык: C++, C
• Операционная система: Ubuntu 22.04 LTS/24.04 LTS, Red OS 7.3, Astra Linux 1.8

Экземпляр и обновление ПО¶

Установка и настройка программы осуществляется сотрудниками отдела внедрения и системной интеграции ООО «Тракт-Софт».

«Синапс X-Media Драйвер Синапс» является модулем ПО «Синапс X-Media», которое устанавливается на персональный компьютер (с операционной системой Linux Ubuntu или Red OS), находящийся в локальной сети по одной из сетей, либо, в случае возможности, по основной и резервной локальной сети. Для работы необходимо постоянное подключение к серверам комплекса, автономная работа программы не предусматривается.

Установка  ПО «Синапс X-Media» происходит согласно инструкции «Установка ПО» и общим правилам установки ПО для выбранной операционной системы. Программа инсталлируется на сервер путем запуска исполняемого установочного файла. Установочный файл публикуется в соответствующем каталоге репозитория, доступного через Интернет. Доступ к репозиторию (учетная запись) предоставляется инсталлятору программного обеспечения по запросу.

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

Рабочее место с установленной Программой с точки зрения комплекса представляет собой многоканальное устройство. «Синапс X-Media Драйвер Синапс» является абонентским устройством Синапс, что позволяет серверам Синапс работать с ПО «Синапс X-Media» также как с другими абонентскими устройствами Синапс.

При установке Программы на комплексе служебной связи Синапс администратор комплекса служебной связи должен активировать абонента для возможности работы в системе. Активация абонента осуществляется через Программное обеспечение «Синапс Администратор».

Экземпляр ПО можно скачать по ссылке:

• Linux Ubuntu: http://redmine.digispot.ru/Distributives/Synapse/x-media/synapse-x-media_1.12.0.74-ubuntu20.04_amd64.deb  
• Red OS: http://redmine.digispot.ru/Distributives/Synapse/x-media/synapse-x-media-1.12.0.74_redos7.3-1.x86_64.rpm 
• Ядро ALSA: предоставляется по запросу при покупке лицензии «Синапс X-Media Драйвер ALSA»

Установка¶

Установка и настройка программы осуществляется сотрудниками отдела внедрения и системной интеграции ООО «Тракт-Софт». 

Для установки Синапс X-Media на Linux Ubuntu в командной строке необходимо выполнить команду:

где {...} - номер сборки и версии платформы.

Для установки Синапс X-Media на Red OS в командной строке необходимо выполнить команду:

где {...} - номер сборки и версии платформы.

ПО устанавливается как демон systemd. Проверить, что сервис успешно установился можно с помощью команды:

За возможность работы ПО отвечают лицензии:

• «Синапс X-Media» - лицензия на ПО «Синапс X-Media»
• «Синапс X-Media Драйвер ALSA» - лицензия на ПО «Синапс X-Media» в специальной конфигурации «Синапс X-Media Драйвер ALSA»)

Звуковое ядро ALSA устанавливается отдельно с помощью команд:

Настройка¶

Каталог хранения настроек зависит от каталога установки ПО. По умолчанию настройки Синапс X-Media хранятся в json-файлах в папке /usr/share/synapse/xmedia/storage.

Конфигурирование ПО «Синапс X-Media» выполняется с помощью файла настроек AppConfig-AppConfig.json.

Конфигурирование «Синапс X-Media Драйвер Синапс» выполняется с помощью файла настроек /usr/share/alsa/alsa.conf.

Эксплуатация¶

Рабочее место с установленной Программой с точки зрения комплекса представляет собой многоканальное устройство. «Синапс X-Media Драйвер Синапс» является абонентским устройством Синапс, что позволяет серверам Синапс работать с ПО «Синапс X-Media» также как с другими абонентскими устройствами Синапс.

При установке Программы на комплексе служебной связи Синапс администратор комплекса должен активировать абонента через ПО «Синапс Администратор».

Прямого взаимодействия пользователя с Программой не осуществляется, возможно конфигурирование/управление настройками коммутации абонента.

При возникновении вопросов по эксплуатации Программы вы можете отправить запрос на почту support@tract.ru.

Запуск и остановка Программы¶

Для запуска и остановки приложения используются следующие команды:

• команда запуска Программы

• команда остановки Программы

Проверить состояние Программы можно с помощью команды:

Эта команда выводит на экран общую информацию о приложении — его статус (Active/Inactive (dead)), добавлено оно в автозагрузку или нет (Enabled/Disabled), PID процесса, количество используемой памяти, зависимости и последние несколько строк лога. Здесь же выводятся системные ошибки при запуске приложения.

Команды для ALSA-драйвера¶

Проверка запуска ядра ALSA

Проверка загруженных аудиоустройств X-Media

Перезапуск звукового ядра

Логи Программы¶

Логи Программы для Linux-подобных систем по умолчанию записываются в каталог /var/log/synapse-xmedia.out.logs.

Поведение логов можно настроить в конфигурационном файле: /usr/share/synapse/xmedia/synapse-xmedia.out.log_settings.json.