《电信级以太网OAM概要设计说明书》.doc

软件概要设计说明书 模块名称： 电信级以太网OAM 编 写 人： 文件编号： 版 本 号： 时 间： 2007-12-2 目录 软件概要设计说明书 1 1. 前言 1 1.1. 文档说明 1 1.2. 项目背景 1 1.3. 术语定义和缩略语说明 1 1.4. 参考资料 3 2. 任务概述 4 2.1. 目标 4 2.2. 需求概述 4 2.3. 条件与限制 4 3. 总体设计 5 3.1. 总体结构和模块外部设计 5 3.1.1. 总体结构设计 5 3.1.2. 模块概要设计 6 3.2. 功能分配 7 4. 接口设计 8 4.1. 外部接口 8 4.1.1. OAM运行状态控制 8 4.1.2. OAM网管参数的设置与读取 8 4.1.3. 其它模块提供给本软件调用的接口 8 4.2. 内部接口 9 4.2.1. OAM初始化 9 4.2.2. MEPprocessEqualCCM（）函数 9 4.2.3. MEPprocessLowCCM（）函数 9 4.2.4. ProcessLBM() 9 4.2.5. xmitLBM() 9 4.2.6. 函数ProcessLBR() 9 4.2.7. 函数xmitFaultAlarm() 10 4.2.8. 函数xmitLTM() 10 4.2.9. 函数ProcessLTR() 10 4.2.10. 函数ProcessLtm() 10 4.2.11. 函数clearPendingLTRs() 10 4.2.12. 函数enqueLTR() 10 4.2.13. 函数xmitOldestLTR() 10 4.2.14. OSAL提供的函数 10 5. 数据结构设计 12 5.1. 全局变量定义及说明 12 5.1.1. 各模块判断条件全局变量说明 12 5.1.2. MEP全局变量定义说明 12 5.1.3. 连续性检测发起者全局使用的变量（continuity check initiator） 14 5.1.4. MEP/MHF连续性检测接受者变量 14 5.1.5. 远端MEP变量及说明 15 5.1.6. 远端MEP错误变量定义及说明 15 5.1.7. MEP交叉连接变量 16 5.1.8. MP环回响应者变量定义及说明 16 5.1.9. MEP环回发起者变量定义及说明 16 5.1.10. MEP故障通知发生者变量定义及说明 17 5.1.11. MEP链路跟踪发起者变量 17 5.1.12. MEP LTR接收者变量 17 5.1.13. 链路跟踪响应者变量定义及说明 18 5.2. 结构体定义及说明 18 5.2.1. 以太网头部 18 5.2.2. 以太网OAM头部 18 5.2.3. TLV详细定义 19 5.2.4. MA (MEG)ID(名称对应见附录) 20 5.2.5. MEP结构体 24 5.2.6. 远端MEP结构体 25 5.2.7. CCM结构体 26 5.2.8. LBM/LBR结构体 28 5.2.9. 出入口结构体 30 5.2.10. ltmReplyList结构体 31 5.2.11. LTM结构体 32 5.2.12. LTR结构体 34 5.2.13. FNG结构体 35 5.2.14. LCK结构体 37 5.2.15. ltmReplyList结构体 38 5.2.16. 定时器 38 5.3. 枚举类型定义 38 5.3.1. highestDefect说明不同缺陷的优先级 38 5.3.2. recvdPortState说明接收端口状态 39 5.3.3. recvdInterfaceStatus说明接收接口状态 39 5.3.4. rMEPlastPortState说明接收到的CCM中端口状态TLV的值 40 5.3.5. rMEPlastInterfaceStatus说明接收到的CCM中接口状态TLV的值 41 5.3.6. fngDefect 41 5.3.7. ltrRelayAction返回的LTR的Relay Action字段 42 5.3.8. ltrIngressAction返回的LTR中Reply IngressTLV的Ingress Action字段 42 5.3.9. ltrIngressPorIdSubtype 43 5.3.10. ltrEgressAction 43 5.3.11. ltrEgressPortIdSubtype 44 5.4. 定时器 45 6. 逻辑结构设计 47 6.1. CFM管理对象 47 6.1.1. 读CFM配置 48 6.1.2. 建立维护域管理对象 48 6.1.3. 删除维护域管理对象 49 6.2. CF