《ARM程序设计文档》由会员分享，可在线阅读，更多相关《ARM程序设计文档（28页珍藏版）》请在金锄头文库上搜索。
1、告警模块详细设计（嵌入式软件设计）版本：V1.0修订记录版本内容日期人员V1.0文档建立2010-03-09V1.11、添加内容2、修改内容3、删除内容2009-10-21V1.21、添加内容2、修改内容3、删除内容2010-1-25目录文档标题错误!未定义书签。1 摘要错误!未定义书签。1.1 文档说明错误!未定义书签。1.2 关键词错误!未定义书签。1.3 缩写说明错误!未定义书签。1.4 参考资料错误!未定义书签。2 模块错误!未定义书签。2.1 功能简介错误!未定义书签。2.2 模块结构设计错误!未定义书签。2.3 模块接口设计错误!未定义书签。3 类错误!未定义书签。3.1 类设计错
2、误!未定义书签。3.2 属性设计错误!未定义书签。3.3 事件标志设计错误!未定义书签。3.4 方法设计错误!未定义书签。4 C语言函数设计错误!未定义书签。4.1 中断服务程序错误!未定义书签。4.2 驱动函数错误!未定义书签。4.3 接口函数错误!未定义书签。1摘要1.1内容简介1.2关键词1.3缩写说明1.4参考资料2模块本小节设计共有3个模块，STM_SFP_OF模块，STM_R_LOSI块,STM_TX_LO膜块,（获取当前秒标的模块，其具体实现。暂不考虑，先实现占位函数）。2.1功能简介初始化功能：包括告警属性类，告警条目类，STM_SFP_OF皆警类型类的声明，秒标，绝对时间Da
3、te，；创建当前告警条目当前告警链表的函数，历史链表的函数，判断告警生成/消除机制的函数，是否发trap及其函数接口。STM_SFP_OF模块：STMN（目前N=4,将来扩展后N的值会增加）端口下的光模块不在位告警模块。功能：具体判断条件（是判断告警生成/消除机制函数中的参数。端口使能/禁能寄存器配置，屏蔽关系端口屏蔽，各级告警屏蔽，上一级有告警，下面几级都没告警；上一级告警被屏蔽，则以下告警不受影响，正常）；调用创建当前告警条目的功能，注册MIB;调用添加当前告警链表的功能；如需上报，调用提供发Trap接口；消除当前告警链表中的一条告警条目并将其移到历史告警链表中的功能。提供系统任务调用接口
4、的功能。STM_R_LO模块：STMN口下的收信号失效模块。功能：具体判断条件（是判断告警生成/消除机制函数中的参数。端口使能/禁能寄存器配置，屏蔽关系端口屏蔽，各级告警屏蔽，上一级有告警，下面几级都没告警；上一级告警被屏蔽，则以下告警不受影响，正常）；调用创建当前告警条目的功能，注册MIB;调用添加当前告警链表的功能；如需上报，调用提供发Trap接口；消除当前告警链表中的一条告警条目并将其移到历史告警链表中的功能。提供系统任务调用接口的功能。STM_T_LO麒块：STMN口下的发信号意外实效。功能：具体判断条件（是判断告警生成/消除机制函数中的参数。端口使能/禁能寄存器配置，屏蔽关系端口屏蔽
5、，各级告警屏蔽，上一级有告警，下面几级都没告警；上一级告警被屏蔽，则以下告警不受影响，正常）；调用创建当前告警条目的功能，注册MIB;调用添加当前告警链表的功能；如需上报，调用提供发Trap接口；消除当前告警链表中的一条告警条目并将其移到历史告警链表中的功能。提供系统任务调用接口的功能。告警生成/消除机制：此机制来判断是否产生一条新的告警记录，或者消除已经存在但当前消失了的告警记录。Currrentstatus:当前的状态，异常1，正常0；Recorded:该条告警是否生成过记录，生成告警则记录1,没生成告警记录0;当前告警消失，复位0。Othercondition:这包括端口使能，端口屏蔽，
6、类型屏蔽，告警优先级，有这4个条件，记为1,没有这些条件记为：0。Measure:处理采取的方法。add表示新增一条告警，removal表示消除一条告警放到历史告警记录中。“一”：表示什么都不做。表1告警生成/消除机制CurrentstatusRecordedOtherconditionMeasure000一001一010removal011removal100add1101一110一111removal以上是对告警生成或消除机制的简单描述。这个机制体现在告警类型类里面。这个类里面除了包括当前状态、告警类型属性外，还应该包括“当前是否记录过这个属性。其他条件（Othercondition）:端
7、口使能（端口使能STM通道使能VC12）、端口屏蔽，告警屏蔽等级关系属性，所有这些其它的条件可以按某种规则做或运算，其逻辑结果作为该类的一个属性。告警类型类里面包含告警条目对象的指针，该指针指向生成的一条当前告警条目。告警类型类里面的方法有五个：数据采集方法调用，数据对比、判断，告警生成，告警消除，告警上报，告警链表的维护，注册MIB库。屏蔽的处理：这里特别指明屏蔽关系的三重性：其一：端口屏蔽（如STM口使能与否决定该端口下的告警是否被屏蔽，这本质上是端口使能的问题，却表现为有可能导致下级告警屏蔽的问题。），这是属于配置管理设置，但是告警却不得不处理的问题。其二：屏蔽设置属性。在告警属性这个类
8、里面有3个属性：屏蔽，上报，级别。这里的屏蔽属性是上层网管配置的，用来表示某种告警类型本身是否允许被屏蔽。值为0表示没有设置屏蔽，为1表示设置有屏蔽。其三：屏蔽等级关系中的屏蔽问题。这个问题可以这样处理：可以在告警类型类里面设置一个属性（屏蔽等级关系属性，数据类型uint32,这个屏蔽等级关系中的某种类型发生告警则该值置1,下级对应值都是1。则可以很方便的设置位于此种类型下面的告警类型是否被屏蔽的问题，又区别于屏蔽设置属性中的屏蔽，也就是上面的第二种屏蔽），如果判断本级产生告警，则以下各级屏蔽等级关系的相应值都置1）。这样，调用对象来进行操作，便于处理。2.2 模块结构设计模块基本指导思想：告
9、警生成与消除一律用告警生成/消除机制来判断，不与前一模块直接发生关系，前一模块的任何状态仅作为告警生成/消除机制里面的一个逻辑状态值。2.2.1 类型屏蔽等级图（STM端口，陈总设计广PortDisableSFP_OFFVR_LOSVR_LOFVR_OOFVMS_AISVVVV|mS_RDIJ|J0_TIM|B1_EXC|B2_EXC2.2.2 屏蔽等级关系轮询:起始端口图1-1屏蔽等级关系1-2 ，图 1-3 ,图 1-4。2.2.3 模块结构关系：每个模块的结构与其它的结构的关系如下图：图肯定是先调用屏 蔽等级高的模块 系统*调用STM_SFP_OFF 能模块STM 口SFP_OFF、使能
10、态）（屏蔽态/司用 STM.SFP_OFF.Mask ；(int )属性类对象.判断告警机制某种逻辑或判什 断新增 获取秒标获取秒标和绝对时间当刖告警链表移到历史告警链表状态其他类调用LineIF.SFP_OFF.setCurrentSt atus (int )相关对象提供newt前告警条目对象是否记录值re，来获取。添加到当前告警链表其他类调用LineIF.STM.setEnable（int相关对象提供SII端口使能值（0or1）告警生成机制的一个参数注册MIB提供发Trap*接口参数,图1-2STM_SFP_OFF模块功能框图肯定是先调用屏蔽等级高的模块系统一调用其他类调用LineIF.S
11、TM.setEnable（int相关对象提供SII端口使能值（0or1）告警生成机制的一个参数STM_SFP_OFF能模块告警机制获取秒标和绝对时间屏蔽态当刖告警链表移到历史告警链表新增判小断口SFPOFFR_LOS屏蔽态使能态记录值某种逻辑或当前状态其他类调用LineIF.SFP_OFF.setCurrentStatus(int)相关对象提供四用STM.SFP_OFF.Mask)(int)属性类对象记录值置1newt前告警条目对象rdd0ng卢r彳取。SFP-OF来狄添加到当前告警链表注册MIB提供发Trap*接口参数.图1-3STM_R_LOS模块功能框图肯定是先调用屏蔽等级高的模块系统一
12、调用其他类调用LineIF.STM.setEnable（int相关对象提供SII端口使能值（0or1）告警生成机制的一个参数STM_SFP_OFF能模块告警机制获取秒标和绝对时间屏蔽态当刖告警链表移到历史告警链表新增判小断口SFPOFFT_LOS屏蔽态使能态记录值某种逻辑或当前状态其他类调用LineIF.SFP_OFF.setCurrentStatus(int)相关对象提供四用STM.SFP_OFF.Mask)(int)属性类对象记录值置1newt前告警条目对象rdd0ng卢r彳取。SFP-OF来狄添加到当前告警链表注册MIB提供发Trap*接口参数.图1-4STM_T_LOS模块功能框图2.
13、3 模块接口设计告警数据的调用接口（暂时仅考虑这3个模块的数据）：这涉及到告警类型类和数据采集中的一个类的设计，后者继承前者。在告警类型类里面设计方法调用“当前状态”这个对象，即可获取该对象的当前状态的值。这个方法由告警类型类设计，由其他的这个继承类通过调用把数据赋值到对象中，这样，我调用就可以获取其值。其他的接口：告警数据的输出接口：告警等级关系状态值得记录：Trap接口：系统调用接口：3类告警类型类AlarmType和告警条目类Alarmitem的设计。3.1类设计类名称描述设计说明AlarmType告警类型类。告警类型类父类。公有属性和方法。目前暂定58种告警类型，Alarmitem告警条目类用来设计生成一条当前告警条目。3.2AlarmType类设计变量名称
