Интерфейс DAHDI — архитектура и использование
DAHDI — (Digium/Asterisk Hardware Device Interface) — технология, обеспечивающая поддержку различного оборудования (в основном плат расширения) в системах VoIP-телефонии. DAHDI разрабатывается компанией Digium (ныне Sagoma) и является частью проекта Asterisk. Все драйверы и утилиты, входящие в состав DAHDI являются открытым программным обеспечением. Программный интерфейс DAHDI не является зависимым от Asterisk, и, также, может использоваться другими […]
DAHDI — (Digium/Asterisk Hardware Device Interface) — технология, обеспечивающая поддержку различного оборудования (в основном плат расширения) в системах VoIP-телефонии. DAHDI разрабатывается компанией Digium (ныне Sagoma) и является частью проекта Asterisk. Все драйверы и утилиты, входящие в состав DAHDI являются открытым программным обеспечением. Программный интерфейс DAHDI не является зависимым от Asterisk, и, также, может использоваться другими приложениями.
Введение
DAHDI ранее носил название Zaptel, поскольку был частью проекта Zapata Telephony Project, разработанного в 2001 году Джимом Диксоном, занимающегося созданием устройств для VoIP-телефонии и поддержкой их для BSD-систем. Позже, с 2008 года, компания Digium начала разработку плат расширений по аналогии с дизайном Диксона, но для систем, основанных на ядре Linux.
Архитектура
Интерфейс DAHDI — это загружаемый модуль ядра, предоставляющий абстрактный уровень между аппаратными драйверами и Asterisk. Использование такой концепции позволяет добавлять поддержку новых устройств с помощью драйверов, не внося изменений в сам Asterisk.Несмотря на то, что Asterisk может быть скомпилирован на разных операционных системах, драйверы DAHDI предназначены для работы непосредственно с ядром Linux. На сегодняшний день известны реализации DAHDI для платформ Solaris и BSD.
DAHDI состоит из двух основных компонентов: модулей ядра (dahdi-linux) и утилит настройки и отладки (dahdi-tools).Такое разделение сделано по той причине, что модули ядра (драйверы) так же портируются на различные операционные системы.
В список поддерживаемого DAHDI оборудования на сегодняшний день входят следующие устройства (ниже перечислены модули dahdi-linux):
* Digium TE435: PCI express 4 порта T1/E1/J1;
* Digium TE436: PCI 2 порта T1/E1/J1;
* Digium TE235: PCI express 2 порта T1/E1/J1;
* Digium TE236: PCI 2 порта T1/E1/J1;
* Digium TE131: PCI express 1 порт T1/E1/J1;
* Digium TE133: PCI express 1 порт T1/E1/J1 с эхоподавлением;
* Digium TE132: PCI 1 порт T1/E1/J1;
* Digium TE134: PCI 1 порт T1/E1/J1 с эхоподавлением;
* Digium TE205P/TE207P/TE210P/TE212P: PCI 2 порта T1/E1/J1;
* Digium TE405P/TE407P/TE410P/TE412P: PCI 2 порта T1/E1/J1;
* Digium TE220: PCI-Express 2 порта T1/E1/J1;
* Digium TE420: PCI-Express 4 порта T1/E1/J1;
* Digium TE820: PCI-Express 8 портов T1/E1/J1;
* Digium B410: PCI 4 порта BRI;
* Digium B233: PCI-Express 2 порта BRI с эхоподавлением;
* Digium B234: PCI 2 порта BRI с эхоподавлением;
* Digium B433: PCI-Express 2 порта BRI с эхоподавлением;
* Digium B434: PCI 4 порта BRI с эхоподавлением;
* Digium A8A: PCI до 8 портов FXS/FXO;
* Digium A8B: PCI express до 8 портов FXS/FXO;
* Digium A4A: PCI до 4 портов FXS/FXO;
* Digium A4B: PCI express до 4 портов FXS/FXO;
* Digium TDM2400P/AEX2400: до 24 аналоговых портов;
* Digium Hx8 Series: до 8 аналоговых/BRI 8 портов;
Xorcom Astribank: USB-подключаемый модуль до 32 BRI и E1/T1 портов;
— модуль wctc4xxp: Обеспечивает трансляцию различных методов кодирования (необходим модуль dahdi_transcode);
— модуль dahdi_dynamic_eth: драйвер TDM over Ethernet (TDMoE). Для функционирования необходим модуль прерываний dahdi_dynamic;
— модуль dahdi_dynamic_loc: Драйвер прерываний локального интерфейса. Для функционирования необходим модуль прерываний dahdi_dynamic.
В пакет dahdi-tools включены следующие утилиты:
dahdi_cfg — инструмент настройки DAHDI, которая парсит конфигурационный файл /etc/dahdi/system.conf и записывает эту информацию в основной модуль dahdi. Утилита dahdi_cfg запускается автоматически при старте сервиса dahdi в системе.
dahdi_genconf — инструмент обнаружения оборудования и его автоматического конфигурирования. Информацию об обнаруженной конфигурации dahdi_genconf записывает в /etc/dahdi/system.conf и /etc/asterisk/dahdi-channels.conf.
dahdi_hardware — утилита, которая выводит на экран список всего, обнаруженного в системе оборудования, с которым может работать DAHDI.
dahdi_monitor — утилита, производящая мониторинг уровня сигнала на аналоговом канале, а также позволяющая записывать аудиопоток с него. dahdi_monitor отображает визуальное представление уровня входящего и исходящего сигналов и позволяет обнаружить возможные проблемы (слабый сигнал, дисбаланс сигналов). Запись аудиопотока происходит в формате 8 КГц 16 бит.
dahdi_scan — утилита, которая генерирует список каналов DAHDI, с их описанием и подробной информацией.
dahdi_test — инструмент, который измеряет точность цифровой обработки сигналов программного обеспечения плат расширения FXO/FXS. Чем ближе результат к 100%, тем выше точность цифрового преобразования.
dahdi_speed — утилита, позволяющая оценить скорость работы DAHDI-совместимых устройств в конкретной системе с помощью тестирования.
dahdi_tool — инструмент, позволяющий произвести комплексную оценку работы подключаемого устройства. Объединяет в себе функции вышеописанных утилит. Имеет псевдографический интерфейс.
Конфигурационные файлы DAHDI
/etc/dahdi/system.conf — основной конфигурационный файл DAHDI. Определяет параметры потоков, портов, их согласование и синхронизацию, а так же глобальные переменные для всего интерфейса.
/etc/asterisk/chan_dahdi.conf — в данном файле определяются параметры для каждого канала DAHDI, что бы Asterisk мог их использовать. Данный файл содержит следующие секции:
- context — направляет канал в определенный контекст (определяет действия при вызове);
- channel — назначает номер канала (или диапазон каналов);
- group — объединение каналов в группу;
- switchtype — устанавливает тип сигнализации для PRI;
- signalling — определяет вид соединения либо сигнализации (FXO/FXS либо PRI);
- priindication — данный параметр устанавливает то, как сервер Asterisk должен сигнализировать состояние Busy() и Congestion() для удаленного коммутатора или пользователя;
- pridialplan — устанавливает тип плана набора для ISDN PRI;
- overlapdial — определяет передачу набранных цифр в поток.
/etc/dahdi/init.conf — файл, генерируемый при инициализации DAHDI, указанные в нем параметры могут быть переопределены в других файлах.
/etc/dahdi/modules — содержит список модулей (драйверов устройств), для загрузки.
/etc/dahdi/genconf_parameters — устанавливает параметры тонкой настройки для утилиты dahdi_genconf.
DAHDI
DAHDI is a collection of open source drivers, for linux, that are used to interface with a variety of telephony related hardware. It consists of two parts.
- The DAHDI-Linux project contains the individual board drivers for the supported hardware.
- The DAHDI-Tools project contains an assortment of user space utilities that are used to setup and test the drivers.
Current Development Source
DAHDI was previously kept on git.asterisk.org, but has instead been moved to Github. Please use the Github repositories as they are the most up to date and where future changes will occur.
Stable Release Tarball
How to get help
- If you’re a Digium customer, simply Contact Sangoma Technical Support. This is the fastest way to get your issue resolved.
- Send your question to the asterisk-users mailing list. DAHDI developers actively watch this list for dahdi related questions.
- Ask your question in the #asterisk IRC channel.
Where can I file a DAHDI bug report?
- If you think you have found a bug in DAHDI itself, you can submit it to our bug tracker in the DAHDILIN project. Much of the Asterisk Issue Guidelines will apply.
- If your bug is with chan_dahdi (the Asterisk channel driver for DAHDI) then you’ll file it in the ASTERISK project.
Overview
On Linux, we will use the DAHDI-linux-complete tarball, which contains the DAHDI Linux drivers, DAHDI tools, and board firmware files. Again, we’re assuming that you’ve untarred the tarball in the /usr/local/src directory, and that you’ll replace X and Y with the appropriate version numbers.
See What to Download? for more information on downloading the DAHDI tarballs.
Install DAHDI before libpri
libpri 1.4.13 and later source code depends on DAHDI include files. So, one must install DAHDI before installing libpri.
If you are not integrating with any traditional telephony equipment and you are not planning on using the MeetMe dialplan application, then you do not have to install DAHDI or libpri in order to use Asterisk.
Starting with DAHDI-Linux-complete version 2.8.0+2.8.0, all files necessary to install DAHDI are available in the complete tarball. Therefore, all you need to do to install DAHDI is:
[[email protected] src]# cd dahdi-linux-complete-2.X.Y+2.X.Y [[email protected] dahdi-linux-complete-2.X.Y+2.X.Y]# make [[email protected] dahdi-linux-complete-2.X.Y+2.X.Y]# make install [[email protected] dahdi-linux-complete-2.X.Y+2.X.Y]# make config
1 Comment
Alexander Traud
is more generic and avoids error messages if the Terminal was not started with the super user. wiki.asterisk.org/wiki/display/DAHDI/Quick+Start+From+Source does not allow comments, why ever. Therefore, I comment here. It should be (see https://askubuntu.com/a/268710):
sudo apt install linux-headers-generic
which is not part of the script install_prereq. In any way, this page here and the page over in DAHDI should be kept in sync, or link to each other at least. The other page does not know about the ‘complete’ package, because it was created earlier. That is OK. However, both pages should follow the same approach, for example: