CSBM V 2.0发布和使用说明.pdf

CSBM V 2.0 发布及使用说明 拟制：樊 征 臻 校核： 批准： 版本变更记录： 版本号 拟制日期 拟制人 版本描述 存档编号 V1.0 2014-10-08 樊征臻 CSBM V 1.0 发布及使用说明 V2.0 2015-10-08 樊征臻 CSBM V 2.0 发布及使用说明 0 前言 CSBM 是Common Software Based on Modbus 的缩写。CSBM 基于Modbus 协 议，目前只支持0x03 和0x10 功能。由于标准的Modbus 的0x03 功能限制，CSBM 采用了新的任务调度算法，理论上来说在满足标准Modbus 协议的前提下，可以 读取任意地址、任意长度的数据。 CSBM 的基本功能有：（1）定时读下位机数据；（2 ）手动读取下位机数据； （3 ）手动修改下位机数据；（4 ）读取下位机某一段连续地址的数据，保存到本 地计算机的Comtrade 文件中；（5 ）打开本地的Comtrade 文件，进行波形回放、 数据统计、数据查看等。 CSBM 采用XML 文件做为配置文件，XML 具有自说明的能力，扩展性好。每 个编写过基于 Modbus 协议的下位机程序的人看了 CSBM 的XML 配置文件模板 都应该可以自己动手扩展。随着工作的逐渐深入，软件功能也可能随着需求变化 而需要扩展。所以，当CSBM 不能满足要求时，不要吝惜你的建议。 利用大量业余时间编写这个软件只是单纯地想更快完成自己的工作，本人保 留以下权利：（1）可以选择公开或不公开CSBM 解决方案源代码；（2 ）可以以适 当的形式公开、发布编译后的可执行二进制文件；（3 ）未经作者本人同意，不得 将CSBM 用于商业用途。 1 历史版本 1.1 第一版 第一版基于串口通信，支持保存数据为 Comtrade 格式的文件，满足了各个 调试阶段的基本要求。 1.2 第二版 CSBM V 1.0 发布后，在使用过程中先后数次进行优化，功能得到了扩展，使 用体验也得到了改善，例如支持以太网通信方式、自定义列表颜色、自定义 Comtrade 文件名、可选配置文件等等。 本文档针对必威体育精装版版本的CSBM 的功能和使用方面做一些简单介绍。 2 开发/测试环境 OS ： Windows 8 （64 bit ） IDE：Visual Studio 2012 Language：C++ 测试过的平台：Windows 8 （X64 ），Windows 7 （X86/X64 ） 为了获得最佳的使用体验，建议使用23 寸及以上的显示器。 3 必需的文件和目录 3.1 必需的配置文件 （1）config-*.xml 文件，用于保存串口配置、以太网配置、下位机数据配置、 Comtrade 配置等，必须以“config-”为前缀，位于Config 目录下，如下图所示； 图 3.1 config 目录 （2 ）color.xml 文件，用于保存自定义的列表颜色，位于Config 目录下； （3 ）license.xml 文件，用于保存注册信息，该文件最关键的字段是“machine” 和”key” ，每台主机的Machine code 是唯一的，对应的key 也是唯一的。license.xml 位于license 目录下； 当需要在不同的计算机上使用CSBM 时，将Config 目录拷贝到目标主机即可， 不要覆盖目标主机上的license.xml 文件。 3.2 默认的Comtrade 文件目录 默认的Comtrade 文件目录是wave 文件夹 （不包括子文件夹），读取的远程 数据都会被保存到该目录下，软件启动后也会读取该目录下的Comtrade 配置文 件。Comtrade 文件比较多的情况下可以新建文件夹进行分类，便于管理，在进行 波形回放的时候也可以加快速度。 图3.2 wave 目录 4