融合通信专栏>>手册下载>>
 
Dialogic Dialogic Global Call协议3.0
Linux和Windows版本
软件说明
 
 

关于技术支持， 请访问下面网站关于Dialogic电信支持资源
http://www.Dialogic.com/
关于产品和服务信息，请访问Dialogic通信系统产品网站:
http://www.Dialogic.com/
关于销售和其他信息， 请访问Dialogic电信建筑模块销售网页: http://www.Dialogic.com/

■ 关于这个文档

　　这个文件里包含下面部分：

  • 目的
  • 针对的读者
  • 如何使用这个文档
  • 相关信息

　　目　的

　　这个文档描述了Dialogic Dialogic Globalcall协议3.0 Linux和Windows版本的优点， 也提供了安装指导。

　　针对的读者

　　这个发布文档针对需要使用GlobalCall API在DM3和Springware板卡上开发模拟， E1 CAS或T1 robbedbit技术的用户。

　　如何使用这个文档

　　这个文档为了使信息可以更快地被找到进行了组织。 主要包括：

  • 软件概述
  • 系统需求
  • 新功能
  • 安装
  • 配置
  • 解决的问题
  • 已知的问题
  • 限制
  • 文档

　　相关信息

　　请参考下面信息:

  • Global Call 国家相关参数参考手册，这也在软件里提供，描述了每个协议可修改的CDP参数
  • "在线书架"包括了编程指南和参考信息，可用来帮助开发GlobalCall应用程序。
  • Dialogic 电信支持资源网站 http://www.Dialogic.com/ 提供了广泛的信息， 包括技术文档， 问题跟踪报告，应用程序指南和其它有益的信息。

■ 软件概述

　　Dialogic Dialogic GlobalCall 协议3.0 Linux 和 Windows版介绍了DM3板卡上的PDK协议。 几乎所有在Springware上支持的协议现在都可以在DM3上运行。 这个版本也包括了一些PDK协议的增强来支持更多的国家和交换机。 请参考新功能部分，来了解DM3和Springware协议。

　　所有GlobalCall 2.0的SpringWare PDK 和ICAPI 协议在这个版本里还会被继续支持

　　注意:尽管ANAPI和ICAPI协议在这个版本中被支持。 客户应该移植到PDK里面的相应协议。 新协议的开发和现存协议的支持都只针对PDK。 对于没有相应支持的PDK协议的ICAPI协议， 客户应该尽早开一个功能请求来生成PDK协议。

■ 系统要求

　　对于GlobalCall 3.0 协议系统要求包括下面部分：

  • Linux 系统要求
  • Windows 系统要求

　　Linux系统要求

　　使用GlobalCall3.0 协议Linux系统需要下面Dialogic Dialogic系统软件:

  • 如果要使用DM3板卡上的协议， 需要系统软件 5.1 Linux版要装 Service Pack 1 (或更高)
  • Springware卡需要Linux 系统软件5.1. 请参考Release Guide看它所需要的软硬件环境。

　　Windows系统要求

　　使用GlobalCall3.0 协议Windows系统需要下面Dialogic Dialogic系统软件:

  • 如果要使用DM3板卡上的协议， 需要系统软件 5.1 Windows版要装 Service Pack 1 (或更高)
  • Springware卡需要Windows 系统软件5.1. 请参考Release Guide看它所需要的软硬件环境。

■ 新功能

　　这个版本的新功能包括下面部分:

  • 新的协议
  • 修改的协议
  • 支持DM3板卡的协议
  • PDK协议的优点

　　有很多PTR 被修正，请参考已解决问题部分.

　　这个版本中的新协议

　　下面的协议是这个版本中的新协议。这些协议可以用在 DM3 和 SpringWare 板卡上， 除了 Alcatel VPS 4x00 是专门给 SpringWare 用的。如需要DM3板卡上支持的全部的协议，参考下面DM3板卡协议支持部分。

  • Alcatel VPS for 4x00 Switch (只支持SpringWare) ( pdk_sw_vps_4x00_io )
  • CCITT R2 (pdk_ccitt_r2_io)
  • Hong Kong DTMF (pdk_hk_dtmf_io)
  • Indonesia E&M (pdk_id_em_io)
  • Korea R2 (pdk_kr_r2_io)
  • Lucent Lineside E-1 (pdk_sw_e1_luls_io for DM3, pdk_sw_e1_fxs_io for SpringWare)
  • Malaysia R2 (pdk_my_r2_io)
  • Nortel Meridian Lineside E-1 (pdk_sw_e1_ntmd_io for DM3, pdk_sw_e1_fxs_io for SpringWare)
  • Pakistan R2 (pdk_pk_r2_io)
  • Philippines R2 (pdk_ph_r2_io)
  • Singapore R2 (pdk_sg_r2_io)
  • Taiwan Modified R1 (pdk_tw_mr1_io)
  • Thailand R2 (pdk_th_r2_io)
  • Vietnam R2 (pdk_vn_r2_io)

　　修改的协议

　　下面的协议在这个版本中被修改:

  • Alcatel 4400 Switch E-1 FXS: 新的CDP文件, pdk_sw_e1_ac4400_io.cdp
  • North American Analog (SpringWare only): 增加了新的参数, CDP_Timeout_Wait_For_RingOff_When_Drop_In_Offered
  • US MF T-1: 增加了新的呼叫转移参数

　　支持 DM3 板卡的协议

　　除了上面列的新协议，几乎所有过去在Springware板卡上的PDK协议现在都支持DM3板卡。表1列出了支持的协议

表 1. 支持SpringWare 和 DM3 板卡的 PDK 协议

　　PDK 协议的优点

　　Global Call PDK 协议 (和 PDK 运行时呼叫控制库，PDKRT 通过GlobalCall API支持)代表了下一代协议的实现。 我们建议你把基于PDK的协议放到你未来软件计划中，那样你就可以使用计划的功能和未来协议的更新。尽可能的情况下，应该使用PDK协议而不是ANAPI和ICAPI协议，下面是原因：

  • 每个项目实施点特定的参数
    和ANAPI和ICAPI协议相比，PDK协议可以通过.cdp文件配置更多协议相关参数允许更多在现场的改变。而且，PDK协议也可以使用.sdp文件，它包含了每个项目实施点特定的参数，它们可以重载.cdp文件中的相应参数。更多关于.sdp文件的信息，请参?quot;GlobalCall E-1/T-1技术用户手册"。

  • 基于SpringWare 和 基于DM3产品的兼容
    希望增加基于DM3产品来增强他们现有应用的用户，PDK协议可以兼容Springware和DM3的产品。

  • 基于PDK的未来的协议和功能
    因为PDK协议更加容易配置和实施，未来所有的协议和协议功能要求都要基于PDK协议实施

  • 支持未来Global Call API 功能
    和ANAPI 或 ICAPI 协议不同, PDK 协议可以增加或修改来使用未来的GlobalCall API的特性，例如运行时配置管理（RTCM），GlobalCall告警管理系统（GCAMS），GlobalCall增强呼叫模型（GCCME），和功能透明扩展(FTE).

  • PDK 协议支持呼叫路由
    PDK 协议通过GCST_CALLROUTING支持内呼的呼叫路由。请参考GlobalCall编程手册了解更多关于GCST_CALLROUTING 的状态。

■ 安　装

　　GlobalCall协议3.0版本的安装有下面两个部分：

  • 在Linux系统上安装GlobalCall协议

  • 在Windows系统上安装GlobalCall协议

　　在Linux系统上安装GlobalCall协议

　　安装GlobalCall协议之前，要确认Dialogic Dialogic系统软件Linux版已经被安装。更多信息请参考系统需求部分

　　如果你安装了老的GlobalCall协议版本，你应该在安装新版本之前卸载。

　　如下安装GlobalCall协议3.0:

1. 以root登录Linux系统
2. 插入GlobalCall协议光盘。如果你的系统不是在CD-ROM插入光盘就直接mount的话，输入下面命令来把CD mount到/mnt/cdrom:
mount /dev/cdrom /mnt/cdrom
关于Linux上mount一个目录的更多信息，请参考操作系统的手册。
3. 假设 CD-ROM 已经被 mount 到 /mnt/cdrom 目录，请输入下列命令来切换并列出目录内容
cd /mnt/cdrom/linux/i386
ls -al
这个目录列表应该包含GlobalCall协议包
DLGCgcpr-3.00-x.i386.rpm 和 install.sh 脚本.
4. 输入下列命令来运行安装脚本
./install.sh
下面信息会被显示
Dialogic Dialogic Global Call Protocols 3.00 for Linux INSTALLATION
You will now have the opportunity to install software packages.
After the menu is displayed, enter the package number(s) of the desired
packages, separated by a space. Enter A for all packages, Q to quit.
Package dependencies will be automatically resolved during installation. For example, selecting a single package will automatically install packages required for that selection.
Press ENTER to display the menu of packages:
5. 按回车键。安装包的菜单会被显示:
Item Package Description
1 Dialogic Dialogic Global Call Protocols 3.00
A Install All
Q Quit Installation
Enter the packages you wish installed, separated by a space, or [A,a,Q,q]:
6. 按 1 或 A 键安装GlobalCall协议包
7. 根据屏幕的指令来完成安装。软件被安装在/usr/Dialogic目录。当安装完成后，软件包的菜单又会被显示
8. 按 Q 退出. 当你退出后，会显示下列信息
Quitting the installation tool by request.
If you installed software, you must now configure
CDP file/files and pdk.cfg for DM3.

　　安装GlobalCall协议后，你可以配置CDP文件；请参考下面的配置部分。而且为了在DM3板卡上使用协议，一定要运行下面的步骤，在"配置DM3板卡运行PDK协议"部分
　　注意: 如果你需要卸载Dialogic Dialogic系统软件，请先卸载GlobalCall协议

　　在Windows系统上安装GlobalCall协议

　　安装GlobalCall协议之前，要确认Dialogic Dialogic系统软件Linux版已经被安装。更多信息请参考系统需求部分
　　如果你安装了老的GlobalCall协议版本，你应该在安装新版本之前卸载。
　　如下安装GlobalCall协议3.0:

　　1.退出所有程序
　　2.插入GlobalCall协议光盘
　　3.如果安装过程没有自动启动，请在CD-ROM中浏览找到setup.exe程序并双击安装过程显示一个欢迎界面，然后是一系列窗口，包括软件协议和安装目录等窗口。(缺省是 C:\Program Files\Dialogic).
　　4.根据屏幕上的指令完成安装
　　5.当安装完成时，选择重启动机器

按 Finish. 安装GlobalCall协议后，你可以配置CDP文件；请参考下面的配置部分。而且为了在DM3板卡上使用协议，一定要运行下面的步骤，在"配置DM3板卡运行PDK协议"部分

注意: 如果你需要卸载Dialogic Dialogic系统软件，请先卸载GlobalCall协议.

■ 配　置

　　下面部分提供的信息有:

  • 配置.cdp参数
  • 配置DM3板卡运行PDK协议

　　配置.cdp参数

　　每个协议包含一个独立的模块化的二进制文件。用户可选择的选项允许为国家特定的参数进行定制，可以适应一个国家中的应用和配置。(例如, 一个国家中的交换机可能使用相同的协议，但是需要不同的参数) 关于国家相关参数，请参考Global Call 国家相关参数 (CDP) 手册 .

　　配置DM3板卡运行PDK协议

　　安装完GlobalCall协议3.0以后，下面解释如何配置DM3板卡运行PDK协议:

  • 在Linux系统上配置DM3板卡
  • 在Windows系统上配置DM3板卡

　　在Linux系统上配置DM3板卡

　　在DM3板卡上使用PDK协议，需要执行下面步骤:

1. 停止Dialogic服务如果它在运行的话

2. 创建／编辑文件 /usr/Dialogic/cfg/pdk.cfg 为每一块DM3板卡按照下面格式添加一行:
board <b> fcdfile <f> pcdfile <p> variant <v>
其中:
<b> 是板卡的逻辑号
<f> 是在pyramid.scd文件中为每个板卡配置的 .fcd 文件
<p> 是在pyramid.scd文件中为每个板卡配置的 .pcd 文件
<v> 是协议的CDP文件名，例如,pdk_ar_r2_io.cdp.

3. 启动板卡

　　在Windows系统上配置DM3板卡

　　执行下面步骤在DM3板卡上配置PDK协议：

1. 停止Dialogic服务如果它在运行的话

2. 执行 -pdkmanagerregsetup add"

3. 创建／编辑文件 \Program Files\Dialogic\cfg\pdk.cfg为每一块DM3板卡按照下面格式添加一行::
board <b> fcdfile <f> pcdfile <p> variant <v>
其中:
<b> 是板卡的逻辑号
<f> 是在DCM中为每个板卡配置的 .fcd 文件
<p> 是在DCM中为每个板卡配置的 .pcd 文件
<v> 是协议的CDP文件名，例如,pdk_ar_r2_io.cdp.

4. 运行DCM启动板卡

■ 解决的问题

　　表2里是以前GlobalCall协议软件在3.0这个版本中已解决，用PTR号码进行标试。对于每个PTR, 提供下面信息:

  • PTR 号码: 这个号码用来标识这个问题
  • 描述: 问题的概述

表 2. 这个版本中已解决的问题

PTR 号码
描述
23943 When using the pdk_us_ls_fxs_io protocol, if a program executes gc_OpenEx( ) followed by gc_Close( ) and then gc_OpenEx( ) again while the FXO side is waiting for a call, then an unsolicited GCEV_OFFERED event is seen by the FXO side.
24881 When using the pdk_us_mf_io.cdp file, setting the parameter CDP_OUT_WinkStart = 0 causes the program to fail with a disconnect making a call as soon as gc_MakeCall( ) is executed.
25511 DROPCALL is not supported on ANAPI or PDK Analog protocol while in the OFFERED or ACCEPTED state.
25543 When using the pdk_us_mf_io.cdp file, setting the parameter CDP_IN_DialTone_Needed = 1 does not produce a dialtone when the calling party seizes the line.
25593 When using the PDK Analog protocol, a disconnect event is not received when the called party answers and then immediately drops the call.
25822 PDK E-1 protocols may have channels hang forever while dropping a call if other side has already sent the IDLE pattern.
25878 The pdk_us_mf_io protocol does not work in Feature Group B and with expanded Call Analysis.
25984 When using the pdk_ar_r2_io.cdp file on DM3, a GCEV_ANSWERED event is not generated the first time a call is answered.
26106 When using the pdk_ar_r2_io protocol on DM3, if channel is set to out-of-service then back to in-service again, and the remote channel state has changed between the two operations, the remote channel state is not reported correctly by the protocol after being set back to in-service
26108 On DM3, when using Malaysia, Philippines, Singapore, Pakistan, Thailand, and CCITT R2 PDK protocols on the inbound side, gc_GetANI( ) retrieves the correct ANI information, but appended with 'f' at the end.
26145 When using the Hong Kong DTMF PDK protocol ( pdk_hk_dtmf_io), the protocol hangs when receiving an inbound call if the CDP_R2CallScenario parameter is set to 2.
26790 The pdk_us_mf_io protocol does not transmit CAS_HANGUP in the time-out condition until gc_DropCall( ) is received.
27006 An immediately aborted blind transfer causes ports/channels to lock up.

■ 已知问题

　　表3里是以前GlobalCall协议软件在3.0这个版本中已解决，用PTR号码进行标试。对于每个PTR, 提供下面信息:

  • PTR 号码: 这个号码用来标识这个问题
  • 描述: 问题的概述，也包括问题的回避办法

表 3. 已知问题

PTR 号码
描述
26022 On DM3, when using the pdk_us_ls_fxs_io.cdp file, setting the parameter CDP_WaitDialToneEnabled = 1 causes gc_BlindTransfer( ) to fail.
This is a problem with the System Release, not with the Global Call Protocols package. The problem is scheduled to be resolved in the next System Release.
27103 The Italy E-1 Bidirectional for PDKRT protocol ( pdk_it_e1_io) does not function properly. One pulse digit notification is being missed, resulting in time-out and loss of a call.
This is a problem with the System Release, not with the Global Call Protocols package. The problem is scheduled to be resolved in the next System Release.

■　限　制

　　这个软件版本的限制有：

  • 不支持DM3板卡上的重叠收／发. 如果一个PDK协议支持重叠收发，用在DM3板卡上，这个功能就不能使用。
    这是一个系统软件的问题，不是GlobalCall协议包的问题。这个问题计划在下一个系统软件版本里解决。

  • 使用美国 T-1 双向 ICAPI 协议 ( us_mf_io), $1 参数 (无应答之前的振铃数) 没有作用，这是一个永久的限制。你可以使用这个协议的PDK版本(pdk_us_mf_io) 如果你需要这个功能，这可以通过使用gc_SetCallProgressParm( ) 实现.

■　文 档

　　下面文档随这个版本一起提供:

  • Dialogic Dialogic Global Call 协议 3.00版本 Linux 和 Windows 软件手册(本文档)
  • Global Call 国家相关参数 (CDP) 参考手册

参考系统软件的在线书架了解更多信息http://www.Dialogic.com/

 

 

 


[ 全文英文版 ]

 


融合通信专栏>>手册下载>>