版本信息获取方法、错误码获取方法和镜像加载方法

摘要

本发明提供一种版本信息的获取方法，包括以下步骤：在射频板卡xml脚本中增加版本描述字符串；根据xml脚本编译生成源码，版本描述字符串的信息载入源码的注释栏中；根据源码编译生成镜像；注释栏中的版本描述字符串的信息载入到镜像的major及minor version中的reserved区域；通过向5G模块发送AT命令和命令参数，从reserved区域获取版本描述字符串的信息。本发明还提供一种错误码的获取方法和镜像的加载方法。本发明通过AT命令能够获取版本信息、获取下载版本所需的Service地址等配置信息、获取故障的错误码，减小人力投入分析工作量，降低维护成本，提高客户满意度。

说明书

技术领域

本发明涉及基于高通平台的射频板卡研发和生产的技术领域，尤其涉及一种版本信息和错误码的获取方法以及镜像的加载方法。

背景技术

目前高通5G(5th-Generation，第五代移动通信技术)平台软件射频板卡(例如SDX24、SDX55平台的射频板卡框架)的镜像加载策略，该策略大致分为三步:

1、射频板卡的xml(Extensible Markup Language，可扩展标记语言，也做文件扩展名)文件编译生成射频板卡源码；

2、射频板卡源码编译生成独立的射频板卡镜像并挂载到高通指定的文件系统的分区下；

3、高通5G模块modem开机装载基于所述分区下的射频板卡镜像到内存并启动该射频板卡镜像运行。

其中，modem是基带处理器，用于调制/解调5G等无线射频信号及基于3GPP(3rdGeneration Partnerships Project，第三代移动通信合作计划)协议栈调度管理等。modem主要包含两个功能块即射频板卡镜像和协议栈镜像。射频板卡镜像基于xml文件自主开发，其源码开源；协议栈镜像由高通提供，其源码不开源，协议栈镜像的版本即为高通基线版本。

xml文件中原有的version的范围为bit11～bit0，可用数值范围太小，并且不同项目运用同一套version，难以对不同项目的版本加以区分。该version仅仅提供版本参考，查询该版本号对应的xml文件需要一套庞大的管理系统与其映射对应，而这样牵动的资源不可估量，例如：A负责前期不同项目及不同xml文件的版本仓储维护，B负责射频团队分析查询等，C负责客户模组的射频板卡新的需求再定制维护管理等。

射频板卡镜像的挂载过程为：SDX55平台中处理器核开机运行Linux通过后，会挂载Nand flash(非线性宏单元模式)协议栈镜像和射频版本镜像到处理器核指定分区下，处理器核先搬迁协议栈镜像到内存并通知modem启动运行，协议栈镜像运行后基于modem与处理器核之间的通信接口，例如TFTP(Trivial File Transfer Protocol，简单文件传输协议)等，向处理器核请求获取射频版本镜像到modem内存空间随即运行该射频板卡镜像。

类似高通5G平台软件射频板卡的镜像加载策略，存在如下缺陷或不能满足如下场景需求：

1、在现有版本管理记载中无法从运行中的射频版本镜像直接追溯射频板卡变更版本号，客户的射频相关问题无法直接追溯射频源码，需要花费大量时间核对射频板卡镜像的源码来源，维护成本大。

2、由于无法获取下载版本所需的Service地址等配置信息，导致无法通过远端网络升级射频板卡镜像，因此无法满足客户因射频功能或性能调试单独升级射频板卡镜像、或因射频板卡存在功能或性能级漏洞，而完成升级射频板卡修复。

3、由于射频板卡镜像加载方式，容易出现5G模块开机加载射频板卡失败，例如TFTP服务器故障等，而没有射频板卡备用镜像的二次加载，造成客户无法使用。

4、由于需要加载的射频器件数量多，射频器件数量是9X07的4G平台的5倍及以上，以及射频通路复杂性极高，需要匹配3G(3rd-Generation，第三代移动通信技术)/4G(4th-Generation，第四代移动通信技术)/5G/CA(Carrier Aggregation，载波聚合)/ENDC(EUTRA-NR Dual Connectivity，4G和5G双连接)等射频配置，射频板卡在开机加载出现失败或功能初始化失败，即射频板卡加载成功但射频板卡的内部规则校验不过，例如：未找到射频某个器件等的场景多样且排查难度高，高通在用户层面未提供较为快速问题定位的方法，故出现失败后存在极大的人力投入分析成本及小概率的客户问题被迫丢弃后的安全隐患。

发明内容

本发明要解决的技术问题是为了克服现有技术中无法获取版本信息、获取下载版本所需的Service(服务)地址等配置信息、获取故障的错误码的缺陷，提供一种版本信息和错误码的获取方法以及镜像的加载方法。

本发明是通过下述技术方案来解决上述技术问题：

本发明提供一种版本信息的获取方法，包括以下步骤：

在射频板卡xml脚本中增加版本描述字符串；

根据xml脚本编译生成源码，所述版本描述字符串的信息载入所述源码的注释栏中；

根据所述源码编译生成镜像；

所述注释栏中的所述版本描述字符串的信息载入到所述镜像的major及minorversion中的reserved区域；

通过向5G模块发送AT命令和命令参数，从所述reserved区域获取所述版本描述字符串的信息。

较佳地，所述命令参数为QRFVERSION。

较佳地，通过向5G模块发送AT命令和命令参数后，切换所述5G模块进入工程模式，所述5G模块从所述reserved区域获取所述版本描述字符串的信息。

本发明还提供一种错误码的获取方法，包括以下步骤：

出现射频板卡无法使用的故障时，5G模块判断故障类型；

5G模块按照所述故障类型上报对应的错误码。

较佳地，所述故障类型包括：射频板卡依赖的NV(非易失性随机访问存储器，高通平台采用NV保存参数)数据丢失、射频板卡加载失败、射频板卡加载pass但射频板卡中的射频器件出现故障、其他故障；

所述其他故障为所述射频板卡依赖的NV数据丢失、所述射频板卡加载失败和所述射频板卡加载pass(成功)但射频板卡中的射频器件出现故障以外的故障。

较佳地，所述5G模块判断故障类型的步骤包括：

识别所述故障类型是否为射频板卡依赖的NV数据丢失；

根据高通的rf_mbn_load函数的执行返回状态来识别所述故障类型是否为射频板卡加载失败；

根据高通的rf_device_scan函数的执行返回状态来识别所述故障类型是否为射频板卡加载pass但射频板卡中的射频器件出现故障；

所述故障类型不是所述射频板卡依赖的NV数据丢失、所述射频板卡加载失败、所述射频板卡加载pass但射频板卡中的射频器件出现故障，则所述故障类型为其他故障。

较佳地，所述故障类型为所述其他故障时，所述5G模块按照所述故障类型上报对应的错误码的步骤包括：

切换5G模块进入工程模式；

调用高通的RF_debug接口获取射频板卡自开机后到初始化Fail(失败)的状态信息；

根据所述的状态信息解析出Fail点；

所述的Fail点的信息编入所述错误码；

上报所述错误码。

本发明还提供一种镜像的加载方法，包括以下步骤：

待升级射频板卡镜像上传到指定的Service地址及端口限定的存储空间；

通过向5G模块发送AT命令和命令参数，所述命令参数包括所述Service地址和所述端口；

所述5G模块激活一路独立的PDP(Packet Data Protocol，分组数据协议)数据链路场景并获取所述PDP的IP(Internet Protocol，网际互连协议)地址；

所述5G模块根据所述PDP的IP地址向所述存储空间请求并获取射频板卡镜像；

所述5G模块自动重启并在开机过程中完成射频板卡镜像的替换。

较佳地，所述通过向5G模块发送AT命令和命令参数，所述命令参数包括所述Service地址和所述端口的步骤包括：

通过向5G模块发送AT+QRFMBNUPDATE＝address,port，其中所述命令参数还包括QRFMBNUPDATE，所述address为所述Service地址，所述port为所述端口。

较佳地，获取的所述射频板卡镜像包括主用版本和备用版本；

所述主用版本加载失败时，将所述备用版本备份至高通指定的modem文件系统中，触发整机重启并加载所述备用版本。

本发明的积极进步效果在于：通过AT命令能够获取版本信息、获取下载版本所需的Service地址等配置信息、获取故障的错误码，减小人力投入分析工作量，降低维护成本，提高客户满意度。

附图说明

图1为实施例1的版本信息的获取方法的流程图。

图2为实施例2的错误码的获取方法的流程图。

图3为实施例2的错误码的获取方法中的5G模块判断故障类型的流程图。

图4为实施例2的错误码的获取方法中的5G模块按照其他故障上报对应的错误码的流程图。

图5为实施例3的镜像的加载方法的流程图。

具体实施方式

下面通过实施例的方式进一步说明本发明，但并不因此将本发明限制在所述的实施例范围之中。

实施例1

本实施例提供一种版本信息的获取方法。参照图1，版本信息的获取方法包括以下步骤：

步骤S11、在射频板卡xml脚本中增加版本描述字符串。

步骤S12、根据xml脚本编译生成源码，所述版本描述字符串的信息载入所述源码的注释栏中。

步骤S13、根据所述源码编译生成镜像。

步骤S14、所述注释栏中的所述版本描述字符串的信息载入到所述镜像的major及minor version中的reserved区域；

其中，使用注释栏解析函数解析注释栏得到所述版本描述字符串的信息。major及minor version以及其中的reserved区域为高通平台中的定义。

步骤S15、通过向5G模块发送AT命令和命令参数，从所述reserved区域获取所述版本描述字符串的信息；

其中，命令参数的具体名称为自定义。命令参数用于区分和识别AT命令的具体功能，以及传递参数信息。可以根据需要设置命令参数。

具体实施时，所述命令参数为QRFVERSION。

具体实施时，通过向5G模块发送AT命令和命令参数后，切换所述5G模块进入工程模式，所述5G模块从所述reserved区域获取所述版本描述字符串的信息。

其中，xml脚本中增加版本描述字符串，xml脚本经过压缩加密等编译生成源码，源码编译生成镜像，xml脚本、源码和镜像均包含版本信息，即通过xml脚本中的版本描述字符串建立了xml脚本、源码和镜像之间的版本信息的相互关联。随着5G模块加载射频板卡镜像，射频板卡的版本信息存储于5G模块中的reserved区域。5G模块运行后，通过AT+QRFVERSION向5G模块发送请求射频板卡版本号，5G模块切换到工程模式获取reserved区域的字段并转换成版本描述字符串响应AT命令请求，呈现射频板卡的版本信息，然后5G模块自动切回正常工作模式。

另外，xml脚本、源码和镜像可以互逆转换，镜像可以反编译生成源码，源码可以反编译生成xml脚本。获取了镜像或者源码，可以反编译得到xml脚本，并读取xml脚本中的版本描述字符串。

本实施例在射频板卡xml脚本中增加版本描述字符串，编译后射频板卡镜像包含版本描述字符串的版本信息，通过AT命令能够获取版本信息，实现射频板卡镜像版本的精确跟踪，便于从射频板卡镜像追溯对应版本的xml脚本，减小人力投入分析工作量，降低维护成本，提高客户满意度。

实施例2

本实施例提供一种错误码的获取方法。参照图2，错误码的获取方法包括以下步骤：

步骤S21、出现射频板卡无法使用的故障时，5G模块判断故障类型；

其中，出现射频板卡无法使用的故障表现为：无法注册网络，并且通过AT+CFUN？(查询射频板卡初始化Pass状态，CFUN？为命令参数)查询到非1的异常状态。如果5G模块开机出现射频板卡初始化Pass会上报该状态，检查该状态即可知道射频板卡初始化是否成功。命令参数的具体名称为自定义。命令参数用于区分和识别AT命令的具体功能，以及传递参数信息。可以根据需要设置命令参数。

步骤S22、5G模块按照所述故障类型上报对应的错误码；

其中，5G模块会间歇性主动上报+QRFERROR:xx，xx为错误码，QRFERROR表示上报的信息为错误码。

具体实施时，所述故障类型包括：射频板卡依赖的NV数据丢失、射频板卡加载失败、射频板卡加载pass但射频板卡中的射频器件出现故障、其他故障；

所述其他故障为所述射频板卡依赖的NV数据丢失、所述射频板卡加载失败和所述射频板卡加载pass但射频板卡中的射频器件出现故障以外的故障。

具体实施时，参照图3，所述5G模块判断故障类型的步骤包括：

步骤S211、识别所述故障类型是否为射频板卡依赖的NV数据丢失。

步骤S212、根据高通的rf_mbn_load函数的执行返回状态来识别所述故障类型是否为射频板卡加载失败。

步骤S213、根据高通的rf_device_scan函数的执行返回状态来识别所述故障类型是否为射频板卡加载pass但射频板卡中的射频器件出现故障。

步骤S214、所述故障类型不是所述射频板卡依赖的NV数据丢失、所述射频板卡加载失败、所述射频板卡加载pass但射频板卡中的射频器件出现故障，则所述故障类型为其他故障。

具体实施时，参照图4，所述故障类型为所述其他故障时，所述5G模块按照所述故障类型上报对应的错误码的步骤包括：

步骤S221、切换5G模块进入工程模式。

步骤S222、调用高通的RF_debug接口获取射频板卡自开机后到初始化Fail的状态信息。

步骤S223、根据所述的状态信息解析出Fail点。

步骤S224、所述的Fail点的信息编入所述错误码。

步骤S225、上报所述错误码。

其中，错误码可以包括子错误码，对故障类型进一步划分和定位。例如，参见下表，射频板卡加载失败的故障类型包括4个子故障类型：

故障类型和子故障类型包括但不限于前述的内容，错误码和子错误码包括但不限于数字和/或字母，可以根据需要设置故障类型、子故障类型、错误码和子错误码。

本实施例通过故障识别和上报机制，获取故障的错误码，精确快速地定位故障，减少定位故障花费的时间，减小人力投入分析工作量，降低维护成本，提高客户满意度。

实施例3

本实施例提供一种镜像的加载方法。参照图5，镜像的加载方法包括以下步骤：

步骤S31、待升级射频板卡镜像上传到指定的Service地址及端口限定的存储空间。

步骤S32、通过向5G模块发送AT命令和命令参数，所述命令参数包括所述Service地址和所述端口；

即，通过向5G模块发送AT+QRFMBNUPDATE＝address,port，其中所述命令参数还包括QRFMBNUPDATE，所述address为所述Service地址，所述port为所述端口。

步骤S33、所述5G模块激活一路独立的PDP数据链路场景并获取所述PDP的IP地址；

其中，如果5G模块无法自动激活一路独立的PDP数据链路场景并获取所述PDP的IP地址，可以通用AT+QICSGP完成该操作，QICSGP为命令参数。

步骤S34、所述5G模块根据所述PDP的IP地址向所述存储空间请求并获取射频板卡镜像。

步骤S35、所述5G模块自动重启并在开机过程中完成射频板卡镜像的替换。

其中，在5G模块联网通过网络进行升级的场景下，可以采用特殊协议，如LWM2M(Lightweight Machine-To-Machine，轻量级物联网协议)等，使用所述镜像的加载方法加载待升级的射频板卡镜像。例如，设置射频板卡升级服务器-客户端系统，通过AT命令触发5G模块获取授权升级密钥，启动5G模块的射频板卡升级客户端下载AT命令中所指定的Service(此处为射频板卡升级服务器)地址等配置信息，将Service端射频板卡镜像下载到本地并完成镜像的校验及替换，完成射频板卡镜像的网络升级。也可以通过处理器核的源码的开放性定制交互接口驱动，如USB(Universal Serial Bus，通用串行总线)接口，实现射频板卡镜像的替换升级。

在本实施例中，命令参数的具体名称为自定义。命令参数用于区分和识别AT命令的具体功能，以及传递参数信息。可以根据需要设置命令参数。

在一种具体实施方式中，获取的所述射频板卡镜像包括主用版本和备用版本。所述备用版本为轻量级低配版本，所述备用版本的配置比所述主用版本低，所述备用版本实现的功能比所述主用版本少。所述主用版本加载失败时，将所述备用版本备份至高通指定的modem文件系统中，触发整机重启并加载所述备用版本，保证5G模块正常启动及实现基本的网络功能。

其中，高通默认的镜像加载机制是modem加载协议栈镜像后，会先检查modem文件系统是否存在射频板卡镜像，如果存在射频板卡镜像则加载射频板卡镜像。本实施例通过识别5G模组本次开机射频板卡的加载失败，触发将保存在处理器核文件系统下的射频板卡镜像的备用版本下载到高通默认的modem的文件系统下后，触发整机重启，以加载该备用版本。

本实施例获取下载版本所需的Service地址等配置信息，通过网络获取射频板卡镜像，在主用版本加载失败时加载备用版本，确保射频板卡镜像的基本功能的实施，降低维护成本，提高客户满意度。

虽然以上描述了本发明的具体实施方式，但是本领域的技术人员应当理解，这仅是举例说明，本发明的保护范围是由所附权利要求书限定的。本领域的技术人员在不背离本发明的原理和实质的前提下，可以对这些实施方式做出多种变更或修改，但这些变更和修改均落入本发明的保护范围。