TDLTEeNodeBOM接口设计说明书

1、 td-lte enodeb om 软件软件接口设计说明书接口设计说明书cpit-7.3-lte-sys_dd-041ebbu1606a v2.0 r2.0v1.1 普天信息技术研究院 2009 年年 6 月月 2 日评审通过日评审通过 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 i i 页页 修订历史记录修订历史记录日期版本文档负责人修改内容2009.04.8v1.0余立红初始版本2009.06.22v1.0刘玉洁更新 2.3.1 章、4.10 章4.6.6 moduleid 增加了 rruagent2009.06.26v1.1余

2、立红/王峥更新了 4.5.6增加了 4.7.13、4.7.14更新了 4.8、4.92009-7-9v1.1余立红4.5.7 mac 增加了两个参数4.6.6 去掉了 bid增加 4.7.11，获取主控板 mid2009-8-8余立红2.3.2 去掉了消息码om_rrm_file_ready_ind2.3.4 增加了消息码om_sw_alarm_report_msg4.3 去掉了 rrm 文件下载通知消息4.5.6 mac 增加了 8 个参数增加了 4.7.2 消息接口 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 iiii 页页 编

3、制姓名签字日期电话余立红江丽蓉王峥审查姓名签字日期电话 宗华审核姓名签字日期电话盖平批准批准姓名签字日期电话蒋纯波文档评审负责人： 盖平 参加评审人员：参加评审人员：汤素锋、王宇、杨隽、王峥、江丽蓉、曹伟、欧阳国威、陶雅静 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 iiiiii 页页 目目 录录目目 录录.iii1引言引言 .11.1文档目的文档目的.11.2文档读者文档读者.11.3文档背景文档背景.11.4文档说明文档说明.11.4.1文档范围.11.4.2文档输入.11.4.3下属指导文档.21.4.4书写约定.21.5参考

4、文档参考文档.41.5.1内部文档.41.5.2外部文档.41.6术语及缩略语术语及缩略语.42接口概述接口概述.52.1接口说明接口说明.52.2消息格式说明消息格式说明.52.3消息类型说明消息类型说明.52.3.18548 om 与 8144 调试消息定义.52.3.2om 与 rrm 之间的消息.52.3.3om 与 up 之间的消息定义.62.3.4om 公共接口消息定义.63常用数据类型说明常用数据类型说明.74接口定义接口定义.74.1mcb rrm 与与 cpb rruagent 之间的消息接口之间的消息接口.74.2om 与与 bb 之间的接口之间的接口 .74.3om 与与

5、 mcb rrm 之间的接口之间的接口.74.3.1初始化接口.74.3.2本地小区可用请求消息.8 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 iviv 页页 4.3.3本地小区可用响应消息.94.3.4本地小区不可用通知消息.94.3.5本地小区删除通知消息.94.3.6ecpb 阻塞/解阻塞消息.104.4om 与与 rcp 之间的接口之间的接口.104.4.1初始化接口.104.5om 与与 up 之间的接口之间的接口 .114.5.1初始化接口.114.5.2gtpu 参数配置请求消息.114.5.3gtpu 参数配置响应

6、消息.124.5.4pdcp 参数配置请求消息.124.5.5pdcp 参数配置响应消息.134.5.6mac 参数配置请求接口.144.5.7mac 参数配置响应接口.154.6om 性能接口性能接口.164.6.1local om 通知其它模块开始数据采集消息.164.6.2其它模块通知 local om 收到开始数据采集反馈消息.164.6.3local om 通知其它模块停止数据采集消息.174.6.4其它模块通知 local om 收到停止数据采集反馈消息.174.6.5local om 通知其它模块获取采集数据消息.174.6.6其它模块向 local om 传送获取的采集数据消息

7、.184.7om 提供的公共接口提供的公共接口.194.7.1软件告警消息接口.194.7.2软件告警上报消息接口.204.7.3getselfbid() 获取本板标识.214.7.4bidtomid() 根据板卡标识及 cpu 类型获取 mid.224.7.5midtobid () 根据 mid 获取板卡标识及 cpu 类型.224.7.6getipbymid() 根据 mid 获取整型 ip 地址.234.7.7getipstrbymid() 根据 mid 获取字符串型 ip 地址.234.7.8getnodebip ()获取 nodeb ip 地址 .244.7.9getnodebpor

8、t ()获取 nodeb port 号.244.7.10getnodebsysfuncid ()获取 nodeb 标识.244.7.11getnodebsysname()获取 nodeb 系统名称.254.7.12getemcbmid()获取 emcb 板 mid.254.7.13getdspip()获取 8144dsp 的 ip 地址.264.7.14getpicoip()获取 pico 的 ip 地址.264.7.15getdspmid()获取 8144dsp 的 mid.264.7.16getecpbmid()获取 ecpb8548 的 mid.274.8cm 模块提供给模块提供给 gr

9、m 的接口的接口.274.8.1读表函数.274.8.2流程处理函数.484.8.3消息.494.9grm 提供给提供给 om 的函数的函数.524.9.1grm_ctxt 上下文的修改.52 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 v v 页页 4.9.2s1/x2 流程 .534.108548 om 与与 8144 之间调试接口之间调试接口.544.10.18548 om 向 8144 发送 mml 命令.544.10.28144 向 8548 om 发送调试打印消息.545附录附录 .55 td-lte enodeb om

10、 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1 1 页页 1 引言引言1.1文档目的此文档的目的是定义 tdlte enodeb om 与其他软件模块的接口，此文档用于指导 om 及相关软件模块的的详细设计、编码、单元测试以及集成测试。1.2文档读者此文档的读者是软件设计工程师，测试工程师。1.3文档背景略。1.4文档说明1.4.1文档范围此文档主要定义了 om 与其他软件的接口，具体包括如下方面：1.om 与 bb 之间的接口；2.om 与 rrm 之间的接口；3.om 与 rcp 之间的接口；4.om 与 up 之间的接口；5.om 的性能接口；6.om 通用

11、接口1.4.2文档输入此文档的输入文档如表格 1 所示:表格 1 输入文档列表输入文档名输入文档名文档版本文档版本文档类型文档类型备注备注lte enodeb 系统需求规格说明书1.1产品级功能需求文档必选td-lte enodeb 高层软件架构设计说明书1.0架构设计文档必选 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2 2 页页 1.4.3下属指导文档此文档的下属指导文档如表格 2 所示:表格 2 下属文档列表下属指导文档名下属指导文档名文档版本文档版本文档类型文档类型备注备注td-lte enodeb om 模块详细设计v1

12、.0 详细设计文档必选td-lte enodeb 业务面各模块详细设计v1.0 详细设计文档必选td-lte enodeb 控制面各模块详细设计v1.0 详细设计文档必选1.4.4书写约定此文档应满足下列格式要求：1.4.4.1函数接口书写约定函数接口需要按照如下格式定义：功能：功能：说明该函数接口的功能。接口：接口：函数的声明，应符合研究院的编码规范。static classname:registerme(void *pobj, funcptr pcbfunc, int iappid)返回值：返回值：函数的返回值说明。参数说明：参数说明：（函数参数的详细说明）参数名称类型说明pobjvoid

13、 *注册的对象指针pcbfuncfuncptr回调函数指针。回调函数必须以对象指针和 message 指针为参数，完成消息的落地，返回 ok 或 error。 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 3 3 页页 iappidint分配给应用模块的应用索引号，即 fid如果参数类型是个复杂数据类型，且在其它地方没有说明过，应当在说明中详细定义。复杂数据类型说明：复杂数据类型说明：如果有，在此详细说明“参数说明”中的复杂数据类型。1.4.4.2消息接口书写约定消息接口需要按照如下格式定义：功能：功能：说明该消息接口的功能。方向：方

14、向：说明该消息从哪个模块发送给哪个模块。bmcmcp消息头：消息头：消息头字段，可选。hostsendermidbtscpmfidabiscpm_callpid0 或abispid(更软切换时)呼叫实例 pid消息净荷：消息净荷：详细说明消息净荷字段。参数类型说明bts_setup_typeenum连接建立类型：0：normal_setup，正常的始呼/被呼或硬切换目的。1：soft_ho，软切换支路加入。2：softer_ho，更软切换加入。3：a3a7_soft_ho，bsc 间软切换加入 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密

15、第第 4 4 页页 如果 bts_setup_type = normal_setup（正常的始呼/被呼或硬切换目的） ，soft_ho (软切换支路加入)， sdmaddressinl=true。true-以下 sdmaddress 信息字段有效。false-以下 sdmaddress 信息字段无效sdmaddressstructsdm 处理实例的地址。复杂数据类型说明：复杂数据类型说明：如果有，在此详细说明“消息净荷”中的复杂数据类型。1.5参考文档1.5.1内部文档1.5.2外部文档1.6术语及缩略语（英文缩写）（英文全称）（中文全称）emcbmain control board主控板ec

16、pbchannel processing board信道处理板rruremote radio unit射频拉远单元omoperation and maintenance操作维护 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 5 5 页页 2接口概述接口概述2.1接口说明本文档定义了 om 与其他软件模块之间的自定义接口，包括：mcb rrm 与 om 之间的接口；up 与 om 之间的接口；bb 与 om 之间的消息接口；om 软件向其他模块提供的接口。2.2消息格式说明消息接口采用统一的消息封装格式，消息结构定义如下：struct

17、messagestruct cpidsthost;/* 宿主标识 */struct cpidstsender;/* 发送者标识 */uint16 unsap;uint16 uncode; /* 消息种别码 */uint32unbodylen;/* 消息参数体长度（单位：字节）*/uint8uchbodymessage_body_size; /* 消息参数体 */;struct cpiduint16 unpid;/* 进程编号 */uint16 unfid;/* 功能块号 */uint16 unmid;/* 模块编号 */;2.3消息类型说明2.3.18548 om 与 8144 调试消息定义t

18、ypedef enum omdspmmldebug om_dsp_mml_msg = om_common_msg_end, dsp_om_debug_msg， om_dsp_mml_debug_end2.3.2om 与 rrm 之间的消息typedef enum omrrmmsgtype td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 6 6 页页 om_rrm_lc_enabled_req bb_debug_msg_end,rrm_om_lc_enabled_rsp,om_rrm_lc_disabled_ind,om_rrm_lc_d

19、el_ind,om_rrm_ecpb_block_ind,om_rrm_ecpb_unblock_ind,cm2cellrm_cell_setup_req, cm2cellrm_cell_reconfig_req, cm2cellrm_cell_delete_req, cm2sib_sysinf_update_req, cm2connc_reset_x2_link , cm2connc_reset_s1_link,rrm_rru_cell_setup_req, rru_rrm_cell_setup_cnf,rrm_rru_cell_delete_req,rru_rrm_cell_delete_

20、cnf ,om_rrm_msg_end;2.3.3om 与 up 之间的消息定义typedef enum omupmsgtypeom_gtpu_para_cfg_req = om_rrm_msg_end , gtpu_om_para_cfg_rsp,om_pdcp_para_cfg_req,pdcp_om_para_cfg_rsp,om_mac_para_cfg_req,mac_om_para_cfg_rsp,om_up_msg_end;2.3.4om 公共接口消息定义typedef enum omcommonmsgtype td-lte enodeb om 软件接口设计说明书普天信息技术研究

21、院普天信息技术研究院 机密机密 第第 7 7 页页 om_sw_alarm_msg = om_up_msg_end , om_sw_alarm_report_msg, localpm _otherm_start_perf,otherm_ localpm _start_perf_ack,localpm _otherm_stop_perf,otherm_ localpm _stop_perf_ack,localpm _otherm_get_perf_result,otherm_ localpm _perf_result,om_common_msg_end;3常用数据类型说明常用数据类型说明type

22、def unsigned char uint8； 占用一个字节（8 比特）;typedef unsigned short uint16； 占用两个字节（16 比特）;typedef unsigned long uint32； 占用四个字节（32 比特）;typedef signed char int8; 占用一个字节（8 比特）;typedef short int16; 占用两个字节（16 比特）;typedef long int32; 占用四个字节（32 比特）;enum 占用四个字节（32 比特）4接口定义接口定义4.1mcb rrm 与 cpb rruagent 之间的消息接口参见lte

23、-tdd enodeb v2.0 板间消息定义说明书4.2om 与 bb 之间的接口参见td-lte enodeb 基带和高层软件接口设计说明书4.3om 与 mcb rrm 之间的接口4.3.1初始化接口功能：功能： td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 8 8 页页 初始化 mcb 板的 rrm 模块。接口：接口：int32rrminit(char* filename);返回值：返回值：int32，操作结果：enodeb_ok，成功；其他，失败。参数说明：参数说明： 无复杂数据类型说明：复杂数据类型说明：无4.3.2本地小

24、区可用请求消息功能：功能：当本地小区状态变为可用时 om 通知协议模块。方向：方向：om rrm消息净荷：消息净荷：参数类型说明localcelliduint8本地小区标识lc_add_infostruct grmlocalcellinfo本地小区信息复杂数据类型说明：复杂数据类型说明：struct grmlocalcellinfobidtype cpbbid;bidtype rrubid;uint32 cpbip;uint32 dspip;uint32 picoip; uint32 rruip; uint8 txnum; /*天线个数*/ td-lte enodeb om 软件接口设计说明书

25、普天信息技术研究院普天信息技术研究院 机密机密 第第 9 9 页页 4.3.3本地小区可用响应消息功能：功能：本地小区可用的响应消息方向：方向：rrm om 消息净荷：消息净荷：参数类型说明localcelliduint8本地小区标识resultuint80：成功1：失败复杂数据类型说明：复杂数据类型说明：无4.3.4本地小区不可用通知消息功能：功能：当本地小区状态变为不可用时 om 通知协议模块。方向：方向：om rrm消息净荷：消息净荷：参数类型说明localcelliduint8本地小区标识复杂数据类型说明：复杂数据类型说明：无4.3.5本地小区删除通知消息功能：功能：当本地小区删除时

26、om 通知协议模块。 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1010 页页 方向：方向：om rrm消息净荷：消息净荷：参数类型说明localcelliduint8本地小区标识复杂数据类型说明：复杂数据类型说明：无4.3.6ecpb 阻塞/解阻塞消息功能：功能：通知 rrm 模块发起 ecpb 板卡阻塞/解阻塞操作。方向：方向：om rrm消息净荷：消息净荷：参数类型说明rackiduint16板卡机架号shelfiduint16板卡机框号slotiduint16板卡槽位号复杂数据类型说明：复杂数据类型说明：无4.4om 与

27、rcp 之间的接口4.4.1初始化接口功能：功能：初始化 rcp 模块。接口：接口：int32rcpinit()；返回值：返回值： td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1111 页页 int32，操作结果：enodeb_ok，成功；其他，失败。参数说明：参数说明：无无复杂数据类型说明：复杂数据类型说明：无4.5om 与 up 之间的接口4.5.1初始化接口功能：功能：初始化 cpb 板的 up 模块。接口：接口：int32upinit();返回值：返回值：int32，操作结果：enodeb_ok，成功；其他，失败。参数说明：

28、参数说明：无复杂数据类型说明：复杂数据类型说明：无4.5.2gtpu 参数配置请求消息功能功能:om 模块对 gtp-u 参数进行配置方向方向omgtp-u消息净荷消息净荷参数类型说明inactivationdurationuint16隧道转为非激活状态的时长，单位：秒。echoflaguint8echo 过程使能标识enable = 1 disable = 0echoperioduint8echo 周期，单位:秒。t3responseuint8echo 响应消息的定制器时长,单位：秒。n3responseuint8发送 echo 请求的最大尝试次数，在没有收到echo 响应的情况下。 td-

29、lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1212 页页 inactivationdetectionflaguint8非激活性检测使能标识enable = 1 disable = 0reserveduint8保留字段复杂数据类型说明：复杂数据类型说明：无4.5.3gtpu 参数配置响应消息功能功能:gtp-u 模块对 om 配置消息的响应方向方向gtpuom消息净荷消息净荷参数类型说明resultuint320：成功1：失败复杂数据类型说明：复杂数据类型说明：无4.5.4pdcp 参数配置请求消息功能：功能：om 对 pdcp 参数进行

30、配置。方向方向ompdcp消息净荷：消息净荷： td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1313 页页 复杂数据类型说明：复杂数据类型说明：无4.5.5pdcp 参数配置响应消息功能功能:pdcp 模块对 om 配置消息的响应方向方向pdcpom消息净荷消息净荷参数类型说明resultuint320：成功1：失败参数类型说明reversedecompressiondepthuint32反向解压缩层次。是否使用“反向解压” 。值 0 表示“反向解压”不被使用。如果使用，则说明范围。这个值说明了可缓存的最大包数目。（当 pdcp 压

31、缩标识为 1 时才生效）0：不启动非 0：可缓存的最大包数目缺省值：0maxciduint16最大上下文 id 号。压缩方使用的最大上下文 id 号。 （当 pdcp 压缩标识为 1 时才生效）116383缺省值：15pdcphcflaguint8pdcp 压缩标识。是否起用 pdcp 头部压缩功能。disable=0enable=1缺省值：0pdcpintegrityflaguint8pdcp 完整性标识。是否起用 pdcp完整性保护和验证功能。disable=0enable=1缺省值：0pdcpcipherflaguint8pdcp 加密标识。是否起用 pdcp 加密和解密功能。disab

32、le=0enable=1缺省值：0reserved3uint8保留字段 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1414 页页 复杂数据类型说明：复杂数据类型说明：无4.5.6mac 参数配置请求接口功能：功能：om 模块对 mac 参数进行配置方向：方向：om mac消息净荷：消息净荷：参数类型说明maxservicerateuint32业务的限制最大速率ueaveragerateinituint32用户空口平均速率初始值tqosuint16速率维护周期numof tqosuint16小区满意度统计时长包含的 t_qos 个数

33、drxenableuint8是否 drxshortdrxenableuint8是否支持 shortdrxmaxharqtxuint8最大 harq 重传次数ttibundlingenableuint8是否支持 ttibundlingtransmitmodeuint8传输模式shedulingarithmeticuint8调度算法maxsheduleuenumuint8最大调度用户数目maxactiveuenumuint8最大在线用户数目tc uint8滤波因子orderingperioduint8用户优先级排序周期unsatiueguartqosuint8不满意用户 qos 保证参数initw

34、idebandcqiuint8宽带 cqi 初始值servicesatiminuint8业务满意度的最小值beltauint8信道环境权重因子srresourcesizeuint8为每个有 sr 的用户分配的资源大小runumforraruint8为 rar 预留的 ru 数spsresourceratiouint8sps 业务占用总资源的比例emerginitcqiinduint8紧急呼叫用户初始 cqi 指示spsinitcqiinduint8半静态用户的初始 cqi 指示 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1515

35、页页 maxharqmsg3txuint8msg3 的最大 harq 传输次数cqithreholduint8深衰非深衰判决门限ulharqmodeuint8上行 harq 缺省重传方式defaultresallocmodeuint8下行缺省资源分配方式uintefficyfactoruint8归一化传输效率权重因子uintqcifactoruint8归一化 qci 权重因子numberforrichangeuint8表示改变传输模式时，所需连续传输 ri的次数，取值范围 1-127basedpuschcqivaluint8pusch 基准 cqi 值，取值范围：0-15rrresunitui

36、nt8rr 算法资源粒度，取值范围：1-55rrrbgresunituint8rr 算法下的资源粒度，type0 下一个rr 用户所占用的 rbg 数量，取值范围：1-25rarcqiinduint8rar 用户初始 cqi 指示，取值范围：0-15bpinitcqiinduint8bp 的初始 cqi 指示，取值范围：0-15ccchinitcqiinduint8ccch 用户的初始 cqi 指示，取值范围：0-15pdcchratiouint8上下行 pdcch cce 比例，取值范围：0-10puschhoppingmodeuint8pusch 跳频类型，0:不启用跳频，1：type1

37、跳频类型；2：type2 跳频类型puschhoppingtype1bandwidthuint8pusch type1 带宽，0:1/4 带宽，1：-1/4带宽2:1/2 带宽reserveduint8保留字段复杂数据类型说明：复杂数据类型说明：无4.5.7mac 参数配置响应接口功能功能:mac 模块对 om 配置消息的响应方向方向macom消息净荷消息净荷参数类型说明resultuint320：成功1：失败 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1616 页页 复杂数据类型说明：复杂数据类型说明：无4.6om 性能接口4.

38、6.1local om 通知其它模块开始数据采集消息功能：当功能：当 local pm 收到 main pm 的采集开始消息后， 通知其它模块执行数据采集的任务。方向：方向：local pm other module消息头：消息头：参数类型含义message typeenum消息类型 localpm_otherm_start_perf消息消息净净荷：荷：参数类型说明perfcollectstarttimeuint32采集开始时间，单位：s复杂数据类型说明：复杂数据类型说明：无4.6.2其它模块通知 local om 收到开始数据采集反馈消息功能：当功能：当其它模块收到 local pm 的采集

39、开始消息后， 通知 localpm 执行数据采集的任务成功或失败。方向：方向：other module local pm 消息头：消息头：参数类型含义message typeenum消息类型 otherm_localpm_start_perf_ack消息消息净净荷：荷：参数类型说明 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1717 页页 causeuint320：成功1：失败复杂数据类型说明：复杂数据类型说明：无4.6.3local om 通知其它模块停止数据采集消息功能：当功能：当 local pm 收到 main pm 的采

40、集停止消息后， 通知其它模块停止数据采集的任务。方向：方向：local pm other module消息头：消息头：参数类型含义message typeenum消息类型 localpm_otherm_stop_perf消息消息净净荷：荷：无复杂数据类型说明：复杂数据类型说明：无4.6.4其它模块通知 local om 收到停止数据采集反馈消息功能：当功能：当其它模块收到 local pm 的采集停止消息后， 通知 localpm 停止数据采集的任务成功或失败。方向：方向：other module local pm 消息头：消息头：参数类型含义message typeenum消息类型 othe

41、rm_localpm_stop_perf_ack消息消息净净荷：荷：参数类型说明causeuint320：成功1：失败复杂数据类型说明：复杂数据类型说明： td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1818 页页 无4.6.5local om 通知其它模块获取采集数据消息功能：功能：当采集周期到时，local pm 通知其它模块报送数据采集的结果。方向：方向：local pm other module消息头：消息头：参数类型含义message typeenum消息类型 localpm_otherm_get_perf_result消

42、息消息净净荷：荷：无复杂数据类型说明：复杂数据类型说明：无4.6.6其它模块向 local om 传送获取的采集数据消息功能：功能：当采集周期到时，local pm 通知其它模块报送数据采集的结果，其它模块传送结果给 localpm。方向：方向：other module local pm 消息头：消息头：参数类型含义message typeenum消息类型 otherm_localpm_perf_result消息消息净净荷：荷：参数类型说明moduleiduint16模块标识具体定义如下：/* control plane */rrm(mcb) ： 1rrm (ue based,cpb)： 2r

43、rc(cpb)： 3s1/x2(mcb)： 4s1/x2(ue based,cpb)：5 /* user plane */ td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 1919 页页 pdcp： 11mac： 12rlc： 13gtp-u： 14 /* operation&matainance */om： 21rruagent：31celliduint32小区标识（注：若为 enodeb级的则填 0 xffffffff）numberofpmuint32消息中采集的 pm 测量项数目performvalue1uint32测量项结果 1

44、performvalue2uint32测量项结果 2performvaluenuint32测量项结果 n复杂数据类型说明：复杂数据类型说明：无4.7om 提供的公共接口说明：om 提供的公共接口中，软件告警的消息接口适用于所有模块，其他的函数接口，4.7.24.7.10 只适用于 emcb 和 ecpb 的 8548 上面的模块，4.7.12 以后适用于 8144 上的模块。4.7.1软件告警消息接口功能：功能：各模块向 om 上报一般软件告警，该告警不会报告给 omcr/lmt，它将被写入flash。方向：方向：其他软件模块 om fault消息净荷：消息净荷：参数类型说明alarmcode

45、uint16软件告警码。paddinguint16填充linenouint32产生错误的源代码行号。filenamechar*产生错误的源文件名。 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2020 页页 reservedinfochar*长度为 20 字节的保留字段，可保存与软件错误相关的任何信息。复杂数据类型说明：复杂数据类型说明：无4.7.2软件告警上报消息接口功能：功能：各模块向 om 上报软件告警（如参数错误等） ，该告警会上报给 omcr/lmt。方向：方向：其他软件模块 om fault消息净荷：消息净荷：参数类型说

46、明alarmtimetime_t告警时间alarmcodeuint16告警码alarminstuint16告警码对应的告警实例号（例如：dsp 告警，这填的是 dsp 的编号）alarmstateuint8告警状态， 0 表示告警清除；1 表示告警产生alarmsubtypeuint8告警类型alarmseverityuint8告警严重级别alarmorirackiduint16告警所在的板卡 rackidalarmorishelfiduint16告警所在的板卡 shelfidalarmorislotiduint16告警所在的板卡 slotidreserved0uint8保留reserved1

47、uint8保留extrainfochar长度为 12 字节的附加信息字段。复杂数据类型说明：复杂数据类型说明：struct hwalarminfotype time_t alarmtime; /告警时间 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2121 页页 uint16alarmcode; /告警码 uint16 alarminstanceid; /告警实例 uint8 alarmstate; /告警状态 0 清除；1 产生 uint8 alarmsubtype; /告警类型 uint8 alarmseverity; /告警严

48、重级别 uint16 alarmorirackid; /告警所在的板卡 rackid uint16 alarmorishelfid; /告警所在的板卡 shelfiduint16 alarmorislotid; /告警所在的板卡 slotiduint8 resv0;uint8 resv1; char extrainfo12; /附加信息字段 char reserved1; /告警保留字段 ;/*告警类型定义*/enum alarmhwtype alarm_communication = 1, /通信类告警 alarm_qos, /服务质量类告警 alarm_process, /处理器类告警 a

49、larm_equipment, /设备类告警 alarm_environment /环境类告警;/*告警严重级别枚举*/enum alarmseveritytype alarm_sev_critical = 1, alarm_sev_major, alarm_sev_minor, alarm_sev_warning, alarm_sev_cleared;4.7.3getselfbid() 获取本板标识功能：功能：获取本板的 bid，其中包括：板卡机架号，机框号和槽位号。接口：接口：static int32 basenodebomutility:getselfbid(bidtype& bid);

50、返回值：返回值： td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2222 页页 int32，操作结果。enodeb_ok：成功；enodeb_error：失败。参数说明：参数说明：参数名称类型说明bidbidtype&板卡标识，输出参数。复杂数据类型说明：复杂数据类型说明：无4.7.4bidtomid() 根据板卡标识及 cpu 类型获取 mid功能：功能：根据板卡标识（机架号、机框号和槽位号）及 cpu 类型获取 mid。接口：接口：static uint16 basenodebomutility:bidtomid (const b

51、idtype& bid，const uint16 cputype);返回值：返回值：uint16，板卡的 mid。返回值为 0 表示输入参数有误。参数说明：参数说明：参数名称类型说明bidconst bidtype&板卡标识。cputypeuint16cpu 类型。0：8548；1：8144dsp；2：pico复杂数据类型说明：复杂数据类型说明：无4.7.5midtobid () 根据 mid 获取板卡标识及 cpu 类型功能：功能：根据 mid 获取板卡标识（机架号、机框号和槽位号）及 cpu 类型。接口：接口：static int32 basenodebomutility:midtobid

52、(uint16 mid, bidtype& bid, uint16 &cputype)返回值：返回值： td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2323 页页 int32，操作结果，0 表示成功，非 0 表示各种失败情况。参数说明：参数说明：参数名称类型说明miduint16模块标识bidconst bidtype&板卡标识。cputypeuint16cpu 类型。0：8548；1：8144dsp；2：pico复杂数据类型说明：复杂数据类型说明：无4.7.6getipbymid() 根据 mid 获取整型 ip 地址功能：功能：

53、根据板卡 mid 获得板卡的整数类型的 ip 地址。接口：接口：static int32 nodebipmgr:getipbymid (uint16 mid, uint32& ipaddr );返回值：返回值：int32，操作结果，0 表示成功获得 ip 地址，非 0 表示各种失败情况。参数说明：参数说明： 参数名称类型说明miduint16板卡的 mid 标识。ipaddruint32&输出参数，表示板卡的 ip 地址。复杂数据类型说明：复杂数据类型说明：无4.7.7getipstrbymid() 根据 mid 获取字符串型 ip 地址功能：功能：根据板卡 mid 获得板卡的字符串类型的 i

54、p 地址。接口：接口：static int32 nodebipmgr:getipstrbymid (uint16 mid, char* ipstr); td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2424 页页 返回值：返回值：int32，操作结果，0 表示成功获得 ip 地址，非 0 表示各种失败情况。参数说明：参数说明： 参数名称类型说明miduint16板卡的 mid 标识。ipstrchar*输出参数，板卡的字符串形式的 ip 地址。复杂数据类型说明：复杂数据类型说明：无4.7.8getnodebip ()获取 nodeb

55、ip 地址功能：功能：获取 enodeb 的 ip 地址接口：接口：static uint32 nodebipmgr: getnodebip ();返回值：返回值：uint32，操作结果，非 0 表示获得的 ip 地址， 0 表示失败参数说明：参数说明： 无4.7.9getnodebport ()获取 nodeb port 号功能：功能：获取 enodeb 的端口号接口：接口：static uint16 nodebipmgr: getnodebport ();返回值：返回值：uint16，操作结果，非 0 表示获得的端口号， 0 表示失败 td-lte enodeb om 软件接口设计说明书普

56、天信息技术研究院普天信息技术研究院 机密机密 第第 2525 页页 参数说明：参数说明： 无4.7.10 getnodebsysfuncid ()获取 nodeb 标识功能：功能：获取 enodeb 的标识接口：接口：static uint32 basenodebomutility:getnodebsysfuncid（）;返回值：返回值：uint32，操作结果，表示获得的 enodeb 标识参数说明：参数说明： 无4.7.11 getnodebsysname()获取 nodeb 系统名称功能：功能：获取 enodeb 的名称接口：接口：static int32 basenodebomutili

57、ty: getnodebsysname (char* sysname);返回值：返回值：int32，操作结果，0 表示成功获得 ip 地址，非 0 表示各种失败情况。参数说明：参数说明： 参数名称类型说明sysnamechar*输出参数，enodeb 的系统名称4.7.12 getemcbmid()获取 emcb 板 mid功能：功能：ecpb 板上获取 emcb 板 mid。接口：接口：static uint16 nodebomutility:getemcbmid(); td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2626 页页

58、返回值：返回值：uint16，操作结果，返回 mid， 若出现错误返回 invalid_mid。参数说明：参数说明： 参数名称类型说明无无无以下接口为以下接口为 8144 专用的：专用的：4.7.13 getdspip()获取 8144dsp 的 ip 地址功能：功能：获取本板 8144dsp 的 ip 地址接口：接口：uint32 getdspip ();返回值：返回值：uint32，操作结果，非 0 表示获得的 ip 地址， 0 表示失败。参数说明：参数说明： 无4.7.14 getpicoip()获取 pico 的 ip 地址功能：功能：获取本板 pico 的 ip 地址接口：接口：ui

59、nt32 getpicoip ();返回值：返回值：uint32，操作结果，非 0 表示获得的 ip 地址， 0 表示失败。参数说明：参数说明： 无 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2727 页页 4.7.15 getdspmid()获取 8144dsp 的 mid功能：功能：获取 8144dsp 的 mid接口：接口：uint16 getdspmid ();返回值：返回值：uint16，表示获得的 mid。参数说明：参数说明： 无4.7.16 getecpbmid()获取 ecpb8548 的 mid功能：功能：获取

60、ecpb8548 的 mid接口：接口：uint16 getecpbmid ();返回值：返回值：uint16，表示获得的 mid。参数说明：参数说明： 无4.8cm 模块提供给 grm 的接口4.8.1读表函数4.8.1.1cm 给小区流程提供的接口4.8.1.1.1获取小区基本属性接口函数4.8.1.1.1.1cm_getcellbasictable()函数说明： 获得小区基本配置参数 td-lte enodeb om 软件接口设计说明书普天信息技术研究院普天信息技术研究院 机密机密 第第 2828 页页 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduin