把Asterisk装备上FXO做成IPPBX

Asterisk系统能够配合一种叫做Zaptel的通信板卡，这种板卡上面又可以支持好多模块实现多种功能。可以连接PSTN、ISDN等等电路网络，从而变成真正意义上的IPPBX，变成中继网关，使得Asterisk的功能再一次更加丰富强大起来。

系统环境：CentOS 4.4，并且预安装开发库以及开发工具（编译需要）。

Zeptel四语音模块TDM400板卡，以及4个FXO语音模块。

基本上需要的源码包有两个：

zaptel-1.4.6.tar.gz

asterisk-1.4.13.tar.gz

注意：安装顺序必须是先Zaptel再安装Asterisk。由于这里不涉及中继电路，所以暂不包含LibPRI部分。

一.编译安装Zaptel：

1.解压Zaptel源码包

[root@IPPBX ~]# tar -zxvf zaptel-1.4.6.tar.gz

2.进入Zaptel包内

[root@IPPBX zaptel-1.4.6]# cd zaptel-1.4.6

3.进行编译Zaptel前的预配置

[root@IPPBX zaptel-1.4.6]# ./configure

4.清除陈旧的已编译文件

[root@IPPBX zaptel-1.4.6]# make clean

5.编译Zaptel

[root@IPPBX zaptel-1.4.6]# make all

6.安装Zaptel

[root@IPPBX zaptel-1.4.6]# make install

二.编译安装Asterisk源码包：

1.解压Asterisk源码包

[root@IPPBX ~]# tar -zxvf asterisk-1.4.13.tar.gz

2.进入Asterisk包内

[root@IPPBX ~]# cd asterisk-1.4.13

3.进行编译Asterisk前的预配置，并制定安装路径。

[root@IPPBX asterisk-1.4.13]# ./configure --prefix=/usr/local

4.清除陈旧的已编译文件

[root@IPPBX asterisk-1.4.13]# make clean

5.编译Asterisk

[root@IPPBX asterisk-1.4.13]# make all

6.安装Asterisk

[root@IPPBX asterisk-1.4.13]# make install

7.安装配置文件模版

[root@IPPBX asterisk-1.4.13]# make samples

8.安装Asterisk程序文档

[root@IPPBX asterisk-1.4.13]# make progdocs

三.前期准备工作：

1.符号连接Asterisk主配置文件路径，为了方便。

[root@IPPBX ~]# ln -s /etc/asterisk/ astetc

2.通过符号连接就可以进入Asterisk主配置文件路径。[root@IPPBX ~]# cd astetc/

3.备份SIP配置文件

[root@IPPBX astetc]# cp sip.conf sip.conf.backup

4.备份IAX2配置文件

[root@IPPBX astetc]# cp iax.conf iax.conf.backup

5.备份拨号规则配置文件

[root@IPPBX astetc]# cp extensions.conf extensions.conf.backup

6.备份Zapata板卡主配置文件

[root@IPPBX astetc]# cp zapata.conf zapata.conf.backup

7.确认Asterisk的各种主要调用路径

[root@IPPBX astetc]# cat asterisk.conf

--------------------------------------------------

[directories]

astetcdir => /etc/asterisk

astmoddir => /usr/local/lib/asterisk/modules

astvarlibdir => /var/lib/asterisk

astdatadir => /var/lib/asterisk

astagidir => /var/lib/asterisk/agi-bin

astspooldir => /var/spool/asterisk

astrundir => /var/run

astlogdir => /var/log/asterisk

以上这些都是Asterisk各种主要调用的路径，这些路径上都分类放置了Asterisk的如配置文件、模块、AGI程序、日志等等各种重要部件。反过来，如果当要卸除Asterisk的时候，也可以参考这些给出的路径，将Asterisk进行完整删除。之前我就卸载过一次Asterisk，直接就是“rm -fr”掉这些路径。

;[options]

;internal_timing = yes

;systemname = my_system_name ; prefix uniqueid with a system name for global uniqueness issues

; Changing the following lines may compromise your security.

;[files]

;astctlpermissions = 0660

;astctlowner = root

;astctlgroup = apache

;astctl = asterisk.ctl

--------------------------------------------------

8.确认Zaptel的模块

[root@IPPBX astetc]# ll /usr/local/lib/asterisk/modules/ |grep chan_zap

--------------------------------------------------

-rwxr-xr-x 1 root root 511766 Nov 9 14:26 chan_zap.so

这个chan_zap.so就是Zaptel的主要模块，如果能够找到这个模块的话那么说明Zaptel基本上成功编译，初步工作成功。

--------------------------------------------------

注意：这个模块的来源是chan_zap.c这件代码，如果当Asterisk进行configure进行环境预检查配置的时候没有发现Zeptel的时候，他不会对chan_zap.c进行编译，所以也不会有chan_zap.so这个模块，因此必定要先搞定Zaptel的安装，然后Asterisk才会把这chan_zap.c 代码件部分加入进去编译成chan_zap.so模块。

四.对Asterisk进行主要配置：

1.配置SIP部分

[root@IPPBX astetc]# vi sip.conf

--------------------------------------------------

[sip](!)

type=friend

host=dynamic

disallow=all

allow=gsm

context=test

[9901](sip)

username=9901

secret=123456

[9902](sip)

username=9902

secrest=123456

--------------------------------------------------

2.配置IAX部分

[root@IPPBX astetc]# vi iax.conf

-------------------------------------------------- [iax](!)

type=friend

context=test

disallow=all

allow=gsm

qualify=yes

host=dynamic

transfer=no

auth=md5

context=test

[8801](iax)

username=8801

secret=123456

[8802](iax)

username=8802

secret=123456

--------------------------------------------------

3.配置拨号规则部分

[root@IPPBX astetc]# vi extensions.conf -------------------------------------------------- [test]

exten => _880X,1,Dial(IAX2/${EXTEN},,r) exten => _990X,1,Dial(SIP/${EXTEN},,r)

[zapfxo2sip]

exten => s,1,Dial(SIP/9901,,r)

exten => h,1,Hangup()

当FXO接受到呼叫拨入的时候，自动转呼叫SIP终端9901。

[zapfxo2iax]

exten => s,1,Dial(IAX2/8801,,r)

exten => h,1,Hangup()

当FXO接受到呼叫拨入的时候，自动转呼叫IAX终端8801。

--------------------------------------------------

五.对Zeptel进行主要配置：

首先要交代Zaptel的几个相关文件。

（1）zapata.conf：这个是Zaptel的主配置文件。

（2）zaptel.conf：这个是Zaptel的硬件配置文件。

（3）zaptel- channels.conf：这个是Zaptel的通道配置文件，它是由zapata.conf生成的，而且它也不是必须的。它是通过include的方式附加在zapata.conf主配置文件外的，完全也可以把通道的配置定义在zapata.conf文件中而不需要该文件。

在安装好的默认情况下，主配置路径/etc/asterisk/下会有一个Zaptel的主属性配置文件zapata.conf，在这个文件中配置了Zaptel部件的全部属性，而且一开始的时候Zeptel也只有这一个配置文件。但是实际上Zeptel不仅仅只有这一个配置文件，它仍然需要其它配置文件，如zaptel.conf以及zapata-channels.conf，但是后来两者是需要由zapata.conf这个主配置文件生成并在这个基础上修改才能使Asterisk-Zaptel工作起来的。接下来就简要交代一下步骤。

1.生成zaptel.conf以及zapata-channels.conf配置文件。

[root@IPPBX astetc]# genzaptelconf

使用这个命令会生成以下两个硬件和通道配置文件，而这两个配置文件是一开始没有的。（1）/etc/zaptel.conf (注意，这个文件是直接在/etc/目录下的。)

（2）/etc/asterisk/zapata-channels.conf

2.分析硬件通道配置文件生成命令

[root@IPPBX astetc]# man genzaptelconf

--------------------------------------------------

NAME

命令名

genzaptelconf -- generates zaptel configuration (TDM adaptors)

生成zaptel配置（时分多路适配器）

DESCRIPTION

描述

genzaptelconf is a script to detect zaptel devices (currently mostly

TDM cards are supported). It generates both /etc/zaptel.conf and

/etc/asterisk/zapata-channels.conf

这是一个用来探测zaptel设备（TDM卡通常支持）的脚本。它会同时生成/etc/zaptel.conf以及/etc/asterisk/zapata-channels.conf这两个文件。

FILES

相关的文件

/etc/zaptel.conf

The configuration file used by ztcfg to configure zaptel

devices. re-written by genzaptelconf

. A backup copy is saved to /etc/zaptel.conf.bak

/etc/zaptel.conf是用来被ztcfg命令调用来配置zaptel设备配置文件。可以通过genzaptelconf 命令来通过重新生成的方式来改写。每次重新生成时，会把原来的配置文件备份成/etc/zaptel.conf.bak。

/etc/asterisk/zapata.conf

The configuration file of Asterisk鈙 chan_zap. Not modified

directly by genzaptelconf. If you want genzaptelconf鈙setting

to take effect, add the following line at the end of zap-

ata.conf:

#include "zapata-channels.conf"

/etc /asterisk/zapata.conf是模块chan_zap.so会首先调用读取的主配置文件。而其它的zaptel 配置文件都是由genzaptelconf生成出来而不是手动写出来的。它其中一个会生成的通道配置文件就是zapata-channels.conf。在zapata.conf的最后加入#include "zapata-channels.conf" 来使zapata.conf主配置文件外连接这个通道配置文件。

/etc/asterisk/zapata-channels.conf

This is the snippet of chan_zap configuration file that gen-

zaptelconf generates.

. A backup copy is saved to /etc/asterisk/zapata-chan-

nels.conf.bak

/etc/asterisk/zapata-channels.conf是由genzaptelconf生成的zaptel通道配置文件，每次重新生成时，会把原来的配置文件备份成/etc/asterisk/zapata-channels.conf.bak。

--------------------------------------------------

3.配置zaptel硬件配置文件

[root@IPPBX astetc]# vi /etc/zaptel.conf

--------------------------------------------------

# Autogenerated by /usr/sbin/genzaptelconf -- do not hand edit

# Zaptel Configuration File

#

# This file is parsed by the Zaptel Configurator, ztcfg

#

# It must be in the module loading order

这个是通过/usr/sbin/genzaptelconf脚本命令生成而来，然后我在这个基础上作一些配置修改。

# Span 1: WCTDM/0 "Wildcard TDM400P REV I Board 1"

fxsks=1

fxsks=2

fxsks=3

fxsks=4

这里是四个模块接口。注意，这里的fxsks的信令模式，其实是表示该四个接口为FXO通道接口。

（理由：FXO通道使用FXS信令，连接的对端是FXS端口，在Asterisk中，配置就是这样反着写的！这个会在Asterisk很多其它地方出现，这里特别声明！）

# Global data

#loadzone = us

#defaultzone = us

这里是指定区域，默认的us被我后来注释掉了。

loadzone = cn

defaultzone = cn

在这里我指定为cn。

--------------------------------------------------

4.察看zaptel的通道配置

[root@IPPBX astetc]# ztcfg -vvv

--------------------------------------------------

Zaptel Version: 1.4.6

Echo Canceller: MG2

Configuration

======================

Channel map:

Channel 01: FXS Kewlstart (Default) (Slaves: 01)

Channel 02: FXS Kewlstart (Default) (Slaves: 02)

Channel 03: FXS Kewlstart (Default) (Slaves: 03)

Channel 04: FXS Kewlstart (Default) (Slaves: 04)

四条FXO端口已经被配置，再特别提醒一边，这里的FXS指的是“FXO端口-使用FXS信令模式-连接FXS对端”，所以标示为FXS。也说明它自己是一个FXO端口。在Asterisk中都是这样“显示相反的”。这个会在Asterisk很多其它地方出现，是使人感到困惑的地方之一，请务必注意。

4 channels to configure.

--------------------------------------------------

5.察看ztcfg命令

[root@IPPBX astetc]# ztcfg --help

--------------------------------------------------

ztcfg: invalid option -- -

Usage: ztcfg [options]

Valid options are:

-c -- Use instead of /etc/zaptel.conf

-d [level] -- Generate debugging output. (Default level is 1.)

-f -- Always reconfigure every channel

-h -- Generate this help statement

-s -- Shutdown spans only

-t -- Test mode only, do not apply

-v -- Verbose (more -v's means more verbose)

--------------------------------------------------

6.配置zaptel通道

[root@IPPBX astetc]# vi zapata-channels.conf

--------------------------------------------------

; Autogenerated by /usr/sbin/genzaptelconf -- do not hand edit

; Zaptel Channels Configurations (zapata.conf)

;

; This is not intended to be a complete zapata.conf. Rather, it is intended

; to be #include-d by /etc/zapata.conf that will include the global settings

这个文件也是通过/usr/sbin/genzaptelconf生成的，然后我在这个基础上作一些配置修改。; Span 1: WCTDM/0 "Wildcard TDM400P REV I Board 1"

;;; line="1 WCTDM/0/0 FXSKS"

signalling=fxs_ks

callerid=asreceived

group=0

context=zapfxo2sip

这个是在拨号方案extenions.conf中的context名称。

channel => 1

context=default

;;; line="2 WCTDM/0/1 FXSKS"

signalling=fxs_ks

callerid=asreceived

group=0

context=zapfxo2sip

channel => 2

context=default

;;; line="3 WCTDM/0/2 FXSKS"

signalling=fxs_ks

callerid=asreceived

group=0

context=zapfxo2iax

channel => 3

context=default

;;; line="4 WCTDM/0/3 FXSKS"

signalling=fxs_ks

callerid=asreceived

group=0

context=zapfxo2iax

channel => 4

context=default

以上指定了四个通道，并对每个通道进行了一些配置修改。

--------------------------------------------------

7.修改zapata主配置文件

[root@IPPBX astetc]# vi zapata.conf

--------------------------------------------------

#include "zapata-channels.conf"

由于通道信息配置在了zapata-channels.conf文件里，所以要把那个文件包含进来。在zapata.conf配置文件最后只需要添加以上这么一行。

--------------------------------------------------

六.启动Asterisk：

1.将Asterisk运行起来

[root@IPPBX ~]# /usr/local/sbin/safe_asterisk

2.查看Asterisk的运行进程信息

[root@IPPBX ~]# ps aux|grep asterisk

--------------------------------------------------

root 3026 0.0 0.0 4432 604 pts/1 S 16:43 0:00 /bin/bash /usr/local/sbin/safe_asterisk

root 3031 1.0 0.1 20756 7256 pts/1 Sl 16:43 0:00 /usr/local//sbin/asterisk -f -vvvg -c root 3069 0.0 0.0 3880 692 pts/1 S+ 16:43 0:00 grep asterisk

--------------------------------------------------

3.查看Asterisk的网络连接状态

[root@IPPBX ~]# netstat -nap|grep asterisk

--------------------------------------------------

tcp 0 0 0.0.0.0:2000 0.0.0.0:* LISTEN 3031/asterisk

udp 0 0 0.0.0.0:2727 0.0.0.0:* 3031/asterisk

udp 0 0 0.0.0.0:4520 0.0.0.0:* 3031/asterisk

udp 0 0 0.0.0.0:5060 0.0.0.0:* 3031/asterisk

udp 0 0 0.0.0.0:4569 0.0.0.0:* 3031/asterisk

unix 2 [ ACC ] STREAM LISTENING 8487 3031/asterisk /var/run/asterisk.ctl

--------------------------------------------------

七.测试：

1.进入控制台

[root@IPPBX astetc]# /usr/local/sbin/asterisk -crvvvg

--------------------------------------------------

Asterisk 1.4.13, Copyright (C) 1999 - 2007 Digium, Inc. and others.

Created by Mark Spencer

markster@https://www.360docs.net/doc/f014718535.html,

>

Asterisk comes with ABSOLUTELY NO WARRANTY; type 'core show warranty' for details.

This is free software, with components licensed under the GNU General Public

License version 2 and other licenses; you are welcome to redistribute it under

certain conditions. Type 'core show license' for details.

=========================================================================

== Parsing '/etc/asterisk/asterisk.conf': Found

== Parsing '/etc/asterisk/extconfig.conf': Found

Connected to Asterisk 1.4.13 currently running on IPPBX (pid = 3031)

-- Remote UNIX connection

Verbosity is at least 3

调整排错等级

IPPBX*CLI> core set debug 255

Core debug was 0 and is now 255

调整显示信息等级

IPPBX*CLI> core set verbose 255

Verbosity was 3 and is now 255

显示Zaptel的通道

IPPBX*CLI> zap show channels

Chan Extension Context Language MOH Interpret

pseudo default default

1 zapfxo2sip default

2 zapfxo2sip default

3 zapfxo2iax default

4 zapfxo2iax default

重新载入zaptel通道模块

IPPBX*CLI> reload chan_zap.so

The 'reload' command is deprecated and will be removed in a future release. Please use 'module reload' instead.

-- Reloading module 'chan_zap.so' (Zapata Telephony)

== Parsing '/etc/asterisk/zapata.conf': Found

== Parsing '/etc/asterisk/zapata-channels.conf': Found

--------------------------------------------------

2.注册软终端

这里我注册了两个软终端如下

（1）SIP终端9901

--------------------------------------------------

-- Registered SIP '9901' at 192.168.0.199 port 22058 expires 3600

-- Saved useragent "eyeBeam release 1004p stamp 31962" for peer 9901

[Nov 9 16:49:01] NOTICE[3057]: chan_sip.c:14719 handle_request_subscribe: Received SIP subscribe for peer without mailbox: 9901

Really destroying SIP dialog 'MzJjZDZiZTYxYTE3NWFkMDFlYTJiMTJkYWVlMjRlYWM.' Method: SUBSCRIBE

--------------------------------------------------

（2）IAX终端8801

--------------------------------------------------

-- Registered IAX2 '8801' (AUTHENTICATED) at 192.168.0.199:4569

[Nov 9 16:49:29] NOTICE[3044]: chan_iax2.c:5933 update_registry: Restricting registration for peer '8801' to 60 seconds (requested 300)

Really destroying SIP dialog 'NGZiMDcyMTBiMTM2ZWUxMGQ1ZmE1N2ViY2EzYTFlNTg.' Method: REGISTER

--------------------------------------------------

3.连接Zaptel模块的FXO端口

Zaptel板卡FXO端口1、2、3、4都通过电话线接入PBX交换机，从PBX交换机中得到馈电。

4.通过PSTN呼叫Zaptel的FXO端口1，它会转呼叫SIP/9901这个软终端。

--------------------------------------------------

[Nov 9 16:50:01] NOTICE[3057]: chan_sip.c:14719 handle_request_subscribe: Received SIP subscribe for peer without mailbox: 9901

Really destroying SIP dialog 'ZjM2YTdlODJkOTk3NzA4YzVmMzU3MDVmODMyMGZlYzc.' Method: SUBSCRIBE

-- Starting simple switch on 'Zap/1-1'

[Nov 9 16:50:31] NOTICE[3099]: chan_zap.c:6371 ss_thread: Got event 18 (Ring Begin)...

[Nov 9 16:50:32] NOTICE[3099]: chan_zap.c:6371 ss_thread: Got event 2 (Ring/Answered)...

-- Executing [s@zapfxo2sip:1] Dial("Zap/1-1", "SIP/9901||r") in new stack

-- Called 9901

-- SIP/9901-0964bea8 is ringing

-- SIP/9901-0964bea8 answered Zap/1-1

== Spawn extension (zapfxo2sip, s, 1) exited non-zero on 'Zap/1-1'

-- Executing [h@zapfxo2sip:1] Hangup("Zap/1-1", "") in new stack

== Spawn extension (zapfxo2sip, h, 1) exited non-zero on 'Zap/1-1'

-- Hungup 'Zap/1-1'

Really destroying SIP dialog

[email=%2776ee83ac3b328e52062eea0f5d448616@192.168.0.100%27]'76ee83ac3b328e52062 eea0f5d448616@192.168.0.100'[/email]

Method: BYE

--------------------------------------------------

5.通过PSTN呼叫Zaptel的FXO端口3，它会转呼叫IAX2/8801这个软终端。

--------------------------------------------------

[Nov 9 16:55:02] NOTICE[3057]: chan_sip.c:14719 handle_request_subscribe: Received SIP subscribe for peer without mailbox: 9901

Really destroying SIP dialog 'MzVhMzRmYWExZDM3ZjQwOGI2MWIzMzBhOWJjYTgyMGI.' Method: SUBSCRIBE

-- Starting simple switch on 'Zap/3-1'

[Nov 9 16:56:55] NOTICE[3122]: chan_zap.c:6371 ss_thread: Got event 18 (Ring Begin)...

[Nov 9 16:56:56] NOTICE[3122]: chan_zap.c:6371 ss_thread: Got event 17 (Polarity Reversal)...

-- Executing [s@zapfxo2iax:1] Dial("Zap/3-1", "IAX2/8801||r") in new stack

-- Called 8801

-- Call accepted by 192.168.0.199 (format gsm)

-- Format for call is gsm

-- IAX2/8801-1 is ringing

-- IAX2/8801-1 answered Zap/3-1

-- Hungup 'IAX2/8801-1'

== Spawn extension (zapfxo2iax, s, 1) exited non-zero on 'Zap/3-1'

-- Executing [h@zapfxo2iax:1] Hangup("Zap/3-1", "") in new stack

== Spawn extension (zapfxo2iax, h, 1) exited non-zero on 'Zap/3-1'

-- Hungup 'Zap/3-1'

--------------------------------------------------

OK，到这里成功了，虽然是比较简单的测试模型。一些用例也是出于最基本的原则考虑的。但是在国内Asterisk的可用参考相当说，中文的、可以参考一下资料想也不要想，基本上没有，关于Zaptel的部分更加凤毛麟角。这篇虽然不复杂，但是过程中遇到许多问题，然后研究了不少国外文档才摸索出来的。不过这样印象也反而深刻。希望这份文档能够帮助和我一样的人，尽可能多的减少精神损耗以及研究阻力。