Keygoe系统版本发布说明书(for Linux)

Keygoe 系统版本发布说明书

V3.1.2

修订记录

本文档的版权归深圳市东进通讯技术股份有限公司所有，受中华人民共和

国法律的保护。东进公司有权在未经申明的情况下对文档的内容做必要的

改动，且不另行通知，更改的内容将会补充到本文档中。

本文档力求准确说明Keygoe 系统，但由于产品的更新和修订，东进公司

不保证您所购买的产品和本文档内容完全一致，并对此所导致的错误及产

生的后果不承担任何法律责任。

除特别声明外，此文档所用的公司名称、个人姓名及数据均属为说明的目

的而拟定。

本文档所含的任何构思、设计、工艺及其他技术信息均属本公司所有，受

中华人民共和国法律的保护。未经本公司书面同意，任何单位和个人不得

擅自摘抄、全部或部分复制本书内容，或者以其他任何方式使第三方知悉。

注册商标说明

东进、DONJIN 、Keygoe 是深圳市东进通讯技术股份有限公司的注册商标。

Microsoft 、Windows 、Windows Server是微软的注册商标。

第2页共32页

引言 ....................................................................................................................................... 5

1.1 产品支持服务 ................................................................................................................ 5

2. 安装包DJKeygoe V 3. 1.2（Linux ）中相关改进 . ............................................................... 6

2.1 具体内容 ........................................................................................................................ 6

2.1.1 特别提示.............................................................................................................. 6

2.1.2 新增功能.............................................................................................................. 6

2.1.3 改进和提高 . ......................................................................................................... 7

2.1.4 帮助文档.............................................................................................................. 7

3. 安装包DJKeygoe V 3. 1.0中相关改进 ................................................................................ 8

3.1 具体内容 ........................................................................................................................ 8

3.1.1 特别提示.............................................................................................................. 8

3.1.2 新增功能.............................................................................................................. 8

3.1.3 改进和提高 . ....................................................................................................... 10

3.1.4 其他 ................................................................................................................... 11

4. 安装包DJKeygoe V3.0_SP1_for_K200中相关改进 ......................................................... 12

4.1 具体内容 ...................................................................................................................... 12

4.1.1 特别提示............................................................................................................ 12

4.1.2 新增功能............................................................................................................ 12

4.1.3 改进和提高 . ....................................................................................................... 12

4.1.4 其他 ................................................................................................................... 12

5. 安装包DJKeygoe V 3.0_SP1中相关改进 . ......................................................................... 13

5.1 具体内容 ...................................................................................................................... 13

5.1.1 特别提示............................................................................................................ 13

5.1.2 新增功能............................................................................................................ 13

5.1.3 改进和提高 . ....................................................................................................... 14

5.1.4 其他 ................................................................................................................... 14

6. 安装包DJKeygoe V 3.0.2中相关的改进 ........................................................................... 15

6.1 相关改进 ...................................................................................................................... 15

6.2 具体内容 ...................................................................................................................... 15

6.2.1 特别提示............................................................................................................ 15

6.2.2 新增功能............................................................................................................ 16

6.2.3 改进和提高 . ....................................................................................................... 19

6.2.4 其他 ................................................................................................................... 20 1.

安装包DJKeygoe V 2.3.0中相关的改进 ........................................................................... 21

7.1 相关改进 ...................................................................................................................... 21

7.2 具体内容 ...................................................................................................................... 21

7.2.1 特别提示............................................................................................................ 21

7.2.2 新增功能............................................................................................................ 22

7.2.3 改进和提高 . ....................................................................................................... 25

7.2.4 其他 ................................................................................................................... 26

8. 安装包DJKeygoe V 2.2.0中相关的改进 ........................................................................... 27

8.1 相关改进 ...................................................................................................................... 27

8.2 具体内容 ...................................................................................................................... 27

8.2.1 特别提示............................................................................................................ 27

8.2.2 新增功能............................................................................................................ 27

8.2.3 改进和提高 . ....................................................................................................... 28

8.2.4 其他 ................................................................................................................... 29

9. 安装包DJKeygoe V 2.1.1_sp1中相关的改进 . ................................................................... 30

9.1 相关改进 ...................................................................................................................... 30

9.2 具体内容 ...................................................................................................................... 30

9.2.1 特别提示............................................................................................................ 30

9.2.2 新增功能............................................................................................................ 30

9.2.3 改进和提高 . ....................................................................................................... 30

9.2.4 其他 ................................................................................................................... 30

10. 安装包DJKeygo V 2.1.1中相关的改进 . ............................................................................ 31

10.1 相关改进 .................................................................................................................... 31

10.2 具体内容 .................................................................................................................... 31

10.2.1 特别提示.......................................................................................................... 31

10.2.2 新增功能.......................................................................................................... 31

10.2.3 改进和提高 . ..................................................................................................... 31

10.2.4 其它 ................................................................................................................. 32

1. 引言

本文档主要记录每次DJKeygoe 安装包版本升级后，新版本所支持的新的功能或者修正的软件BUG 信息。在使用Keygoe 时，当出现异常现象，请阅读本文档，并检查问题是否能够通过更新软件版本来解决。

1.1 产品支持服务

在使用本公司产品时遇到困难时，请先仔细阅读本文档，其中对于普遍遇到的问题提供了可以采取的步骤。当没有找到问题的答案时，一个有效的方法是访问我们的网站www.donjin.com ，查找有关产品的最新消息或问题解答。

深圳市东进通讯技术股份有限公司将努力改进产品和相关的用户手册，使其更便于使用，您的意见对于我们的工作非常重要，您可以用您喜欢的任何方式告诉我们。我们技术支持的联系地址与电话是：

深圳东进通讯技术股份有限公司总部

⏹

⏹ 邮编：518040 电话：0755-83636988 83435288 传真：0755-83631239 83846752 网址：www.donjin.com 地址：深圳市福田区车公庙泰然工贸园苍松大厦南座21层

东进技术营销中心

⏹

⏹ 邮编：100083 电话：010-82390098 传真：010-82390028 地址：北京市海淀区王庄路1号清华同方科技广场B 座11层D 座

2. 安装包DJKeygoe V 3. 1.2（Linux ）中相关改进

安装包由DJKeygoe V 3.0.4（Linux ）升级为DJKeygoe V 3. 1.2（Linux ）。本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

说明

关于DJKeygoe V3.1.2的帮助文档，下载链接

为： http://www.donjin.com/chinadonjin/uploadfolder/otherfile/files/DJKeygoe手册-V3.1.2.rar

2.1 具体内容

2.1.1 特别提示

如果要升级到Keygoe V3.1.2（Linux ）版本：

当用户系统为Keygoe V2.3.0或以上版本，可在安装新的软件包时，选择“恢复上一次卸载时的INI 配置文件”，即可平滑进行系统的升级。

当用户系统为Keygoe V2.3.0之前的版本，不能平滑升级到V3.1.2。需要在安装完成V3.1.2之后，重新对业务进行配置。

此版本的所有帮助文档不再统一打进安装包，需用户自己手动下载。

2.1.2 新增功能

与DJKeygoe V 3. 1.0相同，具体请参加“3.1.2 新增功能”。

2.1.3 改进和提高

与DJKeygoe V 3. 1.0相同，具体请参见“3.1.3 改进和提高”。

2.1.4 帮助文档

DJKeygoe3.1.2（Linux ）帮助文档的说明如下：

DJKeygoe V 3. 1.2（Linux ）使用DJKeygoe V 3. 1.0的帮助文档。

除了《Keygoe 系统安装配置手册（简约版）》、《Keygoe 系统安装配置手册（经典版）》与《Keygoe 系统例子程序与常用工具使用指导》内容有变动，版本号更新为3.1.2，其他文档无变动。

3. 安装包DJKeygoe V 3. 1.0中相关改进

DJKeygoe 安装包的版本号由V3.0_SP1升级为V3.1.0。

本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

说明

关于DJKeygoe V3.1.0的帮助文档，下载链接为：

3.1 具体内容

3.1.1 特别提示

如果系统要升级到Keygoe V3.1.0版本：

当用户系统为Keygoe V2.3.0版本，可在安装新的软件包时，选择“恢复上一次卸载时的INI 配置文件”，即可平滑进行系统的升级。

当用户系统为Keygoe V2.3.0之前的版本，不能平滑升级到V3.1.0。需要在安装完成V3.1.0之后，重新对业务进行配置。

此版本的所有帮助文档不再统一打进安装包，需用户自己手动下载。

3.1.2 新增功能

⏹ 快速配置

界面新增的快速配置功能，让各种信令的配置变得简单快捷。

在绝大部分的配置场景中，快速配置之后，系统便可以正常运行。

具体请参见《Keygoe 系统安装配置手册（简约版）》中的“2.3 运行主界面开始配置”。

⏹ 双界面切换

增加了简约配置界面，保留了以前的经典配置界面，点击主界面切换按钮，可切换到以前的经典界面。

新界面可以对DSP 的E1接口、ISDN 、SS7、V oIP 等信令的参数进行快速配置。同时可以在一个界面查看监控各种状态，包括E1通道状态、ISDN 链路状态、SS7链路状态（MTP2，MTP3）以及V oIP 的各种参数和各种系统状态。 ⏹ 支持远程配置

新界面支持对远端配置管理的连接以及各种模块的配置操作和状态查看。可以在新界面中对远端DSP 以及各种模块的参数进行配置，也可以在新界面中查看各种远端模块的状态。

⏹ 支持K200与Keygoe 两种模式

新配置界面既可以支持传统的Keygoe 配置，也可以支持K200的配置。

在配置服务器IP 地址时，在ITPCfgIpSet.exe 主界面中有“Keygoe 交换机”与“Keygoe 板卡”两个选项，具体请参见《Keygoe 系统安装配置手册（简约版）》中的“2.2 配置服务器IP 地址”。

在“Keygoe 板卡”模式下，“设备及协议配置”节点下增加了“KDSP 配置”子节点，具体请参见《Keygoe 系统安装配置手册（简约版）》中的“2.4.2 KDSP配置”。

⏹ 支持告警功能

Keygoe 新界面支持告警功能。当系统出现告警信息时，新界面的告警图标会变亮，提示系统出现告警信息。点击告警可查看实时告警信息，也可搜索历史告警信息，并可对告警信息进行分类查询。告警信息分为普通告警、停止告警和严重告警三个级别。

具体可参见《Keygoe 系统安装配置手册（简约版）》中的“3.3 告警中心”。 ⏹ 支持跨网段搜索DSP 功能

新界面支持跨网段搜索DSP 的功能，但是必须是在同一网关下不同网段的DSP ，并且DSP 的固件必须是3.1.0或以上版本。

关于DSP ，有以下两点说明：

⏹ 搜索DSP 时，显示DSP 的socket 状态，具体请参见《Keygoe 系统安装配

置手册（经典版）》中的“5.8 查看DSP socket状态”。

导出DSP 证书，具体请参见《Keygoe 系统安装配置手册（经典版）》中

的“5.7 导出授权码”。 ⏹

⏹ 支持批量授权

新界面支持同时加载多个DSP 授权文件的功能。

关于查看授权文件，请参见《Keygoe 系统安装配置手册（简约版）》中的“3.1.2 查看授权文件”。

⏹ 支持Windows 7 和Windows2008的64位操作系统

支持各种例子程序在64操作系统下的编译运行。

⏹ 工具及例子

在ITPCfgIpSet.exe 工具中增加“模块IP 维护”与“DSP 板更换”功能，具体请参见《Keygoe 系统例子程序与常用工具使用指导》中的“2.1 Keygoe配置管理器IP 设置”。

例子程序支持C#、Delphi 、Java 等多语言编程，具体见《Keygoe 系统编程指南》中的“第4章使用各种语言编程”。

3.1.3 改进和提高

本版本解决了如下问题：

⏹

⏹ 重启远端服务后，DSP 与远端服务无法连接。功能模块重启后，流程没有向应用程序上报事件。添加模块失败后配置文件被写乱。跨平台V oIP 终端之间呼叫单通。 V oIP 设备退出会议的一些问题。 DSP 负载不均衡：V oIP 呼入选择V oIP 通道采用轮询机制，从其中一个

DSP 的最后一个V oIP 通道倒数轮询呼叫, 导致V oIP 呼入集中在一个DSP 上，使得DSP 负载不均衡。

⏹ 会议中如果VOC 设备和IP 设备的ChannelID 一致，在IP 退出会议时语

3.1.4 其他音设备之间出现单通现象。 ⏹ 开启Keygoe 系统日志后，应用程序加载内存索引导致媒体模块崩溃。 ⏹ SS7模块有闪断现象。 ⏹ 关于V oIP 模块中RTP 流中断超时。 ⏹ 对电信交换机有时发送的CQM 消息，Keygoe 无法正确处理，导致线路吊死。 ⏹ 软终端在通话过程中如果所在的机器断电或断网时，在注册周期结束前该软终端所使用的IP 通道会一直被占用。本版本的改进如下： ⏹ 改进了工具栏图标，并在下方显示文字标注。 ⏹ 改进了LogTool 日志分析工具，具体见《Keygoe 系统例子程序与常用工具使用指导》2.15节“日志解析工具”。

Keygoe3.1.0版本文档体系做了以下变动：

⏹ 此版本所有文档版本都升级到V3.1.0。

⏹ 《Keygoe 系统安装配置手册（简约版）》：新增文档，主要介绍在系统配置方面，此版本相对于以前版本的新增功能。

⏹ 《Keygoe 系统维护手册》：新增文档，主要介绍了Keygoe 系统在配置应用过程中的常见问题以及解决方法。

⏹ 《Keygoe 系统例子程序与常用工具使用指导》：新增文档，主要内容为Keygoe3.1.0以前版本《Keygoe 系统编程指南》中关于例子程序与工具方面的内容。

⏹ 《Keygoe 系统安装配置手册（经典版）》：兼容了以前的Keygoe 系统版本的配置介绍，在3.1.0以前版本的《Keygoe 系统软件安装及配置管理指南》上更新界面，并修该了bug 。

其他文档更新了相关界面，并修改了bug 。

最新的文档架构可以参考《Keygoe 系统总述》中“第7章 Keygoe 文档体系”。

4. 安装包DJKeygoe V3.0_SP1_for_K200中相关改进

Keygoe 安装包的版本号由V2.3.0_for_K200升级为V3.0_SP1_for_K200。本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

4.1 具体内容

4.1.1 特别提示

此版本在V2.3.0_for_K200基础上，增加了下面2.1.2节所述的功能，并修改了相关bug 。

相对于KeygoeV2.3.0，KeygoeV3.0中的其他新增功能如3G 功能、双机热备、高速2M 、M3UA 、SNMP 、DSP 调试功能、T38等，KeygoeV3.0_SP1_for_K200不支持。

4.1.2 新增功能

⏹

⏹ 支持64位操作系统支持openSUSE11.2 支持端口电压检测支持信号音检测支持模拟接口箱

4.1.3 改进和提高

⏹ 修正了模拟卡忙音检测不准确的问题。

4.1.4 其他

关于此版本的帮助文档，本次只更新了《Keygoe 系统硬件及使用手册-200系列分册》，其他手册没有变动，沿用KeygoeV3.0_SP1系列帮助文档。

5. 安装包DJKeygoe V 3.0_SP1中相关改进

DJKeygoe 安装包的版本号由V3.0.x 升级为V3.0_SP1。

说明

Keygoe 的版本号由V3.0.2升级到V 3.0_SP1，中间经历了两个版本V3.0.3与V3.0.4。因变动不大，本文档不做单独章节介绍，具体改动如下： V3.0.3：修改单E1授权问题。

V3.0.4：修复了V2.3.0升级到V3.0.3后无法连接DSP 的问题。

另外，V3.0.3与V3.0.4 Windows开发包对应的Linux 开发包版本都是V3.0.3。

本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

5.1 具体内容

5.1.1 特别提示

支持1U 高密度板固件，关于高密度VOIP 扣板PABEIP120的介绍，见《Keygoe 系统硬件及使用手册-1001系列分册》中的“4.1.2.3 高密度V oIP 扣

板 PABEIP120”。

Keygoe3.0.3（Windows ）对应的Linux 开发包是的Windows 开发包对应的Linux 开发包仍然是

5.1.2 新增功能

⏹ 增加了CallModify 功能，见《Keygoe 系统编程指南》中的“3.14.12 支持

CallModify 功能”。

⏹ 增加了注册到多个软交换功能，同时支持向注册的软交换中心发送心跳

消息，见《Keygoe 系统编程指南》中的“3.14.8.3 Keygoe作为客户端注册

说明”。

⏹ 增加了向软交换发送Option 功能，见《Keygoe 系统编程指南》中的“3.14.13

支持Option 功能”。

增加了STUN 功能，见《Keygoe 系统编程指南》中的“3.14.14 支持STUN

功能”。 ⏹

5.1.3 改进和提高

⏹

⏹ Keygoe1001系列交换机最大支持的IP 资源数由30路增加到120路。支持多层子网组网。修正硬话机位于子网下存在的问题。支持100位号码长度。

5.1.4 其他

关于V3.0_SP1的帮助文档，更新了《Keygoe 系统编程指南》、《Keygoe 系统软件安装及配置管理指南》与《Keygoe 系统硬件及使用手册-1001系列分册》3本，其他手册没有变动，沿用Keygoe3.0.x 系列帮助文档。

6. 安装包DJKeygoe V 3.0.2中相关的改进

6.1 相关改进

DJKeygoe 安装包的版本号由V2.3.0升级为V3.0.2。

本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

6.2 具体内容

6.2.1 特别提示

⏹

⏹ 新增了3G 、高速2M 主要功能。增加了高密度板。配置界面节点增加了“媒体交换单元“与”3G-324M单元”。配置界面增加了“DSP调试”与“日志信息配置”选项。系统增加了多个例子程序与工具。 Keygoe3.0.0版本的帮助文档适用于Keygoe3.0.2安装包，文档内有关

Keygoe3.0.0版本的描述同样适用于Keygoe3.0.2安装包。

说明

Keygoe V3.0.2版本升级说明：

当用户系统为Keygoe V2.3.0版本，可在安装新的软件包时，选择“恢复上一次卸载时的INI 配置文件”，即可平滑进行系统的升级。

当用户系统为Keygoe V2.3.0之前的版本，不能平滑升级到V3.0.2。需要在安装完成V3.0.2之后，重新对业务进行配置。

6.2.2 新增功能

⏹ 增加了3G 编程接口，见《Keygoe 系统编程接口参考》如下：

1.5.12 初始化3GPP 放音索引XMS_ctsInitPlay3GPPIndex()，

1.5.13 建立3GPP 放音索引XMS_ctsBuildPlay3GPPIndex ()，

1.5.14 启动视频播放XMS_cts3GPPPlay ()，

1.5.15 视频播放控制XMS_ctsControl3GPPPlay ()，

1.5.16 启动视频录像XMS_cts3GPPRecord ()，

1.5.17 视频录像控制XMS_ctsControl3GPPRecord ()，

1.5.25 加入3G 视频会议XMS_ctsJoinTo3GVConf()，

1.5.26 离开3G 视频会议XMS_ctsLeaveFrom3GVConf()，

1.5.27 清除3G 视频会议XMS_ctsClear3GVConf ()，

1.5.28 重启3G 视频会议XMS_ctsRestart3GVConf ()，

1.5.29 获取3G 视频会议显示顺序XMS_ctsGetLayout ()，

1.5.30 设置3G 视频会议显示顺序XMS_ctsSetLayout ()，

1.5.31 获取3G 视频会议可视方列表XMS_ctsGetVisibleList ()，

1.5.32 设置3G 视频会议可视方列表XMS_ctsSetVisibleList ()，

1.5.33 关于3G 视频会议播放与录制，

1.5.34 图片处理函数XMS_ctsPutTextInPicture()，

1.8 3G-324M函数和事件。

⏹ 增加设置参数XMS_ctsSetParam()接口相关说明，见《Keygoe 系统编程接

口参考》“1.3.5.3 RTP通道设备”与“1.3.5.4 3G-324M通道设备”。

增加了3G 事件，见《Keygoe 系统编程接口参考》如下：

2.39 XMS_EVT_RECORDCSP，

2.40 XMS_EVT_3GPP_PLAY，

2.41 XMS_EVT_3GPP_CONTROLPLAY，

2.42 XMS_EVT_3GPP_RECORD，

2.43 XMS_EVT_3GPP_CONTROLRECORD，

2.44 XMS_EVT_3GPP_INIT_INDEX，

2.45 XMS_EVT_3GPP_BUILD_INDEX，

2.54 XMS_EVT_3G324M，

2.55 XMS_EVT_3GVCONF_JOIN，

2.56 XMS_EVT_3GVCONF_LEAVE ，

2.57 XMS_EVT_3GVCONF_CLEAR，

2.58 XMS_EVT_3GVCONF_GETLAYOUT， ⏹

2.59 XMS_EVT_3GVCONF_SETLAYOUT，

2.60 XMS_EVT_3GVCONF_GETVISIBLELIST，

2.61 XMS_EVT_3GVCONF_SETVISIBLELIST。

⏹ 3G 视频功能更新固件更新，见《Keygoe 系统软件安装及配置管理指南》

“5.5.4 更新固件”中的“说明”与“注意”部分。

增加了3G 视频的控制信息，见《Keygoe 系统编程指南》“3.8.3 全局放

音索引的建立”与“3.8.4 启动及控制放音”。

增加了3G 视频录音、放音、循环播放说明，见《Keygoe 系统软件安装

及配置管理指南》“6.2 媒体单元”。

增加了3G-324M 功能，见《Keygoe 系统编程指南》“3.16 关于3G-324M”，与《Keygoe 系统软件安装及配置管理指南》“6.4 3G-324M单元”。

增加了媒体交换单元，提供视频媒体流的编解码转换和会议特效等功能，见《Keygoe 系统软件安装及配置管理指南》“6.3 媒体交换单元”。

增加了3G 视频会议功能，见《Keygoe 系统编程指南》“3.17 关于3G 视频会议编程”。

增加了3G 视频的界面状态显示，见《Keygoe 系统软件安装及配置管理

指南》“6.1.2.10 RTP通道状态”，“6.1.2.11 TCP/IP协议栈状态”，“6.1.2.12 监听链路状态”，“6.1.2.13 H223通道状态”，“6.1.2.14 RTPX通道状态”。 ⏹ ⏹ ⏹ ⏹ ⏹ ⏹ 高速2M

⏹ 增加了高速2M 功能，见《Keygoe 系统软件安装及配置管理指南》“3.1 安

装环境”中的“注意”部分与“表6-1 数字接口可配置属性说明”部分。

高密度板

⏹ 增加了高密度DSP 板说明，见《Keygoe 系统编程指南》“3.24 关于高密

度DSP 板”。

增加了高密度板卡系统说明，见《Keygoe 系统软件安装及配置管理指南》“第8章高密度板卡系统”。

增加了高密度V oIP 资源处理板PFBT480X 说明，见《Keygoe 系统硬件

及使用手册-3000系列分册》“4.2 高密度V oIP 资源处理板PFBT480X”。 ⏹ ⏹ 配置界面

⏹ DSP 调试界面，见《Keygoe 系统软件安装及配置管理指南》“5.10 DSP

调试”。

日志信息配置界面，见《Keygoe 系统软件安装及配置管理指南》“5.11 日志信息配置”。 ⏹

SNMP 代理端

⏹ 支持DSP 、E1、MTP2、MTP3的查询，具体见《Keygoe 系统编程指南》

“3.25 关于SNMP 代理”。

SIGTRAN

⏹ 增加了SIGTRAN 功能，见《Keygoe 系统软件安装及配置管理指南》“6.7

SS7单元（支持SIGTRAN 功能）”。

例子程序

⏹ 增加的例子程序见《Keygoe 系统编程指南》，如下：

7.8 XMS_VoIPServer

7.9 XMS_3G_Demo

7.15 XMS_HotBackup_Demo

工具

⏹ 增加的工具见《Keygoe 系统编程指南》，如下：

8.4 信号音分析工具

8.11 网络连通及能力检测工具

8.12 交换机监控工具

8.13 UCTools

8.16 DSP调试日志

8.17 Keygoe异常监控工具

其他

⏹

⏹ TTS 主时钟功能 ini 文件IP 替换的工具 Remove DSP事件磁石模块功能信号音模板按通道设置 M2R 获取电压 M2C 获取电压信息 VOC2、VOC4获取版本信息 FSK 参数设置功能日志功能（系统级、模块级日志记录模块及解析工具，可以自动记录模

块连接断开、重连、系统启动等各种警告及异常信息）

⏹ 支持录音输入混声器功能。

6.2.3 改进和提高

解决问题

⏹

⏹ 设定时间长度录音无record 事件返回 FSK 主叫少收一位 SCCP 收到长包导致模块挂死 E1状态获取错误录音延时停止错误 CSP 放音错误无IP 情况下搜索不到DSP 录音文件>2G导致媒体模块出错查询时隙连接返回信息错误准直连查找linkid 错误 DTMF 检测不准确

改进问题

⏹ V oIP 的优化：增加了rtp 分离、transfer 功能、options 功能、g729静音检

测功能等

改进DTMF 信号音

改进会议效果

支持监听模式打开通道的功能

支持Delphi 头文件

G729静音检测 ⏹ ⏹ ⏹ ⏹ ⏹

手册更新

软件：

⏹ 配置管理服务器安装环境由Microsoft Windows XP/2000 Server/2003

Server 更新为Microsoft Windows XP/2003 Server/2008 Server。

修改了媒体单元的“功能参数配置”节点界面。具体见《Keygoe 系统软件安装及配置管理指南》“6.2.2.1功能参数配置”。

V oIP 的部署方案增加了STUN 组网穿越网关功能，见《Keygoe 系统软件安装及配置管理指南》“6.9.5.3.网关/防火墙穿透”。

原“信号音分析工具”名称改为“语音编辑工具”。

增加了关于RTP 的相关说明，见《Keygoe 系统编程指南》“3.15 关于RTP”。 ⏹ ⏹ ⏹ ⏹

6.2.4 其他 ⏹ 更新了《Keygoe 系统编程指南》“第5章函数接口”与“第6章事件”表格内容。 ⏹ 复位设备XMS_ctsResetDevice()不会影响传真设备的状态，传真设备的停止建议使用XMS_ctsStopSendFax和XMS_ctsStopReceiveFax。 ⏹ XMS_ctsGetParam()接口增加了获取电压功能，见《Keygoe 系统编程接口参考》“1.3.6 XMS_ctsGetParam()”相关说明。 ⏹ 更新了《Keygoe 系统编程接口参考》“2.49 XMS_EVT_RECVIODATA”。 ⏹ 增加了设置应用程序指示灯的编程接口，见《Keygoe 系统编程接口参考》“1.3.9 设置应用程序指示灯XMS_acsLedCtrl()”。 ⏹ 增加了选用主控板的Keygoe 1001多媒体交换机的系统配置，见《Keygoe 系统硬件及使用手册-1001系列分册》“2.5 软件特性概述”。 ⏹ 增加了Keygoe 1001交换机软件相关操作，见《Keygoe 系统硬件及使用手册-1001系列分册》第7章到第10章。 ⏹ 对于V oIP 设备的Acs_CallControl_Data，用V oIPCallPrivate_t结构替换PrivateData_t结构，见“2.16 XMS_EVT_CALLOUT”。硬件： ⏹ 更新了Keygoe1001系列交换机的前面板与后面板说明，见《Keygoe 系统硬件及使用手册-1001系列分册》“第3章机箱介绍”。 ⏹ 更新了数模混用接口机箱与数字接口机箱的面板指示灯说明。 ⏹ Keygoe1001系列交换机增加了主控板等配件介绍，见《Keygoe 系统硬件及使用手册-1001系列分册》“第4章配件介绍”。 ⏹ 增加了Keygoe 3000系列交换机部分安装说明，见《Keygoe 系统硬件及使用手册-3000系列分册》“6.2.1 安装内线和外线等模块”，“6.2.2 安装扣板”。 ⏹ 增加了高密度板卡系统的维护说明，见《Keygoe 系统硬件及使用手册-3000系列分册》“第7章系统维护”。

手册内容增加了公司的技术支持与服务联系方式等信息。

7. 安装包DJKeygoe V 2.3.0中相关的改进

7.1 相关改进

DJKeygoe 安装包的版本号由V2.2.0升级为V2.3.0。

本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

7.2 具体内容

7.2.1 特别提示

⏹

⏹ 改进优化传真模块，新增T38和ECM 传真功能。媒体模块和V oIP 模块新增多种功能。配置界面增加向导、导入导出等功能。增加多个辅助工具。

说明

Keygoe V2.3.0版本升级说明：

当用户系统为Keygoe V2.2.0版本（或V2.3.0版本覆盖安装时），可在安装新的软件包时，选择“恢复上一次卸载时的INI 配置文件”，即可平滑进行系统的升级。

当用户系统为Keygoe V2.2.0之前的版本，不能平滑升级到V2.3.0。需要在安装完成V2.3.0之后，重新对业务进行配置。

7.2.2 新增功能

传真

⏹ 优化传真模块，见《Keygoe 系统软件安装及配置管理指南》6.5.2节“设

定关联单元”按照最新界面操作进行更新。

传真支持Ecm 功能，见《Keygoe 系统编程参考手册》“1.8.14 设置传真

ECM 模式”。删除原“1.8.12 设置传真类型”。

传真支持T.38功能，见《Keygoe 系统总述》3.8节“传真资源”，增加简

要说明。《Keygoe 系统编程参考手册》“1.5.12 发送传真

XMS_ctsSendFax()”和“1.5.13 停止发送传真XMS_ctsStopSendFax()”增

加T38内容。《Keygoe 系统软件安装及配置管理指南》6.6.1节2中增加“传

真模式：.38/udptl传真和T.30透传（G .711）”说明。 ⏹ ⏹

⏹ 传真增加波特率设置接口，见《Keygoe 系统编程参考手册》1.8.11“设置

传真频率”。

传真增加多文件发送接口，见《Keygoe 系统编程参考手册》1.8.13“发送

多个传真文件”。 ⏹

V oIP

⏹ 增加RTP 会话参数获取接口，见《Keygoe 系统编程参考手册》1.3.5和

1.3.6节，增加VOIP_PARAM_RTPADDR（RTP 会话远端地址）和

VOIP_PARAM_RTPCODEC两个参数的说明。

⏹ Alert/Answer接口增加媒体格式扩展参数(SIP协议) ，见《Keygoe 系统编

程参考手册》1.4.2节 XMS_ctsAnswerCallIn()的扩充参数。增加1.4.4节“振

铃XMS_ctsAlertCall()”的扩充参数。

⏹ Drop 接口增加被叫挂机返回码扩展参数(SIP协议) ，见《Keygoe 系统编

程参考手册》1.4.3节“清除呼叫XMS_ctsClearCall()”拆线原因说明。

增加RTP 流量活动监测功能，见《Keygoe 系统软件安装及配置管理指南》

6.6.3节“RTP协议设置”，增加“无活动会话断开时间（秒）”参数项。 ⏹

媒体

⏹ 放音支持快进快退功能，见《Keygoe 系统编程参考手册》1.5.4节“放音

控制XMS_ctsControlPlay()”，增加说明。

录音命令增加TaskID 控制，见《Keygoe 系统编程参考手册》1.5.5节“启

动录音XMS_ctsRecord()”，增加m_u8TaskID参数说明。

录音支持暂停和快退功能，见《Keygoe 系统编程参考手册》1.5.6节“录

音控制XMS_ctsControlRecord()”，增加说明。 ⏹ ⏹

⏹

⏹ 支持录音按键打断返回正常事件。 CSP 录音增加bargein 、nobargein 、延迟停止功能(延迟停止录音) ，见

《Keygoe 系统编程参考手册》1.5.9 “启动CSP 录音”中相关说明

（m_u8CSPRecType：是否打断正在播放的提示音，参见

XMS_CSPREC_TYPE）。

⏹ CSP 录音支持从混声器录音，见《Keygoe 系统编程参考手册》1.5.9节“启

动CSP 录音XMS_ctsRecordCSP()”增加m_s8IsMixEnable和

m_MixerControl。

⏹ CSP 放音延迟停止放音功能，见《Keygoe 系统编程参考手册》1.5.4节“放

音控制XMS_ctsControlPlay()”，m_u16ControlType参数增加

XMS_CSP_DELAY_STOP_PLAY。

⏹ 会议成员数查询功能，见《Keygoe 系统编程参考手册》1.3.6节，“表1-32

获取参数XMS_ctsGetParam()触发事件”增加 m_u8TotalOfConfMem。

增加了对会议活动语音检测功能的支持，见《Keygoe 系统编程参考手册》

1.3.6节 “表1-32 获取参数XMS_ctsGetParam()触发事件”，增加获取会

议设备参数。 ⏹

⏹ 增加发送MSK 功能，见《Keygoe 系统编程参考手册》1.6.1节“发送

DTMF/TONE音/FSK/MSK/数据XMS_ctsSendIOData()”，增加对MSK 的

支持。《Keygoe 系统编程参考手册》1.3.5节“设置参数XMS_ctsSetParam()”

中表1-27 m_VocGtdControl. m_u8EXTEnable。

⏹ 增加DPD/PVD/VSD等功能，见《Keygoe 系统编程参考手册》1.3.5节“设

置参数XMS_ctsSetParam()”中表1-27 m_VocGtdControl.

m_u8EXTEnable。

⏹ 放音队列支持“延时和多种编码类型文件”种可选功能，见《Keygoe 系统

软件安装及配置管理指南》6.2节“媒体单元”中更新。已和最新的界面同

步。

⏹ 媒体模块增加网络访问用户名和密码设置配置项，见《Keygoe 系统软件

安装及配置管理指南》中6.2.3节3。

配置界面

⏹ 配置界面中新增时隙连接查询界面，见《Keygoe 系统编程指南》8.1节“时

隙连接查询工具”。

配置界面增加模块配置向导功能，该功能将自动删除以前的模块配置并

添加当前用户设置的模块配置，并自动添加模块关联关系。见《Keygoe

系统软件安装及配置管理指南》4.1.5节 1.“模块配置向导”和5.3.2节“方

法2：配置向导方式”。并修改5.4节“设置单元的关联关系”。 ⏹

⏹ 配置界面增加简易配置向导功能，该功能将自动删除以前的模块配置并

添加当前用户设置的模块配置，并根据用户选择的应用场景自动导入应

用配置，自动设置关联关系。见《Keygoe 系统软件安装及配置管理指南》

4.1.5节 2.“简易配置向导”。

⏹ 整体配置导入导出功能，见《Keygoe 系统软件安装及配置管理指南》5.8

节“导入/导出配置”。

配置界面增加关联关系统一查看与设置界面。见《Keygoe 系统软件安装

及配置管理指南》 5.4.2节“手动设置”。 ⏹

其他

⏹ 增加了SS7发送原始数据包的接口，见《Keygoe 系统编程参考手册》1.6.3

节“SCCP数据包收发透传XMS_ctsSendRawFrame()”和2.52节

“XMS_EVT_SS7RawFrame”。

⏹ 增加了一个SS7模块可以关联多个流程模块的功能（可以实现客户的多

链路交叉备份的需求），见《Keygoe 系统软件安装及配置管理指南》6.4

节 “SS7单元”。

⏹

⏹ ISDN 增加原始主叫和接收后续地址。增加EM 功能，见《Keygoe 系统编程参考手册》1.8.9节 “EM发送E 和

M 信号功能”。

增加了对中继拍叉簧的设置功能，见《Keygoe 系统编程参考手册》 1.8.3

节“设置中继拍叉簧时间”。

增加了读取模拟模块序列号的功能 (必须使用东进公司版本号为01或以

上的模拟接口箱) ，见《Keygoe 系统编程参考手册》1.3.6节 “表1-32 获

取参数XMS_ctsGetParam()触发事件”，增加获取模拟用户、模拟中继和

模拟高阻序列号说明。 ⏹ ⏹

⏹ 增加了设置模拟高阻录音模块电压的功能 (必须使用东进公司版本号为

01或以上的模拟接口箱) ，见《Keygoe 系统编程参考手册》1.8.17“设置模

拟高阻录音模块电压”一节。

⏹ 增加E1时钟设置，见《Keygoe 系统编程参考手册》1.8.15节“设置E1

时钟参考源”。

增加打开board 设备时，选择设置主时钟参考源参数功能。见《Keygoe

系统编程指南》3.22节“关于Keygoe 主时钟参考源设置”和《Keygoe 系统

编程参考手册》1.3.2节“打开设备XMS_ctsOpenDevice()”特别说明。另外，《Keygoe 系统编程参考手册》增加2.45节

“XMS_EVT_CTBUS_CLK_REF_SRC_STATE”事件说明。 ⏹

⏹ 添加对C#等开发语言开发Keygoe 应用的支持，并添加了C#的Dail 与

⏹

7.2.3 改进和提高

⏹

⏹ Demo 例子程序。见《Keygoe 系统编程指南》3.21节“关于ActiveX 控件”。增加如下辅助工具：1）NetDiagTool ：网络诊断工具；2）WaveEdit ：模拟信号音分析工具；3）KGMonitor ： SS7信令监控工具；4）LogManager ：日志备份工具；5）Portmap ：V oIP 端口映射工具；6）.KGEventView ：API 命令事件监视工具；7）DiagISD ：ISDN 信令分析工具。见《Keygoe 系统编程指南》第8章“常用工具”。呼叫及注册API 接口参数结构变更(应用程序需要重新编译) ，见《Keygoe 系统编程参考手册》1.4.1节“呼出XMS_ctsMakeCallout()”，修改“VoIP 呼叫参数说明表”的部分参数。《Keygoe 系统编程指南》3.15.7节“注册服务”修改“Keygoe注册特点”，并增加“SIP 注册认证”部分。呼入选路改为倒序线性轮询方式，见《Keygoe 系统编程指南》3.15.2节，增加V oIP 呼入选路规则说明。 SendIOData 发送SIP INFO消息接口参数结构变更（应用程序需要重新编译），见《Keygoe 系统编程参考手册》1.6.1节，修改“表1-93 VoIP 设备发送IO 数据参数说明”部分说明。支持放音路径名称长度有128 bytes扩展到256 bytes，见《Keygoe 系统编程参考手册》1.5.3节XMS_ctsPlay()的扩充参数说明。录放音精度提高到1 bytes。 WA V 文件有原来只支持8K 扩充到8K 、6K 、11k 三种文件类型；见《Keygoe 系统软件安装及配置管理指南》6.2节“媒体单元”中更新。已和最新的界面同步。 FSK 由512 bytes扩充至1024 bytes，见《Keygoe 系统编程参考手册》1.6.1节“表1-91 语音通道设备发送IO 数据参数说明”修改说明，将511改为1023。 SS7收号规则更加灵活，见《Keygoe 系统软件安装及配置管理指南》6.4.3节“ISUP参数配置”修改“表6-24 ISUP通用参数配置”，并增加“表6-27 几种不同收号方式”。 ISUP 一次性呼入和呼出号码长度由最大16位调整到32位。 API 回调部分修改成了多线程方式，线程个数和线程消息轮询个数在DJITPAcsDef.ini 中定义，默认是一个回调线程。见《Keygoe 系统编程指南》2.5.3节“有关回调的编程注意事项”，增加关于多线程的说明。修改了PRI 回状态信息的bug ，修改了当PRI 收到长度为0的信息包导致

出错的BUG ，修改了XMS_ctsClearCall设置挂机原因无效。

7.2.4 其他

更新了DJKeygoe 安装盘的Help 文档。

其中原《Keygoe 系统硬件安装及维护指南》，更名为《Keygoe 3000系列多媒体交换机硬件安装及维护指南》，并增加了《Keygoe 1001系列多媒体交换机硬件手册》。

8. 安装包DJKeygoe V 2.2.0中相关的改进

8.1 相关改进

DJKeygoe 安装包的版本号由V2.1.1升级为V2.2.0。

本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

8.2 具体内容

8.2.1 特别提示

⏹

⏹ 增加了Keygoe 英文版本。增加了过机交换功能。增加了信令监听（漏话）功能。增加了数字话机录音功能。 V oIP 增加了注册功能。模拟接口Api 做了重大改变，编程方式更灵活。

8.2.2 新增功能

⏹

⏹ 增加授权剩余时间查询接口XMS_acsQueryLicense。增加对SS7（TUP 、ISUP ）14位点码的支持。增加H.323/SIP注册服务功能，增加了代理服务器例子程序V oIPProxy ，

修改了例子程序V oIPDemo 和V oIPGateway ，见《Keygoe 系统编程指南》

3.13.2节、3.13.6节、7.5节和7.6节。

⏹ H.323协议呼出信令Q.931消息增加主/被叫号码信息，见《Keygoe 系统

编程参考手册》1.4.1节。

V oIP 增加呼叫权限控制功能和API 接口（呼入/呼出/注册）。总体说明，

见《Keygoe 系统编程指南》3.13.3和3.13.6节；关于V oIP 相关配置，见

《Keygoe 系统软件安装及配置管理指南》8.6.3节。 ⏹

⏹

⏹ 增加11K 语音编解码类型的功能。录音停止事件中增加了返回录音长度。

⏹

8.2.3 改进和提高

⏹

⏹ 增加设置拍叉簧间隔、FSK 参数、GTD 频率参数、GTD 模版参数、模拟中继拍叉簧、传真头、CAS 参数和ISDN 参数的接口，见《Keygoe 系统编程参考手册》1.8节。增加PVD 检测功能，见《Keygoe 系统编程参考手册》1.3.5节m_VocGtdControl. m_u8EXTEnable。增加RTP 会话控制API 接口，见《Keygoe 系统编程参考手册》1.3.5节。 V oIP 增加发送/接收Alert 消息功能和API 接口，见《Keygoe 系统编程指南》3.13.2节。 V oIP 增加呼叫会话转移通道功能和API 接口，见《Keygoe 系统编程参考手册》1.6.1节。模拟中继增加了主动摘机接口，见《Keygoe 系统编程指南》3.6.3中模拟中继流程图和相关描述。增加查询DSP 设备基本信息的功能，见《Keygoe 系统编程参考手册》1.3.6节。增加信令监控功能。《Keygoe 系统编程指南》3.14描述信令监控概要说明；关于XMS_EVT_SIGMON，见《Keygoe 系统编程参考手册》2.40节；关于信令监控模块配置，见《Keygoe 系统软件安装及配置管理指南》8.7节。增加模拟/数字话机录音功能，见《Keygoe 系统编程指南》3.19节和7.9节。增加过机交换功能。关于原理性说明，见《Keygoe 系统编程指南》3.17节；关于函数和事件说明，见《Keygoe 系统编程参考手册》1.7节、2.41~2.43节；关于交换中心配置，见《Keygoe 系统软件安装及配置管理指南》8.8节。增加信令监控例子，见《Keygoe 系统编程指南》7.10节。修改支持系统中配置多个V oIP 模块。修正SIP 协议注册消息Nonce 域更新导致认证失败问题。配置多个媒体模块时，修改索引队列放音结束时，第二个以后的媒体模块队列放音结束后返回的没有返回事件的问题。修正了先调用普通放音然后调用队列放音，导致普通放音结束后没有放音结束事件返回给APP 的问题。修改了队列放音时，整个队列的语音文件播放完毕再返回放音完成事件包的问题。修改了8K VOX格式录放音不正确的问题。

8.2.4 其他 ⏹ FSK 收发字节由128字节修改为增大到511字节。 ⏹ 解决了索引对应的语音不存在时，无错误信息返回的问题。 ⏹ 修正了传真文件收发的页偏移不准确的问题。 ⏹ 修改了模拟外呼时，用于信号音分析的绑定语音资源不能跨DSP 的问题。 ⏹ 解决了模拟座席通过模拟中继外呼时，某种情况下导致语音单通和SendDtmf 失败的问题。 ⏹ 修改中继检测到忙音后的处理过程，由原来DSP 底层主动挂机改为应用程序处理。 ⏹ 解决了模拟座席与语音绑定后，给座席振铃，座席摘机，当调用clearcall 停止给座席振铃，会造成与座席绑定的语音资源释放的问题。 ⏹ 修改了模拟中继有时检测不到外线挂机的问题。 ⏹ 模拟呼叫过程中发送前导码修改为手动方式发送。 ⏹ 解决了模拟中继外呼有时失败的问题。 ⏹ 解决了V oc 设备与模拟接口设备断开连接成功后还能收到DTMF 码的问题。 ⏹ 解决了传真多页有时只收到一页的问题。 ⏹ 解决了传真接续过程，人工收发传真时（没有“嘀”声），不能判断来电业务的问题。 ⏹ 解决了停止发送传真后，传真接受端中间文件无限增大的问题。 ⏹ 改善了传真成功率和传真效果。 ⏹ 修改了传真格式不兼容导致黑页的问题。 ⏹ 修改了ISDN 复位慢的问题。 ⏹ 修改了由配置管理器心跳包超时引起的所有功能模块断开连接的问题。 ⏹ 修改了当DSP 数目超过64时，可能会导致媒体模块异常死掉的问题。 ⏹ 修改了重启流程模块收到两次QueryDevice 事件的问题。

更新了DJKeygoe 安装盘的Help 文档，增加了英文版本文档。

Keygoe系统版本发布说明书

9. 安装包DJKeygoe V 2.1.1_sp1中相关的改进

9.1 相关改进

DJKeygoe 安装包的V2.1.1版本增加一个_sp1补丁版本。

本章包含以下内容。

⏹

⏹ 特别提示新增功能改进和提高其他

9.2 具体内容

9.2.1 特别提示

⏹ 解决了Keygoe v2.1.1版本link 功能的问题：link 功能会造成双向连接结

果，unlink 不能拆除单向连接。

解决了3G 试用功能可能导致语音资源默认情况下为0的问题。 ⏹

9.2.2 新增功能

增强了DSP 自动收索的功能，只要DSP 与Keygoe 软件物理在同一个网络，无论DSP 的IP 地址具体配置如何，都可以自动收索。

9.2.3 改进和提高

解决了模拟接口板Run 指示灯闪烁异常的问题。

9.2.4 其他

更新了DJKeygoe 安装盘的Help 文档。

10. 安装包DJKeygo V 2.1.1中相关的改进

10.1 相关改进

DJKeygoe 安装包的版本号由V2.1.0升级为V2.1.1。

本章包含以下内容：

⏹

⏹ 特别提示新增功能改进和提高其他

10.2 具体内容

10.2.1 特别提示

多媒体交换机安装盘修改为Keygoe 标识。

10.2.2 新增功能

⏹

⏹ DSP 增加了掩码和网关的设置功能。配置管理界面程序中增加了一个对多媒体交换机服务进行管理的功能。在配置界面中增加了对配置服务器IP 的显示功能。增加了对XMS_Linear_16bit编码类型的支持。增加了H323直接呼叫信令方式的呼入。 EASYAPI 中增加了TTS 的处理接口（XMS_ctsPlayCSPXMS、

ctsSendCSPData ）。

Help 文档中增加了对DSP 的sig 信号指示灯含义的解释说明。

Help 文档中增加了对*.wav格式支持的说明。 ⏹ ⏹

10.2.3 改进和提高

⏹

⏹ 解决了DSP 容易连接不上的问题。修改了DSP 的Q921报包导致ISDN 模块呼叫挂死的问题。解决了长时间运行时，ISDN 模块有时会弹框崩溃的问题。解决了ISDN 模块初时运行时，可能需要数十秒钟才能复位的问题。修改ISDN 模块日志为默认关闭模式。修改了ISDN 模块拆线慢的问题。

⏹ 修改了ISDN 模块在和某些交换机对接时，可能发生拒绝接听和超时情况

不能拆线的问题。

修改了Fax 模块停止接收传真动作可能会导致空文件以及后续传真文件

内容不正确的问题。

修改了函数XMS_ctsSetDevTimer()不能取消前一次设置的定时器问题。修改了网络断开后，DJIPTMainMod 的CPU 占用率容易突发性增高的问题。

修改了播放空文件报错的问题。

修改了某些windows2003系统服务不能正确启动的问题。

解决了默认路径配置不支持安装路径修改的问题。

解决了配置程序界面右上角（最大/最小化、关闭）控件处容易出现重叠效果的问题。

修改了例子程序中总机转中继不通的问题。

修改了多个例子程序（Dial 、Demo 、Conf 、Fax ）模拟用户部分错误的问题。 ⏹ ⏹ ⏹ ⏹ ⏹ ⏹ ⏹ ⏹ ⏹

10.2.4 其它