格西烽火使用用戶手冊

1、上海格西信息科技有限公司格西烽火用戶手冊版本 1.0格西烽火 49 目錄1.簡介41.1關于41.2功能特性41.3系統(tǒng)要求41.4許可與購買51.4.1版權(quán)51.4.2最終用戶許可協(xié)議51.4.3購買71.5支持服務72.軟件入門72.1啟動軟件72.2用戶界面82.2.1主界面82.2.2應用程序菜單82.2.3工具欄102.2.4狀態(tài)欄122.2.5控制臺122.2.6數(shù)據(jù)區(qū)142.3軟件設置152.3.1常規(guī)設置152.3.2激勵工程設置162.3.3插件信息162.4軟件注冊173.直接激勵項目183.1簡介183.2基本操作193.2.1新建直接激勵項目193.2.2打開直接激勵項

2、目193.2.3關閉直接激勵項目193.2.4保存直接激勵項目203.2.5修改直接激勵項目屬性203.2.6添加直接激勵項203.2.7刪除直接激勵項203.2.8激勵203.2.9停止激勵213.3用途214.協(xié)議激勵項目214.1簡介214.2基本操作214.2.1新建協(xié)議激勵項目214.2.2打開協(xié)議激勵項目214.2.3關閉協(xié)議激勵項目224.2.4保存協(xié)議激勵項目224.2.5修改協(xié)議激勵項目屬性224.2.6添加協(xié)議集224.2.7添加協(xié)議項234.2.8激勵254.2.9停止激勵254.3協(xié)議幀254.4協(xié)議腳本264.4.1腳本界面274.4.2腳本結(jié)構(gòu)284.4.3腳本參數(shù)

3、BSCaseContext類294.4.4串口參數(shù)BSComStreamParameters類404.4.5腳本中使用插件445.插件455.1托管代碼與非托管代碼455.2編寫插件455.3使用托管代碼的第三方庫455.4使用非托管代碼的第三方庫456.工具箱466.1校驗和計算器466.2CRC計算器466.3DES計算器476.4哈希值計算器487.應用技巧497.1分類組織協(xié)議激勵項目的協(xié)議項497.2運行多個軟件實例498.FAQ498.1進行“反饋”或者“注冊軟件”操作時，為什么出現(xiàn)Unknown error (0x80041002)錯誤？498.2進行協(xié)議激勵時，從動方已經(jīng)發(fā)出正

4、確的幀，為什么主動激勵方卻返回失??？49用戶手冊 1. 簡介1.1 關于格西烽火是一個基于串口通信的多功能測試工具。研發(fā)和測試人員可以利用它來接收和顯示串口數(shù)據(jù)，快速創(chuàng)建、運行和管理各種直接激勵源和協(xié)議激勵源，并以項目文件的方式進行組織，徹底地把多變的通信規(guī)約脫離通信軟件，使得通信軟件能夠應付快速多變的通信環(huán)境。格西烽火帶來的好處：Ø 單一的測試工具取代眾多定制的測試工具，極大的降低測試開發(fā)、維護和學習成本Ø 快捷的激勵源管理方式，即改即測，極大的降低研發(fā)成本Ø 以文件的方式組織項目，有利于管理眾多的測試項目，有利于測試標準化Ø 支持循環(huán)激勵與激勵報告，

5、提高測試自動化水平格西烽火主要適用于：Ø 電子產(chǎn)品研發(fā)、測試和生產(chǎn)企業(yè)Ø 電子產(chǎn)品研發(fā)、測試人員1.2 功能特性本軟件發(fā)行了兩個版本：Ø 免費版（Free Edition）Ø 專業(yè)版（Professional Edition）下表列出了本軟件的功能特性以及在各個版本中的支持情況。功能特性描述免費版專業(yè)版基本功能數(shù)據(jù)接收和顯示、工具箱支持支持直接激勵創(chuàng)建、運行和管理直接激勵項目支持支持協(xié)議激勵創(chuàng)建、運行和管理協(xié)議激勵項目支持1.3 系統(tǒng)要求支持的操作系統(tǒng)：Ø Windows XP SP3Ø Windows Server 2003 SP2

6、Ø Windows Vista SP1或更高版本Ø Windows Server 2008（在服務器核心角色上不受支持）Ø Windows 7Ø Windows Server 2008 R2（在服務器核心角色上不受支持）Ø Windows 7 SP1Ø Windows Server 2008 R2 SP1支持的體系結(jié)構(gòu)：Ø x86Ø x64硬件要求：Ø 建議的最低要求：Pentium 1 GHz 或更快，1 GB RAM 或更大Ø 最小磁盤空間： x86 25 MB，x64 50 MB必備組件：

7、Ø Windows Installer 3.1 或更高版本Ø Internet Explorer 5.01 或更高版本Ø Microsoft .NET Framework 4.0 1.4 許可與購買1.4.1 版權(quán)版權(quán)所有 (C) 2014 上海格西信息科技有限公司1.4.2 最終用戶許可協(xié)議重要說明：本軟件最終用戶許可協(xié)議（以下稱協(xié)議）是您（個人或者單一實體）與上海格西信息科技有限公司之間的法律協(xié)議。請在完成安裝過程和使用本軟件之前仔細閱讀這個協(xié)議。它提供了使用本軟件的許可，并包含擔保信息和免責聲明。安裝和使用本軟件的行為表示您確認接受了本軟件，并且同意受到本協(xié)

8、議條款的約束。如果您不同意受這些條款的約束，請不要安裝該軟件。不論此處是否提及或介紹了其它軟件，本協(xié)議只適用于上海格西信息科技有限公司在此提供的軟件。1. 定義(1)“上海格西信息科技有限公司”是指上海格西信息科技有限公司及其許可方（如果有的話）。 (2)“軟件”僅指上海格西信息科技有限公司軟件程序和由上海格西信息科技有限公司在所有情況下提供的第三方軟件程序，及其相應的文檔、相關媒介、印刷材料和聯(lián)機文檔或者電子文檔。 (3)“試用版”是指該軟件的一個標識版本，它僅用于在有限的期限內(nèi)檢查、演示和評估該軟件。試用版的功能可能有所限制，可能不允許最終用戶保存最終產(chǎn)品，并且會因為內(nèi)部的機制而在預定的時

9、間期限到期后停止工作。 2. 授予許可 本協(xié)議授予您以下權(quán)利：您可在一臺計算機、工作站、終端機、手持式計算機上安裝、使用、訪問、顯示、運行或以其它方式互相作用于（“運行”）本軟件的一份副本。3. 許可限制(1) 您不能制作或分發(fā)本軟件的副本，或者用電子方式將本軟件從一臺計算機傳輸?shù)搅硪慌_計算機，或者通過網(wǎng)絡傳輸。 (2) 您不能更改、合并、修改、改編或者翻譯該軟件，或者反編譯、逆向工程、反匯編或者以其它方式將軟件分解成人類可以理解的形式。 (3) 除非在此另有規(guī)定，否則您不能租借、租賃或者轉(zhuǎn)授本軟件的許可。 (4) 除非在此另有規(guī)定，否則您不能修改本軟件或者在本軟件的基礎上創(chuàng)建任何衍生產(chǎn)品。(

10、5) 除非在此另有規(guī)定，您不能總計安裝或者使用一個以上的試用版軟件；不能用一個以上的用戶名使用本軟件的試用版；不能更改硬盤或計算機系統(tǒng)的內(nèi)容，以便使試用版軟件的累計使用時間超過一個試用版許可所允許的試用期限；不能在沒有事先獲得上海格西信息科技有限公司書面準許的情況下將使用本試用版所獲得的軟件性能指標透露給任何第三方；不能使用軟件試用版的目的并非只是為了決定是否購買本軟件商業(yè)版。 (6) 您可能會通過一種以上媒介收到該軟件，但只能安裝或使用一種媒介。不論您收到多少種媒介，您只能使用適合于要安裝本軟件的服務器或計算機的那種媒介。(7) 您可能會收到一個以上平臺的軟件，但只能安裝或使用一個平臺。 (

11、8) 您不能使用本軟件來開發(fā)主要功能與本軟件相同的任何應用程序。 (9) 如果您違反了本 協(xié)議，上海格西信息科技有限公司可以終止該許可，您必須銷毀所有軟件副本（這種終止后仍然保留雙方的所有其它權(quán)利和本協(xié)議所提供的任何其它權(quán)利）。4. 升級程序 如果本軟件副本是對該軟件早期版本的升級，提供升級程序的基礎是許可交換。您安裝和使用此類軟件副本的行為表示您自愿終止早期 協(xié)議，并且不會繼續(xù)使用該軟件的早期版本或者轉(zhuǎn)讓給其他人或?qū)嶓w，除非這種轉(zhuǎn)讓符合第3部分的規(guī)定。 5. 所有關系上述許可賦予您使用本軟件的有限許可。上海格西信息科技有限公司及其供應商保留所有權(quán)利、所有權(quán)和利益，包括軟件（作為單獨產(chǎn)品以及作

12、為您后續(xù)開發(fā)的應用程序基礎的底層產(chǎn)品）之中以及軟件本身的所有版權(quán)和知識產(chǎn)權(quán)，所有副本亦不例外。上海格西信息科技有限公司及其供應商保留本協(xié)議中沒有明確授予的所有權(quán)利。6. 有限擔保和免責聲明(1) 除非與任何示例應用程序代碼、本軟件的試用版有關，否則上海格西信息科技有限公司保證自交付之日起（以您的收據(jù)為準）的90天內(nèi)：與推薦的硬件配置一起使用時，本軟件的性能將與隨附文檔中的描述完全相符；并且在正常使用下，用于提供本軟件的物理媒介在材料和工藝上沒有任何缺陷。 (2) 上海格西信息科技有限公司不對任何示例應用程序代碼、本軟件的試用版提供任何補救措施或明示或暗示的擔保。(3) 除了上述有關所有示例應用

13、程序代碼、本軟件試用版的有限擔保外，上海格西信息科技有限公司及其供應商聲明不承擔所有其它明示、暗示或任何其它形式的擔保和表示，包括對適銷性或者特定目的適用性的擔保。此外，不擔保不侵權(quán)和所有權(quán)。上海格西信息科技有限公司不擔保本軟件無錯誤或者可以不中斷地工作。本軟件并非設計用于或許可在需有故障自動防護功能的危險環(huán)境中使用，包括但不限于，核設施、飛機導航或通信系統(tǒng)、空中交通管制、生命保障系統(tǒng)或武器系統(tǒng)的設計、制造、維護或運行等。上海格西信息科技有限公司明確聲明不提供任何此類用途適用性的明示或暗示擔保。(4) 如果適用法律要求提供與本軟件有關的任何擔保，所有此類擔保的有效期僅限于交付之日后的90天之內(nèi)

14、。(5) 上海格西信息科技有限公司、其經(jīng)銷商、分銷商、代理或者雇員提供的任何口頭或書面信息均不構(gòu)成擔保或者以任何方式擴大此處提供的擔保范圍。 7. 唯一補救措施您的唯一補救措施是將軟件退回購買處，同時提供收據(jù)和問題描述。只要在交付之日后的90天內(nèi)以書面形式向上海格西信息科技有限公司提供任何與上述擔保不符的情況，上海格西信息科技有限公司將用合理的商業(yè)努力為您提供一個完全符合文檔的替換軟件版本，替換有缺陷的媒介，或者按照您購買軟件時的付款額退款，具體措施由上海格西信息科技有限公司選擇。在以下情況下上海格西信息科技有限公司不承擔責任：軟件已被以任何形式更改；因為誤用、事故、濫用、修改或者應用不當而損

15、壞了媒介；或者因為使用非推薦的硬件配置而造成軟件無法使用。若有任何軟件誤用、事故、濫用、修改或者應用不當?shù)那闆r，上述擔保將會無效。這是給您的唯一的補救措施，用于彌補與本軟件及其相關文檔有關的明示或暗示的擔保中的過失。8. 責任限制(1) 若因使用或者無法使用本軟件而出現(xiàn)的，并且以任何責任理論為依據(jù)的，包括違約、擔保過失、民事侵權(quán)行為（包括疏忽）、產(chǎn)品責任等造成的任何間接、特殊、偶發(fā)、懲罰性、覆蓋性或者繼發(fā)損害（包括但不限于無法使用設備或訪問數(shù)據(jù)造成的損壞、業(yè)務損失、利潤損失、營業(yè)中斷等），上海格西信息科技有限公司及其供應商均無需向您或任何第三方負責，即使上海格西信息科技有限公司或其代表事先已經(jīng)

16、得到了可能造成此種損壞的通知，并且即使此處所述的補救措施未能發(fā)揮應有效用，情況亦不例外。(2) 上海格西信息科技有限公司對任何原因造成的實際損壞的總賠償金額限于您購買引起這種損壞的軟件而支付的金額。(3) 上述責任限制適用于以上擔保和免責聲明以及本協(xié)議的所有其它方面。9. 通則本協(xié)議適用中華人民共和國著作權(quán)法、中華人民共和國計算機軟件保護條例、中華人民共和國商標法、中華人民共和國專利法等法律法規(guī)。本協(xié)議受中華人民共和國法律管轄。1.4.3 購買注冊專業(yè)版優(yōu)勢Ø 許可在商業(yè)環(huán)境下使用本軟件Ø 獲得用戶身份校驗信息和豐富的高級功能Ø 獲得支持和幫助購買方式方式1：與銷

17、售代表聯(lián)系Ø 電子郵件：salesØ 電話式2：從淘寶網(wǎng)（）格西旗艦店直接購買Ø 網(wǎng)址：1.5 支持服務您在使用本軟件的過程中遇到問題或者希望獲得產(chǎn)品的支持信息，可以通過我們的網(wǎng)站、電子郵件等方式與我們聯(lián)系。 Ø 支持網(wǎng)站：Ø 電子郵件：supportØ 微信號：gesherØ QQ：9794642. 軟件入門2.1 啟動軟件本軟件安裝成功之后，會在Windows的【開始菜單】中創(chuàng)建菜單項，同時關聯(lián)直接激勵項目文件（.bsp）和協(xié)議激勵項目文件（.bcp）。啟動軟件有兩種方法：Ø 方法1

18、：Windows【開始菜單】->“程序”->“格西烽火”->“格西烽火”。Ø 方法2：鼠標雙擊打開直接激勵項目文件（.bsp）或者協(xié)議激勵項目文件（.bcp）。2.2 用戶界面2.2.1 主界面2.2.2 應用程序菜單命令快捷鍵功能新建->協(xié)議激勵項目Ctrl+N新建一個協(xié)議激勵項目，并建立項目環(huán)境。新建->直接激勵項目Ctrl+Shift+N新建一個直接激勵項目，并建立項目環(huán)境。打開->協(xié)議激勵項目Ctrl+O打開一個協(xié)議激勵項目，并建立項目環(huán)境。打開->直接激勵項目Ctrl+Shift+O打開一個直接激勵項目，并建立項目環(huán)境。關閉關閉當前

19、激活的項目。保存Ctrl+S保存當前激活的項目。另存為將當前激活的項目保存到指定路徑。全部保存Ctrl+Shift+S保存當前打開的所有項目。設置設置軟件的運行參數(shù)。注冊產(chǎn)品注冊軟件，獲得更多功能和服務，注冊成功隱藏該菜單。幫助F1軟件的使用幫助。關于顯示軟件的版權(quán)、版本以及注冊信息等。退出Alt+F4退出系統(tǒng)。2.2.3 工具欄基本工具欄（無項目狀態(tài)）命令功能打開/關閉打開或者關閉串口串口號設置串口號，自動檢測當前系統(tǒng)有效的串口設備。波特率設置波特率，提供標準波特率，支持自定義波特率輸入。數(shù)據(jù)位設置數(shù)據(jù)位，支持5、6、7、8。停止位設置停止位，支持1、1.5、2。校驗位設置校驗位，支持無、奇

20、校驗、偶校驗、置1、置0。流控制（握手協(xié)議）設置流控制，支持無、RequestToSend、XonXoff、RequestToSend /XonXoff。RTS設置在串行通信中是否啟用請求發(fā)送 (RTS) 信號DTR設置在串行通信中是否啟用數(shù)據(jù)終端就緒 (DTR) 信號。HEX設置數(shù)據(jù)面板數(shù)據(jù)顯示格式，選中表示解析為HEX字符串，不選表示直接解析為字符串。清除清除所有數(shù)據(jù)區(qū)的顯示數(shù)據(jù)，不影響已經(jīng)保存的數(shù)據(jù)。折疊工具欄（右上角第1個按鈕）顯示/折疊工具欄。反饋（右上角第2個按鈕）顯示用戶反饋對話框。幫助（右上角第3個按鈕）顯示用戶幫助。協(xié)議激勵工具欄（通信接口已折疊）命令功能激勵單次激勵選中的協(xié)

21、議項或者協(xié)議集，下來菜單提供循環(huán)激勵功能。停止停止運行協(xié)議激勵。報告下來菜單提供顯示/隱藏協(xié)議激勵報告，導出協(xié)議報告。添加下來菜單提供在當前選定節(jié)點的添加協(xié)議項或者協(xié)議集功能。保存保存協(xié)議激勵項目。剪切剪切當前選定節(jié)點。復制復制當前選定節(jié)點。粘貼在當前選定節(jié)點粘貼。刪除刪除當前選定節(jié)點。屬性顯示當前選定節(jié)點的屬性對話框。直接激勵工具欄（通信接口已折疊）命令功能激勵單次激勵直接激勵項目所有激活的激勵項，下來菜單提供循環(huán)激勵功能。停止停止運行直接激勵。添加下來菜單提供在當前選定節(jié)點的添加協(xié)議項或者協(xié)議集功能。保存保存直接激勵項目。刪除刪除當前選定的激勵項。屬性顯示直接激勵項目的屬性對話框。常用工具

22、工具欄命令功能計算器運行系統(tǒng)提供的計算器程序。校驗和運行工具箱的校驗和計算器。CRC運行工具箱的CRC計算器。DES運行工具箱的DES計算器。哈希值運行工具箱的哈希值計算器。2.2.4 狀態(tài)欄狀態(tài)欄分為三部分，分別為操作狀態(tài)信息、通信傳輸字節(jié)信息、通信接口狀態(tài)信息。狀態(tài)欄功能操作狀態(tài)信息顯示上一次操作的狀態(tài)信息，有錯誤、警告、信息三種狀態(tài)。通信傳輸字節(jié)信息顯示自打開通信接口以來總共接收/發(fā)送的字節(jié)數(shù)。通信接口狀態(tài)信息顯示當前通信接口狀態(tài)。2.2.5 控制臺協(xié)議激勵項目控制臺，采用樹形結(jié)構(gòu)進行組織協(xié)議項。協(xié)議激勵項目控制臺右鍵快捷菜單。直接激勵項目控制臺，采用列表結(jié)構(gòu)組織激勵項。支持16進制、字

23、符串、字符串+新行和文件四種數(shù)據(jù)格式，支持激勵項延時，支持激勵項使能，支持立即執(zhí)行激勵項（左邊激勵按鈕，忽略激活屬性）。直接激勵項目控制臺右鍵快捷菜單。2.2.6 數(shù)據(jù)區(qū)數(shù)據(jù)區(qū)是顯示激勵數(shù)據(jù)的區(qū)域，數(shù)據(jù)分為公共數(shù)據(jù)、自定義數(shù)據(jù)和報告數(shù)據(jù)。數(shù)據(jù)類型功能公共數(shù)據(jù)顯示通信傳輸?shù)膶嶋H收發(fā)數(shù)據(jù)，其中發(fā)送數(shù)據(jù)可以通過設置屏蔽，協(xié)議激勵如果沒有自定義數(shù)據(jù)，默認顯示在公共數(shù)據(jù)區(qū)。自定義數(shù)據(jù)只有協(xié)議激勵項目能夠自定義數(shù)據(jù)類型，協(xié)議項在激勵時根據(jù)所屬的協(xié)議類型把結(jié)果輸出到對應的自定義數(shù)據(jù)區(qū)中。報告數(shù)據(jù)只有協(xié)議激勵項目有運行報告，協(xié)議激勵報告作為獨立的頁面顯示在數(shù)據(jù)區(qū)。各個數(shù)據(jù)區(qū)可以按需布局，靈活排布，方便數(shù)據(jù)觀測

24、。2.3 軟件設置操作：【應用程序菜單】->“設置”。2.3.1 常規(guī)設置參數(shù)功能顯示最大長度(KB)設置數(shù)據(jù)區(qū)中結(jié)果數(shù)據(jù)面板最大容納的字節(jié)數(shù)，超過這個最大值，數(shù)據(jù)面板自動清除最舊的數(shù)據(jù)。最小化到系統(tǒng)托盤使能后主窗體在最小化時隱藏到系統(tǒng)托盤。打印輸出數(shù)據(jù)設置數(shù)據(jù)區(qū)“數(shù)據(jù)”面板中是否顯示發(fā)送的數(shù)據(jù)。打印數(shù)據(jù)時間戳設置數(shù)據(jù)區(qū)“數(shù)據(jù)”面板中是否顯示數(shù)據(jù)的時間戳，使能后設置間隔為0則每次收發(fā)都打印時間戳，設置間隔>0則每隔一定時間打印一次。鼠標雙擊運行激勵設置控制臺的激勵項是否在打開通信接口后可以通過鼠標雙擊來運行激勵。啟動時自動打開最近項目設置軟件啟動時是否自動打開最近一次打開的激勵項目

25、。保存結(jié)果使能保存功能，并設置保存結(jié)果的目錄。2.3.2 激勵工程設置協(xié)議激勵結(jié)果數(shù)據(jù)包含名稱、時間（起始時間）、請求幀、響應幀、耗時（執(zhí)行時間）和結(jié)果六個數(shù)據(jù)段。協(xié)議激勵工程參數(shù)功能打印分隔符設置激勵結(jié)果數(shù)據(jù)各個數(shù)據(jù)段之間的分隔符，支持“新行”和“空格”兩種分隔方式。打印起始時間設置激勵結(jié)果數(shù)據(jù)是否顯示“時間”數(shù)據(jù)段。打印執(zhí)行時間設置激勵結(jié)果數(shù)據(jù)是否顯示“耗時”數(shù)據(jù)段。打印幀數(shù)據(jù)設置激勵結(jié)果數(shù)據(jù)是否顯示“請求幀”和“響應幀”的幀數(shù)據(jù)。2.3.3 插件信息列出位于本軟件安裝目錄的Plugins子目錄下的可以被本軟件識別的基于Microsoft .NET Framework的托管代碼組件。2.4

26、 軟件注冊軟件注冊是指專業(yè)版的注冊，免費版無需注冊。如果軟件在未注冊狀態(tài)，【應用程序菜單】中會顯示“注冊產(chǎn)品”菜單條目，注冊成功則隱藏該菜單條目。可以通過【應用程序菜單】中的“關于”菜單查看軟件的注冊信息。軟件可以通過以下步驟完成注冊：步驟1：【應用程序菜單】-> “注冊產(chǎn)品”。用戶標識是用戶計算機特征碼，自動生成。步驟2：輸入用戶名稱和電子郵件地址。合法的電子郵件地址可以直接用來接收注冊文件。步驟3：點擊“提交”。注冊信息會發(fā)送到注冊服務器，如果無法和服務器聯(lián)系，本軟件則會啟動Email發(fā)送程序，由用戶發(fā)送注冊信息給我們。步驟4：購買軟件。購買方式參見1.4.3節(jié)。步驟5：購買成功后，

27、我們會通過Email、郵寄光盤或者其他方式給您發(fā)送注冊文件。步驟6：用接收到的注冊文件覆蓋本軟件安裝目錄下的注冊信息文件。3. 直接激勵項目3.1 簡介直接激勵項目提供了發(fā)送數(shù)據(jù)的功能，采用列表結(jié)構(gòu)組織激勵項。支持16進制、字符串、字符串+新行和文件四種數(shù)據(jù)格式，支持激勵項延時，支持激勵項使能，支持立即執(zhí)行激勵項（左邊激勵按鈕，忽略激活屬性）。3.2 基本操作3.2.1 新建直接激勵項目步驟1：【應用程序菜單】->“新建”->“直接激勵項目”。步驟2：選擇項目路徑，輸入項目名稱，點擊“保存”。3.2.2 打開直接激勵項目方法1：步驟1：【應用程序菜單】->“打開”->“

28、直接激勵項目”。步驟2：選擇項目文件，點擊“打開”。方法2：步驟1：【應用程序菜單】->在“最近項目”面板中選擇需要打開的項目。3.2.3 關閉直接激勵項目步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：【應用程序菜單】->“關閉”。3.2.4 保存直接激勵項目步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：【應用程序菜單】->“保存”或者“另存為”。3.2.5 修改直接激勵項目屬性步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：【工具欄】->“屬性”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“屬性”。直接激勵項目屬性

29、屬性說明工程名稱顯示工程的名稱，可修改。文件路徑顯示工程文件的存儲路徑，不可以修改。3.2.6 添加直接激勵項步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：在“直接激勵管理器”中選中一個激勵項，新添加激勵項將插入選中激勵項的前面。步驟3：【工具欄】->“添加”->“添加直接激勵”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“添加直接激勵”。步驟4：編輯新添加激勵項的數(shù)據(jù)格式、數(shù)據(jù)、延時、激活屬性。3.2.7 刪除直接激勵項步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：在“直接激勵管理器”中選中要刪除的激勵項。步驟3：【工具欄】->“刪

30、除”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“刪除”。3.2.8 激勵激勵前提：通信接口已經(jīng)打開。步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：【工具欄】->“激勵”；或者，【工具欄】->“激勵”菜單->“激勵”/“循環(huán)激勵”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“激勵”/“循環(huán)激勵”。3.2.9 停止激勵停止激勵前提：正在激勵。步驟1：【控制臺】->選擇“直接激勵管理器”。步驟2：【工具欄】->“停止”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“停止”。3.3 用途直接激勵項目有如下幾種使用環(huán)境

31、。Ø 與被激勵方進行命令交互，作為監(jiān)控被激勵方的命令控制臺Ø 給被激勵方增加干擾信號，測試被激勵方4. 協(xié)議激勵項目4.1 簡介協(xié)議是通信系統(tǒng)必不可少的部分，如何組織和開展有效的協(xié)議測試，低成本地應付快速多變的通信環(huán)境，越來越受到企業(yè)和研發(fā)人員的關注。過去，需要為每一份通信協(xié)議定制一個測試工具，眾多定制的測試工具，極大的增加測試開發(fā)、維護和學習成本，與競爭日益激烈的現(xiàn)代電子研發(fā)行業(yè)背道而馳。格西烽火的協(xié)議激勵功能徹底地把多變的通信規(guī)約脫離通信軟件，使得通信軟件能夠應付快速多變的通信環(huán)境。格西烽火協(xié)議激勵功能帶來的好處：Ø 單一的測試工具取代眾多定制的測試工具，極大

32、的降低測試開發(fā)、維護和學習成本Ø 快捷的激勵源管理方式，即改即測，極大的降低研發(fā)成本Ø 以文件的方式組織項目，有利于管理眾多的測試項目，有利于測試標準化Ø 支持循環(huán)激勵與激勵報告，提高測試自動化水平4.2 基本操作4.2.1 新建協(xié)議激勵項目步驟1：【應用程序菜單】->“新建”->“協(xié)議激勵項目”。步驟2：選擇項目路徑，輸入項目名稱，點擊“保存”。4.2.2 打開協(xié)議激勵項目方法1：步驟1：【應用程序菜單】->“打開”->“協(xié)議激勵項目”。步驟2：選擇項目文件，點擊“打開”。方法2：步驟1：【應用程序菜單】->在“最近項目”面板中選擇

33、需要打開的項目。4.2.3 關閉協(xié)議激勵項目步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：【應用程序菜單】->“關閉”。4.2.4 保存協(xié)議激勵項目步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：【應用程序菜單】->“保存”或者“另存為”。4.2.5 修改協(xié)議激勵項目屬性步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：在“協(xié)議激勵管理器”中選擇項目節(jié)點。步驟3：【工具欄】->“屬性”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“屬性”。協(xié)議激勵項目屬性屬性說明工程名稱顯示工程的名稱，可修改。工作模式協(xié)議激勵工程支持“單工”和

34、“雙工”兩種工作模式?！皢喂ぁ蹦Ｊ较虏还苡袥]有“被動模式”的協(xié)議項，一律按照順序執(zhí)行選中的協(xié)議項；“雙工”模式下“主動模式”協(xié)議項和“被動模式”協(xié)議項是分別同時執(zhí)行的，“主動模式”協(xié)議項按順序執(zhí)行，“被動模式”的協(xié)議項是不按照順序的，匹配正確即執(zhí)行。例如：模擬主動型設備，按需求可用“單工”或者“雙工”；模擬被動型設備，一般使用“雙工”，等待需要執(zhí)行的命令。文件路徑顯示工程文件的存儲路徑，不可以修改。4.2.6 添加協(xié)議集步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：在“協(xié)議激勵管理器”中選中一個協(xié)議項/協(xié)議集，作為新添加協(xié)議集的位置。步驟3：【工具欄】->“添加”->

35、“添加協(xié)議集”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“添加協(xié)議集”。步驟4：在協(xié)議集屬性對話框中輸入?yún)f(xié)議集名稱，點擊“確定”。步驟5：選擇新添加協(xié)議集相對當前選中項的位置，點擊“確定”。4.2.7 添加協(xié)議項步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：在“協(xié)議激勵管理器”中選中一個協(xié)議項/協(xié)議集，作為新添加協(xié)議的位置。步驟3：【工具欄】->“添加”->“添加協(xié)議”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“添加協(xié)議”。步驟4：在協(xié)議屬性對話框中，輸入相關參數(shù)，點擊“確定”。屬性說明協(xié)議名稱描述協(xié)議名稱。激活使能協(xié)議節(jié)點。協(xié)議類型為

36、了實現(xiàn)結(jié)果數(shù)據(jù)的分類顯示，協(xié)議激勵項目能夠自定義數(shù)據(jù)類型，協(xié)議項在激勵時根據(jù)所屬的協(xié)議類型把結(jié)果輸出到對應的自定義數(shù)據(jù)區(qū)中?？梢酝ㄟ^“管理協(xié)議類型”按鈕打開協(xié)議類型管理器。工作模式協(xié)議項的工作模式有“主動模式”和“被動模式”兩種?！爸鲃幽Ｊ健北硎驹搮f(xié)議項是主動命令，是發(fā)送請求幀，校驗響應幀；“被動模式”表示該協(xié)議項是被動命令，是等待請求幀，然后根據(jù)請求幀情況發(fā)送響應幀。協(xié)議延時表示協(xié)議執(zhí)行完畢后延時多長才進入下一個協(xié)議激勵。失效超時表示協(xié)議在匹配到正確數(shù)據(jù)之前最長等待時間，超過該時間長度即判失敗。循環(huán)次數(shù)表示循環(huán)激勵該協(xié)議的次數(shù)。期望響應“主動模式”表示發(fā)送請求幀后期望收到的響應幀，默認值表示

37、自動匹配；“被動模式”表示收到請求幀后發(fā)送出去的響應幀，默認值表示發(fā)送響應幀1。請求幀顯示和編輯請求幀的格式和內(nèi)容。參見4.3節(jié)。響應幀1/響應幀2顯示和編輯響應幀1/響應幀2的格式和內(nèi)容。參見4.3節(jié)。協(xié)議腳本顯示和編輯協(xié)議腳本。參見4.4節(jié)。步驟5：選擇新添加協(xié)議相對當前選中項的位置，點擊“確定”。4.2.8 激勵激勵前提：通信接口已經(jīng)打開。步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：【工具欄】->“激勵”；或者，【工具欄】->“激勵”菜單->“激勵”/“循環(huán)激勵”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“激勵”/“循環(huán)激勵”。4.2.9

38、 停止激勵停止激勵前提：正在激勵。步驟1：【控制臺】->選擇“協(xié)議激勵管理器”。步驟2：【工具欄】->“停止”；或者，【控制臺】->鼠標右鍵彈出快捷菜單->“停止”。4.3 協(xié)議幀協(xié)議幀由一個或者多個幀格式單元組成，幀格式單元可以非字節(jié)對齊，但協(xié)議幀必須字節(jié)對齊。幀格式單元屬性說明序號表示幀格式單元的排列順序。名稱表示幀格式單元的名稱。數(shù)據(jù)格式表示幀格式單元的數(shù)據(jù)構(gòu)成，可以有多段數(shù)據(jù)格式構(gòu)成。數(shù)據(jù)格式左邊表示位數(shù)，右邊表示數(shù)值。數(shù)據(jù)格式的位數(shù)可以是任意位數(shù)。例如：單段字節(jié)對齊，多段字節(jié)對齊，單段非字節(jié)對齊，多段非字節(jié)對齊。屬性（變量類型）幀格式單元的變量類型支持普通變量

39、、計算變量和重復變量三種。普通變量是常量；計算變量是通過計算前面數(shù)據(jù)得到的結(jié)果作為變量值，如校驗和；重復變量是指該變量在該數(shù)據(jù)幀中可能重復多次，0表示自動，可表示0n次，>0表示精確次數(shù)。屬性（存儲模式）幀格式單元的數(shù)據(jù)支持小端模式和大端模式兩種存儲模式，例如，字節(jié)順序從低到高（即發(fā)送/接收的字節(jié)順序）為0x12 0x34 0x56，小端模式下設置為，大端模式下設置為。屬性（匹配）匹配選擇用來判斷協(xié)議幀完整性。工具條命令功能添加在當前選擇的幀格式單元中插入新的幀格式單元。刪除刪除當前選擇的幀格式單元。上移將當前選擇的幀格式單元向上移動一格。下移將當前選擇的幀格式單元向下移動一格。添加格式

40、單元在當前選擇的幀格式單元中添加一個數(shù)據(jù)格式單元。刪除格式單元刪除當前選擇的幀格式單元中的數(shù)據(jù)格式單元。4.4 協(xié)議腳本4.4.1 腳本界面工具條命令功能腳本語言設置本協(xié)議項的腳本語言，支持C#、VB、Jscript三種語言。編譯檢查通過編譯檢查當前腳本的是否有錯誤。導入導入外部存儲的腳本。導出將當前的腳本導出為文件。剪切剪切選中的腳本文本。復制復制選中的腳本文本。粘貼在當前光標位置粘貼剪切板的文本。刪除刪除選中的腳本文本。清除清除所有腳本。腳本有錯誤，編譯檢查會提示錯誤的位置、錯誤碼以及錯誤信息。4.4.2 腳本結(jié)構(gòu)協(xié)議腳本支持C#、VB、Jscript三種語言，軟件安裝目錄下的Script

41、s子目錄保存了三種語言的腳本模版，可以通過“導入”命令導入腳本編輯器。下面是C#版本的腳本模版，由一個.NET類Script構(gòu)成，該類包含三個方法，分別是OnRequest方法，OnProcess方法，OnRespond方法。/*  Copyright (c) 2014, 上海格西信息科技有限公司  文件名稱: Script.cs  文件描述: C#腳本模版*/* * 命名空間定義 */using System;/* * 腳本類 */public class Script&#

42、160;   /*     函數(shù)名稱：OnRequest     功能說明：主動模式在發(fā)送請求幀之前執(zhí)行，被動模式在接收請求幀之后執(zhí)行。     輸入?yún)?shù)：context 運行時上下文，存儲運行時的參數(shù)     輸出參數(shù)：無     返回參數(shù)：成功返回1，失敗返回0    

43、60;*/    public int OnRequest(BSCaseContext context)            return 1;        /*     函數(shù)名稱：OnProcess     功能說明：等待接

44、收/發(fā)送響應幀時每一個處理周期（約5ms）執(zhí)行1次。     輸入?yún)?shù)：context 運行時上下文，存儲運行時的參數(shù)     輸出參數(shù)：無     返回參數(shù)：成功返回1，失敗返回0     */    public int OnProcess(BSCaseContext context)    &

45、#160;       return 1;        /*     函數(shù)名稱：OnRespond     功能說明：主動模式接收響應幀之后執(zhí)行，被動模式在發(fā)送響應幀之后執(zhí)行。     輸入?yún)?shù)：context 運行時上下文，存儲運行時的參數(shù)    

46、; 輸出參數(shù)：無     返回參數(shù)：成功返回1，失敗返回0     */    public int OnRespond(BSCaseContext context)            return 1;    4.4.3 腳本參數(shù)BSCaseContex

47、t類腳本函數(shù)的唯一輸入?yún)?shù)是BSCaseContext類型，該類型實例承載了整個激勵過程的腳本執(zhí)行上下文，BSCaseContext類提供了屬性和方法讓腳本調(diào)用，完成對激勵、協(xié)議幀、通信接口參數(shù)等執(zhí)行參數(shù)的控制和管理。 .Power屬性獲取或者設置激勵的運行狀態(tài)，該值表明激勵是否在運行。語法C#public bool Power get; set; 屬性值類型：System.BooleanVBPublic Property Power As Boolean Get Set屬性值類型：System.Boolean備注當需要停止激勵運行時，可以在腳本中設置Power值為false，腳

48、本運行完畢后停止激勵。示例下面的示例在腳本的OnRequest方法中設置Power為false。C#public int OnRequest(BSCaseContext context) context.Power = false; context.Msg = "Power=false.rn" return 1;VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer context.Power = false context.Msg = "Power=false.rn"

49、 OnRequest = 1End Function .CommParameters屬性獲取用于描述通信接口的對象。在串口通信中，該對象的類型為BSComStreamParameters，參見4.4.4。語法C#public object CommParameters get; 屬性值類型：System.ObjectVBPublic ReadOnly Property CommParameters As Object Get屬性值類型：System.Object備注當需要運行中獲取或者修改通信接口參數(shù)時，可以在腳本中先把CommParameters轉(zhuǎn)換通信接口參數(shù)類型，然后再進行

50、操作。示例下面的示例在腳本的OnRespond方法中設置串口通信接口參數(shù)。C#public int OnRespond(BSCaseContext context)BSComStreamParameters comParams = context.CommParameters as BSComStreamParameters; comParams.BaudRate = 115200; / 波特率設置為115200 comParams.Parity = Parity.Odd; / 校驗位設置為奇校驗StringBuilder sb = new StringBuilder();sb.Append(

51、string.Format("串口通信參數(shù)設置為: BaudRate=0, Parity=1rn",comParams.BaudRate, comParams.Parity); / 輸出信息 context.Msg = sb.ToString(); return 1;VBPublic Function OnRespond (ByRef context As BSCaseContext) As Integer Dim comParams As BSComStreamParameters comParams = DirectCast(context.CommParameters

52、, BSComStreamParameters) comParams.BaudRate = 115200 '波特率設置為115200 comParams.Parity = Parity.Odd ' 校驗位設置為奇校驗Dim sb As StringBuilder sb = new StringBuilder()sb.Append(String.Format("串口通信參數(shù)設置為: BaudRate=0, Parity=1rn",comParams.BaudRate, comParams.Parity) ' 輸出信息context.Msg = sb.T

53、oString() OnRequest = 1End Function .Msg屬性獲取或者設置一個信息字符串，該字符串在腳本函數(shù)結(jié)束后顯示到數(shù)據(jù)區(qū)。語法C#public string Msg get; set; 屬性值類型：System.StringVBPublic Property Msg As String Get Set屬性值類型：System.String備注當需要在腳本函數(shù)結(jié)束后顯示信息到數(shù)據(jù)區(qū)時，可以在腳本函數(shù)中設置Msg值，Msg的值是讀后清除的，如果需要設置多個信息，可以先通過StringBuilder拼接，再統(tǒng)一賦值給Msg，或者使用AppendMsg方法。示

54、例下面的示例在腳本的OnRequest方法中設置Msg。C#public int OnRequest(BSCaseContext context) context.Msg = "Hello World.rn" return 1;VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer context.Msg = "Hello World.rn" OnRequest = 1End Function .MatchResult屬性獲取協(xié)議匹配的索引號。從0開始，匹配請求幀有效值為0，匹配響應幀有效值為0和1。語法C#public int MatchResult get; 屬性值類型：System.IntegerVBPublic Property MatchResult As Integer Get 屬性值類型：System. Integer備注示例下面的示例在腳本的OnRespond方法中獲取。C#public int OnRespond (BSCaseContext context) if (contex