当前位置：首页 > news >正文

告别裸机调试：在Zynq上为AD9361移植Linux并配置IIO驱动的完整流程（基于Vivado 2022.1和Petalinux）

news 2026/4/20 8:18:11

从裸机到Linux：Zynq平台AD9361驱动开发全指南

在嵌入式无线电系统开发中，AD9361作为一款高性能射频收发器，常与Xilinx Zynq SoC搭配使用。传统裸机开发虽然直接高效，但面临功能扩展性差、开发周期长等痛点。本文将手把手带你完成从No-OS到Linux IIO驱动的完整迁移，利用Vivado 2022.1和Petalinux构建可扩展的SDR开发平台。

1. 环境准备与工具链配置

工欲善其事，必先利其器。针对AD9361的Linux驱动开发，需要准备以下工具链：

Vivado 2022.1：Xilinx官方推荐的LTS版本，稳定性经过验证
Petalinux 2022.1：与Vivado版本严格对应，避免兼容性问题
ADI Linux BSP：包含AD9361的IIO驱动和硬件定义文件

安装时特别注意：

# 验证Petalinux安装 source /opt/pkg/petalinux/2022.1/settings.sh petalinux-util --webtalk off # 禁用匿名数据收集

硬件设计方面，建议直接从Analog Devices官网获取参考设计：

HDL硬件定义文件（system_top.v和约束文件）
预配置的Vivado Block Design（含Zynq PS配置）

注意：Vivado工程中必须正确设置AXI接口时钟，AD9361的SPI时钟建议限制在10MHz以下

2. 硬件设计到Linux系统的桥梁

2.1 Vivado工程关键配置

在Vivado中完成硬件设计后，需要特别注意以下参数：

配置项	推荐值	说明
AXI接口时钟	100MHz	确保与AD9361数据手册一致
SPI模式	Mode 0	AD9361硬件复位后的默认模式
中断号	61-63	避免与系统预留中断冲突

生成硬件描述文件(XSA)时，勾选Include bitstream选项，这将为后续Petalinux工程提供完整的硬件定义。

2.2 Petalinux工程初始化

创建Petalinux工程时，建议采用分层设计：

petalinux-create -t project -n ad9361_linux --template zynq cd ad9361_linux petalinux-config --get-hw-description=../vivado_project/

关键配置步骤：

在Subsystem AUTO Hardware Settings中确认检测到AD9361外设
启用Device Drivers -> Industrial I/O -> AD9361驱动
设置启动参数为console=ttyPS0,115200 root=/dev/mmcblk0p2 rw earlyprintk

3. IIO驱动深度配置

3.1 设备树定制化修改

AD9361需要正确的设备树节点定义，以下是典型配置片段：

&axi_ad9361 { compatible = "adi,ad9361"; reg = <0x79000000 0x10000>; interrupts = <0 61 4>, <0 62 4>, <0 63 4>; clocks = <&ad9361_clkin>; clock-names = "ad9361_ext_refclk"; adi,2rx-2tx-mode-enable; adi,frequency-division-duplex-mode-enable; };

常见问题排查：

时钟不工作：检查clkin频率（建议40MHz）
SPI通信失败：验证CS极性设置spi-cpol和spi-cpha
DMA错误：确认AXI Stream接口宽度匹配（通常为16位）

3.2 内核驱动编译技巧

ADI官方驱动需要手动集成到Petalinux工程：

petalinux-create -t modules --name ad9361 --enable cp -r ADI_linux_drivers/iio/ad9361/* project-spec/meta-user/recipes-modules/ad9361/files/

编译时建议开启调试信息：

echo 'CONFIG_IIO_AD9361_DEBUGFS=y' >> project-spec/meta-user/conf/user-rootfsconfig

4. 从裸机到Linux的范式转换

4.1 关键操作对比

功能	裸机实现	Linux IIO实现
寄存器读写	直接SPI操作	通过`debugfs`或`sysfs`接口
数据采集	DMA轮询	IIO缓冲区事件驱动
参数配置	调用ADI API	通过`libiio`抽象层

4.2 性能优化实践

对于实时性要求高的场景，建议：

使用RT_PREEMPT补丁内核
调整DMA缓冲区大小（默认4KB可能不足）：

static struct iio_buffer *ad9361_alloc_buffer(void) { return iio_kfifo_allocate(128 * 1024); // 128KB缓冲区 }

射频参数设置示例（Python版）：

import iio ctx = iio.Context('ip:192.168.1.100') # 通过网络连接开发板 dev = ctx.find_device('ad9361-phy') dev.attrs['frequency'].value = '2400000000' # 2.4GHz dev.attrs['sampling_frequency'].value = '61440000' # 61.44MSPS

5. 高级调试与实战技巧

5.1 信号完整性验证

搭建测试环境时，推荐工作流程：

通过iio_attr工具验证基础通信：

iio_attr -c ad9361-phy voltage0 sampling_frequency 61440000

使用iio_oscilloscope可视化IQ数据：

git clone https://github.com/analogdevicesinc/iio-oscilloscope mkdir build && cd build && cmake .. && make

频谱分析验证：

import numpy as np from scipy.fft import fft iq_data = np.frombuffer(buffer.read(), dtype=np.complex64) spectrum = 20*np.log10(np.abs(fft(iq_data)))

5.2 常见故障排除

问题：iio:device0未出现
- 检查：dmesg | grep ad9361查看驱动加载日志
- 解决：确认设备树节点地址与Vivado设计一致
问题：DMA传输卡顿
- 优化：调整内核调度策略
```
echo -n "fifo" > /sys/block/zynqmp-dma-0/queue/scheduler
```

在最近的一个气象雷达项目中，我们发现将SPI时钟从默认的5MHz提升到8MHz后，配置时间缩短了40%，但超过10MHz会导致偶发通信错误。这种细微调整往往需要结合实际硬件布局反复验证。

查看全文

http://www.jsqmd.com/news/670249/