格西烽火使用用户基础手册.doc

格西烽火
顾客手册

版本 1.0

目录
1. 简介 4
1.1 关于 4
1.2 功能特性 4
1.3 系统规定 4
1.4 允许与购买 5
1.4.1 版权 5
1.4.2 最后顾客允许合同 5
1.4.3 购买 7
1.5 支持服务 7
2. 软件入门 7
2.1 启动软件 7
2.2 顾客界面 8
2.2.1 主界面 8
2.2.2 应用程序菜单 8
2.2.3 工具栏 10
2.2.4 状态栏 12
2.2.5 控制台 12
2.2.6 数据区 14
2.3 软件设立 15
2.3.1 常规设立 15
2.3.2 勉励工程设立 16
2.3.3 插件信息 16
2.4 软件注册 17
3. 直接勉励项目 18
3.1 简介 18
3.2 基本操作 19
3.2.1 新建直接勉励项目 19
3.2.2 打开直接勉励项目 19
3.2.3 关闭直接勉励项目 19
3.2.4 保存直接勉励项目 20
3.2.5 修改直接勉励项目属性 20
3.2.6 添加直接勉励项 20
3.2.7 删除直接勉励项 20
3.2.8 勉励 20
3.2.9 停止勉励 21
3.3 用途 21
4. 合同勉励项目 21
4.1 简介 21
4.2 基本操作 21
4.2.1 新建合同勉励项目 21
4.2.2 打开合同勉励项目 21
4.2.3 关闭合同勉励项目 22
4.2.4 保存合同勉励项目 22
4.2.5 修改合同勉励项目属性 22
4.2.6 添加合同集 22
4.2.7 添加合同项 23
4.2.8 勉励 25
4.2.9 停止勉励 25
4.3 合同帧 25
4.4 合同脚本 26
4.4.1 脚本界面 27
4.4.2 脚本构造 28
4.4.3 脚本参数BSCaseContext类 29
4.4.4 串口参数BSComStreamParameters类 40
4.4.5 脚本中使用插件 44
5. 插件 45
5.1 托管代码与非托管代码 45
5.2 编写插件 45
5.3 使用托管代码第三方库 45
5.4 使用非托管代码第三方库 45
6. 工具箱 46
6.1 校验和计算器 46
6.2 CRC计算器 46
6.3 DES计算器 47
6.4 哈希值计算器 48
7. 应用技巧 49
7.1 分类组织合同勉励项目合同项 49
7.2 运营各种软件实例 49
8. FAQ 49
8.1 进行“反馈”或者“注册软件”操作时，为什么浮现Unknown error (0x80041002)错误？ 49
8.2 进行合同勉励时，从动方已经发出对的帧，为什么积极勉励方却返回失败？ 49
顾客手册

1. 简介
1.1 关于

格西烽火是一种基于串口通信多功能测试工具。研发和测试人员可以运用它来接受和显示串口数据，迅速创立、运营和管理各种直接勉励源和合同勉励源，并以项目文献方式进行组织，彻底地把多变通信规约脱离通信软件，使得通信软件可以应付迅速多变通信环境。

格西烽火带来好处：
Ø 单一测试工具取代众多定制测试工具，极大减少测试开发、维护和学习成本
Ø 快捷勉励源管理方式，即改即测，极大减少研发成本
Ø 以文献方式组织项目，有助于管理众多测试项目，有助于测试原则化
Ø 支持循环勉励与勉励报告，提高测试自动化水平

格西烽火重要合用于：
Ø 电子产品研发、测试和生产公司
Ø 电子产品研发、测试人员

1.2 功能特性

本软件发行了两个版本：
Ø 免费版（Free Edition）
Ø 专业版（Professional Edition）

下表列出了本软件功能特性以及在各个版本中支持状况。
功能特性
描述
免费版
专业版
基本功能
数据接受和显示、工具箱
支持
支持
直接勉励
创立、运营和管理直接勉励项目
支持
支持
合同勉励
创立、运营和管理合同勉励项目

支持

1.3 系统规定

支持操作系统：
Ø Windows XP SP3
Ø Windows Server SP2
Ø Windows Vista SP1或更高版本
Ø Windows Server （在服务器核心角色上不受支持）
Ø Windows 7
Ø Windows Server R2（在服务器核心角色上不受支持）
Ø Windows 7 SP1
Ø Windows Server 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) 上海格西信息科技有限公司

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：与销售代表联系
Ø 电子邮件：
Ø 电话：

方式2：从淘宝网（.com）格西旗舰店直接购买
Ø 网址：

1.5 支持服务

您在使用本软件过程中遇到问题或者但愿获得产品支持信息，可以通过咱们网站、电子邮件等方式与咱们联系。

Ø 支持网站：.com
Ø 电子邮件：
Ø 微信号：gesher
Ø QQ：979464

2. 软件入门
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 /XonXoff。
RTS
设立在串行通信中与否启用祈求发送 (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) ，上海格西信息科技有限公司
  文献名称：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.Boolean
VB
Public Property Power As Boolean
Get
Set
属性值
类型：System.Boolean

备注
当需要停止勉励运营时，可以在脚本中设立Power值为false，脚本运营完毕后停止勉励。

示例
下面示例在脚本OnRequest办法中设立Power为false。
C#
public int O