问题处理与终检

问题处理

表 1 故障原因排查表

运行阶段	运行子项	报错具体内容	可能原因
前置检查	log初始化配置	Special characters are not supported for calibration tool path! Including but not limited to: ^&(),; and space character Please correct them and run again!	脚本路径中含有特殊字符。
	脚本运行时	python库文件错误	缺少对应库文件。
	COM申请链接	1.Error: EVK not responding 2.The serial port COM15 failed to open. Please check the serial port.	config中COM配置格式有误。 COM未连接或被占用。
	脚本运行时	OSError: Could not open VISA library Please make the following changes: Find the path to visa32.dll and place the path in visa.ResourceManager For example: visa.ResourceManager(C:\\Windows\System32\\visa32.dll)	环境未安装VISA或环境变量未正确配置。
	仪表初始化配置	1.Please check whether the CMW500 software is open or the instrument IP address is correct 2.Fail item : The selected instrument does not support or spell errors, please reselect the instrument 3.Please check whether the port is correct	仪表未开启或IP配置错误。 选择了不支持的仪表。 选择了仪表不支持的端口号。
	金板检测	Gold board can not run calibration.	制作金板后需要先清除数据后才能继续校准。
	线损初始化	1.Please check the PathLossTable.csv file path,the path does not exist 2.PathLossFile is not complete, no band	找不到同名的线损文件。 线损文件中Band重复或缺失。
	校准类实例初始化	Please check the RadioConfig.cal file path	找不到同名的校准文件。
校准阶段	发送AT时	serial timeout error	选择端口有误。 A核死机。 开机自动入网。
	selfcal	错误码返回不为0	错误码对应bit位不为0的项校准失败。
	xo cali	xo cali fail	信号过小导致结果超出门限。 晶振本身异常。
	rx ip2 cali	错误码返回不为0	校准失败。
	rx dc cali & tx dc cali	错误码返回不为0	校准失败。
	rx iq cali & tx iq cali	TRX iq cali fail	校准结果超出设定限制。
	rx agc gain cali	rx agc gain fail	Tx功率太低或者延时不够。
	tx power cali	tx power cali fail	校准结果缺少对应功率码字配置。 电流过大导致重启。
	校准文件写入Flash	tlv update fail	校准文件损坏或丢失。 PA配置错误导致rf初始化失败。
综测阶段	灵敏度测试	AT+NRDTEST返回ERROR	环境干扰过大或信号大小过低。
	ARB	ARB file is not existed	ARB波形文件不存在或放置位置不在指定路径下。
金板点检	tx power测量	Tx power is below limit. Please check the cable or the EVK	Tx功率过小，可能射频线连接异常。
温补提取	温补计算	Band has no normal temp value	没有测量该温度下的温补数据就直接计算。
	温补计算	Band mea data is not complete	温补测量数据不完整，可能被误删除。

产测配置问题

脚本路径错误

问题原因：校准脚本存放的路径中存在特殊字符如：^&(),;或者空格

解决方法：排查脚本路径下各个文件夹的命名是否有特殊字符，修改路径合法后再重新打开脚本运行。

python缺少库文件

缺少库文件会产生系统报错。通用 Python 环境配置参见开发环境快速入门，建议优先使用一站式 CLI 开发环境；缺失模块可从 PyPI 获取，或使用 RFTOOL 的环境配置功能完成准备。

COM口连接错误

常见端口错误有如下几种：

• 配置端口格式错误

  

  报错原因是在configuration文件中配置的仪表端口格式有误，不满足COMXXX格式的字符串，需要检配置文件是否输入错误。

• 端口未打开或占用

  

  报错原因是配置的端口未打开或者sscom中占用该端口未关闭，需要检查端口配置是否符合预期或者关闭端口。

• AT指令异常

  AT的返回中未带有'OK'会报serial timeout error；AT的返回中带有ERROR时会报Send (cmd) error错误。

解决方法：重新烧版本或者重启单板。

CFUN0 ERROR

问题原因：若上一次综测有异常退出的情况，在重新跑产测脚本时，脚本会自动发送“AT+CFUN=0”命令，此时该命令会报错。

解决方法：发送“AT+RESET”复位单板后再重新跑校准综测。

VISA资源库缺失

问题原因：此环境未安装VISA或者环境变量未正确配置。

解决方法：使用一键安装Python环境工具安装。

仪表连接错误

问题原因：一般为仪表的IP配置错误或者仪表未打开。

解决方法：

• 检查仪表IP正确且能ping通。
• 检查仪表是否打开（CMW100仪表本地软件）。

仪表选择错误

问题原因：configuration配置文件中选择的仪表类型'INSTRUMENTS_SELECT'选项选择了错误的仪表或者不支持的仪表。

解决方法：重新选择支持的三种仪表并以正确的格式填写，如果使用RFTOOL工具一般不会有此错误。

仪表端口错误

问题原因：选择了仪表不支持的端口。

图 1 LITEPOINT

图 2 CMW500

图 3 CMW100

解决方法：重新选择仪表所支持的端口号。

AT命令执行异常

现象为在某校准项或者某AT出现fail时，其返回值不为0或1。

问题原因：当前固件版本不支持该AT命令，固件版本与脚本版本不匹配或者当前单板有异常。

解决方法：

• 复位单板。
• 发送“AT+CGMR”读取固件版本信息，如不匹配则重新选择烧录版本。

制作金板后校准错误

问题原因：此单板制作了金板，一般制作金版前需要先进行校准，制作金版后不允许再重新进行校准。

解决方法：发送“AT+NGOLD=00”命令先清除金板数据后再重新进行校准，详细命令请参见《HiDiTingV100 2131E AT命令清单》“金板数据读写命令: +NGOLD”章节。

线损文件异常报错

常见线损文件异常如下两种：

• 找不到线损文件

  

  问题原因：可能是线损文件丢失或者线损文件名字错误。

• 线损文件Band配置错误

  

  问题原因：可能是线损文件配置的Band有重复或者缺失。

解决方法：确认线损文件路径正确，确保线损文件内容完整或更换新的线损文件。

校准文件读取失败

问题原因：校准文件名字错误

解决方法：将需要更改的校准文件配置放入“RadioConfig.cal”文件中，或者将需要更改的名字在脚本中同步更新。

制作金板时测量值波动过大

问题原因：制作金板或测量线损时，测量值tx power或rssi多次测量偏差过大。

解决方法：测量值不稳定可能受环境影响，请确认环境的影响并重新执行制作金板/测量线损。

测量线损值异常

问题描述：测量线损值超出门限导致异常退出。

解决方法：线损值异常（小于等于零或者大于CABLE_LOSS_DELTA_LIMIT时），排查射频线和仪表环境后重新测量；也可能是制作金板异常，重新制作金板后再测量线损。

校准问题

串行超时

AT未响应，常见原因为端口错误或A核死机或开机自动入网导致没有进入radio test模式。

解决方法：

1. reset单板。
2. 确认EVK端口是否正确。
3. 发送“AT+CGMR”查询是否有tlv版本号，检查校准文件是否损坏。

nrdexec返回状态码（自校准除外）

nrdexec命令的返回结果中包含状态码，如下图所示：

状态码指示：

0：校准成功；

1：校准失败；

2：校准参数错误；

3：校准类型错误或者不支持。

若返回状态码为2或3，常见原因是固件版本与校准版本不匹配，需要更换固件或脚本后重新校准。

自校准异常

该项校准为芯片内部自校准，以消除芯片做工的差异。涵盖校准项如下图所示：

校准的返回结果中包含的状态码如下：

bit位不为0的项校准失败。返回0表示所有项校准成功。

自校准响应超时，常见原因为开机自动入网导致没有进入radio test模式。

trx通路测试异常

校准前trx通路测试门限配置。

报错原因：trx通路异常导致测量值超出门限。

解决方法：排查仪表和射频线连接是否正常后重新校准，或者确定配置门限是否过小。

xo 校准异常

该项为XO校准，校准原理为在一定信号强度下RX收数计算频偏大小。

常见失败样例如下图：

失败原因为：

• 信号过小或过大会导致计算结果超出门限。
• 晶振本身问题。

解决方法：

• 排查仪表选择端口与连接是否一致。
• 排查脚本中配置的单板端口与实际需要校准的单板端口是否匹配。
• 检查线损是否过大，射频线是否拧紧。

rx ip2 校准异常

RX IP2校准用于消除TX信号经过双工器时在RX通道产生的IMD2产物。

常见错误：

• 校准失败，请参见“nrdexec返回状态码（自校准除外）”章节。
• 电流过大，ip2校准过程中TX会发送功率信号，如果电流过大会导致自动复位。

rx dc 校准 & tx dc 校准异常

DC校准用于消除器件产生的直流对有用信号的影响。

常见错误：校准失败，请参见“nrdexec返回状态码（自校准除外）”章节。

rx iq 校准 & tx iq 校准异常

IQ校准用于消除器件对信号分量振幅不同带来的影响。

常见错误：

• 校准失败，请参见“nrdexec返回状态码（自校准除外）”章节。
• 校准结果超出设定限制。门限值采用经验值设定，可以通过检测TX信号质量来判断门限值或者校准结果是否可靠。

rx agc 校准异常

AGC校准用于计算AGC各档位的增益值和带内不同频点的增益值差异。流程为先用仪表连续下发6dB递减的CW信号遍历8个档位，后再用中间档位和中间强度信号由低信道至高信道遍历频带内的增益差异。因此，AGC校准的返回结果中各项值差异不能过大。

常见错误：

• 校准失败，请参见“nrdexec返回状态码（自校准除外）”章节。
• 校准结果超出限制原因1，Tx功率太低或者延时不够导致仪表无法trigger没有及时下发连续信号。
• 校准结果超出限制原因2，对应频点线损太大，或者硬件RX通路问题。

Tx power校准异常

Tx power校准用于测量射频发送功率的能力，并计算得到发送对应强度功率所需要的码字。

常见错误：

• 校准失败，请参见“nrdexec返回状态码（自校准除外）”章节。
• 校准结果缺少对应功率码字配置，排查方向见后续。
• 电流过大导致重启，会显示serial错误等。

排查方向：

确认log中校准功率满足脚本中设置的最大功率和最小功率。

确认log中校准的PA模式划分功率满足校准文件（.cal）中设置的pa_ctrl配置，如果不满足，请根据Band调整“calibration_module/CalibrationClass.py”中的下图所示range范围，原则上最大功率过低左调左边界，最小功率过高右调右边界，调整的TX_POWER_TABLE中的range参数的取值只能为非负整数。

Tx power测量失败

问题原因：仪表测量Tx power时测量失败没有测到值。

解决方法：检查仪表链接正确和Tx是否通路后重新测量。

tlv 更新失败

报错命令是“AT+NRCUPD=2”返回failed，此命令用于单板重新加载tlv文件并初始化rf，产生错误的原因一般有两种：

• tlv文件有损坏或不完整。
• 烧录进去的校准文件PA配置有误或不匹配。

解决方法：重新烧录tlv或使用MIPI READ命令读取单板PA配置检查是否匹配。

校准前烧录校准文件

代码修改：

1. 在“calibration_module/CalibrationClass.py”文件中修改以下代码：

   

   

   

   

2. 在“calibration_module/CalibrationMain.py”文件中修改以下代码：

   

   

   

3. 在“calibration_test_configuration.py”文件中修改以下代码：

   

4. 在“calibration_test_main.py”文件中修改以下代码：

   

5. 在“user_tools/TxTempCompMea.py”文件中修改以下代码：

   

使用说明：

1. “calibration_test_configuration.py”文件中的CAL_UPDATE_IN_ADVANCE置为True，表示校准前烧写cal文件；置为False，表示校准前不烧写cal文件。
2. “calibration_test_configuration.py”文件中的CAL_SELECT置为True，表示自动读取单板里的PAid（pro_id+manuf_id），并找到对应的校准文件，PAid和校准文件名的映射关系通过“calibration_module/CalibrationClass.py”文件里的PA_RADIOCONFIG_CAL_SEL_TABLE配置；置为False，表示使用“RadioConfig.cal”校准文件。

3. 提取温补数据时，如果CAL_SELECT置为True，需要将“user_tools/TxTempCompLoad.py”里的“RadioConfig.cal”改为当前使用的校准文件名。

   

IQX仪表低概率出现连接异常

问题描述：IQX仪表压测上万片概率出现以下报错，重启仪表能够恢复。

问题原因：与设备的通信出现了I/O问题。这可能是因为设备忙未被正确释放。

解决方案：在配套综测工程的 instrument_driver/litepoint.py 文件中增加释放设备操作。

综测问题

脚本发送NRDTEST命令返回ERROR并异常退出

常见原因为信号过低、环境噪声太大。

解决方法：

• 调高对应Band的RX_DL_POWER。

  

• 降低环境干扰，在屏蔽箱或屏蔽房内进行综测。

ARB文件缺失异常退出

提示ARB文件不存在报错。

解决方法：

• 检查ARB文件放置的路径是否与错误提示中的路径一致。
• 检查是否在此路径有对应ARB文件。

综测时间异常（指标正常）

在配套综测工程的 instrument_driver/cmw500.py 或同目录的 cmw100.py 中按如下绿框添加：

仪表连接异常

产测失败，可排查日志中VI_ERROR类报错，出现“VI_ERROR_CONN_LOST (-1073807194): The connection for the given session has been lost. ”表示仪表连接丢失。

解决方法：检查仪表连接是否正常。

功能测试及终检

检查号码是否正确写入基本的功能，例如USIM（Universal Subscriber Identity Module，全球用户身份模块）功能测试，在模块最后的测试工位环节是必要的。

说明： Hi2131支持备份与恢复出厂设置，分别使用 AT&W0 和 AT&F0。产线流程建议在终检后完成一次出厂设置备份；接口不应在短时间内反复执行，最大备份次数为255次。