格西烽火使用用户手册[应用知识]
格西烽火用户手册版本 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.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.4 串口参数BSComStreamParameters类 404.4.5 脚本中使用插件 445. 插件 455.1 托管代码与非托管代码 455.2 编写插件 455.3 使用托管代码的第三方库 455.4 使用非托管代码的第三方库 456. 工具箱 466.1 校验和计算器 466.2 CRC计算器 466.3 DES计算器 476.4 哈希值计算器 487. 应用技巧 497.1 分类组织协议激励项目的协议项 497.2 运行多个软件实例 498. FAQ 498.1 进行“反馈”或者“注册软件”操作时，为什么出现Unknown error (0x80041002)错误？ 498.2 进行协议激励时，从动方已经发出正确的帧，为什么主动激励方却返回失败？ 49用户手册 1. 简介1.1 关于格西烽火是一个基于串口通信的多功能测试工具。
研发和测试人员可以利用它来接收和显示串口数据，快速创建、运行和管理各种直接激励源和协议激励源，并以项目文件的方式进行组织，彻底地把多变的通信规约脱离通信软件，使得通信软件能够应付快速多变的通信环境格西烽火带来的好处：Ø 单一的测试工具取代众多定制的测试工具，极大的降低测试开发、维护和学习成本Ø 快捷的激励源管理方式，即改即测，极大的降低研发成本Ø 以文件的方式组织项目，有利于管理众多的测试项目，有利于测试标准化Ø 支持循环激励与激励报告，提高测试自动化水平格西烽火主要适用于：Ø 电子产品研发、测试和生产企业Ø 电子产品研发、测试人员1.2 功能特性本软件发行了两个版本：Ø 免费版（Free Edition）Ø 专业版（Professional Edition）下表列出了本软件的功能特性以及在各个版本中的支持情况功能特性描述免费版专业版基本功能数据接收和显示、工具箱支持支持直接激励创建、运行和管理直接激励项目支持支持协议激励创建、运行和管理协议激励项目支持1.3 系统要求支持的操作系统：Ø Windows XP SP3Ø Windows Server 2003 SP2Ø Windows Vista SP1或更高版本Ø Windows Server 2008（在服务器核心角色上不受支持）Ø Windows 7Ø Windows Server 2008 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 最终用户许可协议重要说明：本《软件最终用户许可协议》（以下称《协议》）是您（个人或者单一实体）与上海格西信息科技有限公司之间的法律协议。
请在完成安装过程和使用本软件之前仔细阅读这个协议它提供了使用本软件的许可，并包含担保信息和免责声明安装和使用本软件的行为表示您确认接受了本软件，并且同意受到本协议条款的约束如果您不同意受这些条款的约束，请不要安装该软件不论此处是否提及或介绍了其它软件，本《协议》只适用于上海格西信息科技有限公司在此提供的软件1. 定义(1)“上海格西信息科技有限公司”是指上海格西信息科技有限公司及其许可方（如果有的话） (2)“软件”仅指上海格西信息科技有限公司软件程序和由上海格西信息科技有限公司在所有情况下提供的第三方软件程序，及其相应的文档、相关媒介、印刷材料和联机文档或者电子文档 (3)“试用版”是指该软件的一个标识版本，它仅用于在有限的期限内检查、演示和评估该软件试用版的功能可能有所限制，可能不允许最终用户保存最终产品，并且会因为内部的机制而在预定的时间期限到期后停止工作 2. 授予许可 本《协议》授予您以下权利：您可在一台计算机、工作站、终端机、手持式计算机上安装、使用、访问、显示、运行或以其它方式互相作用于（“运行”）本软件的一份副本3. 许可限制(1) 您不能制作或分发本软件的副本，或者用电子方式将本软件从一台计算机传输到另一台计算机，或者通过网络传输。
(2) 您不能更改、合并、修改、改编或者翻译该软件，或者反编译、逆向工程、反汇编或者以其它方式将软件分解成人类可以理解的形式 (3) 除非在此另有规定，否则您不能租借、租赁或者转授本软件的许可 (4) 除非在此另有规定，否则您不能修改本软件或者在本软件的基础上创建任何衍生产品5) 除非在此另有规定，您不能总计安装或者使用一个以上的试用版软件；不能用一个以上的用户名使用本软件的试用版；不能更改硬盘或计算机系统的内容，以便使试用版软件的累计使用时间超过一个试用版许可所允许的试用期限；不能在没有事先获得上海格西信息科技有限公司书面准许的情况下将使用本试用版所获得的软件性能指标透露给任何第三方；不能使用软件试用版的目的并非只是为了决定是否购买本软件商业版 (6) 您可能会通过一种以上媒介收到该软件，但只能安装或使用一种媒介不论您收到多少种媒介，您只能使用适合于要安装本软件的服务器或计算机的那种媒介7) 您可能会收到一个以上平台的软件，但只能安装或使用一个平台 (8) 您不能使用本软件来开发主要功能与本软件相同的任何应用程序 (9) 如果您违反了本 《协议》，上海格西信息科技有限公司可以终止该许可，您必须销毁所有软件副本（这种终止后仍然保留双方的所有其它权利和本《协议》所提供的任何其它权利）。
4. 升级程序 如果本软件副本是对该软件早期版本的升级，提供升级程序的基础是许可交换您安装和使用此类软件副本的行为表示您自愿终止早期 《协议》，并且不会继续使用该软件的早期版本或者转让给其他人或实体，除非这种转让符合第3部分的规定 5. 所有关系上述许可赋予您使用本软件的有限许可上海格西信息科技有限公司及其供应商保留所有权利、所有权和利益，包括软件（作为单独产品以及作为您后续开发的应用程序基础的底层产品）之中以及软件本身的所有版权和知识产权，所有副本亦不例外上海格西信息科技有限公司及其供应商保留本《协议》中没有明确授予的所有权利6. 有限担保和免责声明(1) 除非与任何示例应用程序代码、本软件的试用版有关，否则上海格西信息科技有限公司保证自交付之日起（以您的收据为准）的90天内：与推荐的硬件配置一起使用时，本软件的性能将与随附文档中的描述完全相符；并且在正常使用下，用于提供本软件的物理媒介在材料和工艺上没有任何缺陷 (2) 上海格西信息科技有限公司不对任何示例应用程序代码、本软件的试用版提供任何补救措施或明示或暗示的担保3) 除了上述有关所有示例应用程序代码、本软件试用版的有限担保外，上海格西信息科技有限公司及其供应商声明不承担所有其它明示、暗示或任何其它形式的担保和表示，包括对适销性或者特定目的适用性的担保。
此外，不担保不侵权和所有权上海格西信息科技有限公司不担保本软件无错误或者可以不中断地工作本软件并非设计用于或许可在需有故障自动防护功能的危险环境中使用，包括但不限于，核设施、飞机导航或通信系统、空中交通管制、生命保障系统或武器系统的设计、制造、维护或运行等上海格西信息科技有限公司明确声明不提供任何此类用途适用性的明示或暗示担保4) 如果适用法律要求提供与本软件有关的任何担保，所有此类担保的有效期仅限于交付之日后的90天之内5) 上海格西信息科技有限公司、其经销商、分销商、代理或者雇员提供的任何口头或书面信息均不构成担保或者以任何方式扩大此处提供的担保范围 7. 唯一补救措施您的唯一补救措施是将软件退回购买处，同时提供收据和问题描述只要在交付之日后的90天内以书面形式向上海格西信息科技有限公司提供任何与上述担保不符的情况，上海格西信息科技有限公司将用合理的商业努力为您提供一个完全符合文档的替换软件版本，替换有缺陷的媒介，或者按照您购买软件时的付款额退款，具体措施由上海格西信息科技有限公司选择在以下情况下上海格西信息科技有限公司不承担责任：软件已被以任何形式更改；因为误用、事故、滥用、修改或者应用不当而损坏了媒介；或者因为使用非推荐的硬件配置而造成软件无法使用。
若有任何软件误用、事故、滥用、修改或者应用不当的情况，上述担保将会无效这是给您的唯一的补救措施，用于弥补与本软件及其相关文档有关的明示或暗示的担保中的过失8. 责任限制(1) 若因使用或者无法使用本软件而出现的，并且以任何责任理论为依据的，包括违约、担保过失、民事侵权行为（包括疏忽）、产品责任等造成的任何间接、特殊、偶发、惩罚性、覆盖性或者继发损害（包括但不限于无法使用设备或访问数据造成的损坏、业务损失、利润损失、营业中断等），上海格西信息科技有限公司及其供应商均无需向您或任何第三方负责，即使上海格西信息科技有限公司或其代表事先已经得到了可能造成此种损坏的通知，并且即使此处所述的补救措施未能发挥应有效用，情况亦不例外2) 上海格西信息科技有限公司对任何原因造成的实际损坏的总赔偿金额限于您购买引起这种损坏的软件而支付的金额3) 上述责任限制适用于以上担保和免责声明以及本《协议》的所有其它方面9. 通则本《协议》适用《中华人民共和国著作权法》、《中华人民共和国计算机软件保护条例》、《中华人民共和国商标法》、《中华人民共和国专利法》等法律法规本《协议》受中华人民共和国法律管辖1.4.3 购买注册专业版优势Ø 许可在商业环境下使用本软件Ø 获得用户身份校验信息和丰富的高级功能Ø 获得支持和帮助购买方式方式1：与销售代表联系Ø 电子邮件：sales@Ø 电话：021-52194366方式2：从淘宝网（）格西旗舰店直接购买Ø 网址：1.5 支持服务您在使用本软件的过程中遇到问题或者希望获得产品的支持信息，可以通过我们的网站、电子邮件等方式与我们联系。
Ø 支持网站：Ø 电子邮件：support@Ø 微信号：gesherØ QQ：9794642. 软件入门2.1 启动软件本软件安装成功之后，会在Windows的【开始菜单】中创建菜单项，同时关联直接激励项目文件（.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打开一个直接激励项目，并建立项目环境关闭关闭当前激活的项目保存Ctrl+S保存当前激活的项目另存为将当前激活的项目保存到指定路径全部保存Ctrl+Shift+S保存当前打开的所有项目设置设置软件的运行参数注册产品注册软件，获得更多功能和服务，注册成功隐藏该菜单。
帮助F1软件的使用帮助关于显示软件的版权、版本以及注册信息等退出Alt+F4退出系统2.2.3 工具栏基本工具栏（无项目状态）命令功能打开/关闭打开或者关闭串口串口号设置串口号，自动检测当前系统有效的串口设备波特率设置波特率，提供标准波特率，支持自定义波特率输入数据位设置数据位，支持5、6、7、8停止位设置停止位，支持1、1.5、2校验位设置校验位，支持无、奇校验、偶校验、置1、置0流控制（握手协议）设置流控制，支持无、RequestToSend、XonXoff、RequestToSend /XonXoffRTS设置在串行通信中是否启用请求发送 (RTS) 信号DTR设置在串行通信中是否启用数据终端就绪 (DTR) 信号HEX设置数据面板数据显示格式，选中表示解析为HEX字符串，不选表示直接解析为字符串清除清除所有数据区的显示数据，不影响已经保存的数据折叠工具栏（右上角第1个按钮）显示/折叠工具栏反馈（右上角第2个按钮）显示用户反馈对话框帮助（右上角第3个按钮）显示用户帮助协议激励工具栏（通信接口已折叠）命令功能激励单次激励选中的协议项或者协议集，下来菜单提供循环激励功能停止停止运行协议激励。
报告下来菜单提供显示/隐藏协议激励报告，导出协议报告添加下来菜单提供在当前选定节点的添加协议项或者协议集功能保存保存协议激励项目剪切剪切当前选定节点复制复制当前选定节点粘贴在当前选定节点粘贴删除删除当前选定节点属性显示当前选定节点的属性对话框直接激励工具栏（通信接口已折叠）命令功能激励单次激励直接激励项目所有激活的激励项，下来菜单提供循环激励功能停止停止运行直接激励添加下来菜单提供在当前选定节点的添加协议项或者协议集功能保存保存直接激励项目删除删除当前选定的激励项属性显示直接激励项目的属性对话框常用工具工具栏命令功能计算器运行系统提供的计算器程序校验和运行工具箱的校验和计算器CRC运行工具箱的CRC计算器DES运行工具箱的DES计算器哈希值运行工具箱的哈希值计算器2.2.4 状态栏状态栏分为三部分，分别为操作状态信息、通信传输字节信息、通信接口状态信息状态栏功能操作状态信息显示上一次操作的状态信息，有错误、警告、信息三种状态通信传输字节信息显示自打开通信接口以来总共接收/发送的字节数通信接口状态信息显示当前通信接口状态2.2.5 控制台协议激励项目控制台，采用树形结构进行组织协议项协议激励项目控制台右键快捷菜单。
直接激励项目控制台，采用列表结构组织激励项支持16进制、字符串、字符串+新行和文件四种数据格式，支持激励项延时，支持激励项使能，支持立即执行激励项（左边激励按钮，忽略激活属性）直接激励项目控制台右键快捷菜单2.2.6 数据区数据区是显示激励数据的区域，数据分为公共数据、自定义数据和报告数据数据类型功能公共数据显示通信传输的实际收发数据，其中发送数据可以通过设置屏蔽，协议激励如果没有自定义数据，默认显示在公共数据区自定义数据只有协议激励项目能够自定义数据类型，协议项在激励时根据所属的协议类型把结果输出到对应的自定义数据区中报告数据只有协议激励项目有运行报告，协议激励报告作为独立的页面显示在数据区各个数据区可以按需布局，灵活排布，方便数据观测2.3 软件设置操作：【应用程序菜单】->“设置”2.3.1 常规设置参数功能显示最大长度(KB)设置数据区中结果数据面板最大容纳的字节数，超过这个最大值，数据面板自动清除最旧的数据最小化到系统托盘使能后主窗体在最小化时隐藏到系统托盘打印输出数据设置数据区“数据”面板中是否显示发送的数据打印数据时间戳设置数据区“数据”面板中是否显示数据的时间戳，使能后设置间隔为0则每次收发都打印时间戳，设置间隔>0则每隔一定时间打印一次。
鼠标双击运行激励设置控制台的激励项是否在打开通信接口后可以通过鼠标双击来运行激励启动时自动打开最近项目设置软件启动时是否自动打开最近一次打开的激励项目保存结果使能保存功能，并设置保存结果的目录2.3.2 激励工程设置协议激励结果数据包含名称、时间（起始时间）、请求帧、响应帧、耗时（执行时间）和结果六个数据段协议激励工程参数功能打印分隔符设置激励结果数据各个数据段之间的分隔符，支持“新行”和“空格”两种分隔方式打印起始时间设置激励结果数据是否显示“时间”数据段打印执行时间设置激励结果数据是否显示“耗时”数据段打印帧数据设置激励结果数据是否显示“请求帧”和“响应帧”的帧数据2.3.3 插件信息列出位于本软件安装目录的Plugins子目录下的可以被本软件识别的基于Microsoft .NET Framework的托管代码组件2.4 软件注册软件注册是指专业版的注册，免费版无需注册如果软件在未注册状态，【应用程序菜单】中会显示“注册产品”菜单条目，注册成功则隐藏该菜单条目可以通过【应用程序菜单】中的“关于”菜单查看软件的注册信息软件可以通过以下步骤完成注册：步骤1：【应用程序菜单】-> “注册产品”。
用户标识是用户计算机特征码，自动生成步骤2：输入用户名称和电子邮件地址合法的电子邮件地址可以直接用来接收注册文件步骤3：点击“提交”注册信息会发送到注册服务器，如果无法和服务器联系，本软件则会启动Email发送程序，由用户发送注册信息给我们步骤4：购买软件购买方式参见1.4.3节步骤5：购买成功后，我们会通过Email、邮寄光盘或者其他方式给您发送注册文件步骤6：用接收到的注册文件覆盖本软件安装目录下的注册信息文件3. 直接激励项目3.1 简介直接激励项目提供了发送数据的功能，采用列表结构组织激励项支持16进制、字符串、字符串+新行和文件四种数据格式，支持激励项延时，支持激励项使能，支持立即执行激励项（左边激励按钮，忽略激活属性）3.2 基本操作3.2.1 新建直接激励项目步骤1：【应用程序菜单】->“新建”->“直接激励项目”步骤2：选择项目路径，输入项目名称，点击“保存”3.2.2 打开直接激励项目方法1：步骤1：【应用程序菜单】->“打开”->“直接激励项目”步骤2：选择项目文件，点击“打开”方法2：步骤1：【应用程序菜单】->在“最近项目”面板中选择需要打开的项目3.2.3 关闭直接激励项目步骤1：【控制台】->选择“直接激励管理器”。
步骤2：【应用程序菜单】->“关闭”3.2.4 保存直接激励项目步骤1：【控制台】->选择“直接激励管理器”步骤2：【应用程序菜单】->“保存”或者“另存为”3.2.5 修改直接激励项目属性步骤1：【控制台】->选择“直接激励管理器”步骤2：【工具栏】->“属性”；或者，【控制台】->鼠标右键弹出快捷菜单->“属性”直接激励项目属性属性说明工程名称显示工程的名称，可修改文件路径显示工程文件的存储路径，不可以修改3.2.6 添加直接激励项步骤1：【控制台】->选择“直接激励管理器”步骤2：在“直接激励管理器”中选中一个激励项，新添加激励项将插入选中激励项的前面步骤3：【工具栏】->“添加”->“添加直接激励”；或者，【控制台】->鼠标右键弹出快捷菜单->“添加直接激励”步骤4：编辑新添加激励项的数据格式、数据、延时、激活属性3.2.7 删除直接激励项步骤1：【控制台】->选择“直接激励管理器”步骤2：在“直接激励管理器”中选中要删除的激励项步骤3：【工具栏】->“删除”；或者，【控制台】->鼠标右键弹出快捷菜单->“删除”3.2.8 激励激励前提：通信接口已经打开步骤1：【控制台】->选择“直接激励管理器”。
步骤2：【工具栏】->“激励”；或者，【工具栏】->“激励”菜单->“激励”/“循环激励”；或者，【控制台】->鼠标右键弹出快捷菜单->“激励”/“循环激励”3.2.9 停止激励停止激励前提：正在激励步骤1：【控制台】->选择“直接激励管理器”步骤2：【工具栏】->“停止”；或者，【控制台】->鼠标右键弹出快捷菜单->“停止”3.3 用途直接激励项目有如下几种使用环境Ø 与被激励方进行命令交互，作为监控被激励方的命令控制台Ø 给被激励方增加干扰信号，测试被激励方4. 协议激励项目4.1 简介协议是通信系统必不可少的部分，如何组织和开展有效的协议测试，低成本地应付快速多变的通信环境，越来越受到企业和研发人员的关注过去，需要为每一份通信协议定制一个测试工具，众多定制的测试工具，极大的增加测试开发、维护和学习成本，与竞争日益激烈的现代电子研发行业背道而驰格西烽火的协议激励功能彻底地把多变的通信规约脱离通信软件，使得通信软件能够应付快速多变的通信环境格西烽火协议激励功能带来的好处：Ø 单一的测试工具取代众多定制的测试工具，极大的降低测试开发、维护和学习成本Ø 快捷的激励源管理方式，即改即测，极大的降低研发成本Ø 以文件的方式组织项目，有利于管理众多的测试项目，有利于测试标准化Ø 支持循环激励与激励报告，提高测试自动化水平4.2 基本操作4.2.1 新建协议激励项目步骤1：【应用程序菜单】->“新建”->“协议激励项目”。
步骤2：选择项目路径，输入项目名称，点击“保存”4.2.2 打开协议激励项目方法1：步骤1：【应用程序菜单】->“打开”->“协议激励项目”步骤2：选择项目文件，点击“打开”方法2：步骤1：【应用程序菜单】->在“最近项目”面板中选择需要打开的项目4.2.3 关闭协议激励项目步骤1：【控制台】->选择“协议激励管理器”步骤2：【应用程序菜单】->“关闭”4.2.4 保存协议激励项目步骤1：【控制台】->选择“协议激励管理器”步骤2：【应用程序菜单】->“保存”或者“另存为”4.2.5 修改协议激励项目属性步骤1：【控制台】->选择“协议激励管理器”步骤2：在“协议激励管理器”中选择项目节点步骤3：【工具栏】->“属性”；或者，【控制台】->鼠标右键弹出快捷菜单->“属性”协议激励项目属性属性说明工程名称显示工程的名称，可修改工作模式协议激励工程支持“单工”和“双工”两种工作模式单工”模式下不管有没有“被动模式”的协议项，一律按照顺序执行选中的协议项；“双工”模式下“主动模式”协议项和“被动模式”协议项是分别同时执行的，“主动模式”协议项按顺序执行，“被动模式”的协议项是不按照顺序的，匹配正确即执行。
例如：模拟主动型设备，按需求可用“单工”或者“双工”；模拟被动型设备，一般使用“双工”，等待需要执行的命令文件路径显示工程文件的存储路径，不可以修改4.2.6 添加协议集步骤1：【控制台】->选择“协议激励管理器”步骤2：在“协议激励管理器”中选中一个协议项/协议集，作为新添加协议集的位置步骤3：【工具栏】->“添加”->“添加协议集”；或者，【控制台】->鼠标右键弹出快捷菜单->“添加协议集”步骤4：在协议集属性对话框中输入协议集名称，点击“确定”步骤5：选择新添加协议集相对当前选中项的位置，点击“确定”4.2.7 添加协议项步骤1：【控制台】->选择“协议激励管理器”步骤2：在“协议激励管理器”中选中一个协议项/协议集，作为新添加协议的位置步骤3：【工具栏】->“添加”->“添加协议”；或者，【控制台】->鼠标右键弹出快捷菜单->“添加协议”步骤4：在协议属性对话框中，输入相关参数，点击“确定”属性说明协议名称描述协议名称激活使能协议节点协议类型为了实现结果数据的分类显示，协议激励项目能够自定义数据类型，协议项在激励时根据所属的协议类型把结果输出到对应的自定义数据区中可以通过“管理协议类型”按钮打开协议类型管理器。
工作模式协议项的工作模式有“主动模式”和“被动模式”两种主动模式”表示该协议项是主动命令，是发送请求帧，校验响应帧；“被动模式”表示该协议项是被动命令，是等待请求帧，然后根据请求帧情况发送响应帧协议延时表示协议执行完毕后延时多长才进入下一个协议激励失效超时表示协议在匹配到正确数据之前最长等待时间，超过该时间长度即判失败循环次数表示循环激励该协议的次数期望响应“主动模式”表示发送请求帧后期望收到的响应帧，默认值表示自动匹配；“被动模式”表示收到请求帧后发送出去的响应帧，默认值表示发送响应帧1请求帧显示和编辑请求帧的格式和内容参见4.3节响应帧1/响应帧2显示和编辑响应帧1/响应帧2的格式和内容参见4.3节协议脚本显示和编辑协议脚本参见4.4节步骤5：选择新添加协议相对当前选中项的位置，点击“确定”4.2.8 激励激励前提：通信接口已经打开步骤1：【控制台】->选择“协议激励管理器”步骤2：【工具栏】->“激励”；或者，【工具栏】->“激励”菜单->“激励”/“循环激励”；或者，【控制台】->鼠标右键弹出快捷菜单->“激励”/“循环激励”4.2.9 停止激励停止激励前提：正在激励步骤1：【控制台】->选择“协议激励管理器”。
步骤2：【工具栏】->“停止”；或者，【控制台】->鼠标右键弹出快捷菜单->“停止”4.3 协议帧协议帧由一个或者多个帧格式单元组成，帧格式单元可以非字节对齐，但协议帧必须字节对齐帧格式单元属性说明序号表示帧格式单元的排列顺序名称表示帧格式单元的名称数据格式表示帧格式单元的数据构成，可以有多段数据格式构成数据格式左边表示位数，右边表示数值数据格式的位数可以是任意位数例如：单段字节对齐，多段字节对齐，单段非字节对齐，多段非字节对齐属性（变量类型）帧格式单元的变量类型支持普通变量、计算变量和重复变量三种普通变量是常量；计算变量是通过计算前面数据得到的结果作为变量值，如校验和；重复变量是指该变量在该数据帧中可能重复多次，0表示自动，可表示0~n次，>0表示精确次数属性（存储模式）帧格式单元的数据支持小端模式和大端模式两种存储模式，例如，字节顺序从低到高（即发送/接收的字节顺序）为0x12 0x34 0x56，小端模式下设置为，大端模式下设置为属性（匹配）匹配选择用来判断协议帧完整性工具条命令功能添加在当前选择的帧格式单元中插入新的帧格式单元删除删除当前选择的帧格式单元上移将当前选择的帧格式单元向上移动一格。
下移将当前选择的帧格式单元向下移动一格添加格式单元在当前选择的帧格式单元中添加一个数据格式单元删除格式单元删除当前选择的帧格式单元中的数据格式单元4.4 协议脚本4.4.1 脚本界面工具条命令功能脚本语言设置本协议项的脚本语言，支持C#、VB、Jscript三种语言编译检查通过编译检查当前脚本的是否有错误导入导入外部存储的脚本导出将当前的脚本导出为文件剪切剪切选中的脚本文本复制复制选中的脚本文本粘贴在当前光标位置粘贴剪切板的文本删除删除选中的脚本文本清除清除所有脚本脚本有错误，编译检查会提示错误的位置、错误码以及错误信息4.4.2 脚本结构协议脚本支持C#、VB、Jscript三种语言，软件安装目录下的Scripts子目录保存了三种语言的脚本模版，可以通过“导入”命令导入脚本编辑器下面是C#版本的脚本模版，由一个.NET类Script构成，该类包含三个方法，分别是OnRequest方法，OnProcess方法，OnRespond方法/************************************************************************* Copyright (c) 2014, 上海格西信息科技有限公司 文件名称: Script.cs 文件描述: C#脚本模版**************************************************************************//** * 命名空间定义 *///using System;/** * 脚本类 */public class Script{ /************************************************************************* 函数名称：OnRequest 功能说明：主动模式在发送请求帧之前执行，被动模式在接收请求帧之后执行。
输入参数：context – 运行时上下文，存储运行时的参数 输出参数：无 返回参数：成功返回1，失败返回0 *************************************************************************/ public int OnRequest(BSCaseContext context) { return 1; } /************************************************************************* 函数名称：OnProcess 功能说明：等待接收/发送响应帧时每一个处理周期（约5ms）执行1次 输入参数：context – 运行时上下文，存储运行时的参数 输出参数：无 返回参数：成功返回1，失败返回0 *************************************************************************/ public int OnProcess(BSCaseContext context) { return 1; } /************************************************************************* 函数名称：OnRespond 功能说明：主动模式接收响应帧之后执行，被动模式在发送响应帧之后执行。
输入参数：context – 运行时上下文，存储运行时的参数 输出参数：无 返回参数：成功返回1，失败返回0 *************************************************************************/ public int OnRespond(BSCaseContext context) { return 1; }}4.4.3 脚本参数BSCaseContext类脚本函数的唯一输入参数是BSCaseContext类型，该类型实例承载了整个激励过程的脚本执行上下文，BSCaseContext类提供了属性和方法让脚本调用，完成对激励、协议帧、通信接口参数等执行参数的控制和管理4.4.3.1 .Power属性获取或者设置激励的运行状态，该值表明激励是否在运行语法C#public bool Power { get; set; }属性值类型：System.BooleanVBPublic Property Power As Boolean Get Set属性值类型：System.Boolean备注当需要停止激励运行时，可以在脚本中设置Power值为false，脚本运行完毕后停止激励。
示例下面的示例在脚本的OnRequest方法中设置Power为falseC#public int OnRequest(BSCaseContext context){ context.Power = false; context.Msg = "Power=false.\r\n"; return 1;}VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer context.Power = false context.Msg = "Power=false.\r\n" OnRequest = 1End Function4.4.3.2 .CommParameters属性获取用于描述通信接口的对象在串口通信中，该对象的类型为BSComStreamParameters，参见4.4.4语法C#public object CommParameters { get; }属性值类型：System.ObjectVBPublic ReadOnly Property CommParameters As Object Get属性值类型：System.Object备注当需要运行中获取或者修改通信接口参数时，可以在脚本中先把CommParameters转换通信接口参数类型，然后再进行操作。
示例下面的示例在脚本的OnRespond方法中设置串口通信接口参数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(string.Format("串口通信参数设置为: BaudRate={0}, Parity={1}\r\n", 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, BSComStreamParameters) comParams.BaudRate = 115200 '波特率设置为115200 comParams.Parity = Parity.Odd ' 校验位设置为奇校验Dim sb As StringBuilder sb = new StringBuilder()sb.Append(String.Format("串口通信参数设置为: BaudRate={0}, Parity={1}\r\n", comParams.BaudRate, comParams.Parity)) ' 输出信息context.Msg = sb.ToString() OnRequest = 1End Function4.4.3.3 .Msg属性获取或者设置一个信息字符串，该字符串在脚本函数结束后显示到数据区。
语法C#public string Msg { get; set; }属性值类型：System.StringVBPublic Property Msg As String Get Set属性值类型：System.String备注当需要在脚本函数结束后显示信息到数据区时，可以在脚本函数中设置Msg值，Msg的值是读后清除的，如果需要设置多个信息，可以先通过StringBuilder拼接，再统一赋值给Msg，或者使用AppendMsg方法示例下面的示例在脚本的OnRequest方法中设置MsgC#public int OnRequest(BSCaseContext context){ context.Msg = "Hello World.\r\n"; return 1;}VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer context.Msg = "Hello World.\r\n" OnRequest = 1End Function4.4.3.4 .MatchResult属性获取协议匹配的索引号。
从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 (context.MatchResult == 0) { // 期望收到响应帧1 string msg = "响应帧1的帧格式单元3:" + context.GetRespondValue(0,2) + "\r\n"; context.Msg = msg; return 1; // 返回成功 } return 0; // 返回失败}VBPublic Function OnRespond (ByRef context As BSCaseContext) As Integer Dim msg As String If context.MatchResult = 0 Then '期望收到响应帧1 msg = "响应帧1的帧格式单元3:" + context.GetRespondValue(0,2) + "\r\n" context.Msg = msg OnRespond = 1 '返回成功 End If OnRespond = 0 '返回失败 End Function4.4.3.5 .ExpectedRespond属性获取或设置Respond属性的索引，有效值从0开始。
主动模式表示期望收到的Respond的index，-1表示自动检测，从动模式表示收到Request后要响应的Respond的索引语法C#public int ExpectedRespond{ get; set; }属性值类型：System.IntegerVBPublic Property ExpectedRespond As Integer Get Set属性值类型：System. Integer备注示例下面的示例在脚本的OnRequest方法中获取C#public int OnRequest(BSCaseContext context){ // 期望的响应帧 string msg = "协议期望的响应帧:" + context.ExpectedRespond + "\r\n";context.Msg = msg;return 1; // 返回成功 }VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integer Dim msg As String msg = "协议期望的响应帧:" + context.ExpectedRespond + "\r\n"context.Msg = msg OnRequest = 1 '返回成功 End Function4.4.3.6 .AppendMsg方法添加一个信息字符串，该字符串将附加在原来Msg后面，在脚本函数结束后显示到数据区。
语法C#public void AppendMsg(string msg)参数msg类型：System.String要附加到Msg后面的新字符串VBPublic Sub AppendMsg(msg As String)参数msg类型：System.String要附加到Msg后面的新字符串备注当需要设置多个信息时，使用AppendMsg方法示例下面的示例在脚本的OnRequest方法中使用AppendMsg添加多个信息字符串C#public int OnRequest(BSCaseContext context){context.AppendMsg("Hello A.\r\n");context.AppendMsg("Hello B.\r\n"); return 1;}VBPublic Function OnRequest(ByRef context As BSCaseContext) As Integercontext.AppendMsg("Hello A.\r\n")context.AppendMsg("Hello B.\r\n") OnRequest = 1End Function4.4.3.7 .GetVariant方法获取用户自定义变量的值。
语法C#public object GetVariant(object key)参数key类型：System.Object用户变量的名称，是一个关键字，不允许有重复的key返回值类型：Syste。
