TDLTEeNodeBOM接口设计说明书

1、 td-lte enodeb om 软件软件 接口设计说明书接口设计说明书 cpit-7.3-lte-sys_dd-041 ebbu1606a v2.0 r2.0 v1.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 增加了 rruagent 2009

2、.06.26v1.1余立红/王峥 更新了 4.5.6 增加了 4.7.13、4.7.14 更新了 4.8、4.9 2009-7-9v1.1余立红 4.5.7 mac 增加了两个参数 4.6.6 去掉了 bid 增加 4.7.11，获取主控板 mid 2009-8-8余立红 2.3.2 去掉了消息码 om_rrm_file_ready_ind 2.3.4 增加了消息码 om_sw_alarm_report_msg 4.3 去掉了 rrm 文件下载通知消 息 4.5.6 mac 增加了 8 个参数 增加了 4.7.2 消息接口 td-lte enodeb om 软件接口设计说明书 普天信息技术研究

3、院普天信息技术研究院 机密机密 第第 iiii 页页 编制 姓名签字日期电话 余立红 江丽蓉 王峥 审查 姓名签字日期电话 宗华 审核 姓名签字日期电话 盖平 批准批准 姓名签字日期电话 蒋纯波 文档评审负责人： 盖平 参加评审人员：参加评审人员：汤素锋、王宇、杨隽、王峥、江丽蓉、曹伟、欧阳国威、陶雅 静 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 iiiiii 页页 目目 录录 目目 录录.iii 1引言引言 .1 1.1文档目的文档目的.1 1.2文档读者文档读者.1 1.3文档背景文档背景.1 1.4文档说明文档说明.1 1

4、.4.1文档范围.1 1.4.2文档输入.1 1.4.3下属指导文档.2 1.4.4书写约定.2 1.5参考文档参考文档.4 1.5.1内部文档.4 1.5.2外部文档.4 1.6术语及缩略语术语及缩略语.4 2接口概述接口概述.5 2.1接口说明接口说明.5 2.2消息格式说明消息格式说明.5 2.3消息类型说明消息类型说明.5 2.3.18548 om 与 8144 调试消息定义.5 2.3.2om 与 rrm 之间的消息.5 2.3.3om 与 up 之间的消息定义.6 2.3.4om 公共接口消息定义.6 3常用数据类型说明常用数据类型说明.7 4接口定义接口定义.7 4.1mcb r

5、rm 与与 cpb rruagent 之间的消息接口之间的消息接口.7 4.2om 与与 bb 之间的接口之间的接口 .7 4.3om 与与 mcb rrm 之间的接口之间的接口.7 4.3.1初始化接口.7 4.3.2本地小区可用请求消息.8 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 iviv 页页 4.3.3本地小区可用响应消息.9 4.3.4本地小区不可用通知消息.9 4.3.5本地小区删除通知消息.9 4.3.6ecpb 阻塞/解阻塞消息.10 4.4om 与与 rcp 之间的接口之间的接口.10 4.4.1初始化接口.

6、10 4.5om 与与 up 之间的接口之间的接口 .11 4.5.1初始化接口.11 4.5.2gtpu 参数配置请求消息.11 4.5.3gtpu 参数配置响应消息.12 4.5.4pdcp 参数配置请求消息.12 4.5.5pdcp 参数配置响应消息.13 4.5.6mac 参数配置请求接口.14 4.5.7mac 参数配置响应接口.15 4.6om 性能接口性能接口.16 4.6.1local om 通知其它模块开始数据采集消息.16 4.6.2其它模块通知 local om 收到开始数据采集反馈消息.16 4.6.3local om 通知其它模块停止数据采集消息.17 4.6.4其它

7、模块通知 local om 收到停止数据采集反馈消息.17 4.6.5local om 通知其它模块获取采集数据消息.17 4.6.6其它模块向 local om 传送获取的采集数据消息.18 4.7om 提供的公共接口提供的公共接口.19 4.7.1软件告警消息接口.19 4.7.2软件告警上报消息接口.20 4.7.3getselfbid() 获取本板标识.21 4.7.4bidtomid() 根据板卡标识及 cpu 类型获取 mid.22 4.7.5midtobid () 根据 mid 获取板卡标识及 cpu 类型.22 4.7.6getipbymid() 根据 mid 获取整型 ip

8、地址.23 4.7.7getipstrbymid() 根据 mid 获取字符串型 ip 地址.23 4.7.8getnodebip ()获取 nodeb ip 地址 .24 4.7.9getnodebport ()获取 nodeb port 号.24 4.7.10getnodebsysfuncid ()获取 nodeb 标识.24 4.7.11getnodebsysname()获取 nodeb 系统名称.25 4.7.12getemcbmid()获取 emcb 板 mid.25 4.7.13getdspip()获取 8144dsp 的 ip 地址.26 4.7.14getpicoip()获取

9、pico 的 ip 地址.26 4.7.15getdspmid()获取 8144dsp 的 mid.26 4.7.16getecpbmid()获取 ecpb8548 的 mid.27 4.8cm 模块提供给模块提供给 grm 的接口的接口.27 4.8.1读表函数.27 4.8.2流程处理函数.48 4.8.3消息.49 4.9grm 提供给提供给 om 的函数的函数.52 4.9.1grm_ctxt 上下文的修改.52 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 v v 页页 4.9.2s1/x2 流程 .53 4.108548

10、 om 与与 8144 之间调试接口之间调试接口.54 4.10.18548 om 向 8144 发送 mml 命令.54 4.10.28144 向 8548 om 发送调试打印消息.54 5附录附录 .55 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 1 1 页页 1 引言引言 1.1文档目的 此文档的目的是定义 tdlte enodeb om 与其他软件模块的接口，此文档用 于指导 om 及相关软件模块的的详细设计、编码、单元测试以及集成测试。 1.2文档读者 此文档的读者是软件设计工程师，测试工程师。 1.3文档背景 略。

11、1.4文档说明 1.4.1文档范围 此文档主要定义了 om 与其他软件的接口，具体包括如下方面： 1.om 与 bb 之间的接口； 2.om 与 rrm 之间的接口； 3.om 与 rcp 之间的接口； 4.om 与 up 之间的接口； 5.om 的性能接口； 6.om 通用接口 1.4.2文档输入 此文档的输入文档如表格 1 所示: 表格 1 输入文档列表 输入文档名输入文档名文档版本文档版本文档类型文档类型备注备注 lte enodeb 系统需求规格说明 书 1.1产品级功能需求文档必选 td-lte enodeb 高层软件架构 设计说明书 1.0架构设计文档必选 td-lte enode

12、b om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2 2 页页 1.4.3下属指导文档 此文档的下属指导文档如表格 2 所示: 表格 2 下属文档列表 下属指导文档名下属指导文档名文档版本文档版本文档类型文档类型备注备注 td-lte enodeb om 模块详细设 计 v1.0 详细设计文档必选 td-lte enodeb 业务面各模块详 细设计 v1.0 详细设计文档必选 td-lte enodeb 控制面各模块详 细设计 v1.0 详细设计文档必选 1.4.4书写约定 此文档应满足下列格式要求： 1.4.4.1函数接口书写约定 函数接口需要按照如下格式定

13、义： 功能：功能： 说明该函数接口的功能。 接口：接口： 函数的声明，应符合研究院的编码规范。 static classname:registerme( void *pobj, funcptr pcbfunc, int iappid ) 返回值：返回值： 函数的返回值说明。 参数说明：参数说明：（函数参数的详细说明） 参数名称类型说明 pobjvoid *注册的对象指针 pcbfuncfuncptr回调函数指针。 回调函数必须以对象指针和 message 指针为参 数，完成消息的落地，返回 ok 或 error。 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息

14、技术研究院 机密机密 第第 3 3 页页 iappidint分配给应用模块的应用索引号，即 fid 如果参数类型是个复杂数据类型，且在其它地方没有说明过，应当在说明中详细定 义。 复杂数据类型说明：复杂数据类型说明： 如果有，在此详细说明“参数说明”中的复杂数据类型。 1.4.4.2消息接口书写约定 消息接口需要按照如下格式定义： 功能：功能： 说明该消息接口的功能。 方向：方向： 说明该消息从哪个模块发送给哪个模块。 bmcmcp 消息头：消息头： 消息头字段，可选。 hostsender midbtscpm fidabiscpm_call pid0 或 abispid(更软切换时) 呼叫实

15、例 pid 消息净荷：消息净荷： 详细说明消息净荷字段。 参数类型说明 bts_setup_typeenum连接建立类型： 0：normal_setup，正常的始呼/被呼或硬切 换目的。 1：soft_ho，软切换支路加入。 2：softer_ho，更软切换加入。 3：a3a7_soft_ho，bsc 间软切换加入 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 4 4 页页 如果 bts_setup_type = normal_setup（正常的始呼/被呼或硬切换 目的） ， soft_ho (软切换支路加入)， sdmaddres

16、sinl=true。 true-以下 sdmaddress 信息字段有效。 false-以下 sdmaddress 信息字段无效 sdmaddressstructsdm 处理实例的地址。 复杂数据类型说明：复杂数据类型说明： 如果有，在此详细说明“消息净荷”中的复杂数据类型。 1.5参考文档 1.5.1内部文档 1.5.2外部文档 1.6术语及缩略语 （英文缩写）（英文全称）（中文全称） emcbmain control board主控板 ecpbchannel processing board信道处理板 rruremote radio unit射频拉远单元 omoperation and m

17、aintenance操作维护 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 5 5 页页 2接口概述接口概述 2.1接口说明 本文档定义了 om 与其他软件模块之间的自定义接口，包括： mcb rrm 与 om 之间的接口； up 与 om 之间的接口； bb 与 om 之间的消息接口； om 软件向其他模块提供的接口。 2.2消息格式说明 消息接口采用统一的消息封装格式，消息结构定义如下： struct message struct cpidsthost;/* 宿主标识 */ struct cpidstsender;/* 发送者标

18、识 */ uint16 unsap; uint16 uncode; /* 消息种别码 */ uint32unbodylen;/* 消息参数体长度（单位：字节）*/ uint8uchbodymessage_body_size; /* 消息参数体 */ ; struct cpid uint16 unpid;/* 进程编号 */ uint16 unfid;/* 功能块号 */ uint16 unmid;/* 模块编号 */ ; 2.3消息类型说明 2.3.18548 om 与 8144 调试消息定义 typedef enum omdspmmldebug om_dsp_mml_msg = om_com

19、mon_msg_end, dsp_om_debug_msg， om_dsp_mml_debug_end 2.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_del_ind, om_rrm_ecpb_block_ind, om_rrm_ecpb_

20、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_cnf , om_rrm_msg_end ; 2.3.3om 与 up 之

21、间的消息定义 typedef enum omupmsgtype om_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 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 7 7

22、页页 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常用数据类型说明常用数据类型说明 typedef unsigned c

23、har 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-tdd

24、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，成功；其他，失败。 参数说明：参数说明： 无 复杂数据类型说明：复杂数据类型说明： 无

25、 4.3.2本地小区可用请求消息 功能：功能： 当本地小区状态变为可用时 om 通知协议模块。 方向：方向： om rrm 消息净荷：消息净荷： 参数类型说明 localcelliduint8本地小区标识 lc_add_info struct grmlocalcellinfo 本地小区信息 复杂数据类型说明：复杂数据类型说明： struct grmlocalcellinfo bidtype cpbbid; bidtype rrubid; uint32 cpbip; uint32 dspip; uint32 picoip; uint32 rruip; uint8 txnum; /*天线个数*/

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

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

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

29、：功能： 初始化 cpb 板的 up 模块。 接口：接口： int32upinit(); 返回值：返回值： int32，操作结果：enodeb_ok，成功；其他，失败。 参数说明：参数说明： 无 复杂数据类型说明：复杂数据类型说明： 无 4.5.2gtpu 参数配置请求消息 功能功能: om 模块对 gtp-u 参数进行配置 方向方向 omgtp-u 消息净荷消息净荷 参数类型说明 inactivationdurationuint16隧道转为非激活状态的时长，单位：秒。 echoflag uint8echo 过程使能标识 enable = 1 disable = 0 echoperioduin

30、t8echo 周期，单位:秒。 t3responseuint8echo 响应消息的定制器时长,单位：秒。 n3responseuint8发送 echo 请求的最大尝试次数，在没有收到 echo 响应的情况下。 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 1212 页页 inactivationdetectio nflag uint8非激活性检测使能标识 enable = 1 disable = 0 reserveduint8保留字段 复杂数据类型说明：复杂数据类型说明： 无 4.5.3gtpu 参数配置响应消息 功能功能: gtp

31、-u 模块对 om 配置消息的响应 方向方向 gtpuom 消息净荷消息净荷 参数类型说明 resultuint320：成功 1：失败 复杂数据类型说明：复杂数据类型说明： 无 4.5.4pdcp 参数配置请求消息 功能：功能： om 对 pdcp 参数进行配置。 方向方向 ompdcp 消息净荷：消息净荷： td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 1313 页页 复杂数据类型说明：复杂数据类型说明： 无 4.5.5pdcp 参数配置响应消息 功能功能: pdcp 模块对 om 配置消息的响应 方向方向 pdcpom 消息净荷

32、消息净荷 参数类型说明 resultuint320：成功 1：失败 参数类型说明 reversedecompressiondepthuint32 反向解压缩层次。是否使用“反向 解压” 。值 0 表示“反向解压”不被 使用。如果使用，则说明范围。这 个值说明了可缓存的最大包数目。 （当 pdcp 压缩标识为 1 时才生效） 0：不启动 非 0：可缓存的最大包数目 缺省值：0 maxciduint16 最大上下文 id 号。压缩方使用的最 大上下文 id 号。 （当 pdcp 压缩标识 为 1 时才生效） 116383 缺省值：15 pdcphcflaguint8 pdcp 压缩标识。是否起用

33、pdcp 头 部压缩功能。 disable=0 enable=1 缺省值：0 pdcpintegrityflaguint8 pdcp 完整性标识。是否起用 pdcp 完整性保护和验证功能。 disable=0 enable=1 缺省值：0 pdcpcipherflaguint8 pdcp 加密标识。是否起用 pdcp 加 密和解密功能。 disable=0 enable=1 缺省值：0 reserved3uint8保留字段 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 1414 页页 复杂数据类型说明：复杂数据类型说明： 无 4.5

34、.6mac 参数配置请求接口 功能：功能： om 模块对 mac 参数进行配置 方向：方向： om mac 消息净荷：消息净荷： 参数类型说明 maxservicerate uint32 业务的限制最大速率 ueaveragerateinituint32用户空口平均速率初始值 tqos uint16 速率维护周期 numof tqosuint16小区满意度统计时长包含的 t_qos 个数 drxenableuint8是否 drx shortdrxenableuint8是否支持 shortdrx maxharqtxuint8最大 harq 重传次数 ttibundlingenableuint8是

35、否支持 ttibundling transmitmodeuint8传输模式 shedulingarithmeticuint8调度算法 maxsheduleuenumuint8最大调度用户数目 maxactiveuenumuint8最大在线用户数目 tc uint8滤波因子 orderingperiod uint8用户优先级排序周期 unsatiueguartqos uint8 不满意用户 qos 保证参数 initwidebandcqiuint8宽带 cqi 初始值 servicesatiminuint8业务满意度的最小值 beltauint8信道环境权重因子 srresourcesizeui

36、nt8为每个有 sr 的用户分配的资源大小 runumforraruint8为 rar 预留的 ru 数 spsresourceratiouint8sps 业务占用总资源的比例 emerginitcqiinduint8 紧急呼叫用户初始 cqi 指示 spsinitcqiinduint8 半静态用户的初始 cqi 指示 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 1515 页页 maxharqmsg3txuint8 msg3 的最大 harq 传输次数 cqithreholduint8 深衰非深衰判决门限 ulharqmodeui

37、nt8 上行 harq 缺省重传方式 defaultresallocmodeuint8 下行缺省资源分配方式 uintefficyfactoruint8 归一化传输效率权重因子 uintqcifactoruint8 归一化 qci 权重因子 numberforrichangeuint8表示改变传输模式时，所需连续传输 ri 的次数，取值范围 1-127 basedpuschcqivaluint8 pusch 基准 cqi 值，取值范围：0-15 rrresunituint8 rr 算法资源粒度，取值范围：1-55 rrrbgresunituint8rr 算法下的资源粒度，type0 下一个 r

38、r 用户所占用的 rbg 数量，取值范围： 1-25 rarcqiinduint8 rar 用户初始 cqi 指示，取值范围：0-15 bpinitcqiinduint8 bp 的初始 cqi 指示，取值范围：0-15 ccchinitcqiinduint8ccch 用户的初始 cqi 指示，取值范围：0- 15 pdcchratiouint8上下行 pdcch cce 比例，取值范围：0- 10 puschhoppingmodeuint8pusch 跳频类型，0:不启用跳频， 1：type1 跳频类型；2：type2 跳频类 型 puschhoppingtype1bandwi dth uin

39、t8 pusch 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.6.1local om 通知其它模块开始数据采集消息

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

41、ocalpm 执行数据采 集的任务成功或失败。 方向：方向：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

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

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

44、localpm_otherm_get_perf_result 消息消息净净荷：荷： 无 复杂数据类型说明：复杂数据类型说明： 无 4.6.6其它模块向 local om 传送获取的采集数据消息 功能：功能：当采集周期到时，local pm 通知其它模块报送数据采集的结果，其它模 块传送结果给 localpm。 方向：方向：other module local pm 消息头：消息头： 参数类型含义 message typeenum消息类型 otherm_localpm_perf_result 消息消息净净荷：荷： 参数类型说明 moduleiduint16模块标识 具体定义如下： /* cont

45、rol plane */ rrm(mcb) ： 1 rrm (ue based,cpb)： 2 rrc(cpb)： 3 s1/x2(mcb)： 4 s1/x2(ue based,cpb)：5 /* user plane */ td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 1919 页页 pdcp： 11 mac： 12 rlc： 13 gtp-u： 14 /* operation /告警时间 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2121 页页 uint16ala

46、rmcode; /告警码 uint16 alarminstanceid; /告警实例 uint8 alarmstate; /告警状态 0 清除；1 产生 uint8 alarmsubtype; /告警类型 uint8 alarmseverity; /告警严重级别 uint16 alarmorirackid; /告警所在的板卡 rackid uint16 alarmorishelfid; /告警所在的板卡 shelfid uint16 alarmorislotid; /告警所在的板卡 slotid uint8 resv0; uint8 resv1; char extrainfo12; /附加信息

47、字段 char reserved1; /告警保留字段 ; /*告警类型定义*/ enum alarmhwtype alarm_communication = 1, /通信类告警 alarm_qos, /服务质量类告警 alarm_process, /处理器类告警 alarm_equipment, /设备类告警 alarm_environment /环境类告警 ; /*告警严重级别枚举*/ enum alarmseveritytype alarm_sev_critical = 1, alarm_sev_major, alarm_sev_minor, alarm_sev_warning, alar

48、m_sev_cleared ; 4.7.3getselfbid() 获取本板标识 功能：功能： 获取本板的 bid，其中包括：板卡机架号，机框号和槽位号。 接口：接口： static int32 basenodebomutility:getselfbid(bidtype 返回值：返回值： td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2222 页页 int32，操作结果。enodeb_ok：成功；enodeb_error：失败。 参数说明：参数说明： 参数名称类型说明 bidbidtype 返回值：返回值： uint16，板卡的 m

49、id。返回值为 0 表示输入参数有误。 参数说明：参数说明： 参数名称类型说明 bidconst bidtype 返回值：返回值： int32，操作结果，0 表示成功获得 ip 地址，非 0 表示各种失败情况。 参数说明：参数说明： 参数名称类型说明 miduint16板卡的 mid 标识。 ipaddruint32 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2424 页页 返回值：返回值： int32，操作结果，0 表示成功获得 ip 地址，非 0 表示各种失败情况。 参数说明：参数说明： 参数名称类型说明 miduint16

50、板卡的 mid 标识。 ipstrchar*输出参数，板卡的字符串形式的 ip 地 址。 复杂数据类型说明：复杂数据类型说明： 无 4.7.8getnodebip ()获取 nodeb ip 地址 功能：功能： 获取 enodeb 的 ip 地址 接口：接口： static uint32 nodebipmgr: getnodebip (); 返回值：返回值： uint32，操作结果，非 0 表示获得的 ip 地址， 0 表示失败 参数说明：参数说明： 无 4.7.9getnodebport ()获取 nodeb port 号 功能：功能： 获取 enodeb 的端口号 接口：接口： stati

51、c uint16 nodebipmgr: getnodebport (); 返回值：返回值： uint16，操作结果，非 0 表示获得的端口号， 0 表示失败 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2525 页页 参数说明：参数说明： 无 4.7.10 getnodebsysfuncid ()获取 nodeb 标识 功能：功能： 获取 enodeb 的标识 接口：接口： static uint32 basenodebomutility:getnodebsysfuncid（）; 返回值：返回值： uint32，操作结果，表示获

52、得的 enodeb 标识 参数说明：参数说明： 无 4.7.11 getnodebsysname()获取 nodeb 系统名称 功能：功能： 获取 enodeb 的名称 接口：接口： static int32 basenodebomutility: getnodebsysname (char* sysname); 返回值：返回值： int32，操作结果，0 表示成功获得 ip 地址，非 0 表示各种失败情况。 参数说明：参数说明： 参数名称类型说明 sysnamechar*输出参数，enodeb 的系统名称 4.7.12 getemcbmid()获取 emcb 板 mid 功能：功能： ecp

53、b 板上获取 emcb 板 mid。 接口：接口： static uint16 nodebomutility:getemcbmid(); td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2626 页页 返回值：返回值： uint16，操作结果，返回 mid， 若出现错误返回 invalid_mid。 参数说明：参数说明： 参数名称类型说明 无无无 以下接口为以下接口为 8144 专用的：专用的： 4.7.13 getdspip()获取 8144dsp 的 ip 地址 功能：功能： 获取本板 8144dsp 的 ip 地址 接口：接口：

54、 uint32 getdspip (); 返回值：返回值： uint32，操作结果，非 0 表示获得的 ip 地址， 0 表示失败。 参数说明：参数说明： 无 4.7.14 getpicoip()获取 pico 的 ip 地址 功能：功能： 获取本板 pico 的 ip 地址 接口：接口： uint32 getpicoip (); 返回值：返回值： uint32，操作结果，非 0 表示获得的 ip 地址， 0 表示失败。 参数说明：参数说明： 无 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2727 页页 4.7.15 getds

55、pmid()获取 8144dsp 的 mid 功能：功能： 获取 8144dsp 的 mid 接口：接口： uint16 getdspmid (); 返回值：返回值： uint16，表示获得的 mid。 参数说明：参数说明： 无 4.7.16 getecpbmid()获取 ecpb8548 的 mid 功能：功能： 获取 ecpb8548 的 mid 接口：接口： uint16 getecpbmid (); 返回值：返回值： uint16，表示获得的 mid。 参数说明：参数说明： 无 4.8cm 模块提供给 grm 的接口 4.8.1读表函数 4.8.1.1cm 给小区流程提供的接口 4.8

56、.1.1.1获取小区基本属性接口函数 4.8.1.1.1.1cm_getcellbasictable() 函数说明： 获得小区基本配置参数 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2828 页页 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 *pstcellbasictablecell_basic_table_s小区基本参数出参 4.8.1.1.1.2cm_getcellbasicinfolist（） 函数说明：获取所有小区基本表 参参 数数类类 型型含含 义义备注（

57、或取备注（或取 值）值） *pstcellbasicinfolistcell_basic_table_list_ s 小区基本参数列表出参 4.8.1.1.2获取小区逻辑无线资源参数接口函数 4.8.1.1.2.1cm_getsubframeassignmentinfo() 函数说明： 获得子帧配置参数 参参 数数类类 型型含含 义义备注（或备注（或 取值）取值） u32celliduint32小区 id入参 *pstsubframeassigninfosubframe_assignment_info_ s 子帧配置参数出参 4.8.1.1.2.2cm_getpucchinfo() 函数说明：

58、 获得 pucch 信道配置参数 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究院 机密机密 第第 2929 页页 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 *pstpucchinfopucch_info_spucch 信道参数出参 4.8.1.1.2.3cm_getpuschinfo() 函数说明： 获得 pusch 信道配置参数 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 *pstpuschinfopusch_info_sp

59、usch 信道参数出参 4.8.1.1.2.4cm_getpdschinfo() 函数说明： 获取 pdsch 配置参数 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 *pstpdschinfopdsch_info_spdsch 信道参数出参 4.8.1.1.2.5cm_getpdcchinfo() 函数说明： 获得 pdcch 信道配置参数 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 td-lte enodeb om 软件接口设计说明书 普天信息技术研究院普天信息技术研究

60、院 机密机密 第第 3030 页页 *pstpdcchinfopdcch_info_spdcch 信道参数出参 4.8.1.1.2.6cm_getpssinfo() 函数说明： 获得主同步信号参数 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 *pstpssinfopss_info_s主同步信号参数出参 4.8.1.1.2.7cm_getsssinfo() 函数说明： 参参 数数类类 型型含含 义义备注（或取值）备注（或取值） u32celliduint32小区 id入参 *pstsssinfosss_info_s次同步信号参数出参