Vivado 2017.4 + ZYNQ-7000：从零开始实现EMIO控制LED与按键读取

第一次拿到ZYNQ开发板时，那种既兴奋又忐忑的心情至今记忆犹新。作为嵌入式开发的新手，面对这块融合了FPGA和ARM处理器的神奇芯片，最迫切的需求就是快速验证基础功能。本文将带你完整走通EMIO控制的全流程，从Vivado工程搭建到SDK程序调试，每个步骤都配有详细说明和可复用的代码片段。

1. 开发环境准备与工程创建

工欲善其事，必先利其器。在开始之前，请确保你的开发环境满足以下要求：

• 硬件设备：xc7z045ffg676开发板（或其他ZYNQ-7000系列板卡）、USB-JTAG调试器、Micro USB线
• 软件工具：Vivado 2017.4设计套件（包含SDK）
• 基础准备：安装好板级支持包（Board Files）和器件支持文件

提示：Vivado不同版本间存在界面差异，建议使用2017.4版本以保证最佳兼容性

创建新工程的步骤如下：

1. 启动Vivado，点击"Create Project"向导
2. 设置工程名称和存储路径（建议使用英文路径）
3. 选择"RTL Project"类型，勾选"Do not specify sources at this time"
4. 在器件选择页面输入"xc7z045ffg676"进行筛选
5. 完成创建后，进入主界面准备Block Design设计

2. 构建Block Design与ZYNQ配置

ZYNQ芯片的独特之处在于其PS(Processing System)和PL(Programmable Logic)的协同工作。我们的第一步是在Block Design中添加ZYNQ处理系统IP核。

2.1 添加并配置ZYNQ IP核

在Flow Navigator中点击"Create Block Design"，命名后进入设计界面：

1. 点击"+"按钮添加IP，搜索并选择"ZYNQ7 Processing System"
2. 双击添加的IP核进入配置界面
3. 在"Peripheral I/O Pins"选项卡中展开GPIO设置
4. 找到"EMIO GPIO"选项，将宽度设置为2（1位输出控制LED，1位输入读取按键）

关键配置参数说明：

2.2 完成自动化连接

配置完成后，右键点击ZYNQ IP核选择"Run Block Automation"，这将自动完成时钟、复位等基本连接的建立。此时你的Block Design应该类似下图结构：

code复制+---------------------+
|      ZYNQ7 PS       |
|                     |
|  FCLK_CLK0 --------+ 
|  |                |
|  EMIO_GPIO[1:0]   |
+---------------------+

2.3 生成顶层HDL与引脚约束

1. 右键Block Design选择"Create HDL Wrapper"生成顶层文件
2. 新建约束文件（.xdc），添加以下内容：

tcl复制# LED控制引脚约束
set_property PACKAGE_PIN F20 [get_ports {GPIO_0_tri_io[0]}]
set_property IOSTANDARD LVCMOS33 [get_ports {GPIO_0_tri_io[0]}]

# 按键输入引脚约束
set_property PACKAGE_PIN G19 [get_ports {GPIO_0_tri_io[1]}]
set_property IOSTANDARD LVCMOS33 [get_ports {GPIO_0_tri_io[1]}]

注意：实际引脚号需根据你的开发板原理图进行调整

3. 生成比特流与导出硬件

完成上述步骤后，就可以生成FPGA配置文件了：

1. 点击"Generate Bitstream"开始综合与实现过程
2. 完成后选择"File > Export > Export Hardware"
3. 勾选"Include bitstream"选项，指定导出路径
4. 点击"File > Launch SDK"启动软件开发环境

常见问题排查：

• 综合错误：检查约束文件中的引脚名称是否与顶层文件一致
• 时序违例：在简单GPIO应用中通常可忽略时序警告
• 比特流生成失败：确认器件型号选择正确

4. SDK软件开发与GPIO控制

切换到SDK环境后，我们将创建一个基于GPIO例程的应用程序。

4.1 创建应用工程

1. 在SDK中选择"File > New > Application Project"
2. 输入工程名称（如"emio_demo"）
3. 选择"Hello World"模板作为起点
4. 在BSP设置中保持默认配置

4.2 修改主程序代码

打开生成的main.c文件，替换为以下内容：

c复制#include <stdio.h>
#include "platform.h"
#include "xparameters.h"
#include "xgpio.h"
#include "xstatus.h"

#define GPIO_DEVICE_ID XPAR_XGPIOPS_0_DEVICE_ID
#define LED_PIN 54 // EMIO通道0对应的GPIO编号
#define KEY_PIN 55 // EMIO通道1对应的GPIO编号

XGpioPs gpio; // GPIO驱动实例

int main() {
    int status;
    XGpioPs_Config *config;
    
    // 初始化GPIO驱动
    config = XGpioPs_LookupConfig(GPIO_DEVICE_ID);
    status = XGpioPs_CfgInitialize(&gpio, config, config->BaseAddr);
    if (status != XST_SUCCESS) return XST_FAILURE;
    
    // 设置LED引脚为输出
    XGpioPs_SetDirectionPin(&gpio, LED_PIN, 1);
    XGpioPs_SetOutputEnablePin(&gpio, LED_PIN, 1);
    
    // 设置KEY引脚为输入
    XGpioPs_SetDirectionPin(&gpio, KEY_PIN, 0);
    
    while (1) {
        // 读取按键状态并控制LED
        int key_val = XGpioPs_ReadPin(&gpio, KEY_PIN);
        XGpioPs_WritePin(&gpio, LED_PIN, key_val);
        
        // 添加适当延迟防止过于频繁的轮询
        for (int i = 0; i < 1000000; i++);
    }
    
    return 0;
}

代码关键点解析：

1. LED_PIN和KEY_PIN的值54/55对应EMIO的GPIO编号
2. XGpioPs_SetDirectionPin设置引脚方向（1输出/0输入）
3. XGpioPs_WritePin和XGpioPs_ReadPin实现基本的IO操作

4.3 配置调试终端

在SDK中配置串口终端用于调试输出：

1. 点击"Window > Show View > Terminal"
2. 在终端视图中点击"+"按钮添加新连接
3. 选择正确的串口号（可在设备管理器中查看）
4. 设置波特率为115200，其他参数保持默认

5. 板级调试与功能验证

最后一步是将程序下载到开发板进行实际测试。

5.1 下载硬件比特流

1. 连接开发板的JTAG和UART接口
2. 在SDK中选择"Xilinx Tools > Program FPGA"
3. 确认比特流路径正确后点击"Program"

5.2 运行软件程序

1. 右键工程选择"Run As > Launch on Hardware (System Debugger)"
2. 观察开发板上的LED状态
3. 按下按键时，LED应随之亮灭变化
4. 可在终端中增加打印语句验证按键状态

调试技巧：

• 如果LED无反应，首先检查硬件连接和电源
• 使用XGpioPs_ReadPin读取引脚状态并通过串口打印验证
• 在Vivado中通过"Open Hardware Manager"可以实时监测信号

6. 进阶应用与扩展思考

掌握了基础EMIO操作后，可以考虑以下扩展方向：

• 多路GPIO控制：扩展EMIO位宽控制更多外设
• 中断驱动：将按键改为中断方式检测
• 自定义IP集成：在PL侧添加自定义逻辑与PS协同工作
• 性能优化：采用DMA方式批量传输GPIO数据

实际项目中，EMIO常用于以下场景：

• 需要灵活扩展的IO接口
• PL和PS需要紧密交互的控制信号
• 标准外设接口之外的专用通信需求

记得保存完整的工程文件，这将是你后续开发的重要基础。当第一次看到LED按照预期点亮时，那种成就感正是嵌入式开发的魅力所在。