鼎利5G測試產(chǎn)品指導書-V0831（快速上手必看文檔）

軟件配套產(chǎn)品指導書文檔歷史日期版本作者描述說明2019-10-291.0技術(shù)部初稿文檔最后一次修改時間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授權(quán)狀態(tài)一直是“Expired（AuthFailed）” 232.2.2PioneerTools服務狀態(tài)一直顯示“待連接” 243電腦環(huán)境 283.1電腦環(huán)境常見問題 283.1.1殺毒軟件 283.1.2電腦配置 283.1.3安裝路徑 283.1.4系統(tǒng)版本要求 283.1.5系統(tǒng)禁用驅(qū)動簽名強制 294終端連接 304.1海思終端連接 304.1.1海思驅(qū)動 304.1.2海思終端開端口 314.1.3海思終端連接Pioneer 324.1.4海思終端連接Pioneer常見問題 334.2高通終端連接 334.2.1高通驅(qū)動 334.2.2常見高通終端開端口 354.2.3高通終端連接Pioneer 385注意事項 405.1NSA網(wǎng)絡下終端錨點強制 405.1.1海思終端錨點強制 405.1.2高通終端錨點強制 40EP680升級說明書2升級前準備加密鎖加密鎖（超級狗）外觀顏色：深藍色標簽ID：EAxxxxx安裝通過世紀鼎利官方渠道獲取pioneer的軟件包（自帶加密狗驅(qū)動和環(huán)境庫，建議以管理員身份運行），請選擇“BlueHardDongle”（藍色硬件狗環(huán)境庫）+DongleDriver(加密狗驅(qū)動)，并在電腦上安裝。將加密鎖插上電腦的USB口，啟動pioneer軟件，加密鎖會紅燈常亮。注：Pioneer的軟件包為PioneerSetup10.4.0.xx。Pioneer的環(huán)境驅(qū)動包為PioneerDriverSetup。升級權(quán)限查看Pioneer軟件右上角，依次進入：菜單--幫助--加密狗權(quán)限查詢。加密狗權(quán)限查詢界面中，五個信息含義解釋如下：加密狗編號：加密狗內(nèi)部出廠ID。有效期：可使用的截止日期加密狗類型：正式加密狗權(quán)限如下：具體包含終端型號、網(wǎng)絡類型、業(yè)務類型、功能模塊、報表模塊、分析項模塊在線升級：權(quán)限更新或延期權(quán)限更新提供加密鎖的外部編號（或內(nèi)部ID號）給商務或技術(shù)支持申請權(quán)限已獲得我司商務或技術(shù)支持等官方通道對加密鎖的權(quán)限已增加的通知。Pioneer軟件右上角，依次進入：菜單--幫助--加密狗權(quán)限查詢—在線升級。在LicenseUpdateTool界面，點擊升級，升級后會提示“更新成功”。有效期延期操作流程參考章節(jié)，補充說明：加密鎖類型為正式的，有效期是永久的，但需要每3個月進行聯(lián)網(wǎng)自動升級，與權(quán)限服務器進行權(quán)限校驗和自動延期3個月，并且在即將到期的7天前開始友情提醒。加密鎖類型為借試用的，有效期是固定的（一般為一個月，看具體交付），并且在即將到期的7天前開始友情提醒。如果需要繼續(xù)使用，需聯(lián)系公司商務進行申請延期或購買。加密鎖未在提醒期間升級的，將無法啟動軟件；如果需要升級，可在電腦：開始—程序—PilotPioneer10.4.0.xx目錄下，找到LicenseUpdateTool，點擊啟動。（或者載安裝目錄下啟動LicenseUpdateTool譬如：D:\ProgramFiles(x86)\DingLi\PilotPioneer10.4.0.xx\System）加密鎖使用常見問題解決辦法軟件啟動提示：未找到軟件狗（H0007）解決辦法：1，確定電腦已插上鼎利官方的加密鎖2，檢查加密狗硬件是否正常（紅燈是否亮起）工具升級提示：連接超時解決辦法：1，確定電腦能訪問外網(wǎng)，并且沒有網(wǎng)絡限制，譬如：使用手機熱點等更換下電腦網(wǎng)絡，重新升級。工具升級提示：未知錯誤解決辦法：1，確定電腦能訪問外網(wǎng)2，建議嘗試不同運營商的網(wǎng)絡，譬如電信的寬帶或手機熱點。LicenseUpdateTool.exe工具無法打開使用開始菜單快捷方式、或直接進入安裝目錄下System\LicenseUpdateTool.exe均無法打開升級工具；解決辦法：排查軟件是否安裝在計算機系統(tǒng)盤，建議更換其它盤符進行安裝。加密鎖（新黑狗）外觀顏色：黑色標簽ID：AWxxxxx安裝通過世紀鼎利官方渠道獲取pioneer的軟件包（自帶加密狗驅(qū)動和環(huán)境庫，建議以管理員身份運行），請選擇“BlackHardDongle”（黑色硬件狗環(huán)境庫）+DongleDriver(加密狗驅(qū)動），并在電腦上安裝。將加密鎖插上電腦的USB口，啟動pioneer軟件，加密鎖會紅燈常亮。升級權(quán)限查看Pioneer軟件右上角，依次進入：菜單--幫助--加密狗權(quán)限查詢。加密狗權(quán)限查詢界面中，五個信息含義解釋如下：加密狗編號：加密狗內(nèi)部出廠ID。有效期：可使用的截止日期加密狗類型：正式加密狗權(quán)限如下：具體包含終端型號、網(wǎng)絡類型、業(yè)務類型、功能模塊、報表模塊、分析項模塊在線升級：權(quán)限更新或延期權(quán)限更新提供加密鎖的外部編號（或內(nèi)部ID號）給商務或技術(shù)支持申請權(quán)限已獲得我司商務或技術(shù)支持等官方通道對加密鎖的權(quán)限已增加的通知。電腦保持能上網(wǎng)，瀏覽器打開3:8000/home網(wǎng)址，進入DingLi權(quán)限管理客戶端。在DingLi權(quán)限管理客戶端界面，直接點擊“服務：在線鎖更新”，會進去更新界面，在點擊更新，會提示“更新成功”。有效期延期操作流程參考章節(jié)，補充說明：加密鎖類型為正式的，有效期是永久的，但需要每3個月進行聯(lián)網(wǎng)自動升級，與權(quán)限服務器進行權(quán)限校驗和自動延期3個月，并且在即將到期的7天前開始友情提醒。加密鎖類型為借試用的，有效期是固定的（一般為一個月，看具體交付），并且在即將到期的7天前開始友情提醒。如果需要繼續(xù)使用，需聯(lián)系公司商務進行申請延期或購買。加密鎖未在提醒期間升級的，將無法啟動軟件；如果需要升級，參考章節(jié)的步驟4操作便可。加密鎖使用常見問題解決辦法軟件啟動提示：權(quán)限已到期（H0041）解決辦法：請確定加密狗權(quán)限是否延期，如果是購買的永久權(quán)限狗，參考1-2-3-2章節(jié)，訪問web在線更新便可；如果是借試用或租賃的加密狗，請先延期，再進行在線更新。軟件啟動提示：未找到加密狗（H0007）解決辦法：1，按1.2.2安裝章節(jié)確認是否安裝時選擇BlackHardDongle”（黑色硬件狗環(huán)境庫）+DongleDriver；2，加密狗請確認是否是10.4版本的5G加密狗。軟件啟動提示：超過最長離線使用許可解決辦法：1，電腦聯(lián)網(wǎng)點擊確定即可；2，如果聯(lián)網(wǎng)點擊確定還是一直報這個，說明pioneer版本太老，請聯(lián)系鼎利技術(shù)支持更新pioneer版本（0版本之后的版本）。加密鎖（軟狗）外觀6XdXd1X6-bXXb-44Xb-8XX3-7ce6XXXXXX10(32位數(shù)字+字母組成的密匙串)安裝務必確定好即將激活的電腦為測試電腦，密匙將和該電腦進行綁定，且已激活的電腦不可以重裝系統(tǒng)，否則請先聯(lián)系鼎利技術(shù)支持安排權(quán)限備份工作。通過世紀鼎利官方渠道獲取pioneer的軟件包（自帶加密狗驅(qū)動和環(huán)境庫，建議以管理員身份運行），請選擇“SoftDongle”（軟鎖環(huán)境庫）+DongleDriver(加密狗驅(qū)動安裝)，并在電腦上安裝。電腦保持能上網(wǎng)，瀏覽器打開3:8000/home網(wǎng)址，進入DingLi權(quán)限管理客戶端。在DingLi權(quán)限管理客戶端界面，直接點擊“服務：軟鎖在線激活”，會進去激活界面，客戶收到密鑰后，拷貝到前臺登錄網(wǎng)頁并點擊“登錄”。進入軟件鎖的激活及更新頁面，點擊在線激活產(chǎn)品>確定，激活軟件鎖，激活成功后，界面會顯示激活成功。升級權(quán)限查看參考章節(jié)權(quán)限更新參考章節(jié)有效期延期參考章節(jié)加密鎖使用常見問題解決辦法軟件啟動提示：權(quán)限已到期（H0041）解決辦法：請確定加密狗權(quán)限是否延期，如果是購買的永久權(quán)限狗，參考1-2-3-2章節(jié)，訪問web在線更新便可；如果是借試用或租賃的加密狗，請先延期，再進行在線更新。軟件啟動提示：未找到加密狗（H0031）解決辦法：1，按1.3.2安裝章節(jié)確認是否安裝時選擇SoftDongle”（軟狗環(huán)境庫）+DongleDriver；2，請確定該軟件狗是否權(quán)限到期，被我司已回收。軟件啟動提示：超過最長離線使用許可解決辦法：1，電腦聯(lián)網(wǎng)點擊確定即可；2，如果聯(lián)網(wǎng)點擊確定還是一直報這個，說明pioneer版本太老，請聯(lián)系鼎利技術(shù)支持更新pioneer版本（0版本之后的版本）。軟狗遷移如果需要遷移軟狗到新電腦，需要先將軟狗回收，需要聯(lián)系鼎利技術(shù)或商務給該狗增加回收權(quán)限，加了回收權(quán)限后重新打開pioneer會彈出回收的窗口，點擊確定即可。回收后聯(lián)系鼎利技術(shù)或商務重新提供一個新的軟狗號，重新再新電腦上激活即可。如果電腦系統(tǒng)或硬盤故障導致無法先回收的，需要聯(lián)系鼎利技術(shù)支持，提供準確的軟狗號給他們嘗試找回權(quán)限。PioneerToolsAPPPioneerToolsLOGOPioneerTools是pioneer軟件控制手機終端進行業(yè)務測試的APK工具安裝通過世紀鼎利官方渠道獲取PioneerTools的軟件包，并在手機上安裝，安裝方法：直接將APK文件拷進手機內(nèi)存里雙擊運行。Pioneertools界面中，七個信息含義解釋如下：ID：手機的IMEI。授權(quán)狀態(tài)：未授權(quán)、Valid(xxxx-xx-xx)、NoLicense(原因碼)、Expired(xxxx-xx-xx)服務狀態(tài)：待連接、已停止、重啟中、已連接、已斷開、語音業(yè)務測試中、數(shù)據(jù)業(yè)務測試中、并發(fā)業(yè)務測試中重啟Pioneer服務：即重啟APP服務版本號：即當前的pioneertools版本號，一般以年+月+日標記關(guān)于：可顯示當前擁有的權(quán)限（第一次安裝才顯示）退出：退出APP對USB數(shù)據(jù)線的要求：PC連接使用數(shù)據(jù)線時選擇手機終端配套的USB連接線（優(yōu)先）。版本要求：Pioneertools版本需要與pioneer版本匹配正確。為保證Pioneertools工具能夠正常與PC連接通信，請檢查以下幾項：手機上的USB調(diào)試模式已打開，“僅充電”模式下允許ADB調(diào)試打開（海思終端才有）。USB調(diào)試打開方式：設置→關(guān)于本機里，連續(xù)點擊版本號那一行7次，調(diào)出開發(fā)人員選項，在設置→系統(tǒng)（系統(tǒng)和更新）里出現(xiàn)開發(fā)人員選項，USB調(diào)試就在里面。每部手機終端第一次連接PC時，PC端會彈出“是否允許該電腦對手機進行任何操作”的提示,且一定要勾選始終允許（如忘記選擇，可以重新插拔usb或點擊撤銷USB調(diào)試授權(quán)后重新打開上面第1）點兩項，讓終端再次彈出）。當軟件pioneer啟動并檢測/連接終端成功后，服務狀態(tài)會顯示“已連接”，即連接成功。如果還是待連接，則需如下圖操作，確認電腦是否有認到ADB端口、ADB設備。ADB端口，如果沒有，插拔USB或開關(guān)一次USB調(diào)試；通過CMD進入pioneer里面的ADB路徑，通過adbdevices指令，檢測是否認到設備SN、ADB狀態(tài)是否正常，如正常，則重啟終端再連接，如未授權(quán)則退回本項第2）步操作；沒有認到終端SN，繼續(xù)敲下圖指令返回如下，代表電腦ADB口被限制（占用），需要找自己公司IT解除該限制。當軟件pioneer進行語音/數(shù)據(jù)/并發(fā)業(yè)務測試時，Pioneertools的服務狀態(tài)也會對應顯示“語音業(yè)務測試中”、“數(shù)據(jù)業(yè)務測試中”、“并發(fā)業(yè)務測試中”。升級有效期延期提供PioneerTools的ID號給商務或技術(shù)支持申請權(quán)限已獲得我司商務或技術(shù)支持等官方通道對PioneerTools延期的通知。手機保持能訪問外網(wǎng)，重啟Pioneer服務或退出，重新啟動軟件，便可自動更新權(quán)限。PioneerTools使用常見問題解決辦法PioneerTools授權(quán)狀態(tài)一直是“Expired（AuthFailed）”解決辦法：先卸載該APP，并把手機存儲里的歷史安裝目錄文件夾（內(nèi)部存儲-piontool文件夾）刪掉，再重新安裝。PioneerTools服務狀態(tài)一直顯示“待連接”解決辦法：檢查PioneerTools的授權(quán)狀態(tài)是否正常。檢查手機開發(fā)者選項USB調(diào)試開關(guān)是否打開檢查手機端口是否正常請在“設備管理器”中查看是否出現(xiàn)“ADBInterface”，正常情況如圖2-1所示。圖2-1設備管理器狀態(tài)圖返回參考第2.1.2章節(jié)的步驟進行一一核查，還是連接不上，請按照如下步驟檢查是否由于adb端口被占用。設置系統(tǒng)環(huán)境變量ANDROID_ADB_SERVER_PORT操作步驟如下：Windows7:計算機右鍵->屬性->高級系統(tǒng)設置->環(huán)境變量->新建(以WIN7系統(tǒng)為例，其他操作系統(tǒng)可百度)變量名ANDROID_ADB_SERVER_PORT變量值7035如圖2-2所示圖2-2環(huán)境變量設置窗口2、查看ADB默認端口7035是否被占用操作步驟如下：1)、查看adb端口是否被其他進程占用。C:\DocumentsandSettings\wWX166483>adbnodaemonservercannotbind'tcp:7035如果出現(xiàn)cannotbind'tcp:7035字符串，表示該端口已經(jīng)被占用。2)、查看占用該端口的進程，找到該進程號。C:\DocumentsandSettings\wWX166483>netstat-ano|findstr"7035"TCP:7035:0LISTENING2832如果出現(xiàn)上面的字符串，表示有進程占用，并且該進程的進程號為28323)、進入任務管理器，找到該進程號，殺掉該進程。a）進入任務管理器，點擊查看，選擇列 圖2-26任務管理器窗口b）勾選PID(進程標示符)（P）,就可以再任務管理器中看到每個進程的PID圖2-27任務管理器選擇列窗口c）找到剛才占用端口的進程，右鍵選擇結(jié)束進程樹，殺掉占用端口7035的進程。d）重新啟動serverC:\DocumentsandSettings\wWX166483>adbstart-server*daemonnotrunning.startingitnowonport7035**daemonstartedsuccessfully電腦環(huán)境電腦環(huán)境常見問題殺毒軟件測試電腦建議不要安裝殺毒等防火墻軟件，例如360，QQ殺毒，魯大師，金山毒霸等，因為安裝測試軟件的時候，殺毒軟件會把測試軟件里面一些必要的插件誤當成病毒給殺掉或者隔離掉，造成軟件運行不起來或者運行過程有問題，如果電腦已經(jīng)裝了殺毒軟件的，建議測試時務必關(guān)掉或退出殺毒軟件(任務進程中完全殺掉)。電腦配置5G測試對于電腦的高速讀寫能力有一定要求，建議電腦CPUi7處理器，內(nèi)存8g，系統(tǒng)盤最好固態(tài)硬盤以上配置。安裝路徑pioneer軟件建議安裝在非系統(tǒng)盤，譬如安裝到D盤(如果空間足夠)，安裝在系統(tǒng)盤會占用系統(tǒng)資源。系統(tǒng)版本要求電腦系統(tǒng)建議安裝64位的win7、win10的旗艦版或?qū)I(yè)版系統(tǒng)，不能安裝Ghost版、純凈版或優(yōu)化版系統(tǒng)，因為很多必要的系統(tǒng)配置文件會被優(yōu)化掉，容易導致軟件運行出問題。另外如有些測試電腦如果長期使用于測試容易出現(xiàn)卡頓現(xiàn)象的，建議修復一遍系統(tǒng)或者清理一下系統(tǒng)垃圾，有條件就直接重裝系統(tǒng)。系統(tǒng)禁用驅(qū)動簽名強制電腦有時連終端后，發(fā)現(xiàn)端口都是黃色感嘆號，導致到Pioneer無法調(diào)用這些端口，這個是電腦禁用了驅(qū)動簽名強制導致的，需要電腦開機進入系統(tǒng)前按F8，進去選擇“禁用驅(qū)動程序簽名強制”后進入系統(tǒng)即可。終端連接海思終端連接海思驅(qū)動目前海思驅(qū)動有兩種安裝方式：第一種是直接下載海思驅(qū)動安裝，鏈接：/s/10MuqgIYGULt2VXkmSJo_-Q提取碼：lt2g第二種是下載華為手機助手安裝，連上手機會自動安裝驅(qū)動，裝上驅(qū)動后務必卸載華為手機助手（測試時可能搶占終端端口?。。┌惭b驅(qū)動后連海思終端認到的端口如圖：海思終端開端口海思終端每次開機最好重新配置下端口，開端口的方法是：撥號處輸入*#*#2846579159#*#*按下圖操作選擇5→1→Balong調(diào)試模式。如果終端輸入指令后，進不去工程模式，則在：設置→關(guān)于本機里查看版本號市面上的商用機無法開端口，測試ROM的終端版本號尾號有l(wèi)og后綴，代表可以開端口，如截圖：海思終端連接Pioneer海思終端需要先安裝PioneerTools，參考本文檔2.1章節(jié)。電腦首次連接一個新終端，電腦需要連外網(wǎng)（此步驟為獲取海思代理，每7天需要重新聯(lián)網(wǎng)獲?。４蜷_Pioneer軟件，讓軟件自動識別到終端，正確端口選擇如下。點擊連接，待軟件界面連上后，觀察PioneerTools狀態(tài)是否為已連接，如果不是，參考本文檔2.1章節(jié)操作。海思終端連接Pioneer常見問題Pioneer連接海思終端無信令輸出。首先檢查端口設置是否正常，參考4.1.3正確端口選擇；手機端Balong端口切換到非測試端口，重啟測試手機，再切換至Balong端口，重新連接；Pioneer連接海思終端不成功。首先檢查端口設置是否正常，參考4.1.3正確端口選擇；確定電腦能訪問外網(wǎng)，并且沒有網(wǎng)絡限制，譬如：使用手機熱點等更換下電腦網(wǎng)絡；先關(guān)閉Pioneer，刪除(64位系統(tǒng)路徑)C:\Windows\SysWOW64\Pioneer或(32位系統(tǒng)路徑)C:\Windows\System32\Pioneer目錄下和Pioneer軟件根目錄HiSD.dat、HiSL.dat、HiSR.dat三個文件，然后重新連接；手機上不能運行其他會占用代理的程序，例如PHUSmart，如已運行，需要關(guān)掉該程序，重啟手機，重啟后還是連不上，則將手機恢復出廠設置解決。高通終端連接高通驅(qū)動高通、S20驅(qū)動鏈接：/s/10MuqgIYGULt2VXkmSJo_-Q提取碼：lt2g高通驅(qū)動安裝安裝驅(qū)動后連海思終端認到的端口如圖：X50、X55芯片的部分終端可能會沒有Modem口，但一定會有MDM（5G口）、MSM（4G口）和ADB口，但X55芯片的MSM（4G口）不需要用到，所以可以不選。X52芯片是單芯片，所以Trace口只有一個，不區(qū)分4、5G端口。常見高通終端開端口天機10/Axon10Pro開端口：打開撥號界面輸入*