【文章內(nèi)容簡介】 激勵”；或者，【控制臺】鼠標(biāo)右鍵彈出快捷菜單“激勵”/“循環(huán)激勵”。 停止激勵停止激勵前提：正在激勵。步驟1：【控制臺】選擇“協(xié)議激勵管理器”。步驟2：【工具欄】“停止”；或者，【控制臺】鼠標(biāo)右鍵彈出快捷菜單“停止”。 協(xié)議幀協(xié)議幀由一個(gè)或者多個(gè)幀格式單元組成，幀格式單元可以非字節(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é)對齊。屬性（變量類型）幀格式單元的變量類型支持普通變量、計(jì)算變量和重復(fù)變量三種。普通變量是常量；計(jì)算變量是通過計(jì)算前面數(shù)據(jù)得到的結(jié)果作為變量值，如校驗(yàn)和；重復(fù)變量是指該變量在該數(shù)據(jù)幀中可能重復(fù)多次，0表示自動，可表示0~n次，0表示精確次數(shù)。屬性（存儲模式）幀格式單元的數(shù)據(jù)支持小端模式和大端模式兩種存儲模式，例如，字節(jié)順序從低到高（即發(fā)送/接收的字節(jié)順序）為0x12 0x34 0x56，小端模式下設(shè)置為，大端模式下設(shè)置為。屬性（匹配）匹配選擇用來判斷協(xié)議幀完整性。工具條命令功能添加在當(dāng)前選擇的幀格式單元中插入新的幀格式單元。刪除刪除當(dāng)前選擇的幀格式單元。上移將當(dāng)前選擇的幀格式單元向上移動一格。下移將當(dāng)前選擇的幀格式單元向下移動一格。添加格式單元在當(dāng)前選擇的幀格式單元中添加一個(gè)數(shù)據(jù)格式單元。刪除格式單元刪除當(dāng)前選擇的幀格式單元中的數(shù)據(jù)格式單元。 協(xié)議腳本 腳本界面工具條命令功能腳本語言設(shè)置本協(xié)議項(xiàng)的腳本語言，支持C、VB、Jscript三種語言。編譯檢查通過編譯檢查當(dāng)前腳本的是否有錯(cuò)誤。導(dǎo)入導(dǎo)入外部存儲的腳本。導(dǎo)出將當(dāng)前的腳本導(dǎo)出為文件。剪切剪切選中的腳本文本。復(fù)制復(fù)制選中的腳本文本。粘貼在當(dāng)前光標(biāo)位置粘貼剪切板的文本。刪除刪除選中的腳本文本。清除清除所有腳本。腳本有錯(cuò)誤，編譯檢查會提示錯(cuò)誤的位置、錯(cuò)誤碼以及錯(cuò)誤信息。 腳本結(jié)構(gòu)協(xié)議腳本支持C、VB、Jscript三種語言，軟件安裝目錄下的Scripts子目錄保存了三種語言的腳本模版，可以通過“導(dǎo)入”命令導(dǎo)入腳本編輯器。下面是C版本的腳本模版，該類包含三個(gè)方法，分別是OnRequest方法，OnProcess方法，OnRespond方法。/*************************************************************************Copyright (c) 2014, 上海格西信息科技有限公司文件名稱: 文件描述: C腳本模版**************************************************************************//*** 命名空間定義*///using System。/*** 腳本類*/publicclassScript{/*************************************************************************函數(shù)名稱：OnRequest功能說明：主動模式在發(fā)送請求幀之前執(zhí)行，被動模式在接收請求幀之后執(zhí)行。輸入?yún)?shù)：context – 運(yùn)行時(shí)上下文，存儲運(yùn)行時(shí)的參數(shù)輸出參數(shù)：無返回參數(shù)：成功返回1，失敗返回0*************************************************************************/publicintOnRequest(BSCaseContext context){return1。}/*************************************************************************函數(shù)名稱：OnProcess功能說明：等待接收/發(fā)送響應(yīng)幀時(shí)每一個(gè)處理周期（約5ms）執(zhí)行1次。輸入?yún)?shù)：context – 運(yùn)行時(shí)上下文，存儲運(yùn)行時(shí)的參數(shù)輸出參數(shù)：無返回參數(shù)：成功返回1，失敗返回0*************************************************************************/publicintOnProcess(BSCaseContext context){return1。}/*************************************************************************函數(shù)名稱：OnRespond功能說明：主動模式接收響應(yīng)幀之后執(zhí)行，被動模式在發(fā)送響應(yīng)幀之后執(zhí)行。輸入?yún)?shù)：context – 運(yùn)行時(shí)上下文，存儲運(yùn)行時(shí)的參數(shù)輸出參數(shù)：無返回參數(shù)：成功返回1，失敗返回0*************************************************************************/publicintOnRespond(BSCaseContext context){return1。}} 腳本參數(shù)BSCaseContext類腳本函數(shù)的唯一輸入?yún)?shù)是BSCaseContext類型，該類型實(shí)例承載了整個(gè)激勵過程的腳本執(zhí)行上下文，BSCaseContext類提供了屬性和方法讓腳本調(diào)用，完成對激勵、協(xié)議幀、通信接口參數(shù)等執(zhí)行參數(shù)的控制和管理。 .Power屬性獲取或者設(shè)置激勵的運(yùn)行狀態(tài)，該值表明激勵是否在運(yùn)行。語法Cpublic bool Power { get。 set。 }屬性值類型：VBPublic Property Power As Boolean Get Set屬性值類型：備注當(dāng)需要停止激勵運(yùn)行時(shí)，可以在腳本中設(shè)置Power值為false，腳本運(yùn)行完畢后停止激勵。示例下面的示例在腳本的OnRequest方法中設(shè)置Power為false。Cpublic int OnRequest(BSCaseContext context){ = false。 = Power=false.\r\n。 return 1。}VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer = false = Power=false.\r\n OnRequest = 1End Function .CommParameters屬性獲取用于描述通信接口的對象。在串口通信中，該對象的類型為BSComStreamParameters。語法Cpublic object CommParameters { get。 }屬性值類型：VBPublic ReadOnly Property CommParameters As Object Get屬性值類型：備注當(dāng)需要運(yùn)行中獲取或者修改通信接口參數(shù)時(shí)，可以在腳本中先把CommParameters轉(zhuǎn)換通信接口參數(shù)類型，然后再進(jìn)行操作。示例下面的示例在腳本的OnRespond方法中設(shè)置串口通信接口參數(shù)。Cpublic int OnRespond(BSCaseContext context){BSComStreamParameters Params = as BSComStreamParameters。 = 115200。 // 波特率設(shè)置為115200 = 。 // 校驗(yàn)位設(shè)置為奇校驗(yàn)StringBuilder sb = new StringBuilder()。((串口通信參數(shù)設(shè)置為: BaudRate={0}, Parity={1}\r\n, , ))。 // 輸出信息 = ()。 return 1。}VBPublic Function OnRespond (ByRef context As BSCaseContext) As Integer Dim Params As BSComStreamParameters Params = DirectCast(, BSComStreamParameters) = 115200 39。波特率設(shè)置為115200 = 39。 校驗(yàn)位設(shè)置為奇校驗(yàn)Dim sb As StringBuilder sb = new StringBuilder()((串口通信參數(shù)設(shè)置為: BaudRate={0}, Parity={1}\r\n, , )) 39。 輸出信息 = () OnRequest = 1End Function .Msg屬性獲取或者設(shè)置一個(gè)信息字符串，該字符串在腳本函數(shù)結(jié)束后顯示到數(shù)據(jù)區(qū)。語法Cpublic string Msg { get。 set。 }屬性值類型：VBPublic Property Msg As String Get Set屬性值類型：備注當(dāng)需要在腳本函數(shù)結(jié)束后顯示信息到數(shù)據(jù)區(qū)時(shí)，可以在腳本函數(shù)中設(shè)置Msg值，Msg的值是讀后清除的，如果需要設(shè)置多個(gè)信息，可以先通過StringBuilder拼接，再統(tǒng)一賦值給Msg，或者使用AppendMsg方法。示例下面的示例在腳本的OnRequest方法中設(shè)置Msg。Cpublic int OnRequest(BSCaseContext context){ = Hello World.\r\n。 return 1。}VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer = Hello World.\r\n OnRequest = 1End Function .MatchResult屬性獲取協(xié)議匹配的索引號。從0開始，匹配請求幀有效值為0，匹配響應(yīng)幀有效值為0和1。語法Cpublic int MatchResult { get。 }屬性值類型：VBPublic Property MatchResult As Integer Get 屬性值類型：System. Integer備注示例下面的示例在腳本的OnRespond方法中獲取。Cpublic int OnRespond (BSCaseContext context){ if ( == 0) { // 期望收到響應(yīng)幀1 string msg = 響應(yīng)幀1的幀格式單元3: + (0,2) + \r\n。 = msg。 return 1。 // 返回成功 } return 0。 // 返回失敗}VBPublic Function OnRespond (ByRef context As BSCaseContext) A