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