第一次把PYNQ镜像烧进SD卡、板子跑起来之后我盯着Jupyter Notebook里那几个示例的单元格愣了半天代码里既没有碰过FPGA也没有写过时序约束点几下就能控制板载LED。这种体验对刚从Verilog和纯逻辑设计转过来的人来说既痛快又有点“不真实”。后来我把这个入门实验完整跑通才意识到AXI_GPIO这个看似基础的外设恰恰是理解PYNQ软硬件协同工作方式最关键的一环。这篇就把整个实验从原理、接线到寄存器级操作的完整过程以及我踩过的坑一次性说透。1. 实验背景与原理拆解1.1 PYNQ到底改变了什么PYNQ是一个面向嵌入式开发的软硬件协同平台核心思路是把Zynq系列芯片上的ARM处理器和FPGA逻辑资源打包成一个用Python就能操作的开发环境。最直观的表现就是板子启动后你面对的不是一堆硬件描述语言编译器而是一个网页版的Jupyter Notebook可以直接在浏览器里写Python代码然后通过框架内置的Overlay机制把FPGA的比特流文件加载进去控制外设。这个思路解决的最大痛点是FPGA开发的入门门槛。传统流程走一遍需要写RTL代码、做仿真、写约束文件、综合、布局布线最后生成比特流整个过程对纯软件背景的人非常不友好。而PYNQ把这些步骤封装成了类似驱动库的东西你只需要加载Overlay然后对着外设对象调用方法就行。AXI_GPIO实验就是这个体系里最典型、也最容易建立整体认知的第一个实验。我说句实话如果你之前完全没接触过嵌入式直接上手PYNQ可能会有点懵因为你要同时面对ARM、Linux、Python、FPGA这几个概念。但换个角度看AXI_GPIO实验恰好把这几样东西串在了一条线上ARM里面跑着系统Python脚本是应用层FPGA里面挂着GPIO控制器总线把它们连起来。把一个LED点亮的过程就是完整走一遍软硬件通路的过程。1.2 AXI_GPIO在软硬件之间扮演什么角色AXI_GPIO的全称是AXI General Purpose Input/Output它是FPGA厂商提供的一个可配置IP核。这个IP核的一端挂在AXI总线上另一端通过引脚引出到FPGA的IO上。ARM处理器不需要直接操作物理引脚而是通过对一段内存地址进行读写就能控制外部电平。这里面的关键点是AXI总线。Zynq芯片分为PS处理器系统和PL可编程逻辑两部分PS侧运行Linux系统和应用代码PL侧放你做的逻辑电路。AXI总线就是两者之间的数据通道其中AXI-Lite是轻量级版本适合单次读写寄存器这种低速操作。AXI_GPIO正是挂在AXI-Lite总线上的外设ARM侧的程序只要往总线地址空间里写数据数据就会变成FPGA引脚上的高低电平。用人话解释就是ARM是个只会发指令的老板PL是负责干活的员工AXI总线是办公室之间的走廊。老板往指定信箱里投一张写着“把1号灯点亮”的纸条员工看到纸条后就把对应线路的电平拉高灯就亮了。AXI_GPIO就是那个信箱地址就是信箱的编号。1.3 为什么这个实验是入门首选AXI_GPIO实验在PYNQ里相当于嵌入式的“Hello World”但它承载的信息量比打印一行字大得多。做完它你至少能搞明白三件事。第一理解Overlay机制。Overlay是PYNQ里对FPGA比特流加驱动接口的封装加载一个Overlay就相当于给FPGA换了一套硬件电路同时把Python对象和硬件资源绑定起来。这比传统FPGA开发里反复下载比特流要灵活得多。第二理解外设寄存器操作。AXI_GPIO内部就是几个32位寄存器往数据寄存器写值就能改变引脚状态读数据寄存器就能知道外界电平。这和你以后用SPI、I2C、UART等IP核的思路完全一致先看寄存器映射再操作地址。第三理解性能边界。GPIO是通过总线读写寄存器的频率不会太高但足够控制LED、按键这类低速外设。做完这个实验你就会对“什么场合用硬件逻辑、什么场合用软件控制”有个大致判断这对后续做更复杂的设计非常重要。2. 搭建实验环境与地址分配2.1 烧写镜像与启动PYNQ我常用的PYNQ开发板是Zynq架构的入门板系统镜像直接写在TF卡上。准备工作不算复杂但第一次做容易卡在细节上。先把官方编译好的PYNQ镜像文件下载下来得到一个.img或压缩包。用Etcher这个图形化工具烧录到TF卡里也可以直接用Linux下的dd命令逐字节写入命令大概是sudo dd ifpynq_image.img of/dev/sdb bs4M statusprogress烧好后把TF卡插进板子接上网线和电源。网线的目的是访问板子上自带的网页服务PYNQ默认会在启动后开启一个Jupyter Notebook服务你需要在浏览器里访问它的地址。访问地址有两种情况。如果路由器支持板子会通过DHCP自动获取IP到路由器后台查一下就能找到。如果像我一样图省事直接用一根网线把板子和电脑直连然后给电脑网卡配一个同网段的固定IP比如192.168.2.x板子的默认地址通常是192.168.2.99浏览器访问http://192.168.2.99:9090就能看到登录页面。启动过程第一次会有点慢因为系统要解压并初始化文件系统大概一两分钟。看到网页界面后默认密码通常是xilinx登录进去就是Jupyter的文件管理界面。2.2 用BaseOverlay快速接入硬件PYNQ的优势在于它预置了一个官方Overlay叫作BaseOverlay。这个Overlay把板卡上常见的LED、按键、开关、RGB灯等外设都封装好了你不需要写任何硬件描述语言直接加载就行。from pynq.overlays.base import BaseOverlay base BaseOverlay(base.bit)加载之后当前FPGA里面就运行着厂商预先做好的电路里面至少包含一组AXI_GPIO IP核连到了板载LED和按键上。接下来你可以直接操作这些外设对象base.led[0].on() base.led[1].on() base.buttons[0].read()这一瞬间硬件在逻辑上就变成了你代码里的一个对象操作起来和操作普通Python列表差不多。但这里有个隐藏细节BaseOverlay里的base.led、base.buttons这些对象内部最终是通过AXI_GPIO的寄存器访问来实现的。换句话说你看到的这层“Python对象”只是包装内核里还是在读写地址空间。如果你想确认这一点可以直接打印这些对象看看print(base.led) print(base.buttons[0])输出里会包含设备树节点、寄存器地址、通道号等信息。我实测第一次看到这些信息时对PYNQ的理解一下就清晰了原来所有外设再花哨底层都逃不过“总线地址寄存器”这套模型。2.3 看懂地址分配表动手做实验之前强烈建议先把Overlay的地址分配表打出来看一眼。base.ip_dict返回的是一个字典记录了当前Overlay里所有IP核的名字、基地址和地址范围。我这边几个典型的条目长这样axi_gpio_0基地址0x41200000范围0x10000axi_gpio_1基地址0x41210000范围0x10000看到这串数字不用心慌里面是有规律的。Zynq的PS侧有一个专门给PL外设使用的地址窗口通常从0x40000000开始往上分配。厂商在设计Overlay时把同一个IP核固定在某个4KB对齐的地址上这样ARM侧只需要访问这个地址就能操作对应的FPGA逻辑。为什么是4KB对齐因为Linux操作系统的MMU按页管理内存一页通常是4KB。PYNQ框架内部用mmap把物理地址映射到用户空间必须按页码对齐才能映射成功。所以你在写代码时地址参数基本都是0x1000的整数倍。这个表就是你和硬件之间的“地图”。后面手动操作寄存器的时候就是照着这张表找地址然后往里面写字。3. AXI_GPIO实操从封装到寄存器3.1 用Python封装接口点灯和读按键先把最简单的跑通。加载BaseOverlay后写一个循环让LED按顺序闪烁模拟跑马灯效果import time from pynq.overlays.base import BaseOverlay base BaseOverlay(base.bit) while True: for i in range(len(base.led)): base.led[i].on() time.sleep(0.2) if i 0: base.led[i - 1].off() time.sleep(0.2)这段代码做的事情很直白循环点亮一个LED延迟0.2秒后熄灭前一个形成流水效果。用封装接口做的时候你完全不用关心电平是怎么变化的on()和off()方法内部已经把写寄存器、保持状态的逻辑处理好了。读按键稍微有点讲究因为按键默认拉高按下时电平被拉低所以逻辑上要做一次取反while True: if base.buttons[0].read() 0: base.led[0].on() else: base.led[0].off() time.sleep(0.02)这里buttons[0].read()返回的是引脚电平状态0表示按下。20毫秒的延迟用来避免CPU空转也起到简单的滤波作用。3.2 手动操作AXI_GPIO寄存器封装接口好用但它会把底层的寄存器细节藏住。做这个实验如果只停留在“点灯成功、按键成功”的层面收获就太薄了。我建议绕开封装直接用PYNQ提供的MMIO模块访问亲手把寄存器翻一遍。AXI_GPIO这个IP核的寄存器布局很简单以通道1为例偏移地址对应如下偏移地址寄存器名称含义0x00GPIO_DATA数据寄存器读写引脚电平0x04GPIO_DIR方向寄存器0表示输出1表示输入0x08GPIO_CTRL控制寄存器用于中断使能等如果启用了通道2它的寄存器从偏移0x10开始布局相同。默认情况下AXI_GPIO复位后所有引脚都是输入方向也就是方向寄存器里的位全是1。所以你要让LED发光得先把方向配置成输出再写数据。基于常见的地址分配我用MMIO直接操作from pynq import MMIO # 映射AXI_GPIO寄存器空间 axi_gpio MMIO(0x41200000, 0x1000) # 配置方向全部引脚设为输出方向 axi_gpio.write(0x04, 0x00000000) # 向数据寄存器写数据点亮对应引脚 axi_gpio.write(0x00, 0x0000000F)执行完这段代码你会发现低4位对应的LED都亮了。为什么是0x0F因为每个bit对应一个GPIO引脚低四位为1就代表这4个引脚输出高电平灯亮。读按键方向也做一遍手动操作。假设按键接在第二个通道上先把方向设为输入再读数据寄存器axi_gpio_ch2 MMIO(0x41210000, 0x1000) # 通道2方向设为输入 axi_gpio_ch2.write(0x14, 0xFFFFFFFF) # 读取通道2的数据寄存器 value axi_gpio_ch2.read(0x10)读回来的value里对应的bit为0表示按键按下。手动模式虽然代码略麻烦但你会形成一个非常重要的心理模型所谓外设控制本质上就是往特定的地址写特定的值再读特定的地址得到状态。3.3 完整信号通路与时序理解把封装拆开之后现在可以把整个信号通路串一遍。当你在Python里执行一条axi_gpio.write(0x00, 0x0F)时数据流是这样走的第一步调用MMIO.write框架内部使用Linux的/dev/mem设备将这个地址映射到用户空间然后执行一次内存写操作。第二步写操作通过ARM的存储器接口走到芯片内部的总线互连网络上。Zynq芯片里PS侧有一套总线矩阵负责把不同主设备发起的访问路由到对应的从设备上。这条写请求带着地址0x41200000总线互连单元一看这个地址落在PL外设窗口里就把请求转发给AXI-Lite总线。第三步AXI_GPIO核收到总线上的写事务根据总线地址的低位偏移把数据写入自己的寄存器。因为写的是偏移0x00所以数据进了数据寄存器。这个寄存器的值会实时反映到输出引脚上引脚电平变化LED亮灭。读取按键的方向是反过来的。按键按下导致FPGA引脚电平变化AXI_GPIO的数据寄存器里的对应位跟着变化。ARM侧发起一次读请求总线把寄存器值返回回来Python里收到值后做判断就完成了从物理电平到软件逻辑的转换。这里有个很多人会忽略的时序问题GPIO数据寄存器本质上是组合逻辑输出也就是说你不用等时钟周期写完数据引脚立刻变化。但总线访问本身有时延整个读写一次大概需要几十到几百纳秒。所以用PYNQ的GPIO控制外设频率能到几MHz就不错了再高的信号就得放到PL侧用硬件逻辑实现不能靠软件轮询。3.4 扩展在Vivado里自定义AXI_GPIOBaseOverlay只是入门用的赛道。你迟早会想自己定义一个Overlay把自己写的逻辑挂到ARM的总线上。这里我先简单说下路线方便你后续自己动手时不迷路。在Vivado里的操作流程大致是新建一个Block Design添加Zynq PS核再添加AXI GPIO IP核用总线接口把两者自动连接然后分配地址。地址一般在0x40000000之后随便挑一段注意不要和已有的外设冲突。之后生成比特流导出硬件描述文件再用PYNQ的工具链生成Overlay。PYNQ提供了一个命令行工具可以把Vivado生成的产物打包成.bit文件和对应的驱动描述这样你在Python里就能用Overlay(my_design.bit)加载并且通过overlay.ip_dict查到你自己的GPIO地址。我第一次在Vivado里拖那个AXI GPIO核时最困惑的是IP配置界面里的“All Outputs”“All Inputs”这些选项。对应好理解这就是方向寄存器的初值。如果你初始化时选了All Outputs复位后引脚默认都是输出省得软件里去改方向寄存器。但要注意这样配置之后如果你想把这个引脚临时改成输入就得自己写方向寄存器为1了。4. 常见问题与排障经验4.1 加载Overlay后依然无法控制引脚这是最常遇到的问题执行了BaseOverlay(base.bit)但LED没反应或者按键读不到数据。第一步检查加载是否成功。直接打印IP字典看看AXI_GPIO的地址是否正常。如果字典里没有相关条目说明Overlay加载失败原因可能是比特流文件和板卡不匹配或者当前Jupyter会话的Python内核需要重启。第二步检查地址是否写对。很多人直接照抄网上代码里的0x41200000但不同版本的Overlay里地址可能不一样。最稳妥的做法是先用base.ip_dict查实际地址然后再手工用MMIO访问。地址错了的表现通常是不报错但也没效果因为MMIO映射的地址可能落到了一段空闲内存上。第三步检查方向寄存器。刚才强调过IP核复位后默认引脚都是输入你不写方向寄存器就写数据寄存器什么都不会发生。尤其是用MMIO手动操作时这一步最容易漏。4.2 按键误触发与抖动用GPIO读按键最折磨人的问题就是抖动。按下一次逻辑上应该是“按下→松开”一次但物理上按键触点会有几到几十毫秒的抖动导致电平在按下瞬间反复跳变。你在循环里读数据时会发现一次按键可能被当成好几次触发。简单处理方法就是在软件层面加延迟和判断if base.buttons[0].read() 0: time.sleep(0.02) if base.buttons[0].read() 0: # 确认是有效按下这段代码的意思是第一次读到低电平以后先等20毫秒再读一次。如果还是低电平就说明按键真的被按下了。20毫秒的选取是因为一般按键抖动不会持续这么久而人正常按键的持续时间会有几十到上百毫秒不会影响手感。如果要做更严格的去抖用硬件定时采样也行但入门阶段软件延时已经足够。意识到“物理世界有噪声”这件事本身就是嵌入式开发的必修课。4.3 地址冲突与总线挂死用AXI_GPIO手动操作时地址写错还有一个比较坑的后果可能会让总线访问挂起甚至导致整个Jupyter内核卡死。尤其当你不小心访问了一段没有实际外设响应的地址空间时ARM会一直等总线事务完成表现出来就是IPython内核无响应。这不是板子坏了重启内核通常能恢复。预防为主以后每次手动访问不熟悉的地址时先确认这个地址在外设窗口内而且对应的IP核确实存在。宁可先读一遍ip_dict也不要凭感觉猜地址。另一个和地址相关的坑是字节对齐。AXI-Lite总线要求访问按4字节对齐如果你传入的偏移地址不是4的倍数框架底层可能直接报错或者更糟糕静默忽略数据。写代码时记住GPIO寄存器偏移都是0x00、0x04、0x08这种步进就是为了对齐。4.4 关于性能与适用场景的心得最后说点我在实际使用中的体会。先分享一个反直觉的观察用Python操作GPIO表面上看代码执行很“快”但真实的应用场景里你不可能用它在循环里产生精确的高速波形。我用逻辑分析仪实测单纯靠Python轮询切换GPIO输出波形的抖动非常大周期不稳定。所以PYNQ的AXI_GPIO最适合做的是低速控制比如控制灯的开关、读取用户按键、切换板子上的工作模式。一旦涉及高速通信或者精确时序比如驱动高速ADC、产生PWM波就应该在PL侧用硬件逻辑或者专用的定时器外设实现GPIO只负责和ARM交换状态信息。另一个心得是要学会用寄存器思维看问题。封装接口用起来确实舒服但真遇到Bug最后定位问题还是要回到寄存器上。我调试过好几次莫名其妙的现象最后都是打开寄存器看数值才找到原因。这个实验最大的价值不是学会点灯而是第一次形成“地址、寄存器、电平”三者的对应关系这个关系一旦建立后面所有外设开发都顺了。如果你手头有板子别急着往下学别的复杂外设先把这个实验多玩几遍。用封装接口做一遍再用MMIO做一遍最后自己再看看地址分配表你会发现PYNQ这个平台的软硬件边界一下子变得清楚了。 
长河君 · 2026/10/16 5:09:55 · 阅读 1.2k PYNQ入门：AXI_GPIO寄存器操作与软硬件协同实战
第一次把PYNQ镜像烧进SD卡、板子跑起来之后我盯着Jupyter Notebook里那几个示例的单元格愣了半天代码里既没有碰过FPGA也没有写过时序约束点几下就能控制板载LED。这种体验对刚从Verilog和纯逻辑设计转过来的人来说既痛快又有点“不真实”。后来我把这个入门实验完整跑通才意识到AXI_GPIO这个看似基础的外设恰恰是理解PYNQ软硬件协同工作方式最关键的一环。这篇就把整个实验从原理、接线到寄存器级操作的完整过程以及我踩过的坑一次性说透。1. 实验背景与原理拆解1.1 PYNQ到底改变了什么PYNQ是一个面向嵌入式开发的软硬件协同平台核心思路是把Zynq系列芯片上的ARM处理器和FPGA逻辑资源打包成一个用Python就能操作的开发环境。最直观的表现就是板子启动后你面对的不是一堆硬件描述语言编译器而是一个网页版的Jupyter Notebook可以直接在浏览器里写Python代码然后通过框架内置的Overlay机制把FPGA的比特流文件加载进去控制外设。这个思路解决的最大痛点是FPGA开发的入门门槛。传统流程走一遍需要写RTL代码、做仿真、写约束文件、综合、布局布线最后生成比特流整个过程对纯软件背景的人非常不友好。而PYNQ把这些步骤封装成了类似驱动库的东西你只需要加载Overlay然后对着外设对象调用方法就行。AXI_GPIO实验就是这个体系里最典型、也最容易建立整体认知的第一个实验。我说句实话如果你之前完全没接触过嵌入式直接上手PYNQ可能会有点懵因为你要同时面对ARM、Linux、Python、FPGA这几个概念。但换个角度看AXI_GPIO实验恰好把这几样东西串在了一条线上ARM里面跑着系统Python脚本是应用层FPGA里面挂着GPIO控制器总线把它们连起来。把一个LED点亮的过程就是完整走一遍软硬件通路的过程。1.2 AXI_GPIO在软硬件之间扮演什么角色AXI_GPIO的全称是AXI General Purpose Input/Output它是FPGA厂商提供的一个可配置IP核。这个IP核的一端挂在AXI总线上另一端通过引脚引出到FPGA的IO上。ARM处理器不需要直接操作物理引脚而是通过对一段内存地址进行读写就能控制外部电平。这里面的关键点是AXI总线。Zynq芯片分为PS处理器系统和PL可编程逻辑两部分PS侧运行Linux系统和应用代码PL侧放你做的逻辑电路。AXI总线就是两者之间的数据通道其中AXI-Lite是轻量级版本适合单次读写寄存器这种低速操作。AXI_GPIO正是挂在AXI-Lite总线上的外设ARM侧的程序只要往总线地址空间里写数据数据就会变成FPGA引脚上的高低电平。用人话解释就是ARM是个只会发指令的老板PL是负责干活的员工AXI总线是办公室之间的走廊。老板往指定信箱里投一张写着“把1号灯点亮”的纸条员工看到纸条后就把对应线路的电平拉高灯就亮了。AXI_GPIO就是那个信箱地址就是信箱的编号。1.3 为什么这个实验是入门首选AXI_GPIO实验在PYNQ里相当于嵌入式的“Hello World”但它承载的信息量比打印一行字大得多。做完它你至少能搞明白三件事。第一理解Overlay机制。Overlay是PYNQ里对FPGA比特流加驱动接口的封装加载一个Overlay就相当于给FPGA换了一套硬件电路同时把Python对象和硬件资源绑定起来。这比传统FPGA开发里反复下载比特流要灵活得多。第二理解外设寄存器操作。AXI_GPIO内部就是几个32位寄存器往数据寄存器写值就能改变引脚状态读数据寄存器就能知道外界电平。这和你以后用SPI、I2C、UART等IP核的思路完全一致先看寄存器映射再操作地址。第三理解性能边界。GPIO是通过总线读写寄存器的频率不会太高但足够控制LED、按键这类低速外设。做完这个实验你就会对“什么场合用硬件逻辑、什么场合用软件控制”有个大致判断这对后续做更复杂的设计非常重要。2. 搭建实验环境与地址分配2.1 烧写镜像与启动PYNQ我常用的PYNQ开发板是Zynq架构的入门板系统镜像直接写在TF卡上。准备工作不算复杂但第一次做容易卡在细节上。先把官方编译好的PYNQ镜像文件下载下来得到一个.img或压缩包。用Etcher这个图形化工具烧录到TF卡里也可以直接用Linux下的dd命令逐字节写入命令大概是sudo dd ifpynq_image.img of/dev/sdb bs4M statusprogress烧好后把TF卡插进板子接上网线和电源。网线的目的是访问板子上自带的网页服务PYNQ默认会在启动后开启一个Jupyter Notebook服务你需要在浏览器里访问它的地址。访问地址有两种情况。如果路由器支持板子会通过DHCP自动获取IP到路由器后台查一下就能找到。如果像我一样图省事直接用一根网线把板子和电脑直连然后给电脑网卡配一个同网段的固定IP比如192.168.2.x板子的默认地址通常是192.168.2.99浏览器访问http://192.168.2.99:9090就能看到登录页面。启动过程第一次会有点慢因为系统要解压并初始化文件系统大概一两分钟。看到网页界面后默认密码通常是xilinx登录进去就是Jupyter的文件管理界面。2.2 用BaseOverlay快速接入硬件PYNQ的优势在于它预置了一个官方Overlay叫作BaseOverlay。这个Overlay把板卡上常见的LED、按键、开关、RGB灯等外设都封装好了你不需要写任何硬件描述语言直接加载就行。from pynq.overlays.base import BaseOverlay base BaseOverlay(base.bit)加载之后当前FPGA里面就运行着厂商预先做好的电路里面至少包含一组AXI_GPIO IP核连到了板载LED和按键上。接下来你可以直接操作这些外设对象base.led[0].on() base.led[1].on() base.buttons[0].read()这一瞬间硬件在逻辑上就变成了你代码里的一个对象操作起来和操作普通Python列表差不多。但这里有个隐藏细节BaseOverlay里的base.led、base.buttons这些对象内部最终是通过AXI_GPIO的寄存器访问来实现的。换句话说你看到的这层“Python对象”只是包装内核里还是在读写地址空间。如果你想确认这一点可以直接打印这些对象看看print(base.led) print(base.buttons[0])输出里会包含设备树节点、寄存器地址、通道号等信息。我实测第一次看到这些信息时对PYNQ的理解一下就清晰了原来所有外设再花哨底层都逃不过“总线地址寄存器”这套模型。2.3 看懂地址分配表动手做实验之前强烈建议先把Overlay的地址分配表打出来看一眼。base.ip_dict返回的是一个字典记录了当前Overlay里所有IP核的名字、基地址和地址范围。我这边几个典型的条目长这样axi_gpio_0基地址0x41200000范围0x10000axi_gpio_1基地址0x41210000范围0x10000看到这串数字不用心慌里面是有规律的。Zynq的PS侧有一个专门给PL外设使用的地址窗口通常从0x40000000开始往上分配。厂商在设计Overlay时把同一个IP核固定在某个4KB对齐的地址上这样ARM侧只需要访问这个地址就能操作对应的FPGA逻辑。为什么是4KB对齐因为Linux操作系统的MMU按页管理内存一页通常是4KB。PYNQ框架内部用mmap把物理地址映射到用户空间必须按页码对齐才能映射成功。所以你在写代码时地址参数基本都是0x1000的整数倍。这个表就是你和硬件之间的“地图”。后面手动操作寄存器的时候就是照着这张表找地址然后往里面写字。3. AXI_GPIO实操从封装到寄存器3.1 用Python封装接口点灯和读按键先把最简单的跑通。加载BaseOverlay后写一个循环让LED按顺序闪烁模拟跑马灯效果import time from pynq.overlays.base import BaseOverlay base BaseOverlay(base.bit) while True: for i in range(len(base.led)): base.led[i].on() time.sleep(0.2) if i 0: base.led[i - 1].off() time.sleep(0.2)这段代码做的事情很直白循环点亮一个LED延迟0.2秒后熄灭前一个形成流水效果。用封装接口做的时候你完全不用关心电平是怎么变化的on()和off()方法内部已经把写寄存器、保持状态的逻辑处理好了。读按键稍微有点讲究因为按键默认拉高按下时电平被拉低所以逻辑上要做一次取反while True: if base.buttons[0].read() 0: base.led[0].on() else: base.led[0].off() time.sleep(0.02)这里buttons[0].read()返回的是引脚电平状态0表示按下。20毫秒的延迟用来避免CPU空转也起到简单的滤波作用。3.2 手动操作AXI_GPIO寄存器封装接口好用但它会把底层的寄存器细节藏住。做这个实验如果只停留在“点灯成功、按键成功”的层面收获就太薄了。我建议绕开封装直接用PYNQ提供的MMIO模块访问亲手把寄存器翻一遍。AXI_GPIO这个IP核的寄存器布局很简单以通道1为例偏移地址对应如下偏移地址寄存器名称含义0x00GPIO_DATA数据寄存器读写引脚电平0x04GPIO_DIR方向寄存器0表示输出1表示输入0x08GPIO_CTRL控制寄存器用于中断使能等如果启用了通道2它的寄存器从偏移0x10开始布局相同。默认情况下AXI_GPIO复位后所有引脚都是输入方向也就是方向寄存器里的位全是1。所以你要让LED发光得先把方向配置成输出再写数据。基于常见的地址分配我用MMIO直接操作from pynq import MMIO # 映射AXI_GPIO寄存器空间 axi_gpio MMIO(0x41200000, 0x1000) # 配置方向全部引脚设为输出方向 axi_gpio.write(0x04, 0x00000000) # 向数据寄存器写数据点亮对应引脚 axi_gpio.write(0x00, 0x0000000F)执行完这段代码你会发现低4位对应的LED都亮了。为什么是0x0F因为每个bit对应一个GPIO引脚低四位为1就代表这4个引脚输出高电平灯亮。读按键方向也做一遍手动操作。假设按键接在第二个通道上先把方向设为输入再读数据寄存器axi_gpio_ch2 MMIO(0x41210000, 0x1000) # 通道2方向设为输入 axi_gpio_ch2.write(0x14, 0xFFFFFFFF) # 读取通道2的数据寄存器 value axi_gpio_ch2.read(0x10)读回来的value里对应的bit为0表示按键按下。手动模式虽然代码略麻烦但你会形成一个非常重要的心理模型所谓外设控制本质上就是往特定的地址写特定的值再读特定的地址得到状态。3.3 完整信号通路与时序理解把封装拆开之后现在可以把整个信号通路串一遍。当你在Python里执行一条axi_gpio.write(0x00, 0x0F)时数据流是这样走的第一步调用MMIO.write框架内部使用Linux的/dev/mem设备将这个地址映射到用户空间然后执行一次内存写操作。第二步写操作通过ARM的存储器接口走到芯片内部的总线互连网络上。Zynq芯片里PS侧有一套总线矩阵负责把不同主设备发起的访问路由到对应的从设备上。这条写请求带着地址0x41200000总线互连单元一看这个地址落在PL外设窗口里就把请求转发给AXI-Lite总线。第三步AXI_GPIO核收到总线上的写事务根据总线地址的低位偏移把数据写入自己的寄存器。因为写的是偏移0x00所以数据进了数据寄存器。这个寄存器的值会实时反映到输出引脚上引脚电平变化LED亮灭。读取按键的方向是反过来的。按键按下导致FPGA引脚电平变化AXI_GPIO的数据寄存器里的对应位跟着变化。ARM侧发起一次读请求总线把寄存器值返回回来Python里收到值后做判断就完成了从物理电平到软件逻辑的转换。这里有个很多人会忽略的时序问题GPIO数据寄存器本质上是组合逻辑输出也就是说你不用等时钟周期写完数据引脚立刻变化。但总线访问本身有时延整个读写一次大概需要几十到几百纳秒。所以用PYNQ的GPIO控制外设频率能到几MHz就不错了再高的信号就得放到PL侧用硬件逻辑实现不能靠软件轮询。3.4 扩展在Vivado里自定义AXI_GPIOBaseOverlay只是入门用的赛道。你迟早会想自己定义一个Overlay把自己写的逻辑挂到ARM的总线上。这里我先简单说下路线方便你后续自己动手时不迷路。在Vivado里的操作流程大致是新建一个Block Design添加Zynq PS核再添加AXI GPIO IP核用总线接口把两者自动连接然后分配地址。地址一般在0x40000000之后随便挑一段注意不要和已有的外设冲突。之后生成比特流导出硬件描述文件再用PYNQ的工具链生成Overlay。PYNQ提供了一个命令行工具可以把Vivado生成的产物打包成.bit文件和对应的驱动描述这样你在Python里就能用Overlay(my_design.bit)加载并且通过overlay.ip_dict查到你自己的GPIO地址。我第一次在Vivado里拖那个AXI GPIO核时最困惑的是IP配置界面里的“All Outputs”“All Inputs”这些选项。对应好理解这就是方向寄存器的初值。如果你初始化时选了All Outputs复位后引脚默认都是输出省得软件里去改方向寄存器。但要注意这样配置之后如果你想把这个引脚临时改成输入就得自己写方向寄存器为1了。4. 常见问题与排障经验4.1 加载Overlay后依然无法控制引脚这是最常遇到的问题执行了BaseOverlay(base.bit)但LED没反应或者按键读不到数据。第一步检查加载是否成功。直接打印IP字典看看AXI_GPIO的地址是否正常。如果字典里没有相关条目说明Overlay加载失败原因可能是比特流文件和板卡不匹配或者当前Jupyter会话的Python内核需要重启。第二步检查地址是否写对。很多人直接照抄网上代码里的0x41200000但不同版本的Overlay里地址可能不一样。最稳妥的做法是先用base.ip_dict查实际地址然后再手工用MMIO访问。地址错了的表现通常是不报错但也没效果因为MMIO映射的地址可能落到了一段空闲内存上。第三步检查方向寄存器。刚才强调过IP核复位后默认引脚都是输入你不写方向寄存器就写数据寄存器什么都不会发生。尤其是用MMIO手动操作时这一步最容易漏。4.2 按键误触发与抖动用GPIO读按键最折磨人的问题就是抖动。按下一次逻辑上应该是“按下→松开”一次但物理上按键触点会有几到几十毫秒的抖动导致电平在按下瞬间反复跳变。你在循环里读数据时会发现一次按键可能被当成好几次触发。简单处理方法就是在软件层面加延迟和判断if base.buttons[0].read() 0: time.sleep(0.02) if base.buttons[0].read() 0: # 确认是有效按下这段代码的意思是第一次读到低电平以后先等20毫秒再读一次。如果还是低电平就说明按键真的被按下了。20毫秒的选取是因为一般按键抖动不会持续这么久而人正常按键的持续时间会有几十到上百毫秒不会影响手感。如果要做更严格的去抖用硬件定时采样也行但入门阶段软件延时已经足够。意识到“物理世界有噪声”这件事本身就是嵌入式开发的必修课。4.3 地址冲突与总线挂死用AXI_GPIO手动操作时地址写错还有一个比较坑的后果可能会让总线访问挂起甚至导致整个Jupyter内核卡死。尤其当你不小心访问了一段没有实际外设响应的地址空间时ARM会一直等总线事务完成表现出来就是IPython内核无响应。这不是板子坏了重启内核通常能恢复。预防为主以后每次手动访问不熟悉的地址时先确认这个地址在外设窗口内而且对应的IP核确实存在。宁可先读一遍ip_dict也不要凭感觉猜地址。另一个和地址相关的坑是字节对齐。AXI-Lite总线要求访问按4字节对齐如果你传入的偏移地址不是4的倍数框架底层可能直接报错或者更糟糕静默忽略数据。写代码时记住GPIO寄存器偏移都是0x00、0x04、0x08这种步进就是为了对齐。4.4 关于性能与适用场景的心得最后说点我在实际使用中的体会。先分享一个反直觉的观察用Python操作GPIO表面上看代码执行很“快”但真实的应用场景里你不可能用它在循环里产生精确的高速波形。我用逻辑分析仪实测单纯靠Python轮询切换GPIO输出波形的抖动非常大周期不稳定。所以PYNQ的AXI_GPIO最适合做的是低速控制比如控制灯的开关、读取用户按键、切换板子上的工作模式。一旦涉及高速通信或者精确时序比如驱动高速ADC、产生PWM波就应该在PL侧用硬件逻辑或者专用的定时器外设实现GPIO只负责和ARM交换状态信息。另一个心得是要学会用寄存器思维看问题。封装接口用起来确实舒服但真遇到Bug最后定位问题还是要回到寄存器上。我调试过好几次莫名其妙的现象最后都是打开寄存器看数值才找到原因。这个实验最大的价值不是学会点灯而是第一次形成“地址、寄存器、电平”三者的对应关系这个关系一旦建立后面所有外设开发都顺了。如果你手头有板子别急着往下学别的复杂外设先把这个实验多玩几遍。用封装接口做一遍再用MMIO做一遍最后自己再看看地址分配表你会发现PYNQ这个平台的软硬件边界一下子变得清楚了。