PCM嵌入式软件概要设计V0

1、分布式能源箱变测控装置规约转换模块项目软件（/概要）设计说明书项目令号：承担部门：微网所编制：刘宣E-mail/Tel:审核：会审：批准：国电南京I动化股份有限公司软件系统/概要设计文档修改记录日期版本作者修改内容2015.03.231.0刘亮初始版本。描述PCM嵌入式软件的系统概要设计。注1:每次更改归档文件 （指纳入配置重注2:文件第一次归档时，“更改理由”E线的文件）时，需填写此表。、“主要更改内容”栏写“无”。摘要本文对分布式能源箱变测控装置规约转换模块（简称规约转换模块，PCM的嵌入式软件的总体架构设计进行描述。PCM配套的配置工具主要牵涉到数据库设计和界面设计，不包含在本文档的叙述

2、范围内。PCM以数据采集、转发为核心功能，嵌入式软件在架构设计上采用了数据中心模式。为保证数据转发效率，采用共享内存方式的实时数据库设计。为减小系统模块的耦合， 给系统扩展留有足够空间， 系统采用多进程方式独立实现各子功能。各子功能模块通过进程访问接口（PAI）进行通信，通信方式包括信号量和共享内存两种。为提高软件的兼容性，系统设计了硬件抽象层（HAL）模块和数据库访问接口（DAI）模块，将硬件平台和数据库的操作进行了统一封装。为提高系统的稳定性，设计了守护进程模块。守护进程通过信号量握手来监控实时数据库进程、通信规约进程等其他进程的运行状况，可以在被监视的进程发生异常时对其及时修复。目录第

3、1 篇概述 31.1 范围 31.2 设计依据 31.3 术语、定义和缩略语 31.3.1术语、定义31.3.2缩略语4第 2 篇系统总体设计 41体系结概述 41系统体系结构 51标准化设计 61.7模块标准化设计61.7接口标准化设计61.7界面格式61.7编码约定71.7注释约定71系统版本规划 81系统处理流程 91子系统说明 101.10实时数据库RDB101.10历史数据库HDB101.10通信规模块111.10辅助模块111.10守护进程模块111.10网关模块121系统数据结构设计 121.11逻辑结构设计要点121.11物理结构设计要点121.11数据与子系统关系121开发和

4、运行环境 121.12硬件环境121.12软件环境131.12外购件分析131可靠性设计 131可测试 T生设计 131安全性设计 141出错处理设计 141设计依据与需求跟踪 14第 3 篇系统运行说明 161配置说明 161系统应用方式 161代码目录说明错误！未定义书签。第 4 篇技术方案总结 171关键技术问题说明 171技术复用说明 17第 5 篇总体进度计划 182）项目分解 182）完成时间 18第 6 篇参考文献 196.1 参考文献 19第 1 1 篇概述范围本文件规定了分布式能源箱变测控装置规约转换模块 （简称PCM的软件总体设计及使用的关键技术等，主要围绕PCM的嵌入式软

5、件进行阐述。PCM的配置工具并不在本文档中进行说明。设计依据GB/T13729-2002远动终端通用技术条件交流采样远动终端技术条件地区电网调度自动化设计技术规程电力系统调度自动化设计技术规程220kV-500kV电网继电保护装置运行整定规程35kV-110kV无人值班变电所设计规程220-500kV变电所计算机监控系统设计技术规程电保护设备信息接口配套标准DL/T634.5101-2002远动设备及系统动任务配套标准DL/T634.5104-2002远动设备及系统标准传输协议子集的IEC60870-5-101网络访问术语、定义和缩略语术语、定义本文件应用了以下术语和定义：配置数据库存储工程配

6、置的数据库，文件形式，由配置工具产生历史数据库存储历史事件的数据库，文件形式，非易失存储实时数据库存储实时数据的数据库，处于内存中，掉电消失DL/T630-1997DL5002-2005DL5003-2005DL/T559-2007DL/T5103-1999DL/T5149-2001DL/T872-2004小接地电流系统单相接地保护装置DL/T860.3-2004变电站通信网络和系统第3部分总体要求DL/T667-1999远动设备及系统第5部分-传输规约第103篇-继第5-101部分：传输规约基本远第5-104部分：传输规约采用进程OS进行资源分配和调度的基本单位，可理解为动态的程序共享内存可

7、被多个进程共享的物理内存，进程间共享数据最快的方法前端规约进程PCM和前端装置之间的通信规约进程后端规约进程PCM和后台综自系统之间的通信规约进程守护进程PCM中启动、监视、控制其他进程的进程配置工具主机端运行的App,负责配置数据库相关的操作网关进程PCM上运行的网关进程，负责调试功能相关的用户交互硬件抽象层对PCM底层硬件操作进行封装的库，方便跨平台移植.2 缩略语本文件应用了以下缩略语：.PCMProtocolConvertModule规约转换模块HDBHistoryDataBase历史数据库CDBConfigurationDataBase配置数据库RDBReal-tim

8、eDataBase实时数据库HALHardwareAbstractLayer硬件抽象层PAIProcessAccessInterface进程访问接口DAIDatabaseAccessInterface数据库访问接口第 2 2 篇系统总体设计2.12.1 体系结构概述PCM的主要功能是数据采集转发。在嵌入式软件的系统设计中，主要采用数据中心架构，辅助以适配器方式的接口模块。PCM中，数据中心角色由RDB扮演，监视方向和控制方向的信息都需要经过RDB的中转，实现通信规约的转换，继而实现系统内部的通信。HAL、PAI和DAI是PCM功能模块中的公用模块，他们的具体接口见相应的设计文档。他们实际上扮演

9、了针对系统硬件平台、数据库操作、进程间通信的适配器角色。通过这3个模块，可以将系统的其他功能模块实现功能解耦，提高了系统的可维护性。具体的体系结构参见图1.图 1 1PCMPCM 嵌入式软件系统结构示意图系统具有三个数据库：RDB、HDB和CDB。CDB由配置工具离线产生，以文件形式提供了工程项目中的各相关配置；RDB是内存形式的数据库，存放的是微网系统中的实时SCADA信息；HDB是文件形式的数据库，存放的是符合特定条件的SCADA历史信息。HAL封装了PCM底层硬件的驱动操作，为调用者提供了统一、便捷的硬件访问接口，使得其他功能模块与具体的硬件隔离，提高了软件的可移植性。DAI封装了数据库

10、的驱动操作， 使得调用者无需关注具体的SQL、 数据库连接等操作，将数据库的表结构与具体应用隔离开来，为开发后期可能出现的数据库移植、表结构更改留下余地PAI封装了进程间通信接口，它一方面将复杂的进程间通信封装成易调用的库函数，另一方面也提供了类似于面向对象设计中接口适配器的功能，方便应用的开发和调整。前端通信规约模块通过HAL与微网系统中其他装置进行通信，获取系统的2.22.2 系统体系结构配置数据库CDB通用网关接口SCADA信息，并通过PAI接口将其传入RDB保存。后端通信规约模块通过PAI访问RDB,将系统的SCADA信息以特定规约的数据单元格式进行封装，通过HAL转发至微网系统的后台

11、综自系统。通用网关接口模块由Web服务器调用，为用户提供数据查询、数据修改、装置控制等PCM相关的调试功能。守护进程模块负责监控其他进程的运行状态，在出现异常情况时进行恢复处理，保证PCM系统的正常稳定运行。2.32.3 标准化设计模块标准化设计由于RDB、HAL、DAI、PAI牵涉到具体的数据库表设计和平台底层硬件操作封装，CGI模块与具体的网页请求绑定，因此上述模块无法进行模块标准化。但是通信规约模块的数据处理部分可以进行标准化，供其他产品项目使用。接口标准化设计本系统将对HAL、DAI、PAI的接口进行标准化，为项目后期的平台移植、数据库调整、功能扩展等情况预留兼容性操作空间，以提高同系

12、列产品的研发质量和效率。界面格式PCM的界面主要有两部分：配置工具和Web页面。配置工具负责产生配置数据库，其界面设计需结合配置数据库的设计进行设定，不在本文档说明范围内。Web页面主要向用户提供PCM的在线调试功能，其主要页面及各页面涉及的功能见下图。网关功能概述1）权限检查功能：检查用户身份及访问权限；2）数据查询功能：根据 URI 参数，获取相关信息推送至客户端显示3）数据修改功能：根据 URI 参数，修改实时数据库、配置数据库内容4）文件传输功能：数据包抓取以文件形式推送至客户端。5）底层操作功能；重启、信号灯控制等6）Web 服务重启功能图 2 2WebWeb 系统页面功能设计编码约

13、定建议在编程开发时采用应用型匈牙利命名法注释约定无。设备运行状况概述登录页面1）用户名和口令方式的登录；2）验证若通过A）验证信息存入会话变量；B）跳转至主页。3）验证未通过A）提示错误信息；B）停留在本页面1）运行状态A）各通信端口的参数、状态；B）当前的应用软件版本；C）当前运行的进程名称、PID2）设备控制（需权限）A）硬件功能测试例如信号灯B）设备重启C）Web 服务重启主页功能概述1）检查用户访问权限。2）提供各子页面的导航。A）设备运行状况B）项目状况C）在线调试项目状况概述客户端服务器项目名称按信道分类的设备列表显示;系统转发表实时信息显示； 各设备中点的实时信息显示;历史数据库

14、信息显示在线调试概述1）数据包抓取、显示；A）过滤器设置2）人工置数；3）信息点配置信息修改；系统版本规划各子模块的版本应采用x.yy形式。x表示大版本号，在设计未做大的调整的情况下应保持x不变，仅在模块的设计发生大的变化、接口进行调整、研发阶段改变（a阶段、B阶段）时修改,且以步长为1递增；y表示小版本号，在开发者进行bug修正、算法调整等不影响与其他模块接口的情况下，以步长为1递增。x初步定为13,1表明研发阶段，2表明系统测试阶段，3表示发布阶段。系统处理流程实时数据库管理进程1）通过 DAI 读取配置数据库中的系统点表2）为点表信息分配共享内存作为实时库3）定时任务：A）通过 PAI

15、与守护进程握手B）扫描接收缓冲，若存在数据，将之保存;C）扫描实时库a）若存在新信息，将之更新至发送缓冲；b）判断是否更新历史库。若需更新，过 DAI 将信息推送至历史库接收缓冲守护进程1）进行平台初始化A）通过 DAI 读取配置数据库B）通过 HALI 配置硬件参数2）创建并注册实时数据库管理进程3）创建并注册历史数据库管理进程4）创建并注册前端通信规约进程5）创建并注册后端通信规约进程6）创建并注册其它进程7）定时任务：A）与主程序进程握手；B）与创建的（子）进程握手C）若对应（子）进程握手失败，杀死进程。根据配置库，重新创建并注册新的进程。1）定时任务：A）通过 PAI 与守护进程握手B

16、）扫描历史库的接收缓冲区，若存在新信息a）判断点的类型b）通过 DAI 将点的信息添加至历史库前端通信规约进程1）通过 DAI 读取配置数据库中信息2）配置规约各项参数，绑定通信端口3）进入循环工作模式A）定时通过 PAI 与守护进程握手B）按照规约设定获取监视方向信息C）通过 PAI 更新实时库D）通过 PAI 获取控制方向信息E）将控制信息发送至前端装置后端通信规约进程1）通过 DAI 读取配置数据库中信息2）配置规约各项参数，绑定通信端口3）进入循环工作模式A）定时通过 PAI 与守护进程握手B）通过 PAI 获取监视方向信息C）将监视信息发送至后台D）获取控制方向信息E）将控制信息通过

17、 PAI 更新实时库HALI 相关的规定：1）串口 ID:COM1COM6;2）网口 ID:ETH1ETH6;3）尽量采用 Bean 方式数据读写HALI硬件抽象层接口。作用描述：封装底层所有的硬件相关的操作，向调用者提供硬件平台无关的统一接口。接口包括：D 进行端口参数设置；2）进行端口数据接收；3）进行端口数据发送；4）,DAI数据库访问接口。作用描述：封装与数据库表结构、数据结构等相关的 SQL 操作，封装特定数据库的驱动函数，向调用者提供数据库无关的统一接口。接口包括：1）信息获取；2）信息更新；3）,PAI进程访问接口。作用描述：封装与操作系统相关的进程通信操作，包括信号量通信和共享

18、内存通信等，向用户提供与实现方式无关的进程间数据访问。接口包括：D 信号量的操作；2）共享内存相关的操作；3）点信息的获取；4）点信息的修改；5）,图3系统处理流程PCM 底层软件概述1）底层 OS 运行2）启动脚本编制3）QT 库、MySql、Apache 服务器等软件的移植安装；启动脚本内容应包括：A）启动 Web 服务B）启动 SSH、FTP 服务C）加载应用程序主程序1）启动守护进程2）定时任务：A）与守护进程握手B）若握手失败，重启设备通用性接口模块：1）硬件访问要通过硬件抽象层接口（HALI）进行，目前涵盖串口和网口；2）配置和历史数据库访问要通过数据库访问接口（DAI）进行；3）

19、进程间数据通信要通过进程访问接口（PAI）进行，目前涵盖守护进程和实时库进程；历史数据库管理进程IIPAI 相关的规定：1）尽量采用 Bean 方式数据读写DAI 相关的规定：1）历史库名；HIS_DB;2）配置库名：CONF_DB;3）尽量采用 Bean 方出数据读写图3描述了PCM从上电到运行的大致过程，基本涵盖了图1中的所有功能模块。由于CGI模块由Web服务器调用，且主要以函数库的形式向Web服务器提供接口，故而未在图中进行描述。CGI模块具体包含的接口不在本文档的说明范围内，请参见其设计文档。子系统说明实时数据库 RDBRDBRDB是PCM中存储实时SCADA信息的功能模块。在监视方

20、向上，前端通信规约进程将采集的SCADA信息存入RDB,由后端通信规约进程取出后，以另一种规约格式进行封装后转发至综自后台；在控制方向上，则进行上述操作的逆操作。由于PCM前端装置和PCM后台系统之间通常采用不同速率的物理通信方式，RDB实际上还起到同步异步时钟域的作用。RDB要同时处理多个通信规约进程的访问，它的关键质量属性是性能，特别是数据存取速度。系统设计方案考虑了以下两点来保证RDB的性能属性：.PCM系统采用多进程方式的设计，且RDB牵涉大量数据的交互，因此在设计方案中采用进程间通信技术中速度最快、适合大规模数据交互的共享内存技术来作为RDB的实现技术。.RDB主要保存系统的点表信息

21、，点表信息在确定后基本不会改变，那么在数据存储的组织上，方案建议RDB采用数组方式而不是链表方式来组织信息的存放。这样虽然牺牲了动态增添点表的能力，但是保证了信息存取的速度一一对RDB中点信息的访问，只要通过特定的算法计算出数组下标即可一步定位到所需数据。历史数据库 HDBHDBHDB记录PCM在运行过程中接收到的特定SCADA信息，例如SOE事件、遥控操作等，这些特殊SCADA信息来自于RDB。HDB的关键质量属性是安全性，还要考虑对RDB性能的影响。HDB的安全性主要是指它的内容只能由RDB写入，且一旦写入就不可修改删除。HDB在实现上是以文件形式存在，由HDB管理进程管理。HDB管理进程

22、应仅在需要写入信息时将HDB文件的属性设为可写，其余时间都设为只读。由于HDB以文件形式存在，写操作相对写内存来说是低速的。为避免对RDB的性能影响，方案设计建议HDB管理进程配备写缓冲。在写入历史信息时，RDB将信息推送至写缓冲，由HDB管理进程负责将信息写入文件。配备写缓冲还可以防止突发历史信息的丢失。通信规约模块通信规约模块负责采集、转发系统SCADA信息，分为前端通信规约模块和后端通信规约模块。换句话说， 每个通信规约都有client和server两种工作模式。 通信规约模块负责PCM上一个特定物理通信端口的数据通信。在PCM系统设计中，通信规约模块应负责各种ASDU数据的分析，并实现

23、为保证通信质量所规定的一系列通信保障措施。工程应用的多样性决定了通信规约模块的关键质量属性是可扩展性。通信规约模块的可扩展性体现在规约参数的可定制方面。由于每个规约实例对应的参数都不一样，且规约参数是通过配置工具在CDB中定制的，那么它不包含在本文说明范围内。具体请参见CDB设计文档和配置工具设计文档。辅助模块辅助模块主要指硬件抽象层HAL、数据库访问接口DAI和进程访问接口PAI。辅助模块的引入主要是为了降低PCM软件与平台硬件、操作系统、数据库系统的耦合，为系统扩展、平台移植预留空间。辅助模块的关键质量属性是可扩展性和可移植性。在可扩展性方面，方案建议辅助模块采用C+的多态技术实现，这样可

24、以方便地扩展已有接口，不影响前期使用已有接口的模块；另外，与具体硬件操作、操作系统函数调用、具体数据库表结构的访问也应封装在辅助模块中，使得辅助模块具有接口适配器的作用，这样在更换底层软件、跨平台移植、修改表结构、功能模块并行开发的时候，只需修改相应的辅助模块即可，不会对其他模块产生影响。守护进程模块守护进程模块负责监视PCM运行中的通信规约进程、RDB管理进程、HDB管理进程等多个进程的运行状态，在异常情况发生时，通过特定处理来保证系统继续正常运行。守护进程模块是系统可靠性的根基，它的关键质量属性是可靠性。方案设计中，为保证守护进程的可靠性做了两方面的工作。一方面，守护进程的功能被压缩到最低

25、，它只负责其他进程的加载、注册和监视，并对异常进程进行统一的killrestart操作，这就使得代码的实现复杂度大为降低，减少了出错的可能；另一方面，方案设计守护进程由主进程进行监视，一旦发生异常，将采用比killrestart更高级别的系统重启方式来彻底消除隐患。通用网关接口模块 CGICGICGI模块主要负责处理PCM的在线调试功能，它和系统中的其它模块相对独立，由PCM中的Web服务器调用。从使用角度来看，CGI模块是给Web服务提供特定功能的函数库。由于PCM的在线调试功能可以修改RDB和CDB中的部分信息，因此CGI模块的关键质量属性是安全性。为保证CGI模块的安全性，方案设计采用基

26、于角色的访问控制机制。任何用户在使用网页登录PCM进行相关操作前，都需要验证其身份。此外，用户的身份信息在CDB中应以密文形式保存。系统数据结构设计逻辑结构设计要点数据结构的设计与数据库表结构有关。具体请参见项目相关的数据库表设计文档及相关功能模块的设计文档。物理结构设计要点参见项目相关的数据库表设计文档和功能模块设计文档。数据与子系统关系具体请参见相关功能模块的设计文档。开发和运行环境硬件环境开发本软件系统所需的硬件环境为：Inteli3处理器、2GRAM、80G硬盘。本软件系统对实际运行环境的最低要求为：ARM9处理器400MHz、64MROM、64MRAM或同级别工控机。软件环境操作系统

27、：Linux内核;数据库系统：MySql5.0;开发工具：Qt4.8.2、PHP5.5JavaScriptECMA5;编译器：gcc/g+4.3.3、arm-linux-gcc4.4.3;虚拟机：VMWareWorkstation8.0;Web服务器：Apache2.4软件可运行于虚拟机系统上，经过PC机的交叉编译后，运行于ARM9平台c外购件分析暂无。可靠性设计软件设计在两方面对可靠性进行了保障。首先，软件系统被划分为多个功能模块，每个功能模块以单独进程方式运行，通过进程间通信技术进行信息交互。某个进程在发生异常时，不会影响到其他进程，使得问题能被有效控制隔离。其次，系统设计

28、了守护进程模块，能够对各个运行的进程进行主动监测。一且异常发生，守护进程会采取终止异常进程、重新加载功能模块的方式进行错误恢复。守护进程本身也被监视，一旦发生异常会采用设备重启的方式来恢复整个PCM系统。可测试性设计在测试方面建议采用自底向上的方法，这样能够尽可能多地发现设计和实现上的错误。首先，每个功能模块（类/库函数）都需要进行单元测试。单元测试包括库函数使用的子函数、类包含的成员函数，主要关注函数的输入输出、异常处理是否在落在设计范围之内。在子函数、成员函数测试通过的基础上，完成对整个功能模块（类/库函数）功能的测试。其次，在单元测试的基础上，对多个功能模块进行合成测试。合成测试主要测试

29、模块之间接口的正确性和完备性。再次，在合成测试的基础上，对所有功能模块进行整合，进行系统测试。系统测试主要测试软件的功能是否完备， 是否满足软件需求的可追踪性。 系统测试需要在真实的物理平台上运行软件系统。安全性设计PCM运行于相对封闭的电力系统网络环境中，具安全性主要体现在加密、安全审计和访问控制上。加密方面， 用户信息在CDB中不是以明文形式存放， 而是用户信息的密文形式。 在需要的时候，用户输入口令，由PCM进程进行验算核对。在访问控制方面，PCM软件采用基于角色的访问控制策略，用户使用浏览器访问PCM时，需要提供身份信息，并且在通过Web页面进行特定操作，例如重启设备、人工置数、修改点

30、表信息时，都会被网关进程进行权限验证。安全审计方面，PCM的HDB模块会有一些关键操作的记录，例如遥控操作、人工置数、设备重启等，且这些记录对用户是只读的，能够在需要的时候提供审计证据。出错处理设计模块的调试信息输出应受到统一控制。在系统软件运行于调试版本时，对于一般的逻辑错误，模块将出错信息输出至PCM系统控制台（Linux的console）,用户通过SSH工具、Telnet工具可以访问这些调试信息。对于严重的进程异常，由守护进程实行killrestart操作完成错误恢复。设计依据与需求跟踪需求说明书中的4.1.9和4.1.10是配置工具相关，不属于本文档说明范围需求说明书对应章节帚求编 p

31、 及名称总体设计对应章节4.1.1SR-PCMES-F-0010PCMES的上电初始化SR-PCMES-F-0020SCADA信息采集转发2.1、2.5、.3SR-PCMES-F-0030日志记录及查有2.1、2.3.3、.4SR-PCMES-F-0040PCM出厂测试.5SR-PCMES-F-0050基于角色的访问控制机制2.3.3、2.6.6、SR-PCMES-F-0060灾难自恢复2.2、2.5、2.6.5、2.9、SR-PCMES-F-0070实时数据库访问管理2.2、2.5、2.6.1

32、、.8SR-PCMES-F-0080在线调试功能2.2、2.3.3、2.6.6第 3 3 篇系统运行说明配置说明PCM的配置定制具有高度灵活性，与具体的工程应用有关。PCM在运行前，首先应当由配置工具生成CDB,描述采用的通信规约、系统设备、通道参数等，并由配置工具将CDB及相关的规约库模块下载至PCMo配置工具相关描述不在本文档范围内，请参见相关设计文档。PCM运行后，由守护进程加载各通信规约进程，并按照CDB中的描述进行通信端口初始化、通信规约定制等操作。系统应用方式PCM可应用到需要进行Modbus、IEC61850-5-103等电力系统通信规约转换的工程应用项目中。配置

33、工程师需要通过配置工具提供PCM所需的CDB,CDB中应包含系统的装置、通道、点表等工程相关信息。第 4 4 篇技术方案总结4.14.1 关键技术问题说明系统设计和开发过程中，需要掌握如下关键技术：1)Linux进程间通信技术，包括信号量、Socket和共享内存；2)网络通信，Socket编程，Linux下的串口、网口驱动；3)关系数据库设计及访问、XML技术；Web服务器相关配置，JavaScriptPHP；C+、Qt编程;嵌入式Linux的移植、定制。关系数据库的设计是项目的关键所在，需要关注表结构的设计是否涵盖所有系统需求。若开发至后期进行表结构调整，将会对项目质量产生较大影响。在系统设计上，尽管使用DAI模块封装具体的表结构访问操作，可以减小这种风险发生时的影响，还是需要在设计阶段对数据库进行较多关注。Linux进程间通信技术是各功能模块配合运行的关键。RDB模块主要采用共享内存技术，守护进程模块