中国移动自动路测平台商务终端测试子平台数据与接口综

《中国移动自动路测平台商务终端测试子平台数据与接口综》由会员分享，可在线阅读，更多相关《中国移动自动路测平台商务终端测试子平台数据与接口综（13页珍藏版）》请在装配图网上搜索。

1、中国移动通信集团设计院有限公司中国移动自动路测平台商务终端测试子平台数据与接口综合说明文件状态： 草稿 正式发布 正在修改文档发起人李承益文档整理人完成日期2012年04月22日当前版本2.0.0版本号主要作者修改记录完成日期2.0.0李承益新建文档2012年4月22日目 录第一章综述3一概述3二系统描述31测试数据说明32用户分类说明33商务终端子平台功能说明4第二章平台接口说明5一测试流程描述51事件触发测试流程52主动测试流程6二前后台通信接口71商务终端注册72数据上传7第三章上报数据格式10一概述10二详细数据结构101文件名102文件信息行113文件内容11第一章 综述一 概述本文

2、档描述了使用商务终端进行网络质量监控与网络测试的功能规范。商务终端的测试功能旨在使用商务终端上报网络异常事件发生时的空中接口物理层、数据链路层及网络层的相应测量与信令数据，以便网络运营商通过这些数据更好地完成网络测试，发现网络问题，提高网络质量。商务终端的测试数据经过移动互联网回传至统一的后台处理平台，回传数据的组织格式，即数据组织属性、文件格式、关键字等都由本文档统一规定。二 系统描述1 测试数据说明整个商务终端测试系统由商务终端（包含测试功能）、数据处理后台两大部分组成。商务终端即用户日常正常使用的终端，可以记录并上报测试数据。测试数据记录方式包含以下两种模式：（1） 被动模式：在网络发生

3、非正常事件（非正常事件的定义参考下文）时，商务终端直接启动测试数据记录功能，并在数据记录完成后自动上传至数据处理平台，被动模式记录完整的Trace接口数据，其数据持续时间较短。（2） 主动模式：用户在问题路段手工启动测试数据记录功能，并在用户手工停止（或到达下文所述的最大记录时间）后自动上传至数据处理平台，主动模式记录完整的Trace接口数据，其数据持续时间由用户确定。另外，测试数据内容包含以下两种模式（1） 简洁模式：商务终端直接将当前的简略测试数据记录并发送至系统侧，简略测试数据详细定义见下文。简洁模式不需要商务终端打开专用于数据下载的Trace接口。（2） 完整模式：商务终端通过测试软件

4、打开数据下载的Trace接口，并将Trace接口的数据输出至LOG中。2 用户分类说明具有测试功能的商务终端将直接面对普通客户，因此其使用与功能应当与普通的商务终端相一致。在下文中，针对使用此类商务终端的不同用户群，将会有不同的终端功能要求，这些用户群如下：（1） 普通用户：代表完全普通的，能正常使用商务终端提供的电信业务的用户。这些用户会使用商务终端，但不了解移动通信网络。（2） 移动通信行业从业人员：指运营商、商务终端商、终端制造商、优化服务商等行业中的从业人员。这些人员的工作与移动通信网络密切相关，需要经常实时了解并测试移动通信网络的运行情况。商务终端在完成测试后，将测试数据文件通过预定

5、义的FTP回传至后台。3 商务终端子平台功能说明自动路测平台的商务终端子平台完成以下功能：（1） 用于中国移动从业人员日常跟踪网络质量，随时随地进行拔打测试。（2） 用于中国移动投诉处理人员进行日常投诉的现场测试、处理与后续结果跟踪等闭环流程。（3） 用于中国移动的VIP用户或友好用户的疑难投诉跟踪与处理。（4） 用于中国移动普通用户的网络质量日常监控，采集大量用户的海量测试数据，进行终端及网络的长期监控。第二章 平台接口说明一 测试流程描述1 事件触发测试流程1.1 流程启动由事件触发上报数据通过以下两种方式来启动：（1） 商务终端芯片触发：由系统中的通信芯片在相应事件发生导致其中各个信令子

6、层实体（在GSM中是CC实体、MM实体及RR实体，在TD-SCDMA中是RRC实体）发生状态转变后，由芯片直接通过相应的Trace接口外吐数据，通知操作系统事件触发上报流程并准备接收由芯片发送的数据。（2） 商务终端操作系统触发：在系统中的通信芯片开启测试数据上报功能之后，直接上报在专有模式及分组传输模式下的相应数据，终端的操作系统中的守护程序在解码上报的数据后，如果发现发生相应的事件，则触发上报流程。提供给普通用户的具备测试功能的商务终端，应具备“商务终端芯片触发”的启动方式；而提供给移动通信行业从业人员的具备测试功能的商务终端，则至少要支持以上两种启动方式中的任意一种。1.2 数据记录商务

7、终端根据事件触发了测试流程后，即开始记录并处理事件发生前的测试数据，测试数据记录及处理有如下三种方式：（1） 简洁记录：使用下面“接口描述”中所描述的应用层命令接口，上报一组无须Trace接口（通过手机操作系统的公开接口）即可获得的异常事件信息。（2） 简单自动记录：记录一段时间内无须通过Trace接口即可获得的测量信息。简单记录只记录当前时刻及以前很短一段时间的数据，具体记录时长可根据各厂家商务终端的具体机制来实现，但是不得长于一次呼叫（或30秒），亦不得短于5秒。（3） 复杂自动记录：复杂记录是在手机内存中开辟一块内存缓冲区，获取芯片Trace接口的测试数据后将其缓冲在内存中，并实时更新缓

8、冲区中的数据。在事件触发后，复杂记录功能将事件发生时间点以前一段时间的数据组织成文件，具体记录时长可根据各厂家商务终端的具体机制来实现，但是不得长于一次呼叫（或30秒），亦不得短于5秒。1.3 数据传送在数据记录完成后，商务终端中携带的测试软件需要完成以下工作：（1） 将获得的数据组织成一定格式的数据文件，并存储在商务终端的存储商务终端（机身大容量存储、存储卡等）中。（2） 在终端进入空闲状态后，启动上传程序发起上传流程，并通过上传流程告知系统侧上传数据的文件名、文件大小（压缩后）等参数，并将数据文件传送至后台服务器。（3） 后台服务器使用FTP方式支持文件上传，在后台服务器针对此文件的响应过

9、程中，会告知商务终端上传服务器的位置和FTP用户名、密码。如果在文件传送过程中终端由于用户操作导致离开空闲状态，则测试软件需要支持断点续传。需要特别注意的是，对于提供给普通用户的具备测试功能的商务终端，在数据传送时不应有任何消息或提示导致用户负面感知。2 主动测试流程2.1 流程启动商务终端测试功能的主动测试流程由用户通过商务终端中的测试程序手动启动相应的测试功能，这一功能只应对移动通信行业从业人员开放。主动测试流程有以下两种启动方式：（1） 快速测试功能：在用户启动测试记录流程后，用户设置测试记录时长，然后终端中的测试程序即在后台记录测试数据，而用户仍然可像普通用户一样正常使用终端。（2）

10、自动测试功能：在用户启动测试记录流程后，用户根据所需要的测试方式进行设置（例如，设置被叫号码、呼叫时长、测试时长等），然后开始测试。此时，终端相当于一台测试商务终端，用户暂时无法像普通用户一样正常使用终端。2.2 数据记录在启动主动测试后，数据即记录于商务终端的存储商务终端（机身大容量存储、存储卡等）中。数据记录时长由用户在启动时设置（可参考上一节“流程启动”），并在测试完成后回传数据。2.3 数据传送本节内容，请参考本章“事件触发测试流程”中相应“数据传送”的内容。二 前后台通信接口1 商务终端注册商务终端商务终端在开机后，若测试软件自动运行，即向后台注册此测试软件的基本情况，相应的接口使用

11、自动路测平台的标准接口，其商务终端注册的接口命令如下：商务终端开机注册请求RequestCommand=PhoneRegister#请求命令类型为商务终端注册Session=Session ID#当前会话IDSec=seconds#秒，时间为到1970年1月1日0：0：0的秒数Usec=useconds#微秒数Phone=PhoneIMEI#标识商务终端唯一的商务终端IMEI号PhoneOS=OS Name#手机的操作系统名，标准操作系统名见下文PhoneOSVersion=OS Version#手机的操作系统当前版本号PhoneBaseband=Baseband Version#手机的基带版

12、本号SoftwareVendor=Vendor#软件的著作厂家SoftwareVersion=Software Version#软件厂家的内部版本号IsInitiative=Y/N#软件的属性，是否支持主动测试IsTrace=Y/N#软件的属性，是否支持Trace接口数据其中，上报的手机操作系统名和版本号规定如下：（1） 商务终端操作系统名标准化定义：安卓系统（无论多少版本）标准化为“Android”，苹果系统（无论多少版本）标准化为“iOS”，微软的Windows Mobile操作系统标准化为“WM”，微软的Windows Phone操作系统标准化为“WP”。其它操作系统命名后续另文另行通知

13、。（2） 商务终端操作系统当前版本号，以操作系统的公开版本号为准。（3） 商务终端的基带版本号以各个商务终端的内部版本号为准上报。系统在收到商务终端的开机注册接口请求后，即根据商务终端的命令合法性（软件厂家内部版本的许可性、PhoneIMEI的合法性等），回应此时的商务终端注册命令如下：后台回应商务终端开机注册请求ResponseCommand=PhoneRegister#请求命令类型为商务终端注册Session=Session ID#当前会话IDSec=seconds#秒，时间为到1970年1月1日0：0：0的秒数Usec=useconds#微秒数Phone=PhoneIMEI#标识商务终端

14、唯一的商务终端IMEI号PlatformAddress=IP Address#平台的数据回传IP地址，取与商务终端注册时的相同IP地址，包含端口号SoftwareVersion=Software Version#后台存储的软件厂家的内部版本号Result=AC/NAC#系统是否支持此次登录在后台回应商务终端开机注册请求中，会将后台可用于此设备的软件厂家的最新内部版本号回送给设备，此时设备将本机软件版本与此版本对比，如果对比结果后端的软件版本新于当前软件版本，商务终端需要进行软件升级交互：商务终端软件升级请求RequestCommand=PhoneSoftUpdate#请求命令类型为商务终端注册

15、Session=Session ID#当前会话IDPhone=PhoneIMEI#标识商务终端唯一的商务终端IMEI号SoftwareVendor=Vendor#软件的著作厂家PhoneSoftVersion=Old Version#商务终端上的软件版本号PlatformSoftVersion=New Version#平台上的软件版本号系统在收到商务终端的软件升级请求之后，即根据商务终端软件升级请求的合理性回应软件升级请求：后台回应商务终端软件升级请求ResponseCommand=PhoneSoftUpdate#请求命令类型为商务终端注册Session=Session ID#当前会话IDPh

16、one=PhoneIMEI#标识商务终端唯一的商务终端IMEI号SoftwareVendor=Vendor#软件的著作厂家PhoneSoftVersion=Old Version#商务终端上的软件版本号PlatformSoftVersion=New Version#平台上的软件版本号Result=AC/NAC#系统是否支持此次升级Code=A Code#如果结果为NAC时的处理结果代码DownloadServer=Server Address#下载FTP服务器的地址DownloadPort=Server Port#下载FTP服务器的端口号DownloadDir=Server Dir#下载FTP

17、服务器的目录UserName=Server Username#下载FTP服务器的用户名Password=Server Password#下载FTP服务器的密码FileName=Update Filename#下载的文件名需要注意，如果上面的回应命令中Result为NAC，那Code后面的所有项都留空。2 数据上传此处的“数据上传”指商务测试终端在简洁模式、被动模式、主动模式下获得的数据的上传。数据上传请求RequestCommand=PhoneUpload#请求命令类型为数据上传Session=Session ID#当前会话IDPhone=PhoneIMEI#标识商务终端唯一的商务终端IMEI

18、号Filename=File Name#带上传扩展名的文件名FilePassword=Password/NAC#如果是压缩文件，回传密码，否则留空系统在收到商务终端的数据上传请求后，即根据商务终端的命令合法性（文件名合法性、商务终端是否已注册等），回应此时的数据上传请求如下：后台回应数据上传请求ResponseCommand=PhoneUpload#请求命令类型为数据上传Session=Session ID#当前会话IDPhone=PhoneIMEI#标识商务终端唯一的商务终端IMEI号Filename=File Name#带上传扩展名的文件名Result=AC/NAC#代表Request处理

19、结果,Accept和Not Accept，若为NAC，则下面与上传服务器设置相关的几项为空Code=A Code#如果结果为NAC时的处理结果代码UploadServer=Server Address#上传FTP服务器的地址UploadPort=Server Port#上传FTP服务器的端口号UploadDir=Server Dir#上传FTP服务器的目录UserName=Server Username#上传FTP服务器的用户名Password=Server Password#上传FTP服务器的密码在商务终端的FTP数据上传完成后，商务终端将向系统发送FTP数据上传完成请求，告知系统FTP数据

20、上传完成，由系统检验FTP数据是否完整。数据上传完成请求RequestCommand=PhoneUploadEOF#请求命令类型为数据上传完成Session=Session ID#当前会话IDPhone=PhoneIMEI#标识商务终端唯一的商务终端IMEI号Filename=File Name#带上传扩展名的文件名在后台收到商务终端的数据上传完成的请求后，后台将在检验文件完成性之后发送相应的回应给设备。后台回应数据上传完成请求RequestCommand=PhoneUploadEOF#请求命令类型为数据上传完成Session=Session ID#当前会话IDPhone=PhoneIMEI#

21、标识商务终端唯一的商务终端IMEI号Filename=File Name#带上传扩展名的文件名Result=AC/NAC#代表Request处理结果,Accept和Not Accept，若为NAC，则下面与上传服务器设置相关的几项为空Code=A Code#如果结果为NAC时的处理结果代码第三章 上报数据格式一 概述商务终端测试功能中，上报数据格式将遵循中国移动通信集团GERAN DT CQT测试记录规范中要求的格式说明，并根据记录的数据类型进行增补。其中：（1） 根据设备是否可以打开Trace接口，将回传数据分为简洁回传数据和完整回传数据两大类。这两类数据影响中国移动通信集团GERAN DT

22、 CQT测试记录规范中要求的回传数据字段内容。（2） 根据设备是否支持主动测试，将回传数据分为主动回传数据和被动回传数据两大类。这两类数据影响中国移动通信集团GERAN DT CQT测试记录规范回传文件头的内容。二 详细数据结构1 文件名商务终端测试的DTLOG文件名分为以下几个部分：（1） 商务终端IMEI：返回商务终端的15位IMEI。（2） 连接符：使用英文下划线“_”做为连接符。（3） 时间戳：以年月日时分秒的形式表示的商务终端测试文件的形成（开始时间）。（4） 模式说明：使用“PM”代表“被动模式”，使用“AM”代表“主动模式”。（5） 文件扩展名：生成的DTLOG文件的扩展名，遵循

23、中国移动自动路测平台对各种制式文件扩展名的规定。a. *.LOG：说明是GSM/EDGE制式的DTLOG文件。b. *.LOT：说明是TD制式的DTLOG文件。c. *.LOW：说明是WCDMA制式的DTLOG文件。d. *.LOC：说明是CDMA语音业务制式（包含CDMA 1x和CDMA 2000）的DTLOG文件。e. *.LOE：说明是CDMA EVDO数据业务制式的DTLOG文件。例如，一个IMEI为359575041376201的商务终端，其文件是2012年4月20日上午10时15分24秒开始的GSM制式文件，被动模式生成，则其文件名为：359575041376201_2012042

24、0101524PM.log2 文件信息行文件信息行说明FileInfo在每个DTLOG文件的开始都需要使用文件信息行来标识文件信息，其中：（1） DtlogVersion：与DTLOG原始数据要求相同。（2） Vendor：填写测试软件的提供商。（3） Version：填写测试软件版本。（4） NetMode：填写测试的网络制式。（5） Time：与DTLOG原始数据要求相同。（6） Device：填写测试设备的IMEI号。（7） Type：如果数据为主动测试数据，则填写“AM”；如果数据为被动测试数据，则填写“PM”。（8） FileMode：如果数据为简洁模式，则填写“Simple”；如果

25、数据为完整模式，则填写“Trace”。（9） TestInfo：做为保留字，用于前端上报本次的测试目的（投诉处理、日常测试等），当前填写“Null”3 文件内容对于几种模式的上报数据内容，统一以DTLOG格式上报数据为准，若只能上报单个参数的情况（例如不打开Trace接口的情况下），则上报DTLOG的原始格式数据。若可上报Trace接口数据，则根据各个测试设备的芯片类型进行数据组织：（1） 对于高通芯片的G网数据，采用集团原始的DTLOG格式。（2） 对于联芯芯片，采用TBL关键字上报其Trace接口数据。（3） 对于T3G芯片，采用TBT关键字上报其Trace接口数据。（4） 对于展讯芯片，采用TBZ关键字上报其Trace接口数据。（5） 其它的芯片和制式将在未来另文另行通知。第 13 页 共 13 页