ZCU104 Pynq板卡网络配置全攻略：从静态IP到无显示器操作

刚拿到ZCU104开发板时，最让人头疼的莫过于网络连接问题。不同实验室环境、不同办公网络配置，都可能让这块功能强大的板卡变成一块"砖头"。本文将彻底解决这个痛点，分享三种经过实战验证的网络配置方案，特别针对无显示器场景下的操作技巧。

1. 静态IP直连：最稳定的开发环境搭建

静态IP直连是最基础的连接方式，适合个人开发或网络环境受限的场景。这种方式不依赖路由器，直接用网线连接电脑和开发板，稳定性极高。

Windows系统配置步骤：

1. 打开"控制面板 > 网络和共享中心 > 更改适配器设置"
2. 右键点击以太网适配器，选择"属性"
3. 双击"Internet协议版本4(TCP/IPv4)"
4. 输入以下参数：
   • IP地址：192.168.2.100
   • 子网掩码：255.255.255.0
   • 默认网关：留空

注意：Windows防火墙可能会阻止连接，需要在防火墙设置中允许Jupyter Notebook端口（默认8888）的入站连接。

Mac系统配置略有不同：

bash复制# 在终端中设置静态IP
networksetup -setmanual "以太网" 192.168.2.100 255.255.255.0

配置完成后，用网线直接连接电脑和ZCU104，在浏览器访问http://192.168.2.99即可进入Pynq的Jupyter界面。

常见问题排查：

• 如果无法连接，尝试ping 192.168.2.99测试连通性
• 检查网线是否完好，开发板电源和启动状态是否正常
• 确认电脑的以太网适配器已启用

2. DHCP自动获取：团队协作的高效方案

在实验室或团队开发环境中，通常会有现成的路由器或交换机。这时使用DHCP自动获取IP是最方便的方案，允许多个开发者同时访问各自的开发板。

操作流程：

1. 将ZCU104通过网线连接到路由器/交换机
2. 确保路由器开启了DHCP服务
3. 开发板启动后会自动获取IP地址

如何找到开发板的IP地址？

方法一：通过路由器管理界面查询

• 登录路由器后台（通常是192.168.1.1）
• 查找"已连接设备"或"DHCP客户端列表"
• 识别主机名包含"pynq"或"zcu104"的设备

方法二：使用网络扫描工具

• Windows推荐Advanced IP Scanner
• Mac/Linux可以使用nmap：

bash复制nmap -sn 192.168.1.0/24

方法三：查看ARP缓存

bash复制arp -a | find "pynq"  # Windows
arp -a | grep pynq    # Mac/Linux

DHCP方案的优缺点：

• 优点：配置简单，适合多设备环境
• 缺点：IP地址可能变化，需要每次查询

3. 无显示器(Headless)配置：串口终端的妙用

很多情况下，开发环境可能没有多余的显示器，或者远程管理开发板时，串口终端就成为必不可少的工具。这种方案特别适合嵌入式开发者和远程工作者。

必备工具准备：

• USB转TTL串口线（确保兼容3.3V电平）
• 终端软件：Putty（Windows）、screen（Mac/Linux）、Minicom（Linux）

连接步骤详解：

1. 将串口线连接到ZCU104的UART接口
2. 打开设备管理器，确认COM端口号
3. 配置终端软件参数：
   • 波特率：115200
   • 数据位：8
   • 奇偶校验：无
   • 停止位：1
   • 流控：无

常用网络管理命令：

查看当前IP：

bash复制ifconfig eth0

设置静态IP（临时生效）：

bash复制ifconfig eth0 192.168.1.150 netmask 255.255.255.0

永久修改网络配置：

bash复制vi /etc/network/interfaces

添加以下内容：

code复制auto eth0
iface eth0 inet static
address 192.168.1.150
netmask 255.255.255.0
gateway 192.168.1.1

修改主机名（方便识别）：

bash复制hostnamectl set-hostname zcu104-dev

串口操作小技巧：

• 使用screen命令可以保持会话不中断
• tmux工具可以实现多窗口管理
• 配置.bashrc可以自定义提示符，方便区分不同开发板

4. 三种方案对比与实战选择指南

不同的网络配置方案各有优劣，理解它们的适用场景能大幅提升开发效率。下面从六个维度进行详细对比：

实战选择建议：

1. 初次上手验证硬件：使用静态IP直连，排除网络干扰
2. 日常开发调试：DHCP自动获取，配合路由器管理
3. 批量部署或远程管理：串口终端+静态IP组合
4. 无网络环境开发：静态IP或串口终端

高级技巧：网络故障排查三板斧

当网络连接出现问题时，可以按照以下步骤排查：

1. 物理层检查：

   • 网线是否插好
   • 网口指示灯是否正常闪烁
   • 电源供应是否稳定

2. 网络层诊断：

   bash复制ping 192.168.2.99      # 测试连通性
   ifconfig eth0          # 检查接口状态
   route -n               # 查看路由表
   

3. 应用层验证：

   • 检查Jupyter服务是否运行：ps aux | grep jupyter
   • 确认防火墙设置：iptables -L
   • 查看服务日志：journalctl -u jupyter

5. 提升开发体验的进阶配置

掌握了基本网络连接后，一些进阶配置能让开发过程更加顺畅。这些技巧来自实际项目经验，能解决很多"奇怪"的问题。

持久化网络配置

临时修改的IP在重启后会失效，要实现永久配置，需要修改网络配置文件：

bash复制# 编辑网络配置文件
vi /etc/network/interfaces.d/eth0

# 添加以下内容
auto eth0
iface eth0 inet static
address 192.168.2.99
netmask 255.255.255.0
gateway 192.168.2.1
dns-nameservers 8.8.8.8

多网络接口管理

ZCU104有多个网络接口时，可以配置优先级：

bash复制# 查看接口指标
ip route show

# 修改接口metric值
vi /etc/network/interfaces
# 在接口配置中添加
metric 100

SSH免密登录配置

1. 生成密钥对：

bash复制ssh-keygen -t rsa

2. 将公钥复制到开发板：

bash复制ssh-copy-id pynq@192.168.2.99

3. 测试无密码登录：

bash复制ssh pynq@192.168.2.99

自动化网络检测脚本

创建一个定时检查网络状态的脚本：

bash复制#!/bin/bash

LOG_FILE=/var/log/network_check.log

echo "$(date) - 开始网络检查" >> $LOG_FILE

if ! ping -c 1 8.8.8.8 &> /dev/null; then
    echo "$(date) - 网络连接失败，尝试重启网络服务" >> $LOG_FILE
    systemctl restart networking
fi

echo "$(date) - 网络检查完成" >> $LOG_FILE

然后添加到crontab，每5分钟执行一次：

bash复制crontab -e
# 添加以下行
*/5 * * * * /path/to/network_check.sh

在实际项目中，最省时的做法是给每块开发板配置固定的主机名和静态IP，并记录在团队文档中。这样无论何时需要调试，都能快速找到对应的设备。