¶ VoIP语音板卡 : A810E AE810E 基于DAHDI 用户手册
Created by 董舒, last modified by Dario.hu on 2021 五月 26
深圳市开源通信有限公司
¶ 目录
A810E AE810E 基于DAHDI 用户手册#安全说明
A810E AE810E 基于DAHDI 用户手册#测试环境
A810E AE810E 基于DAHDI 用户手册#第一章 概述
A810E AE810E 基于DAHDI 用户手册#1.1 Asterisk 简介
A810E AE810E 基于DAHDI 用户手册#1.2 A810E/AE810E 简介
A810E AE810E 基于DAHDI 用户手册#第二章 硬件安装
A810E AE810E 基于DAHDI 用户手册#2.1 电源
A810E AE810E 基于DAHDI 用户手册#2.2 插槽
A810E AE810E 基于DAHDI 用户手册#2.3 时钟线
A810E AE810E 基于DAHDI 用户手册#2.4 FXO、FXS模块
A810E AE810E 基于DAHDI 用户手册#2.5 硬件安装
A810E AE810E 基于DAHDI 用户手册#第三章 软件安装
A810E AE810E 基于DAHDI 用户手册#3.1 下载
A810E AE810E 基于DAHDI 用户手册#3.2 安装
A810E AE810E 基于DAHDI 用户手册#3.3 配置
A810E AE810E 基于DAHDI 用户手册#3.4 EC 模块
A810E AE810E 基于DAHDI 用户手册#第四章 参考目录
A810E AE810E 基于DAHDI 用户手册#附录 A 硬件指标
¶ 安全说明
- A810E/AE810E 在应用过程中须符合特定的国家安规；
- 安装A810E/AE810E前，请先关闭电源；
- 为了防止静电感应对板卡的损伤，请用螺丝将卡挡板扣在PC上，以达到接地的作用；
- 安装过程中，静电环必不可少；
- 请按指导步骤操作。
¶
¶ 测试环境
硬件板卡：OpenVox A810E/AE810E
操作系统：CentOS-5.6
内核版本：2.6.18-238.12.1.el5
DAHDI： dahdi-linux-complete-current
Asterisk：16
¶ 第一章 概述
¶ 1.1 Asterisk简介
Asterisk是一个开放源代码的软件VoIP PBX系统，它是一个运行在Linux环境下的纯软件实施方案。Asterisk是一种功能非常齐全的应用程序，提供了许多电信功能，能够把x86机器变成用户交换机，还能够当作一台企业级的商用交换机。Asterisk的优势还在于它为小企业在预算可承受的范围内提供了商业交换机的功能，并且具有很强的可扩展性。
图1 Asterisk应用拓扑
¶ 1.2 A810E/AE810E简介
OpenVox A810E/AE810E 是一款绿色无铅的8口FXO/FXS模拟接口产品，AE810E是A810E带Octasic硬件回声消除模块。A810E/AE810E须使用FXO-400 或 FXS-400来组成一个可行的系统，且用户可以根据需求选择FXO/FXS模块数量，无需另外搭配单独的信道组合器和网关接入产品。A810E/AE810E板卡上有8个RJ11接口，每个接口允许接入1路模拟信号。
A810E/AE810E能运行在Asterisk®， Elastix®， FreeSWITCH™， trixbox®， Yate™ 以及 IPPBX/IVR等开源操作系统上传输清晰的语音，可以作SOHO或中小型企业的PBX， IVR，以及VoIP语音网关等应用。
典型应用
当需要接入四路PSTN线及四部模拟电话机时，用户可按下图安装模块。FXS模块对应的接口连接电话机，FXO模块对应的接口连接PSTN线。
图 2 典型应用
主要特性
- 全球通用
- 卓越的硬件设计及稳定性
- FPGA设计，可现场升级固件
- 支持中断引脚选择，中断频率修改，以避免中断共享
- 支持Bus Master操作速度高达132Mbytes/sec；
- 高稳定性的固件使I/O加速，极大程度地降低了CPU负载
- 可扩展性：如果用户需要更多的端口，只需要安装相应型号的板卡即可
- 支持业界最高品质Octasic回声消除DSP，每通道独立的128ms 或1024taps 回声消除功能；
- RoHS
认证
- CE, FCC, A-Tick
- trixbox TM
- Elastix®
¶ 第二章 硬件安装
¶ 2.1 电源
由于PCI-E插槽不能提供FXS-400、FXO-400所需功率，用户需要通过12V 4-PIN的连接器给板卡提供外加电源。若没有提供外加电源，则模块不能被系统识别。
¶ 2.2 插槽
A810E/AE810E 兼容工业标准的PCI-E ×1、PCI-E ×2、PCI-E ×4、PCI-E ×8以及PCI-E ×16插槽，不兼容任何类型的PCI插槽。用户首先需要确认插槽类型，将A810E/AE810E垂直插入任何一种PCI-E插槽。下图描述了四种插槽形状。
图 3 PCI及PCI-E插槽
¶ 2.3 时钟线
如果用户只有一张卡，那么这张卡上的所有通道都运行在同一时钟频率下，此时，不需要时钟线。如果用户同时安装多张卡在一台机器上，此时时钟线可以带来很多好处。如果不用时钟线，每张模拟卡运行在各自的时钟频率下收发数据，精确度受到影响。在语音传输过程中，这个问题可以忽略不计，但在传真及调制解调器等数据传输中，可能产生不可估量的影响。数据丢失将导致通信中断甚至崩溃。时钟线可以使所有的卡都工作在同一时钟源下，收发数据速率相同，不会丢失数据。
如果用户能在卡上找到J914（输入）及J915（输出）接口，则表示此卡支持时钟线。关于时钟线的使用请参考链接HERE。
¶ 2.4 FXO、FXS模块
FXO、FXS模块有下述简单区别：
- FXO-400为红色模块，FXS-400为绿色模块，每个模块支持4路模拟信号；
- FXO模块对应的端口为FXO口，连接PSTN线，使用FXS信令；而FXS模块对应的端口为FXS口，连接模拟分机，使用FXO信令；
¶ 2.5 硬件安装
- 关闭电源；
- 检查是否需要时钟线；
- 确认插槽类型为PCI-E，将A810E/AE810E垂直插入插槽；
- 请将PSTN线连接FXO口，模拟分机连接FXS口；
- 固定板卡，接地；
- 供电。
图 4 硬件安装
注意: 无论用户安装的是何种模块都需要提供外加电源。在上述操作过程中，静电环是必不可少的，安装或卸下板卡在断电之后方可进行。 连接硬件前请先检查PSTN线路及电话机是否可用。确定硬件安装正确之后，即可开始软件安装。
¶ 第三章 软件安装
¶ 3.1 下载
DAHDI的源码包在Digium及OpenVox网站上均可获得。若从Digium官方网站下载驱动，则需要添加补丁，因此建议用户从OpenVox网站上下载DAHDI。 接下来我们以Asterisk-16、dahdi-linux-complete-current为例详细解说软件安装过程。
从OpenVox官方网站上下载DAHDI源码包:
从Digium网站上获取Asterisk:
http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-16-current.tar.gz
通常在目录/usr/src/ 下运行如下指令,下载并解压DAHDI和Asterisk:
# wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-16-current.tar.gz
# tar -xvzf openvox_dahdi-linux-complete-current.tar.gz
# tar -xvzf asterisk-16-current.tar.gz
¶ 3.2 安装
1. 硬件检测
# lspci –vvvv
通过上述指令检查系统是否识别A810E/AE810E。若检测到A810E/AE810E，则在输出结果中将显示"Communication controller"，如图所示:
图 5 硬件检测
如果系统没有检测到A810E/AE810E，请关闭电源，清扫PCI-E插槽或者将卡插入其它相同类型的插槽重新检测。
2. 依赖包安装
在安装DAHDI前请先检查是否所有的依赖包都安装成功，如果依赖包没有安装，将导致后续的软件安装无法顺利进行。请运行如下指令逐个检查。
# yum install bison
# yum install bison-devel
# yum install ncurses
# yum install ncurses-devel
# yum install zlib
# yum install zlib-devel
# yum install openssl
# yum install openssl-devel
# yum install gnutls-devel
# yum install gcc
# yum install gcc-c++
# yum install libxml2
提示：如果系统没有安装内核，用户需要运行如下指令安装:
# yum install kernel-devel
在上述依赖包的检测过程中，如果该依赖包已经安装，系统会提示已经安装，不会继续安装这个包，用户可以运行下一条指令安装其它包；如果没有安装，则会自动安装直到系统提示安装成功。
debian 系统依赖包和内核安装
#apt-get install bison bison-devel ncurses ncurses-devel zlib zlib-devel openssl openssl-devel gnutls-devel gcc gcc-c++ libxml2 libxml2-devel
#apt-get install linux-headers-`uname -r`
#apt-get install libedit-dev
#apt-get install uuid-dev
#apt-get install libxml2-dev
jansson 包下载地址和安装
http://digip.org/jansson/releases/
tar -zxf jansson*
cd jansson*
./configure --prefix=/usr/ && make clean && make && make install && ldconfig
3. 安装DAHDI
将路径转换到dahdi-linux-complete-XX源码包目录下 (XX 代表DAHDI版本)，运行如下指令安装 DAHDI。
# cd /usr/src/dahdi-linux-complete-XX
# make
# make install
# make config
注意: 如果运行"make"指令后系统显示报错信息，请参考链接 HERE，在此链接中介绍了如何添加补丁。用户按照说明添加补丁之后，请再一次运行"make"，若编译通过则操作后面两条指令，DAHDI安装成功后就开始安装Asterisk。
4. 安装Asterisk
请执行下述指令安装Asterisk：
# cd ../asterisk-16.x
# ./configure（如果是64位系统 执行./configure --libdir=/usr/lib64）
# make
# make install
# make samples
提示：运行" make samples"后将在目录 /etc/asterisk下安装标准示例配置文件。作为新手，用户可以执行" make samples"指令，这条指令并非必须执行。因为一旦执行了这条指令之后，系统会自动备份保存以前安装的配置文件，并以新的配置文件取代之。
¶ 3.3 配置
1. 加载驱动
编译通过后，请运行下述指令加载驱动：
# modprobe dahdi
# modprobe opvxa24xx opermode=CHINA
# dahdi_genconf
提示：在运行完 "modprobe dahdi" 和"modprobe opvxa24xx opermode=CHINA"两条指令后，如果没有任何提示信息输出，则表示驱动加载成功。"opvxa24xx" 为A810E/AE810E的驱动模块，"opermode"只适用于FXO端口，也就是说对FXS不起作用。用户也可以用其它国家制式取代 "CHINA"，请查看文件 ../dahdi-linux-XX/linux/drivers/dahdi/fxo_modules.h 获得其它通信制式。
正常情况下，执行指令 "dahdi_genconf"后, 系统会自动生成 /etc/dahdi/system.conf 和 etc/asterisk/dahdi-channels.conf 两个文件。检查生成的配置文件是否符合您的需求，您也可以手动修改相关参数。值得注意的是，请确认dahdi-channels.conf 包含在chan_dahdi.conf中, 若没有, 请运行指令:
# echo "#include dahdi-channels.conf" >> /etc/asterisk/chan_dahdi.conf
FXO端口使用FXS信令，而FXS端口则采用FXO信令。下图显示的是一部分基本通道配置文件system.conf：
图 6 文件 system.conf
2. 修改国家制式
为了匹配国家通信制式，需要修改一些参数。例如，在中国，请修改参数loadzone和 defaultzone，如下所示:
loadzone = cn
defaultzone = cn
用户可以在文件 .. /dahdi-XX/tools/zonedata.c中查找国家参数。另外，还有一个参数在/etc/asterisk/indications.conf中也需要修改：
country=cn
文件/etc/asterisk/dahdi-channels.conf 的一部分如图所示：
图7 文件dahdi-channels.conf的一部分
修改国家制式后请运行指令：
# dahdi_cfg –vvvvvv
这条指令将从文件system.conf中读取并加载参数到硬件中。指令运行的一部分输出结果显示如下图：
图 8 通道图
3. 启动Asterisk
# asterisk -vvvvvgc
如果Asterisk 已运行，则运行"asterisk –r"代替。在CLI界面中， 请运行：
localhost*CLI> dahdi show channels
图 9 通道状态
如果通道显示全部正确，说明DAHDI已成功加载到 Asterisk中，接下来请设置拨号方案。
4. 编写拨号方案
请在extensions.conf文件中编写拨号方案。下图介绍了一个简单的呼入呼出方案：
# vim /etc/asterisk/extensions.conf
[from-pstn]
exten => s,1,Answer()
exten => s,n,Dial(dahdi/1, ,r)
exten => s,n,Hangup()
[from-internal]
exten => 200,1,Dial(dahdi/7/outgoing_number)
exten => 200,2,Hangup()
提示：用户需要将上述拨号方案中的"outgoing_number"替换成被叫号码。该拨号方案实现如下功能：当内部分机拨200时，呼叫通过通道7（FXO）连接；当呼叫来自PSTN时，Asterisk首先应答，然后通过通道1（FXS）接通内部分机。
设置拨号方案后请运行"asterisk –r", 并在CLI界面中执行指令"reload"，接下来就可以拨号了
附件功能
用户可以通过运行指令"cat /proc/interrupts"查看A810E/AE810E是否有独立的中断，若A810E/AE810E与其它设备共享中断，可能导致板卡不能正常工作。如果需要的话，A810E/AE810E允许用户在固件升级过程中修改中断引脚从而避免中断冲突。
¶ 3.4 EC 模块
执行命令“dmesg | grep VPM” 可以检查是否带有EC模块
[root@localhost ~]# dmesg | grep VPM
OpenVox VPM: echo cancellation supports 32 channels
OpenVox VPM: echo cancellation for 32 channels
OpenVox VPM: hardware DTMF disabled.
OpenVox VPM: Present and operational servicing 1 span(s)
按照下列步骤，启用 EC 模块进行回声消除。
步骤1：如下设置 echocanceller=hwec
#vim /etc/dahdi/system.conf
# Span 1: OPVXA24XX/24 "OpenVox A810 Board 25" (MASTER)
fxoks=1
echocanceller=hwec,1
fxoks=2
echocanceller=hwec,2
fxoks=3
echocanceller=hwec,3
fxoks=4
echocanceller=hwec,4
fxsks=5
echocanceller=hwec,5
fxsks=6
echocanceller=hwec,6
fxsks=7
echocanceller=hwec,7
fxsks=8
echocanceller=hwec,8
# Global data
loadzone = cn
defaultzone = cn
步骤2：编辑文件 /etc/asterisk/chan_dahdi.conf，并设置参数 echocancel=yes.
步骤3：执行命令 "dahdi_cfg -vvv".
当有通话在进行时，执行命令 "lsdahdi", 会发现 EC 被启用
[root@localhost ~]# lsdahdi
### Span 1: OPVXA24XX/24 "OpenVox A810 Board 25" (MASTER)
1 FXS FXOKS (In use) (EC: HWEC - INACTIVE)
2 FXS FXOKS (In use) (EC: HWEC - INACTIVE)
3 FXS FXOKS (In use) (EC: HWEC - INACTIVE)
4 FXS FXOKS (In use) (EC: HWEC - INACTIVE)
5 FXO FXSKS (In use) (EC: HWEC - ACTIVE)
6 FXO FXSKS (In use) (EC: HWEC - INACTIVE) RED
7 FXO FXSKS (In use) (EC: HWEC - INACTIVE) RED
8 FXO FXSKS (In use) (EC: HWEC - INACTIVE) RED
"EC: HWEC" 表示已经启用EC。"ACTIVE" 表示通道 5 有当前通话
¶ 第四章 参考目录
温馨提示：
用户在安装和使用过程中遇到任何问题，请在OpenVox论坛或wiki上查找答案、留言。
¶ 附录 A 硬件指标
• 重量、尺寸
重量(g) : 85g (A810E) 10g (EC模块)
尺寸(mm): 136.3×111.2×16
• 接口
8个工业标准的RJ11接口
PCI-E×1、PCI-E ×2、PCI-E ×4、PCI-E ×8或PCI-E ×16插槽
电源连接头: 12V 4-pin 连接头
•环境
温度: 0 ~50°C (工作) - 40 ~125°C (存储)
湿度: 10 ~90% 非凝结
•功耗
电压: 3.3V/5V/12V，3REN
最大功率损耗: 30.43W（2个FXS-400模块）
7.83W （2个FXO-400模块）
• 硬软件配置要求
RAM 128 + MB
Linux kernel 2.4.X 或 2.6.X
CPU 800+ MHZ
¶ 附录 B RJ11 引脚分配
A810E/AE810E兼容4-pin和6-pin RJ11接口，我们通过下面两个表来说明其引脚分配。
4-pin RJ11
6-pin RJ11
