AD9361 RSSI测量与校准：从寄存器配置到功率换算的工程实践

第一次用AD9361做接收功率监测的时候，我踩了一个很基本的坑：名字里带RSSI，我就以为它是射频前端对数检波器，配置完寄存器之后，读一个数字，直接换算成dBm。结果信号源从-40dBm扫到-10dBm，寄存器读数变了没错，但变化幅度完全不成比例，甚至在某些增益点上回跳。后来把AD9361的接收链路框图、AGC状态和测量窗口全部拉通，才把RSSI读数做成一个在要求范围内可用的功率测量值。这篇文章就围绕AD9361 RSSI配置展开，记录我从寄存器使能、测量窗口、结果换算到实际校准的完整过程，也把调试中遇到的坑逐个还原。适合正在用AD9361做TDD收发、频谱监测或AGC策略开发，希望对RSSI读数做工程化处理的朋友参考。

1. 先把RSSI的测量链路捋清楚：它在AD9361里到底怎么工作

1.1 RSSI测的不是天线口，而是内部节点的信号强度

AD9361的接收链路并不是把天线口信号直接送到一个检波器里。从天线口进来，信号要依次经过LNA、混频器、TIA、低通滤波器、PGA，最后才到ADC完成数字化。RSSI测量模块实际上工作在基带模拟或ADC附近，它对经过射频前端放大之后的IQ信号做幅度统计，而不是在天线口直接测量。

这会带来一个很多人刚开始不理解的结论：同样一个输入功率，如果接收增益设置不同，RSSI寄存器读出来的值会完全不同。比如输入-50dBm，手动增益调高时，内部节点信号被放大很多，RSSI寄存器值自然偏大；手动增益调低时，内部节点信号接近量程底部，RSSI寄存器值就偏小。这不是芯片坏了，而是测量点本来就在高增益节点之后。

用个生活化的类比：RSSI模块相当于在你家功放后面接了个电压表，测的是功放输出端的电平，而不是插在功放前的音源信号有多强。想知道音源有多强，必须知道功放当前放大了多少倍，再反推回去。AD9361的增益表就是用来做这件事的。所以在配置RSSI之前，先要有这个全局认识：你读到的原始值和输入功率之间隔着一层增益，不能画等号。

1.2 测量窗口决定了你读到的是平均值还是瞬时值

RSSI不是对一个时刻的信号拍一张照片，而是在一段可配置的时间窗口内对信号做平均。这个窗口在寄存器里配置，工程上习惯叫测量时长或积分时间。窗口长短直接决定了读数的稳定性，也决定了你能反映多快的信号变化。

我最早测试的时候，把测量窗口配得很短，想让它快速响应。结果一个常规的OFDM调制信号读出来，数值在2～3dB范围内来回跳，均值看起来还行，但单次读数完全不敢用来做功率判断。后来把窗口拉长，读数稳定了很多，代价是响应变慢。这就是测量窗口的典型取舍：窗口短，跟踪快但方差大；窗口长，读数稳但反应慢。

还要注意信号帧结构。如果被测信号是TDD帧或者周期性突发信号，窗口必须尽量落在有效数据段内。窗口如果跨在信号和静默期之间，相当于把噪声段的低功率也平均进去，读出的RSSI会比真实突发功率低一截。这种情况下，单纯拉长窗口反而会让误差更大，正确做法是把RSSI测量窗口和收发帧同步信号对齐，或者至少在帧中间的有效负载区读取。

1.3 AGC和RSSI的闭环关系，是读数不稳定的最大来源

AD9361有手动增益模式，也有快速AGC、慢速AGC等自动增益模式。自动增益算法的核心输入就是RSSI测量结果，而RSSI读出的值又受当前增益影响。这是一个闭环：输入功率变化会触发AGC调整增益，增益改变后又会让RSSI内部值发生跳变。

所以你在AGC模式下读RSSI，经常会看到一种奇怪现象：信号源功率缓慢上升，RSSI读数却呈现阶梯状回跳，甚至会出现“输入功率变大，RSSI读数反而变小”的瞬间。这不是测量错误，而是AGC刚刚切换了增益档位，新的增益还没被RSSI读数补偿掉。

如果你做的是“绝对功率测量”，建议在手动增益模式下完成校准和读取；如果必须用AGC，至少要同时读出当前增益索引，把RSSI原始值经过增益补偿后再输出。这个补偿的细节我放在第三节细说，这里先记住一个原则：RSSI读数和AGC状态必须一起看，分开读等于闭着眼睛测量。

2. 寄存器配置逐条拆：从测量使能到结果读取的完整流程

2.1 不知道寄存器是什么的读者，先看这个内核

寄存器可以理解成芯片内部的一排“遥控开关和刻度旋钮”，每个bit控制一个开关，每个字节保存一个配置值。AD9361通过SPI接口访问这些寄存器，要配置哪个功能，就往对应地址写对应的二进制值；要读结果，就从指定地址读值。

对于RSSI来说，我们至少需要配置三个层面的东西：使能与工作模式、测量窗口、结果读取。很多例程里只写一个使能位就去读结果，发现读数不对，往往是因为窗口没配、模式没选对，或者结果寄存器的符号扩展没处理好。后面我会给出一个完整顺序。

需要提前说明的是：以下寄存器地址和位定义，以我手头常用的AD9361寄存器手册Rev.B/C为参考。不同版本、不同平台、甚至不同内核驱动覆盖的寄存器可能有差异，落地前一定以ADI官方最新Register Map为最终依据。直接照抄网上代码翻车的大有人在。

2.2 常用RSSI相关寄存器一览

这张表只解决“从无到有”的问题。实际使用时，不要一次把所有寄存器都填满，而是先配置0x294和0x295，读取0x296、0x297，确认数值随信号源变化；只有在需要精细校准时才去碰偏移补偿寄存器。很多底层驱动只看0x296一个字节，0x297在多数场景下可以当作分辨率扩展位来读，但如果你的芯片版本不支持，读出来可能是固定的0x00，这种情况不要硬解。

2.3 一套稳妥的寄存器配置顺序和伪代码

我推荐的配置顺序是：先复位/失能，再配窗口，再配模式，最后使能。这么做的好处是避免芯片在配置过程中执行半个测量周期，把中间态的脏数据当成有效结果。

uint8_t reg_val; // 1. 读取当前0x294，把bit0清零，先失能RSSI spi_read(0x294, &reg_val); reg_val &= ~0x01; spi_write(0x294, reg_val); // 2. 配置测量窗口，0x295的具体编码以手册为准 spi_write(0x295, duration_code); // 3. 配置为单次模式，并使能RSSI reg_val = read_reg(0x294); reg_val &= ~0x02; // bit1 = 0，单次模式 reg_val |= 0x01; // bit0 = 1，使能RSSI spi_write(0x294, reg_val); // 4. 等待至少一个测量窗口加余量 delay_us(measurement_window_us * 2); // 5. 读取结果 spi_read(0x296, &hi); spi_read(0x297, &lo);

如果使用连续模式，把第3步的bit1置1即可。连续模式下，芯片会持续刷新RSSI结果，你只需要等待固定间隔后读取。单次模式则一般需要先触发一次测量，再等待完成标志，读完后数据可能保持到下一次触发。这个差异极易让人踩坑，我在第四节会专门展开。

2.4 寄存器写没写进去，怎么确认

寄存器配置最隐蔽的问题不是配错，而是没写进去。AD9361某些寄存器存在写入保护或需要在初始化序列之后才能修改；如果你用的是官方Linux驱动或者No-OS例程，驱动可能在初始化末尾又覆盖了你的设置。比如你在应用层裸写了一个SPI命令配置RSSI，但驱动同步状态机在后台把寄存器刷新回默认值，你的配置就白写了。

排查方法很简单，写完之后马上回读。把0x294读出来，确认bit0和bit1和你写进去的值一致。如果回读不一致，优先怀疑SPI读写时序。用逻辑分析仪抓一下SPI波形，确认片选、时钟极性、数据位宽都对得上。AD9361的SPI通常支持多字节读写，但有些平台的SPI控制器默认8位模式，和芯片期望的16位命令头不一致，也会导致寄存器写入无效。

还有一个常见情况：你在FPGA里通过AXI接口直接读寄存器，读回来的数值看起来合理，但实际读的是驱动软件映射的备份寄存器，而不是芯片内部同一地址的真实寄存器。这种问题最坑，因为数据有变化、有规律，就是不对。处理方法是先通过官方驱动例程读一次作为基准，再和你的读操作对比。

3. 从寄存器原始值到dBm：增益补偿、偏移校准与换算公式

3.1 原始RSSI是有符号的dB值，不是线性电压

很多初次接触AD9361 RSSI的人，会习惯性地把寄存器读数当成一个无符号整数，然后除以某个系数得到功率值。这是一个高频错误。AD9361的RSSI结果本质上是dB域的带符号值，弱信号通常显示为负值，强信号可能接近0或正值。

如果直接按无符号数处理，一个表示-6dB的0xFA会被读成250，换算出来完全失控。正确做法是先做符号扩展：

int8_t rssi_db = (int8_t)hi; int32_t rssi_mdb = rssi_db * 1000 + lo * 1000 / 256;

这里我把结果统一成mdB，也就是千分之一dB，便于后续整数运算和拟合。如果只读高字节，就直接用(int8_t)hi * 1000。要注意的是，这个值到底是“相对于ADC满量程的dB”，还是“经过内部校准后的绝对dB”，不同固件版本和驱动处理方式不一样，所以我一般不会只依赖寄存器手册的公式，而是用信号源做一次标定，把寄存器的原生刻度映射到实际功率。

3.2 增益表参与换算：为什么RSSI不能直接当输入功率

前面说了，RSSI模块测的是内部节点信号强度。假如RSSI寄存器指示内部节点为-20dBFS，当前接收链路总增益是50dB，那么天线口的输入功率大约是：

P_input_dBm = RSSI_internal_dBmFS - G_total_dB + C_baseline_dBm

这个式子里的符号看起来有点绕，但逻辑并不复杂：内部节点信号越强，可能是输入功率高，也可能是增益高。要反推输入功率，就得把增益贡献扣除。G_total_dB是当前LNA、TIA、PGA各级增益之和，通常可以从增益索引表里查到。C_baseline_dBm是基准条件下的校准偏移，用来抵消板级插损、balun损耗、滤波器插损和ADC满量程参考电平等因素。

实际操作中，我不会每次都用公式手算，而是把增益索引、RSSI原始值、实测功率三者做成一张查询表。手动增益模式下，每个固定增益索引对应一条RSSI和输入功率的曲线；AGC模式下则根据当前增益索引选择对应的偏移表项，再对RSSI做补偿。这样比单点公式稳健得多，尤其在高增益下接近底噪、低增益下接近饱和时，分段查表能明显减小误差。

3.3 用信号源做一次完整标定，比套公式更可靠

拿到一块新板子，我最先做的不是精读寄存器手册，而是架一套最简单的标定环境：信号源接接收端口，配置好载波频率、采样率和接收增益，然后从-60dBm到0dBm按2dB步进扫功率，读取每个功率点下的RSSI原始值。

扫完之后把数据画出来，你会看到一条类似“S曲线”的形状。中间线性区，RSSI原始值和输入功率基本成正比；靠近底噪时，读数会被噪声底托住，不再继续下降；靠近饱和时，RSSI读数会逐渐压缩，不再继续上升。所以标定不能只看一个点，至少要把工作动态范围的上下边界都测出来，然后在中间区用线性拟合，在两头做成查表。

一个简洁的做法是把“输入功率”作为横轴，“RSSI原始值”作为纵轴，用最小二乘拟合一条一次函数：

P_input_dBm = a * RSSI_raw_dB + b

再把拟合残差检查一遍。如果残差呈明显弯曲，就改用分段线性或者二阶多项式。每块PCB的插损、每个芯片的离散性都不一样，所以这个a和b不能共用，一定要逐板标定。标定后保存到EEPROM或者板载配置文件中，产线校准的流程后面第五节再详细说。

4. 我在实际调试中踩过的五个坑及完整排查链路

4.1 坑一：AGC开着时RSSI来回跳

现象很典型：信号源固定输出-40dBm，RSSI读数却在-38dBm和-45dBm之间来回跳，像接触不良一样。排查的第一步不是怀疑寄存器，而是把射频信号源关掉，看RSSI是否稳定在噪声底附近。如果噪声底稳定，再恢复信号，切到手动增益模式，把增益固定在某一个档位，重新读取RSSI。

我在实际测试中就是这样定位的：切到手动增益后，RSSI立刻稳定了，问题根源就是AGC在-40dBm附近处于增益切换的临界区，两个相邻增益档之间来回切换，导致RSSI产生一个“台阶跳变”。这不是测量模块的问题，而是增益闭环的特性。解决办法是读取当前增益索引，用增益索引和RSSI一起输出；或者在应用层做迟滞滤波，只接受跨越一定时间或一定幅度的变化。

4.2 坑二：信号变化，RSSI纹丝不动

这个坑我写在第二位，因为它最容易让人怀疑芯片坏了。现象是信号源功率从-50dBm一直加到-20dBm，RSSI读数一直停在某个值，最多动0.1dB。收到这种问题，先回读0x294确认使能位，再确认0x295的测量窗口是否写入成功。如果使能位为0，说明你的配置根本没生效。

还有一种可能：你读的是结果寄存器，但芯片处于单次模式，且没有触发新的测量，所以你每次读到的都是同一次测量结果。这个情况下，信号变了，结果不变是完全正常的。正确做法是配置成连续模式，或者在单次模式下先写触发位，等待测量完成后再读。还有一部分板卡是把RSSI结果映射到某个内部FIFO里，读一次之后自动清除，你必须保证每次读取都和信号变化顺序匹配。

4.3 坑三：调制信号和CW的读数总差一截

同样是标称功率相同的信号，CW正弦波和调制信号（比如OFDM）读出来的RSSI经常不一样。很多人第一反应是芯片测量不准，但实际上很可能是测量窗口和信号统计特性不匹配。

CW信号幅度恒定，窗口长短影响不大；OFDM信号峰均比高，短窗口内如果有大峰值，平方检波后的平均值会明显波动。这时候把窗口拉长到覆盖多个OFDM符号，读数会稳定很多。如果系统对响应速度有要求，不能无限加长窗口，就采用多次读数求平均的方案：比如连续读8次，去掉最大最小，再取中间6次的平均值，实测下来对突发信号的稳定性改善明显。

4.4 坑四：单次模式读出来的还是上一次的旧值

这个坑特别容易在FPGA实现里出现。FPGA上电后，配置完RSSI，然后等了一段时间，读到的结果看起来合理，但后续每次读取都是同一份数据。问题在于单次模式的“测量完成”标志处理顺序不对。

排查链路是这样的：先确认当前是单次还是连续模式，再确认读取之前有没有触发新的测量。很多版本的AD9361需要把0x294里的触发位先写1再写0，才能启动一次新的测量；读结果寄存器可能本身就会清除完成标志。如果你的软件只做“延时就读”，完全没写触发位，那读到的自然永远是第一次测量的值。解决方法是把单次模式换成连续模式，或者严格按手册状态机处理触发和读流程。

4.5 坑五：Linux驱动或No-OS例程把寄存器“悄悄”改了

这类问题在Linux平台上最明显。你在应用层用SPI直接写了一个RSSI配置，结果下一次调用ad9361_get_rssi或者读IIO属性时，读数又回到默认状态。原因不是你写错了，而是驱动在初始化、配置带宽或者配置采样率时，会把整个接收链路相关的寄存器组重新写一遍，你的设置就被覆盖了。

排查方案不是和驱动硬刚，而是优先使用官方API。ADI的No-OS工程和libad9361-iio驱动里已经封装了RSSI读取接口，直接调用官方接口，可以避免寄存器被覆盖的问题。如果你确实需要裸寄存器配置，比如在FPGA里自己实现RSSI监控，那么记住一个原则：所有RSSI相关配置必须在系统初始化完成之后进行，并且在配置完成后做一次完整回读，而不是只在启动阶段写一次。

5. 一个可直接落地的FPGA/ARM读取RSSI示例

5.1 最简读取代码与解释

下面这段代码是我在实际项目中用过的最小读取函数，适合ARM裸机或RTOS环境。假设SPI读写函数已经存在，这里只关注RSSI逻辑。

int32_t read_ad9361_rssi_mdB(void) { uint8_t hi = 0, lo = 0; ad9361_spi_read(0x296, &hi, 1); ad9361_spi_read(0x297, &lo, 1); int8_t rssi_db = (int8_t)hi; int32_t rssi_mdb = (int32_t)rssi_db * 1000 + ((int32_t)lo * 1000) / 256; return rssi_mdb; }

这段代码默认0x297是分辨率扩展位。如果你确认芯片版本和驱动都只支持8bit结果，可以把第二行读取去掉，直接返回rssi_db * 1000。实际项目里，我建议加一个连续读取10次求平均的接口，避免单次读数抖动过大：

int32_t read_ad9361_rssi_avg(uint8_t count) { int64_t sum = 0; for (uint8_t i = 0; i < count; i++) { sum += read_ad9361_rssi_mdB(); delay_ms(2); } return (int32_t)(sum / count); }

两次读数之间隔2ms，是因为连续模式下RSSI结果刷新需要时间，间隔太短相当于重复读了同一个旧值。

5.2 标定表格的采集方式和示例

标定流程我固定这么几步：

1. 把信号源接到接收端口，中间用高质量线缆和衰减器链路连接。
2. 配置AD9361工作在目标频点，固定手动增益，采样率保持业务配置。
3. 信号源输出CW，功率从-60dBm开始，每2dB一个点，一直扫到0dBm。
4. 每个功率点等待1秒，读取RSSI并记录平均值。
5. 全扫完之后检查数据曲线，确认没有明显跳变点。

采集结果长下面这个样子，注意这是示意数据，每块板子都必须重新测：

靠近0dBm时误差变大，通常是ADC开始接近满量程，检波特性出现压缩。如果你的系统要求全范围误差都控制在±0.5dB以内，就需要在标定表里单独处理高功率段，比如改用分段线性表。

5.3 验证精度的几个小技巧

标定完之后，不要只拿信号源同一个功率点验证。我会做三件事：第一，用不同的功率点复查拟合结果；第二，把信号源功率每步进1dB连续扫一遍，看RSSI输出是否单调；第三，在目标频点附近各偏10MHz、20MHz再测一轮，确认频率响应影响。

如果系统里有跳频需求，务必按工作频段做多频点校准。AD9361的RSSI链路在不同频点会有零点几dB到1dB以上的响应差异，只校准中心频点直接用于全带宽，误差会在边缘频点暴露。验证时把频谱仪和信号源都用上，频谱仪读到的功率作为基准。不要用信号源面板显示值直接当基准，信号源输出端的线缆损耗和回波损耗都要提前测准，否则标定出来全是“对着错误基准的精确结果”。

6. 关于校准频点、驱动API与长期稳定性的几点经验

6.1 官方API和裸寄存器怎么选

如果你用的是Linux系统，优先用libad9361-iio提供的IIO属性读取RSSI。它会把驱动内部校准和增益状态处理得很好，省去重复造轮子的麻烦。它的输出单位通常是dB或者mdB，具体取决于内核版本，使用前先打印一次确认单位，再应用到算法里。

裸寄存器方式更适合FPGA实现、低延迟场景或者没有Linux支持的裸机环境。选择裸寄存器，就要自己承担增益补偿、符号扩展和时序控制的工作。我的建议很直接：能跑官方驱动就先跑官方驱动，跑通之后再决定要不要换成裸寄存器，不要一上来就挑战高难度。

6.2 工程化校准：多个频点、温度和通道差异

一批板子做下来，你会发现每块板的RSSI校准参数都不一样。原因来自PCB走线损耗差异、balun一致性、芯片本身的离散性。所以量产校准必须逐板做，不能只拿一个“黄金样机”的参数刷到所有板子上。

校准频点建议覆盖工作频段的低、中、高三个位置。每个频点做一遍功率扫描，保存三组拟合系数。实际运行时根据当前频点选择对应系数，频点落在两组之间则做线性插值。温度方面，可以利用AD9361内部温度传感器，在常温和高低温下分别标定一次，得到温度补偿曲线，再把补偿系数写入配置文件。程序启动时读取这些系数，在线计算RSSI功率值，精度会比固定参数稳定很多。

6.3 我对RSSI测量在实际系统里的定位

做了这么多校准和补偿之后，还是要说一句：RSSI适合做趋势监测、AGC策略和粗略功率指示，不适合替代精密功率计。如果项目要求绝对功率误差小于±0.3dB，并且覆盖很宽的动态范围，更稳妥的方案是在射频前端增加独立对数检波器或者定向耦合器加功率计芯片，用AD9361的RSSI作为辅助参考。

我现在接手新板卡时，第一步不是写寄存器，而是先把官方驱动跑通，用IIO接口读一次RSSI，再拿频谱仪对照一遍全频段功率曲线。这样能最快发现板级问题，也能给我后续写裸寄存器版本留下一份可信的参考数据。RSSI配置本身不复杂，难的是把它和AGC、增益表、校准流程整合成一个可靠的整体。希望这篇文章能帮你少走几步弯路。