格西烽火使用用戶(hù)手冊(cè)

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

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

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

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

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

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

7、Ø Windows Installer 3.1 或更高版本Ø Internet Explorer 5.01 或更高版本Ø Microsoft .NET Framework 4.0 1.4 許可與購(gòu)買(mǎi)1.4.1 版權(quán)版權(quán)所有 (C) 2014 上海格西信息科技有限公司1.4.2 最終用戶(hù)許可協(xié)議重要說(shuō)明：本軟件最終用戶(hù)許可協(xié)議（以下稱(chēng)協(xié)議）是您（個(gè)人或者單一實(shí)體）與上海格西信息科技有限公司之間的法律協(xié)議。請(qǐng)?jiān)谕瓿砂惭b過(guò)程和使用本軟件之前仔細(xì)閱讀這個(gè)協(xié)議。它提供了使用本軟件的許可，并包含擔(dān)保信息和免責(zé)聲明。安裝和使用本軟件的行為表示您確認(rèn)接受了本軟件，并且同意受到本協(xié)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

28、直接激勵(lì)項(xiàng)目”。步驟2：選擇項(xiàng)目文件，點(diǎn)擊“打開(kāi)”。方法2：步驟1：【應(yīng)用程序菜單】->在“最近項(xiàng)目”面板中選擇需要打開(kāi)的項(xiàng)目。3.2.3 關(guān)閉直接激勵(lì)項(xiàng)目步驟1：【控制臺(tái)】->選擇“直接激勵(lì)管理器”。步驟2：【應(yīng)用程序菜單】->“關(guān)閉”。3.2.4 保存直接激勵(lì)項(xiàng)目步驟1：【控制臺(tái)】->選擇“直接激勵(lì)管理器”。步驟2：【應(yīng)用程序菜單】->“保存”或者“另存為”。3.2.5 修改直接激勵(lì)項(xiàng)目屬性步驟1：【控制臺(tái)】->選擇“直接激勵(lì)管理器”。步驟2：【工具欄】->“屬性”；或者，【控制臺(tái)】->鼠標(biāo)右鍵彈出快捷菜單->“屬性”。直接激勵(lì)項(xiàng)目屬性

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

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

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

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

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

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

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

36、了實(shí)現(xiàn)結(jié)果數(shù)據(jù)的分類(lèi)顯示，協(xié)議激勵(lì)項(xiàng)目能夠自定義數(shù)據(jù)類(lèi)型，協(xié)議項(xiàng)在激勵(lì)時(shí)根據(jù)所屬的協(xié)議類(lèi)型把結(jié)果輸出到對(duì)應(yīng)的自定義數(shù)據(jù)區(qū)中。可以通過(guò)“管理協(xié)議類(lèi)型”按鈕打開(kāi)協(xié)議類(lèi)型管理器。工作模式協(xié)議項(xiàng)的工作模式有“主動(dòng)模式”和“被動(dòng)模式”兩種。“主動(dòng)模式”表示該協(xié)議項(xiàng)是主動(dòng)命令，是發(fā)送請(qǐng)求幀，校驗(yàn)響應(yīng)幀；“被動(dòng)模式”表示該協(xié)議項(xiàng)是被動(dòng)命令，是等待請(qǐng)求幀，然后根據(jù)請(qǐng)求幀情況發(fā)送響應(yīng)幀。協(xié)議延時(shí)表示協(xié)議執(zhí)行完畢后延時(shí)多長(zhǎng)才進(jìn)入下一個(gè)協(xié)議激勵(lì)。失效超時(shí)表示協(xié)議在匹配到正確數(shù)據(jù)之前最長(zhǎng)等待時(shí)間，超過(guò)該時(shí)間長(zhǎng)度即判失敗。循環(huán)次數(shù)表示循環(huán)激勵(lì)該協(xié)議的次數(shù)。期望響應(yīng)“主動(dòng)模式”表示發(fā)送請(qǐng)求幀后期望收到的響應(yīng)幀，默認(rèn)值表示

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

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

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

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

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

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

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

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

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

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

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

48、本運(yùn)行完畢后停止激勵(lì)。示例下面的示例在腳本的OnRequest方法中設(shè)置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屬性獲取用于描述通信接口的對(duì)象。在串口通信中，該對(duì)象的類(lèi)型為BSComStreamParameters，參見(jiàn)4.4.4。語(yǔ)法C#public object CommParameters get; 屬性值類(lèi)型：System.ObjectVBPublic ReadOnly Property CommParameters As Object Get屬性值類(lèi)型：System.Object備注當(dāng)需要運(yùn)行中獲取或者修改通信接口參數(shù)時(shí)，可以在腳本中先把CommParameters轉(zhuǎn)換通信接口參數(shù)類(lèi)型，然后再進(jìn)行

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

51、string.Format("串口通信參數(shù)設(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 '波特率設(shè)置為115200 comParams.Parity = Parity.Odd ' 校驗(yàn)位設(shè)置為奇校驗(yàn)Dim sb As StringBuilder sb = new StringBuilder()sb.Append(String.Format("串口通信參數(shù)設(shè)置為: BaudRate=0, Parity=1rn",comParams.BaudRate, comParams.Parity) ' 輸出信息context.Msg = sb.T

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

54、例下面的示例在腳本的OnRequest方法中設(shè)置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é)議匹配的索引號(hào)。從0開(kāi)始，匹配請(qǐng)求幀有效值為0，匹配響應(yīng)幀有效值為0和1。語(yǔ)法C#public int MatchResult get; 屬性值類(lèi)型：System.IntegerVBPublic Property MatchResult As Integer Get 屬性值類(lèi)型：System. Integer備注示例下面的示例在腳本的OnRespond方法中獲取。C#public int OnRespond (BSCaseContext context) if (contex