格西烽火串口助手-用户手册

1、格西烽火用户手册版本 1.0目录1.简介41.1关于41.2功能特性41.3系统要求41.4许可与购买51.4.1版权51.4.2最终用户许可协议51.4.3购买71.5支持服务72.软件入门72.1启动软件72.2用户界面82.2.1主界面82.2.2应用程序菜单82.2.3工具栏102.2.4状态栏122.2.5控制台122.2.6数据区142.3软件设置152.3.1常规设置152.3.2激励工程设置162.3.3插件信息162.4软件注册173.直接激励项目183.1简介183.2基本操作193.2.1新建直接激励项目193.2.2打开直接激励项目193.2.3关闭直接激励项目193.

2、2.4保存直接激励项目203.2.5修改直接激励项目属性203.2.6添加直接激励项203.2.7删除直接激励项203.2.8激励203.2.9停止激励213.3用途214.协议激励项目214.1简介214.2基本操作214.2.1新建协议激励项目214.2.2打开协议激励项目214.2.3关闭协议激励项目224.2.4保存协议激励项目224.2.5修改协议激励项目属性224.2.6添加协议集224.2.7添加协议项234.2.8激励254.2.9停止激励254.3协议帧254.4协议脚本264.4.1脚本界面274.4.2脚本结构284.4.3脚本参数BSCaseContext类294.4.

3、4串口参数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分类组织协议激励项目的协议项497.2运行多个软件实例498.FAQ498.1进行“反馈”或者“注册软件”操作时，为什么出现Unknown error (0x)错误？498.2进行协议激励时，从动方已经发出正确的帧，为什么主动激励方却返回失败？49用户手册 1.

4、简介1.1 关于格西烽火是一个基于串口通信的多功能测试工具。研发和测试人员可以利用它来接收和显示串口数据，快速创建、运行和管理各种直接激励源和协议激励源，并以项目文件的方式进行组织，彻底地把多变的通信规约脱离通信软件，使得通信软件能够应付快速多变的通信环境。格西烽火带来的好处： 单一的测试工具取代众多定制的测试工具，极大的降低测试开发、维护和学习成本 快捷的激励源管理方式，即改即测，极大的降低研发成本 以文件的方式组织项目，有利于管理众多的测试项目，有利于测试标准化 支持循环激励与激励报告，提高测试自动化水平格西烽火主要适用于： 电子产品研发、测试和生产企业 电子产品研发、测试人员1.2 功能

5、特性本软件发行了两个版本： 免费版（Free Edition） 专业版（Professional Edition）下表列出了本软件的功能特性以及在各个版本中的支持情况。功能特性描述免费版专业版基本功能数据接收和显示、工具箱支持支持直接激励创建、运行和管理直接激励项目支持支持协议激励创建、运行和管理协议激励项目支持1.3 系统要求支持的操作系统： Windows XP SP3 Windows Server 2003 SP2 Windows Vista SP1或更高版本 Windows Server 2008（在服务器核心角色上不受支持） Windows 7 Windows Server 2008

6、 R2（在服务器核心角色上不受支持） Windows 7 SP1 Windows Server 2008 R2 SP1支持的体系结构： x86 x64硬件要求： 建议的最低要求：Pentium 1 GHz 或更快，1 GB RAM 或更大 最小磁盘空间： x86 25 MB，x64 50 MB必备组件： Windows Installer 3.1 或更高版本 Internet Explorer 5.01 或更高版本 Microsoft .NET Framework 4.0 1.4 许可与购买1.4.1 版权版权所有 (C) 2014 上海格西信息科技有限公司1.4.2 最终用户许可协议重要说明

7、：本软件最终用户许可协议（以下称协议）是您（个人或者单一实体）与上海格西信息科技有限公司之间的法律协议。请在完成安装过程和使用本软件之前仔细阅读这个协议。它提供了使用本软件的许可，并包含担保信息和免责声明。安装和使用本软件的行为表示您确认接受了本软件，并且同意受到本协议条款的约束。如果您不同意受这些条款的约束，请不要安装该软件。不论此处是否提及或介绍了其它软件，本协议只适用于上海格西信息科技有限公司在此提供的软件。1. 定义(1)“上海格西信息科技有限公司”是指上海格西信息科技有限公司及其许可方（如果有的话）。 (2)“软件”仅指上海格西信息科技有限公司软件程序和由上海格西信息科技有限公司在所

8、有情况下提供的第三方软件程序，及其相应的文档、相关媒介、印刷材料和联机文档或者电子文档。 (3)“试用版”是指该软件的一个标识版本，它仅用于在有限的期限内检查、演示和评估该软件。试用版的功能可能有所限制，可能不允许最终用户保存最终产品，并且会因为内部的机制而在预定的时间期限到期后停止工作。 2. 授予许可 本协议授予您以下权利：您可在一台计算机、工作站、终端机、手持式计算机上安装、使用、访问、显示、运行或以其它方式互相作用于（“运行”）本软件的一份副本。3. 许可限制(1) 您不能制作或分发本软件的副本，或者用电子方式将本软件从一台计算机传输到另一台计算机，或者通过网络传输。 (2) 您不能更

9、改、合并、修改、改编或者翻译该软件，或者反编译、逆向工程、反汇编或者以其它方式将软件分解成人类可以理解的形式。 (3) 除非在此另有规定，否则您不能租借、租赁或者转授本软件的许可。 (4) 除非在此另有规定，否则您不能修改本软件或者在本软件的基础上创建任何衍生产品。(5) 除非在此另有规定，您不能总计安装或者使用一个以上的试用版软件；不能用一个以上的用户名使用本软件的试用版；不能更改硬盘或计算机系统的内容，以便使试用版软件的累计使用时间超过一个试用版许可所允许的试用期限；不能在没有事先获得上海格西信息科技有限公司书面准许的情况下将使用本试用版所获得的软件性能指标透露给任何第三方；不能使用软件试

10、用版的目的并非只是为了决定是否购买本软件商业版。 (6) 您可能会通过一种以上媒介收到该软件，但只能安装或使用一种媒介。不论您收到多少种媒介，您只能使用适合于要安装本软件的服务器或计算机的那种媒介。(7) 您可能会收到一个以上平台的软件，但只能安装或使用一个平台。 (8) 您不能使用本软件来开发主要功能与本软件相同的任何应用程序。 (9) 如果您违反了本 协议，上海格西信息科技有限公司可以终止该许可，您必须销毁所有软件副本（这种终止后仍然保留双方的所有其它权利和本协议所提供的任何其它权利）。4. 升级程序 如果本软件副本是对该软件早期版本的升级，提供升级程序的基础是许可交换。您安装和使用此类软

11、件副本的行为表示您自愿终止早期 协议，并且不会继续使用该软件的早期版本或者转让给其他人或实体，除非这种转让符合第3部分的规定。 5. 所有关系上述许可赋予您使用本软件的有限许可。上海格西信息科技有限公司及其供应商保留所有权利、所有权和利益，包括软件（作为单独产品以及作为您后续开发的应用程序基础的底层产品）之中以及软件本身的所有版权和知识产权，所有副本亦不例外。上海格西信息科技有限公司及其供应商保留本协议中没有明确授予的所有权利。6. 有限担保和免责声明(1) 除非与任何示例应用程序代码、本软件的试用版有关，否则上海格西信息科技有限公司保证自交付之日起（以您的收据为准）的90天内：与推荐的硬件配

12、置一起使用时，本软件的性能将与随附文档中的描述完全相符；并且在正常使用下，用于提供本软件的物理媒介在材料和工艺上没有任何缺陷。 (2) 上海格西信息科技有限公司不对任何示例应用程序代码、本软件的试用版提供任何补救措施或明示或暗示的担保。(3) 除了上述有关所有示例应用程序代码、本软件试用版的有限担保外，上海格西信息科技有限公司及其供应商声明不承担所有其它明示、暗示或任何其它形式的担保和表示，包括对适销性或者特定目的适用性的担保。此外，不担保不侵权和所有权。上海格西信息科技有限公司不担保本软件无错误或者可以不中断地工作。本软件并非设计用于或许可在需有故障自动防护功能的危险环境中使用，包括但不限于

13、，核设施、飞机导航或通信系统、空中交通管制、生命保障系统或武器系统的设计、制造、维护或运行等。上海格西信息科技有限公司明确声明不提供任何此类用途适用性的明示或暗示担保。(4) 如果适用法律要求提供与本软件有关的任何担保，所有此类担保的有效期仅限于交付之日后的90天之内。(5) 上海格西信息科技有限公司、其经销商、分销商、代理或者雇员提供的任何口头或书面信息均不构成担保或者以任何方式扩大此处提供的担保范围。 7. 唯一补救措施您的唯一补救措施是将软件退回购买处，同时提供收据和问题描述。只要在交付之日后的90天内以书面形式向上海格西信息科技有限公司提供任何与上述担保不符的情况，上海格西信息科技有限

14、公司将用合理的商业努力为您提供一个完全符合文档的替换软件版本，替换有缺陷的媒介，或者按照您购买软件时的付款额退款，具体措施由上海格西信息科技有限公司选择。在以下情况下上海格西信息科技有限公司不承担责任：软件已被以任何形式更改；因为误用、事故、滥用、修改或者应用不当而损坏了媒介；或者因为使用非推荐的硬件配置而造成软件无法使用。若有任何软件误用、事故、滥用、修改或者应用不当的情况，上述担保将会无效。这是给您的唯一的补救措施，用于弥补与本软件及其相关文档有关的明示或暗示的担保中的过失。8. 责任限制(1) 若因使用或者无法使用本软件而出现的，并且以任何责任理论为依据的，包括违约、担保过失、民事侵权行

15、为（包括疏忽）、产品责任等造成的任何间接、特殊、偶发、惩罚性、覆盖性或者继发损害（包括但不限于无法使用设备或访问数据造成的损坏、业务损失、利润损失、营业中断等），上海格西信息科技有限公司及其供应商均无需向您或任何第三方负责，即使上海格西信息科技有限公司或其代表事先已经得到了可能造成此种损坏的通知，并且即使此处所述的补救措施未能发挥应有效用，情况亦不例外。(2) 上海格西信息科技有限公司对任何原因造成的实际损坏的总赔偿金额限于您购买引起这种损坏的软件而支付的金额。(3) 上述责任限制适用于以上担保和免责声明以及本协议的所有其它方面。9. 通则本协议适用中华人民共和国著作权法、中华人民共和国计算机

16、软件保护条例、中华人民共和国商标法、中华人民共和国专利法等法律法规。本协议受中华人民共和国法律管辖。1.4.3 购买注册专业版优势 许可在商业环境下使用本软件 获得用户身份校验信息和丰富的高级功能 获得支持和帮助购买方式方式1：与销售代表联系 电子邮件：sales 电话：021-方式2：从淘宝网（）格西旗舰店直接购买 网址：1.5 支持服务您在使用本软件的过程中遇到问题或者希望获得产品的支持信息，可以通过我们的网站、电子邮件等方式与我们联系。 支持网站： 电子邮件：support 微信号：gesher QQ：2. 软件入门2.1 启动软件本软件安装成功之后，会在Windows的【开始菜单】中创

17、建菜单项，同时关联直接激励项目文件（.bsp）和协议激励项目文件（.bcp）。启动软件有两种方法： 方法1：Windows【开始菜单】-“程序”-“格西烽火”-“格西烽火”。 方法2：鼠标双击打开直接激励项目文件（.bsp）或者协议激励项目文件（.bcp）。2.2 用户界面2.2.1 主界面2.2.2 应用程序菜单命令快捷键功能新建-协议激励项目Ctrl+N新建一个协议激励项目，并建立项目环境。新建-直接激励项目Ctrl+Shift+N新建一个直接激励项目，并建立项目环境。打开-协议激励项目Ctrl+O打开一个协议激励项目，并建立项目环境。打开-直接激励项目Ctrl+Shift+O打开一个直接

18、激励项目，并建立项目环境。关闭关闭当前激活的项目。保存Ctrl+S保存当前激活的项目。另存为将当前激活的项目保存到指定路径。全部保存Ctrl+Shift+S保存当前打开的所有项目。设置设置软件的运行参数。注册产品注册软件，获得更多功能和服务，注册成功隐藏该菜单。帮助F1软件的使用帮助。关于显示软件的版权、版本以及注册信息等。退出Alt+F4退出系统。2.2.3 工具栏基本工具栏（无项目状态）命令功能打开/关闭打开或者关闭串口串口号设置串口号，自动检测当前系统有效的串口设备。波特率设置波特率，提供标准波特率，支持自定义波特率输入。数据位设置数据位，支持5、6、7、8。停止位设置停止位，支持1、1

19、.5、2。校验位设置校验位，支持无、奇校验、偶校验、置1、置0。流控制（握手协议）设置流控制，支持无、RequestToSend、XonXoff、RequestToSend /XonXoff。RTS设置在串行通信中是否启用请求发送 (RTS) 信号DTR设置在串行通信中是否启用数据终端就绪 (DTR) 信号。HEX设置数据面板数据显示格式，选中表示解析为HEX字符串，不选表示直接解析为字符串。清除清除所有数据区的显示数据，不影响已经保存的数据。折叠工具栏（右上角第1个按钮）显示/折叠工具栏。反馈（右上角第2个按钮）显示用户反馈对话框。帮助（右上角第3个按钮）显示用户帮助。协议激励工具栏（通信接

20、口已折叠）命令功能激励单次激励选中的协议项或者协议集，下来菜单提供循环激励功能。停止停止运行协议激励。报告下来菜单提供显示/隐藏协议激励报告，导出协议报告。添加下来菜单提供在当前选定节点的添加协议项或者协议集功能。保存保存协议激励项目。剪切剪切当前选定节点。复制复制当前选定节点。粘贴在当前选定节点粘贴。删除删除当前选定节点。属性显示当前选定节点的属性对话框。直接激励工具栏（通信接口已折叠）命令功能激励单次激励直接激励项目所有激活的激励项，下来菜单提供循环激励功能。停止停止运行直接激励。添加下来菜单提供在当前选定节点的添加协议项或者协议集功能。保存保存直接激励项目。删除删除当前选定的激励项。属性

21、显示直接激励项目的属性对话框。常用工具工具栏命令功能计算器运行系统提供的计算器程序。校验和运行工具箱的校验和计算器。CRC运行工具箱的CRC计算器。DES运行工具箱的DES计算器。哈希值运行工具箱的哈希值计算器。2.2.4 状态栏状态栏分为三部分，分别为操作状态信息、通信传输字节信息、通信接口状态信息。状态栏功能操作状态信息显示上一次操作的状态信息，有错误、警告、信息三种状态。通信传输字节信息显示自打开通信接口以来总共接收/发送的字节数。通信接口状态信息显示当前通信接口状态。2.2.5 控制台协议激励项目控制台，采用树形结构进行组织协议项。协议激励项目控制台右键快捷菜单。直接激励项目控制台，采

22、用列表结构组织激励项。支持16进制、字符串、字符串+新行和文件四种数据格式，支持激励项延时，支持激励项使能，支持立即执行激励项（左边激励按钮，忽略激活属性）。直接激励项目控制台右键快捷菜单。2.2.6 数据区数据区是显示激励数据的区域，数据分为公共数据、自定义数据和报告数据。数据类型功能公共数据显示通信传输的实际收发数据，其中发送数据可以通过设置屏蔽，协议激励如果没有自定义数据，默认显示在公共数据区。自定义数据只有协议激励项目能够自定义数据类型，协议项在激励时根据所属的协议类型把结果输出到对应的自定义数据区中。报告数据只有协议激励项目有运行报告，协议激励报告作为独立的页面显示在数据区。各个数据

23、区可以按需布局，灵活排布，方便数据观测。2.3 软件设置操作：【应用程序菜单】-“设置”。2.3.1 常规设置参数功能显示最大长度(KB)设置数据区中结果数据面板最大容纳的字节数，超过这个最大值，数据面板自动清除最旧的数据。最小化到系统托盘使能后主窗体在最小化时隐藏到系统托盘。打印输出数据设置数据区“数据”面板中是否显示发送的数据。打印数据时间戳设置数据区“数据”面板中是否显示数据的时间戳，使能后设置间隔为0则每次收发都打印时间戳，设置间隔0则每隔一定时间打印一次。鼠标双击运行激励设置控制台的激励项是否在打开通信接口后可以通过鼠标双击来运行激励。启动时自动打开最近项目设置软件启动时是否自动打开

24、最近一次打开的激励项目。保存结果使能保存功能，并设置保存结果的目录。2.3.2 激励工程设置协议激励结果数据包含名称、时间（起始时间）、请求帧、响应帧、耗时（执行时间）和结果六个数据段。协议激励工程参数功能打印分隔符设置激励结果数据各个数据段之间的分隔符，支持“新行”和“空格”两种分隔方式。打印起始时间设置激励结果数据是否显示“时间”数据段。打印执行时间设置激励结果数据是否显示“耗时”数据段。打印帧数据设置激励结果数据是否显示“请求帧”和“响应帧”的帧数据。2.3.3 插件信息列出位于本软件安装目录的Plugins子目录下的可以被本软件识别的基于Microsoft .NET Framework

25、的托管代码组件。2.4 软件注册软件注册是指专业版的注册，免费版无需注册。如果软件在未注册状态，【应用程序菜单】中会显示“注册产品”菜单条目，注册成功则隐藏该菜单条目。可以通过【应用程序菜单】中的“关于”菜单查看软件的注册信息。软件可以通过以下步骤完成注册：步骤1：【应用程序菜单】- “注册产品”。用户标识是用户计算机特征码，自动生成。步骤2：输入用户名称和电子邮件地址。合法的电子邮件地址可以直接用来接收注册文件。步骤3：点击“提交”。注册信息会发送到注册服务器，如果无法和服务器联系，本软件则会启动Email发送程序，由用户发送注册信息给我们。步骤4：购买软件。购买方式参见1.4.3节。步骤5

26、：购买成功后，我们会通过Email、邮寄光盘或者其他方式给您发送注册文件。步骤6：用接收到的注册文件覆盖本软件安装目录下的注册信息文件。3. 直接激励项目3.1 简介直接激励项目提供了发送数据的功能，采用列表结构组织激励项。支持16进制、字符串、字符串+新行和文件四种数据格式，支持激励项延时，支持激励项使能，支持立即执行激励项（左边激励按钮，忽略激活属性）。3.2 基本操作3.2.1 新建直接激励项目步骤1：【应用程序菜单】-“新建”-“直接激励项目”。步骤2：选择项目路径，输入项目名称，点击“保存”。3.2.2 打开直接激励项目方法1：步骤1：【应用程序菜单】-“打开”-“直接激励项目”。步

27、骤2：选择项目文件，点击“打开”。方法2：步骤1：【应用程序菜单】-在“最近项目”面板中选择需要打开的项目。3.2.3 关闭直接激励项目步骤1：【控制台】-选择“直接激励管理器”。步骤2：【应用程序菜单】-“关闭”。3.2.4 保存直接激励项目步骤1：【控制台】-选择“直接激励管理器”。步骤2：【应用程序菜单】-“保存”或者“另存为”。3.2.5 修改直接激励项目属性步骤1：【控制台】-选择“直接激励管理器”。步骤2：【工具栏】-“属性”；或者，【控制台】-鼠标右键弹出快捷菜单-“属性”。直接激励项目属性属性说明工程名称显示工程的名称，可修改。文件路径显示工程文件的存储路径，不可以修改。3.2

28、.6 添加直接激励项步骤1：【控制台】-选择“直接激励管理器”。步骤2：在“直接激励管理器”中选中一个激励项，新添加激励项将插入选中激励项的前面。步骤3：【工具栏】-“添加”-“添加直接激励”；或者，【控制台】-鼠标右键弹出快捷菜单-“添加直接激励”。步骤4：编辑新添加激励项的数据格式、数据、延时、激活属性。3.2.7 删除直接激励项步骤1：【控制台】-选择“直接激励管理器”。步骤2：在“直接激励管理器”中选中要删除的激励项。步骤3：【工具栏】-“删除”；或者，【控制台】-鼠标右键弹出快捷菜单-“删除”。3.2.8 激励激励前提：通信接口已经打开。步骤1：【控制台】-选择“直接激励管理器”。步

29、骤2：【工具栏】-“激励”；或者，【工具栏】-“激励”菜单-“激励”/“循环激励”；或者，【控制台】-鼠标右键弹出快捷菜单-“激励”/“循环激励”。3.2.9 停止激励停止激励前提：正在激励。步骤1：【控制台】-选择“直接激励管理器”。步骤2：【工具栏】-“停止”；或者，【控制台】-鼠标右键弹出快捷菜单-“停止”。3.3 用途直接激励项目有如下几种使用环境。 与被激励方进行命令交互，作为监控被激励方的命令控制台 给被激励方增加干扰信号，测试被激励方4. 协议激励项目4.1 简介协议是通信系统必不可少的部分，如何组织和开展有效的协议测试，低成本地应付快速多变的通信环境，越来越受到企业和研发人员的

30、关注。过去，需要为每一份通信协议定制一个测试工具，众多定制的测试工具，极大的增加测试开发、维护和学习成本，与竞争日益激烈的现代电子研发行业背道而驰。格西烽火的协议激励功能彻底地把多变的通信规约脱离通信软件，使得通信软件能够应付快速多变的通信环境。格西烽火协议激励功能带来的好处： 单一的测试工具取代众多定制的测试工具，极大的降低测试开发、维护和学习成本 快捷的激励源管理方式，即改即测，极大的降低研发成本 以文件的方式组织项目，有利于管理众多的测试项目，有利于测试标准化 支持循环激励与激励报告，提高测试自动化水平4.2 基本操作4.2.1 新建协议激励项目步骤1：【应用程序菜单】-“新建”-“协议

31、激励项目”。步骤2：选择项目路径，输入项目名称，点击“保存”。4.2.2 打开协议激励项目方法1：步骤1：【应用程序菜单】-“打开”-“协议激励项目”。步骤2：选择项目文件，点击“打开”。方法2：步骤1：【应用程序菜单】-在“最近项目”面板中选择需要打开的项目。4.2.3 关闭协议激励项目步骤1：【控制台】-选择“协议激励管理器”。步骤2：【应用程序菜单】-“关闭”。4.2.4 保存协议激励项目步骤1：【控制台】-选择“协议激励管理器”。步骤2：【应用程序菜单】-“保存”或者“另存为”。4.2.5 修改协议激励项目属性步骤1：【控制台】-选择“协议激励管理器”。步骤2：在“协议激励管理器”中选

32、择项目节点。步骤3：【工具栏】-“属性”；或者，【控制台】-鼠标右键弹出快捷菜单-“属性”。协议激励项目属性属性说明工程名称显示工程的名称，可修改。工作模式协议激励工程支持“单工”和“双工”两种工作模式。“单工”模式下不管有没有“被动模式”的协议项，一律按照顺序执行选中的协议项；“双工”模式下“主动模式”协议项和“被动模式”协议项是分别同时执行的，“主动模式”协议项按顺序执行，“被动模式”的协议项是不按照顺序的，匹配正确即执行。例如：模拟主动型设备，按需求可用“单工”或者“双工”；模拟被动型设备，一般使用“双工”，等待需要执行的命令。文件路径显示工程文件的存储路径，不可以修改。4.2.6 添加

33、协议集步骤1：【控制台】-选择“协议激励管理器”。步骤2：在“协议激励管理器”中选中一个协议项/协议集，作为新添加协议集的位置。步骤3：【工具栏】-“添加”-“添加协议集”；或者，【控制台】-鼠标右键弹出快捷菜单-“添加协议集”。步骤4：在协议集属性对话框中输入协议集名称，点击“确定”。步骤5：选择新添加协议集相对当前选中项的位置，点击“确定”。4.2.7 添加协议项步骤1：【控制台】-选择“协议激励管理器”。步骤2：在“协议激励管理器”中选中一个协议项/协议集，作为新添加协议的位置。步骤3：【工具栏】-“添加”-“添加协议”；或者，【控制台】-鼠标右键弹出快捷菜单-“添加协议”。步骤4：在协

34、议属性对话框中，输入相关参数，点击“确定”。属性说明协议名称描述协议名称。激活使能协议节点。协议类型为了实现结果数据的分类显示，协议激励项目能够自定义数据类型，协议项在激励时根据所属的协议类型把结果输出到对应的自定义数据区中。可以通过“管理协议类型”按钮打开协议类型管理器。工作模式协议项的工作模式有“主动模式”和“被动模式”两种。“主动模式”表示该协议项是主动命令，是发送请求帧，校验响应帧；“被动模式”表示该协议项是被动命令，是等待请求帧，然后根据请求帧情况发送响应帧。协议延时表示协议执行完毕后延时多长才进入下一个协议激励。失效超时表示协议在匹配到正确数据之前最长等待时间，超过该时间长度即判失

35、败。循环次数表示循环激励该协议的次数。期望响应“主动模式”表示发送请求帧后期望收到的响应帧，默认值表示自动匹配；“被动模式”表示收到请求帧后发送出去的响应帧，默认值表示发送响应帧1。请求帧显示和编辑请求帧的格式和内容。参见4.3节。响应帧1/响应帧2显示和编辑响应帧1/响应帧2的格式和内容。参见4.3节。协议脚本显示和编辑协议脚本。参见4.4节。步骤5：选择新添加协议相对当前选中项的位置，点击“确定”。4.2.8 激励激励前提：通信接口已经打开。步骤1：【控制台】-选择“协议激励管理器”。步骤2：【工具栏】-“激励”；或者，【工具栏】-“激励”菜单-“激励”/“循环激励”；或者，【控制台】-鼠

36、标右键弹出快捷菜单-“激励”/“循环激励”。4.2.9 停止激励停止激励前提：正在激励。步骤1：【控制台】-选择“协议激励管理器”。步骤2：【工具栏】-“停止”；或者，【控制台】-鼠标右键弹出快捷菜单-“停止”。4.3 协议帧协议帧由一个或者多个帧格式单元组成，帧格式单元可以非字节对齐，但协议帧必须字节对齐。帧格式单元属性说明序号表示帧格式单元的排列顺序。名称表示帧格式单元的名称。数据格式表示帧格式单元的数据构成，可以有多段数据格式构成。数据格式左边表示位数，右边表示数值。数据格式的位数可以是任意位数。例如：单段字节对齐，多段字节对齐，单段非字节对齐，多段非字节对齐。属性（变量类型）帧格式单元

37、的变量类型支持普通变量、计算变量和重复变量三种。普通变量是常量；计算变量是通过计算前面数据得到的结果作为变量值，如校验和；重复变量是指该变量在该数据帧中可能重复多次，0表示自动，可表示0n次，0表示精确次数。属性（存储模式）帧格式单元的数据支持小端模式和大端模式两种存储模式，例如，字节顺序从低到高（即发送/接收的字节顺序）为0x12 0x34 0x56，小端模式下设置为，大端模式下设置为。属性（匹配）匹配选择用来判断协议帧完整性。工具条命令功能添加在当前选择的帧格式单元中插入新的帧格式单元。删除删除当前选择的帧格式单元。上移将当前选择的帧格式单元向上移动一格。下移将当前选择的帧格式单元向下移动

38、一格。添加格式单元在当前选择的帧格式单元中添加一个数据格式单元。删除格式单元删除当前选择的帧格式单元中的数据格式单元。4.4 协议脚本4.4.1 脚本界面工具条命令功能脚本语言设置本协议项的脚本语言，支持C#、VB、Jscript三种语言。编译检查通过编译检查当前脚本的是否有错误。导入导入外部存储的脚本。导出将当前的脚本导出为文件。剪切剪切选中的脚本文本。复制复制选中的脚本文本。粘贴在当前光标位置粘贴剪切板的文本。删除删除选中的脚本文本。清除清除所有脚本。脚本有错误，编译检查会提示错误的位置、错误码以及错误信息。4.4.2 脚本结构协议脚本支持C#、VB、Jscript三种语言，软件安装目录下

39、的Scripts子目录保存了三种语言的脚本模版，可以通过“导入”命令导入脚本编辑器。下面是C#版本的脚本模版，由一个.NET类Script构成，该类包含三个方法，分别是OnRequest方法，OnProcess方法，OnRespond方法。/*Copyright (c) 2014, 上海格西信息科技有限公司文件名称: Script.cs文件描述: C#脚本模版*/* 命名空间定义*/using System;/* 脚本类*/publicclassScript/*函数名称：OnRequest功能说明：主动模式在发送请求帧之前执行，被动模式在接收请求帧之后执行。输入参数：context 运行时上下

40、文，存储运行时的参数输出参数：无返回参数：成功返回1，失败返回0*/publicintOnRequest(BSCaseContext context)return1;/*函数名称：OnProcess功能说明：等待接收/发送响应帧时每一个处理周期（约5ms）执行1次。输入参数：context 运行时上下文，存储运行时的参数输出参数：无返回参数：成功返回1，失败返回0*/publicintOnProcess(BSCaseContext context)return1;/*函数名称：OnRespond功能说明：主动模式接收响应帧之后执行，被动模式在发送响应帧之后执行。输入参数：context 运行时

41、上下文，存储运行时的参数输出参数：无返回参数：成功返回1，失败返回0*/publicintOnRespond(BSCaseContext context)return1;4.4.3 脚本参数BSCaseContext类脚本函数的唯一输入参数是BSCaseContext类型，该类型实例承载了整个激励过程的脚本执行上下文，BSCaseContext类提供了属性和方法让脚本调用，完成对激励、协议帧、通信接口参数等执行参数的控制和管理。 .Power属性获取或者设置激励的运行状态，该值表明激励是否在运行。语法C#public bool Power get; set; 属性值类型：Syst

42、em.BooleanVBPublic Property Power As Boolean Get Set属性值类型：System.Boolean备注当需要停止激励运行时，可以在脚本中设置Power值为false，脚本运行完毕后停止激励。示例下面的示例在脚本的OnRequest方法中设置Power为false。C#public int OnRequest(BSCaseContext context) context.Power = false; context.Msg = Power=false.rn; return 1;VBPublic Function OnRequest(ByRef con

43、text As BSCaseContext) As Integer context.Power = false context.Msg = Power=false.rn OnRequest = 1End Function .CommParameters属性获取用于描述通信接口的对象。在串口通信中，该对象的类型为BSComStreamParameters，参见4.4.4。语法C#public object CommParameters get; 属性值类型：System.ObjectVBPublic ReadOnly Property CommParameters As Objec

44、t Get属性值类型：System.Object备注当需要运行中获取或者修改通信接口参数时，可以在脚本中先把CommParameters转换通信接口参数类型，然后再进行操作。示例下面的示例在脚本的OnRespond方法中设置串口通信接口参数。C#public int OnRespond(BSCaseContext context)BSComStreamParameters comParams = context.CommParameters as BSComStreamParameters; comParams.BaudRate = ; / 波特率设置为 comParams.Parity =

45、Parity.Odd; / 校验位设置为奇校验StringBuilder sb = new StringBuilder();sb.Append(string.Format(串口通信参数设置为: 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 BSComSt

46、reamParameters comParams = DirectCast(context.CommParameters, BSComStreamParameters) comParams.BaudRate = 波特率设置为 comParams.Parity = Parity.Odd 校验位设置为奇校验Dim sb As StringBuilder sb = new StringBuilder()sb.Append(String.Format(串口通信参数设置为: BaudRate=0, Parity=1rn,comParams.BaudRate, comParams.Parity) 输出信息

47、context.Msg = sb.ToString() OnRequest = 1End Function .Msg属性获取或者设置一个信息字符串，该字符串在脚本函数结束后显示到数据区。语法C#public string Msg get; set; 属性值类型：System.StringVBPublic Property Msg As String Get Set属性值类型：System.String备注当需要在脚本函数结束后显示信息到数据区时，可以在脚本函数中设置Msg值，Msg的值是读后清除的，如果需要设置多个信息，可以先通过StringBuilder拼接，再统一赋值给Msg

48、，或者使用AppendMsg方法。示例下面的示例在脚本的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属性获取协议匹配的索引号。从0开始，匹配请求帧有

49、效值为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 (context.MatchResult = 0) / 期望收到响应帧1 string msg = 响应帧1的帧格式单元3: + context.GetRespondValue(0,2) + rn;context.Msg =