鼎利5G测试产品指导书-V0831（快速上手必看文档）

软件配套产品指导书文档历史日期版本作者描述说明2019-10-291.0技术部初稿文档最后一次修改时间SAVEDATE\@"yyyy-MM-ddHH:mm:ss"2020-08-3116:48:00

目录文档历史 2目录 31加密锁 51.1加密锁（超级狗） 51.1.1外观 51.1.2安装 51.1.3升级 61.1.4加密锁使用常见问题解决办法 81.2加密锁（新黑狗） 101.2.1外观 101.2.2安装 101.2.3升级 111.2.4加密锁使用常见问题解决办法 131.3加密锁（软狗） 141.3.1外观 141.3.2安装 151.3.3升级 171.3.4加密锁使用常见问题解决办法 181.3.5软狗迁移 192PioneerToolsAPP 202.1PioneerTools 202.1.1LOGO 202.1.2安装 202.1.3升级 232.2PioneerTools使用常见问题解决办法 232.2.1PioneerTools授权状态一直是“Expired（AuthFailed）” 232.2.2PioneerTools服务状态一直显示“待连接” 243电脑环境 283.1电脑环境常见问题 283.1.1杀毒软件 283.1.2电脑配置 283.1.3安装路径 283.1.4系统版本要求 283.1.5系统禁用驱动签名强制 294终端连接 304.1海思终端连接 304.1.1海思驱动 304.1.2海思终端开端口 314.1.3海思终端连接Pioneer 324.1.4海思终端连接Pioneer常见问题 334.2高通终端连接 334.2.1高通驱动 334.2.2常见高通终端开端口 354.2.3高通终端连接Pioneer 385注意事项 405.1NSA网络下终端锚点强制 405.1.1海思终端锚点强制 405.1.2高通终端锚点强制 40EP680升级说明书2升级前准备加密锁加密锁（超级狗）外观颜色：深蓝色标签ID：EAxxxxx安装通过世纪鼎利官方渠道获取pioneer的软件包（自带加密狗驱动和环境库，建议以管理员身份运行），请选择“BlueHardDongle”（蓝色硬件狗环境库）+DongleDriver(加密狗驱动)，并在电脑上安装。将加密锁插上电脑的USB口，启动pioneer软件，加密锁会红灯常亮。注：Pioneer的软件包为PioneerSetup10.4.0.xx。Pioneer的环境驱动包为PioneerDriverSetup。升级权限查看Pioneer软件右上角，依次进入：菜单--帮助--加密狗权限查询。加密狗权限查询界面中，五个信息含义解释如下：加密狗编号：加密狗内部出厂ID。有效期：可使用的截止日期加密狗类型：正式加密狗权限如下：具体包含终端型号、网络类型、业务类型、功能模块、报表模块、分析项模块在线升级：权限更新或延期权限更新提供加密锁的外部编号（或内部ID号）给商务或技术支持申请权限已获得我司商务或技术支持等官方通道对加密锁的权限已增加的通知。Pioneer软件右上角，依次进入：菜单--帮助--加密狗权限查询—在线升级。在LicenseUpdateTool界面，点击升级，升级后会提示“更新成功”。有效期延期操作流程参考章节，补充说明：加密锁类型为正式的，有效期是永久的，但需要每3个月进行联网自动升级，与权限服务器进行权限校验和自动延期3个月，并且在即将到期的7天前开始友情提醒。加密锁类型为借试用的，有效期是固定的（一般为一个月，看具体交付），并且在即将到期的7天前开始友情提醒。如果需要继续使用，需联系公司商务进行申请延期或购买。加密锁未在提醒期间升级的，将无法启动软件；如果需要升级，可在电脑：开始—程序—PilotPioneer10.4.0.xx目录下，找到LicenseUpdateTool，点击启动。（或者载安装目录下启动LicenseUpdateTool譬如：D:\ProgramFiles(x86)\DingLi\PilotPioneer10.4.0.xx\System）加密锁使用常见问题解决办法软件启动提示：未找到软件狗（H0007）解决办法：1，确定电脑已插上鼎利官方的加密锁2，检查加密狗硬件是否正常（红灯是否亮起）工具升级提示：连接超时解决办法：1，确定电脑能访问外网，并且没有网络限制，譬如：使用手机热点等更换下电脑网络，重新升级。工具升级提示：未知错误解决办法：1，确定电脑能访问外网2，建议尝试不同运营商的网络，譬如电信的宽带或手机热点。LicenseUpdateTool.exe工具无法打开使用开始菜单快捷方式、或直接进入安装目录下System\LicenseUpdateTool.exe均无法打开升级工具；解决办法：排查软件是否安装在计算机系统盘，建议更换其它盘符进行安装。加密锁（新黑狗）外观颜色：黑色标签ID：AWxxxxx安装通过世纪鼎利官方渠道获取pioneer的软件包（自带加密狗驱动和环境库，建议以管理员身份运行），请选择“BlackHardDongle”（黑色硬件狗环境库）+DongleDriver(加密狗驱动），并在电脑上安装。将加密锁插上电脑的USB口，启动pioneer软件，加密锁会红灯常亮。升级权限查看Pioneer软件右上角，依次进入：菜单--帮助--加密狗权限查询。加密狗权限查询界面中，五个信息含义解释如下：加密狗编号：加密狗内部出厂ID。有效期：可使用的截止日期加密狗类型：正式加密狗权限如下：具体包含终端型号、网络类型、业务类型、功能模块、报表模块、分析项模块在线升级：权限更新或延期权限更新提供加密锁的外部编号（或内部ID号）给商务或技术支持申请权限已获得我司商务或技术支持等官方通道对加密锁的权限已增加的通知。电脑保持能上网，浏览器打开3:8000/home网址，进入DingLi权限管理客户端。在DingLi权限管理客户端界面，直接点击“服务：在线锁更新”，会进去更新界面，在点击更新，会提示“更新成功”。有效期延期操作流程参考章节，补充说明：加密锁类型为正式的，有效期是永久的，但需要每3个月进行联网自动升级，与权限服务器进行权限校验和自动延期3个月，并且在即将到期的7天前开始友情提醒。加密锁类型为借试用的，有效期是固定的（一般为一个月，看具体交付），并且在即将到期的7天前开始友情提醒。如果需要继续使用，需联系公司商务进行申请延期或购买。加密锁未在提醒期间升级的，将无法启动软件；如果需要升级，参考章节的步骤4操作便可。加密锁使用常见问题解决办法软件启动提示：权限已到期（H0041）解决办法：请确定加密狗权限是否延期，如果是购买的永久权限狗，参考1-2-3-2章节，访问web在线更新便可；如果是借试用或租赁的加密狗，请先延期，再进行在线更新。软件启动提示：未找到加密狗（H0007）解决办法：1，按1.2.2安装章节确认是否安装时选择BlackHardDongle”（黑色硬件狗环境库）+DongleDriver；2，加密狗请确认是否是10.4版本的5G加密狗。软件启动提示：超过最长离线使用许可解决办法：1，电脑联网点击确定即可；2，如果联网点击确定还是一直报这个，说明pioneer版本太老，请联系鼎利技术支持更新pioneer版本（0版本之后的版本）。加密锁（软狗）外观6XdXd1X6-bXXb-44Xb-8XX3-7ce6XXXXXX10(32位数字+字母组成的密匙串)安装务必确定好即将激活的电脑为测试电脑，密匙将和该电脑进行绑定，且已激活的电脑不可以重装系统，否则请先联系鼎利技术支持安排权限备份工作。通过世纪鼎利官方渠道获取pioneer的软件包（自带加密狗驱动和环境库，建议以管理员身份运行），请选择“SoftDongle”（软锁环境库）+DongleDriver(加密狗驱动安装)，并在电脑上安装。电脑保持能上网，浏览器打开3:8000/home网址，进入DingLi权限管理客户端。在DingLi权限管理客户端界面，直接点击“服务：软锁在线激活”，会进去激活界面，客户收到密钥后，拷贝到前台登录网页并点击“登录”。进入软件锁的激活及更新页面，点击在线激活产品>确定，激活软件锁，激活成功后，界面会显示激活成功。升级权限查看参考章节权限更新参考章节有效期延期参考章节加密锁使用常见问题解决办法软件启动提示：权限已到期（H0041）解决办法：请确定加密狗权限是否延期，如果是购买的永久权限狗，参考1-2-3-2章节，访问web在线更新便可；如果是借试用或租赁的加密狗，请先延期，再进行在线更新。软件启动提示：未找到加密狗（H0031）解决办法：1，按1.3.2安装章节确认是否安装时选择SoftDongle”（软狗环境库）+DongleDriver；2，请确定该软件狗是否权限到期，被我司已回收。软件启动提示：超过最长离线使用许可解决办法：1，电脑联网点击确定即可；2，如果联网点击确定还是一直报这个，说明pioneer版本太老，请联系鼎利技术支持更新pioneer版本（0版本之后的版本）。软狗迁移如果需要迁移软狗到新电脑，需要先将软狗回收，需要联系鼎利技术或商务给该狗增加回收权限，加了回收权限后重新打开pioneer会弹出回收的窗口，点击确定即可。回收后联系鼎利技术或商务重新提供一个新的软狗号，重新再新电脑上激活即可。如果电脑系统或硬盘故障导致无法先回收的，需要联系鼎利技术支持，提供准确的软狗号给他们尝试找回权限。PioneerToolsAPPPioneerToolsLOGOPioneerTools是pioneer软件控制手机终端进行业务测试的APK工具安装通过世纪鼎利官方渠道获取PioneerTools的软件包，并在手机上安装，安装方法：直接将APK文件拷进手机内存里双击运行。Pioneertools界面中，七个信息含义解释如下：ID：手机的IMEI。授权状态：未授权、Valid(xxxx-xx-xx)、NoLicense(原因码)、Expired(xxxx-xx-xx)服务状态：待连接、已停止、重启中、已连接、已断开、语音业务测试中、数据业务测试中、并发业务测试中重启Pioneer服务：即重启APP服务版本号：即当前的pioneertools版本号，一般以年+月+日标记关于：可显示当前拥有的权限（第一次安装才显示）退出：退出APP对USB数据线的要求：PC连接使用数据线时选择手机终端配套的USB连接线（优先）。版本要求：Pioneertools版本需要与pioneer版本匹配正确。为保证Pioneertools工具能够正常与PC连接通信，请检查以下几项：手机上的USB调试模式已打开，“仅充电”模式下允许ADB调试打开（海思终端才有）。USB调试打开方式：设置→关于本机里，连续点击版本号那一行7次，调出开发人员选项，在设置→系统（系统和更新）里出现开发人员选项，USB调试就在里面。每部手机终端第一次连接PC时，PC端会弹出“是否允许该电脑对手机进行任何操作”的提示,且一定要勾选始终允许（如忘记选择，可以重新插拔usb或点击撤销USB调试授权后重新打开上面第1）点两项，让终端再次弹出）。当软件pioneer启动并检测/连接终端成功后，服务状态会显示“已连接”，即连接成功。如果还是待连接，则需如下图操作，确认电脑是否有认到ADB端口、ADB设备。ADB端口，如果没有，插拔USB或开关一次USB调试；通过CMD进入pioneer里面的ADB路径，通过adbdevices指令，检测是否认到设备SN、ADB状态是否正常，如正常，则重启终端再连接，如未授权则退回本项第2）步操作；没有认到终端SN，继续敲下图指令返回如下，代表电脑ADB口被限制（占用），需要找自己公司IT解除该限制。当软件pioneer进行语音/数据/并发业务测试时，Pioneertools的服务状态也会对应显示“语音业务测试中”、“数据业务测试中”、“并发业务测试中”。升级有效期延期提供PioneerTools的ID号给商务或技术支持申请权限已获得我司商务或技术支持等官方通道对PioneerTools延期的通知。手机保持能访问外网，重启Pioneer服务或退出，重新启动软件，便可自动更新权限。PioneerTools使用常见问题解决办法PioneerTools授权状态一直是“Expired（AuthFailed）”解决办法：先卸载该APP，并把手机存储里的历史安装目录文件夹（内部存储-piontool文件夹）删掉，再重新安装。PioneerTools服务状态一直显示“待连接”解决办法：检查PioneerTools的授权状态是否正常。检查手机开发者选项USB调试开关是否打开检查手机端口是否正常请在“设备管理器”中查看是否出现“ADBInterface”，正常情况如图2-1所示。图2-1设备管理器状态图返回参考第2.1.2章节的步骤进行一一核查，还是连接不上，请按照如下步骤检查是否由于adb端口被占用。设置系统环境变量ANDROID_ADB_SERVER_PORT操作步骤如下：Windows7:计算机右键->属性->高级系统设置->环境变量->新建(以WIN7系统为例，其他操作系统可百度)变量名ANDROID_ADB_SERVER_PORT变量值7035如图2-2所示图2-2环境变量设置窗口2、查看ADB默认端口7035是否被占用操作步骤如下：1)、查看adb端口是否被其他进程占用。C:\DocumentsandSettings\wWX166483>adbnodaemonservercannotbind'tcp:7035如果出现cannotbind'tcp:7035字符串，表示该端口已经被占用。2)、查看占用该端口的进程，找到该进程号。C:\DocumentsandSettings\wWX166483>netstat-ano|findstr"7035"TCP:7035:0LISTENING2832如果出现上面的字符串，表示有进程占用，并且该进程的进程号为28323)、进入任务管理器，找到该进程号，杀掉该进程。a）进入任务管理器，点击查看，选择列 图2-26任务管理器窗口b）勾选PID(进程标示符)（P）,就可以再任务管理器中看到每个进程的PID图2-27任务管理器选择列窗口c）找到刚才占用端口的进程，右键选择结束进程树，杀掉占用端口7035的进程。d）重新启动serverC:\DocumentsandSettings\wWX166483>adbstart-server*daemonnotrunning.startingitnowonport7035**daemonstartedsuccessfully电脑环境电脑环境常见问题杀毒软件测试电脑建议不要安装杀毒等防火墙软件，例如360，QQ杀毒，鲁大师，金山毒霸等，因为安装测试软件的时候，杀毒软件会把测试软件里面一些必要的插件误当成病毒给杀掉或者隔离掉，造成软件运行不起来或者运行过程有问题，如果电脑已经装了杀毒软件的，建议测试时务必关掉或退出杀毒软件(任务进程中完全杀掉)。电脑配置5G测试对于电脑的高速读写能力有一定要求，建议电脑CPUi7处理器，内存8g，系统盘最好固态硬盘以上配置。安装路径pioneer软件建议安装在非系统盘，譬如安装到D盘(如果空间足够)，安装在系统盘会占用系统资源。系统版本要求电脑系统建议安装64位的win7、win10的旗舰版或专业版系统，不能安装Ghost版、纯净版或优化版系统，因为很多必要的系统配置文件会被优化掉，容易导致软件运行出问题。另外如有些测试电脑如果长期使用于测试容易出现卡顿现象的，建议修复一遍系统或者清理一下系统垃圾，有条件就直接重装系统。系统禁用驱动签名强制电脑有时连终端后，发现端口都是黄色感叹号，导致到Pioneer无法调用这些端口，这个是电脑禁用了驱动签名强制导致的，需要电脑开机进入系统前按F8，进去选择“禁用驱动程序签名强制”后进入系统即可。终端连接海思终端连接海思驱动目前海思驱动有两种安装方式：第一种是直接下载海思驱动安装，链接：/s/10MuqgIYGULt2VXkmSJo_-Q提取码：lt2g第二种是下载华为手机助手安装，连上手机会自动安装驱动，装上驱动后务必卸载华为手机助手（测试时可能抢占终端端口！！）安装驱动后连海思终端认到的端口如图：海思终端开端口海思终端每次开机最好重新配置下端口，开端口的方法是：拨号处输入*#*#2846579159#*#*按下图操作选择5→1→Balong调试模式。如果终端输入指令后，进不去工程模式，则在：设置→关于本机里查看版本号市面上的商用机无法开端口，测试ROM的终端版本号尾号有log后缀，代表可以开端口，如截图：海思终端连接Pioneer海思终端需要先安装PioneerTools，参考本文档2.1章节。电脑首次连接一个新终端，电脑需要连外网（此步骤为获取海思代理，每7天需要重新联网获取）。打开Pioneer软件，让软件自动识别到终端，正确端口选择如下。点击连接，待软件界面连上后，观察PioneerTools状态是否为已连接，如果不是，参考本文档2.1章节操作。海思终端连接Pioneer常见问题Pioneer连接海思终端无信令输出。首先检查端口设置是否正常，参考4.1.3正确端口选择；手机端Balong端口切换到非测试端口，重启测试手机，再切换至Balong端口，重新连接；Pioneer连接海思终端不成功。首先检查端口设置是否正常，参考4.1.3正确端口选择；确定电脑能访问外网，并且没有网络限制，譬如：使用手机热点等更换下电脑网络；先关闭Pioneer，删除(64位系统路径)C:\Windows\SysWOW64\Pioneer或(32位系统路径)C:\Windows\System32\Pioneer目录下和Pioneer软件根目录HiSD.dat、HiSL.dat、HiSR.dat三个文件，然后重新连接；手机上不能运行其他会占用代理的程序，例如PHUSmart，如已运行，需要关掉该程序，重启手机，重启后还是连不上，则将手机恢复出厂设置解决。高通终端连接高通驱动高通、S20驱动链接：/s/10MuqgIYGULt2VXkmSJo_-Q提取码：lt2g高通驱动安装安装驱动后连海思终端认到的端口如图：X50、X55芯片的部分终端可能会没有Modem口，但一定会有MDM（5G口）、MSM（4G口）和ADB口，但X55芯片的MSM（4G口）不需要用到，所以可以不选。X52芯片是单芯片，所以Trace口只有一个，不区分4、5G端口。常见高通终端开端口天机10/Axon10Pro开端口：打开拨号界面输入*