fpga.love

EN App

知识库›Linux 驱动

Linux 驱动

设备树、字符设备、SPI、I2C、DMA、驱动开发
本类聚合知识库与社区速查里的相关内容，按主题相关度排序，点击任意一条进入正文 · 共 166 条

Verilog 基础 Vivado 工具 Zynq 开发 Linux 驱动国产 FPGA 选型与工具

2021.1设备树生成器在hsi generate_targets上无限循环

问题未解决，官方仅指出XSA中MicroBlaze中断引脚未连接中断控制器

Alveo SN1022 上 onload 模块无法加载

SN1022 属专用卡，建议通过 support-nic@xilinx.com 或支持工单处理

Arty 7Z10 冷启动后以太网不工作

在LWIP代码开头加延时等待PHY上电复位完成即可解决

BUFG_GT_SYNC与TX_OUT_CLK驱动不可布放错误

改用共享逻辑的user_clk_out直连逻辑后问题解决

Basys 3 打开硬件管理器报 hw_server 版本过旧

帖中仅给出参考链接，未确认根因或解决方案

CoraZ7构建Linux应用时bootgen写SD卡失败

问题未解决，帖中未给出根因或修复方法

FSBL中如何修改SD卡时钟速度？

将xsdps.h中的宏改为0可避免切换到HS模式。

FSBL能读SD卡加载U-Boot但U-Boot无法读同一SD卡

SD控制器不应配置Card Detect和Write Protect线，且2021.2的FSBL存在SD初始化问题

HLS仿真报GLIBCXX_3.4.29未找到如何解决

提问者用软链接替换libstdc++.so.6后HLS仿真不再报错

ISE 14.7 中 OBUFE 驱动总线报多驱动错误

多个 OBUFE 驱动同一信号在 Xilinx 中不被允许，建议改用多路选择器

ISE 14.7在Ubuntu 18.04实现时许可证报错

Windows需装驱动，Ubuntu需解决许可证问题

KR260启动Linux 6.1时pinctrl设置失败

旧PMUFW导致pinctrl报错，更新QSPI固件可消除

KRIA K26自定义载板usb0与SD卡识别问题

问题未解决，USB2244未被正确配置

KV260 U-Boot 中 psgtr_phy lane 2 PLL 锁定超时导致 USB 和 SD 卡启动失败

问题未解决，帖中未给出根因或修复方案

KV260 Ubuntu运行模型报vitis_ai_library缺失

Ubuntu 22.04可安装vitis-ai-library包，20.04可参考相关文章构建

KV260 用 balenaEtcher 烧录 Ubuntu 22.04 镜像报错怎么办？

改用 balenaEtcher 1.18.12 并下载 Kria 专用镜像后烧录成功

KV260上VCU IP启动时系统卡死怎么办？

启动卡死疑似硬件设计或VCU IP连接问题，需逐项排查

KV260用BOOT.BIN启动后Bitstream未加载

Kria K26的Bitstream加载机制与传统MPSoC不同，需按专用文档处理

Kria KR260 SD卡启动Petalinux报VFS内核恐慌

建议先升级Kria SOM Boot Firmware，若无效再提供完整启动日志排查

Kria KV260加速流程为何不生成SD卡启动文件？

加速流程不自动产出启动镜像，需用PetaLinux BSP单独制作WIC并部署固件

MPSoC eMMC启动概率性卡在fsbl f_open失败

加1ms延迟可规避，根因未确认，需查寄存器状态

MicroBlaze启动Bootloader读SREC报错如何排查

问题未定位，仍在排查SPI配置与自测卡死点

Model Composer 与 Matlab 在 Ubuntu/Windows 下生成失败

Windows 端为 license 问题，Ubuntu 端为缺失 Qt 库，均未闭环

PS端DP端口报错是什么原因？

需先查看完整boot log定位PS DP错误，帖中未给出结论

PetaLinux 2019.2 在 Ubuntu 18.04.5 安装 Yocto SDK 失败

Ubuntu 18.04.5 不在 PetaLinux 2019.2 支持范围内，应换用受支持的宿主机

PetaLinux 2021.2 SD卡启动无法打开root设备

问题未解决，提问者按手册操作后问题依旧

PetaLinux 2021.2 编译 device-tree 报 do_configure 失败如何解决？

回答者称在 PetaLinux 2023 中通过改 devicetree.bbclass 修复，2021.2 未确认

PetaLinux 2022.1 SDK工具链编译OpenSSL报FindBin.pm缺失

疑似缺少Perl模块或模块路径配置不正确，可尝试安装或配置路径

PetaLinux 2022.1 构建失败如何生成 BOOT.bin

建议离线构建参考官方文章并禁用网络 sstate feeds 重试

PetaLinux 2022.2 ZCU106 BSP 直通 SD 卡启动 Guest 失败

帖中未给出结论，问题未解决

PetaLinux 2022.2 是否支持 Ubuntu 20.04.4？

20.04.4 LTS 受 2022.2 支持，需检查目录权限与依赖包列表

PetaLinux 2022.2 构建在 Ubuntu 20.04/22.04 上失败如何排查？

构建失败与包 configure 阶段相关，需检查对应日志

PetaLinux 2024.1 SD卡启动image.ub卡在console enabled

修正BOOT.BIN地址偏移并重跑petalinux-build后SD卡启动正常

PetaLinux升级2025.2后GEM网口启动失败

同工程同板升级到2025.2后PS网口GEM0无法初始化，根因未定位

PetaLinux安装报缺少libtool但系统已装

建议参考Xilinx AR 73296安装PetaLinux工具

Petalinux 14.7 在 Zynq7000 上构建失败如何解决？

补丁未生效，根因待日志分析，帖中未给出最终结论

Petalinux 2016.4 选 SD 卡后为何不生成 rootfs.cpio？

可从 deploy 目录取 rootfs.cpio，或改用 rootfs.ext4 并需 EXT4 分区

Petalinux 2018.3 MacB 驱动内存分配失败原因？

根因尚未确定，需提供 u-boot 及完整启动日志进一步排查

Petalinux 2020.1 获取硬件描述失败

建议对照 UG1144 检查创建工程步骤

Petalinux 2021.2 编译 checksecurity 时下载失败怎么办

需通过 bbappend 更新失效的源码 URL，或到 Debian 论坛咨询

Petalinux 2022.2 构建镜像从SD卡启动日志卡住

启动卡住原因未确定，添加rootwait未解决

Petalinux 2023.2 构建失败并出现解析错误

执行 petalinux-upgrade 和 petalinux-build -x mrproper 后恢复正常

Petalinux SD卡启动出现不支持命令错误

问题未解决，bootrom错误码0x00400000在Zynq用户指南中未定义

Petalinux SD卡模式DNS与时钟同步服务启动失败原因

问题源于配置而非版本bug，需修正vpll、服务安装及配置文件混用

Petalinux USB gadget出现UDC错误如何解决？

修改设备树dr_mode为peripheral可解决UDC错误

Petalinux从SD卡启动在U-Boot中停止并报神秘错误

问题未解决，根因未确定

Petalinux离线编译pmu-rom-native下载失败怎么办

按官方README配置离线sstate与Downloads并清理工程

QSPI启动报XFSBL_ERROR_QSPI_LENGTH失败

修正FPGA配置并重新生成XSA后QSPI启动正常

R5在TCM中运行代码访问SD卡失败

需在Xsdps驱动中为TCM地址加0xffe00000偏移以适配DMA

RFDC PLL由bitstream配置时出现频率误差，软件驱动重配后消失

软件重写相同PLL配置可消除bitstream配置带来的频率误差，根因待查

SD卡上长目录名opendir失败怎么办

帖中未给出根因或解决方案

SD卡启动卡在SDHCI平台与OF驱动助手处如何解决？

改用官方终端方法格式化SD卡后问题解决

SP701 MicroBlaze SPI模式SD卡CMD0返回0xFF如何解决？

提问者未确认根因，倾向改用专用SD控制器控制上电时序

ST6G3244ME连接SD卡方向线无法配置

根因为ST6G3244ME焊接不良，更换原型板后SD配置正常工作

U200加速卡计算单元检测为0怎么办？

dmesg无报错，问题原因未确定

Ubuntu 18.04 服务器版安装 Vivado 2022.1 出现黄色空白页

黄色空白页原因未确定，官方建议先确认安装日志并安装缺失器件

Ubuntu 20.04 上安装 2021.2.1 更新报无有效安装

可重装 2021.2 或合并 installedSW.xml 注册条目解决

Ubuntu 20.04 下 PetaLinux 2019.2 编译 libgpg-error-native 失败

问题未解决，根因未确认，仅怀疑与 gawk/Ubuntu 版本有关

Ubuntu 20.04 安装 Vitis 2021.2 解压 rdi_0309_2021.2_1021_0703.xz 报错如何解决？

根因未确认，需先排查存储空间与安装环境

Ubuntu 22.04 上 iMPACT 找不到下载线怎么办？

帖中未给出明确解决结论

Ubuntu 22.04 如何安装 Alveo XRT？

安装 amd64 版本依赖库后问题解决

Ubuntu 22.04.4 安装 Vivado 报路径过长错误

问题未解决，版主仍在询问具体错误信息与出错阶段

Ubuntu 下 vitis_hls GUI 启动后立即退出怎么办

建议用 -showguiout 启动以获取更多错误信息，根因尚未确定

UltraZed-EG 用 bootelf 从 SD 卡启动应用失败

加载到非零 DDR 地址并关闭中断后仍停在启动处，问题未解决

VCK190 SD1 LS启动：部分microSD卡启动失败(BootROM 0x22B)

问题未解决，需进一步收集第二块板测试及U-Boot mmc信息

VCK190 SD卡烧录官方demo串口报错

问题可能与启动流程相关，建议更新系统控制器

VCK190 预构建 Vitis AI SD 卡镜像无法启动

更换新 SD 卡重新烧录后问题解决

VCK190基础镜像启动时AIE IP无法启动

需使用Vitis AI专用DPU镜像，不能直接用VCK190基础镜像运行DPU应用。

VCK5000在Vitis IDE中编译cl_lmem_2rw报SD启动模式错误

Vitis IDE对VCK5000支持不佳，建议改用Makefile流程

VMK180预编译镜像SD卡启动报环境区错误

问题未解决，仅要求提供完整日志并确认PDI是否加载

VPK180 无法从 SD 卡启动，如何排查？

所贴日志来自系统控制器，需确认 SD 启动模式并读取 Versal 串口日志

Versal VPK120 SD启动UEFI报无法加载镜像

自定义machine仅用于生成BOOT.bin，linux镜像须用common machine

VirtualBox中Ubuntu虚拟机安装Vivado窗口缩放问题

安装扩展包后仍存在该问题，帖中未给出最终解决结论

Vitis 2021.1在Ubuntu 22.04编译报错怎么办？

帖中未给出原因或解决方案

Vitis 2022.2 生成 cmake 文件失败如何解决？

重装 Vitis 2022.2 后该错误消失

Vitis 2024.1 在 Ubuntu 安装解压报错如何解决

帖中未给出明确根因与解决步骤

Vitis AI 3.0 量化前检查浮点模型报错

帖中未给出结论，问题未解决

Vitis Windows 下生成 BOOT.BIN 报错无法读取平台 XML 元数据

帖中未给出根因，用户改用命令行 bootgen 手动生成 BOOT.BIN

Vitis内嵌terminal串口调试为何闪退？

帖中未给出结论，仅建议核对安装要求与依赖库

Vitis工程迁移后makefile仍指向旧路径如何修改

帖中未给出有效解决方案

Vitis教程中ROOTFS目录位置如何设置？

回答建议source $ROOTFS下的environment-setup脚本即可

Vitis构建Vadd示例出现52个错误如何解决

建议安装依赖库并选择aarch64-xilinx-linux作为sysroot，问题是否解决帖中未确认

Vitis添加DPU后show_dpu报错如何解决

安装VART后问题仍未解决，帖中无最终结论

Vitis生成设备树报hsi::generate_bsp失败

问题未解决，需完整日志进一步排查

Vitis软件仿真因libstdc++版本报错如何解决

无权限时可通过设置LD_LIBRARY_PATH指向新版libstdc++规避

Vivado 2014.4 在 Ubuntu 14.04 调用 Modelsim 失败

帖中未给出从 Vivado 启动 Modelsim 的修复方法

Vivado 2021.1综合进程被Killed如何解决

增大swap内存后综合被Killed的问题得到解决

Vivado 22.02 综合报 arctanh 未实现错误

改用对数恒等式实现 arctanh 后问题解决

Vivado Lab tool 烧录 ISSI IS25WP01G 失败

问题已通过 Service request 解决，将在 2024.2 版本修复

Vivado 添加配置存储器时报 Labtools 27-3347 错误怎么办？

可尝试两种 flash 类型脚本或只连一个设备

Vivado升级后SD卡初始化失败如何解决

重建工程并换回旧SD函数后仍无法初始化SD卡，问题未解决

Vivado在VirtualBox Ubuntu安装卡在生成设备列表

可终止卡住进程后重跑安装程序恢复，但重跑会重新下载

Vivado安装卡在Final Processing怎么办？

Ubuntu 23.04不受支持，应使用受支持的操作系统

Vivado烧写部分写保护SPI Flash报错27-3347

多位用户遇相同错误，帖中无人给出解决方案

Vivado综合报DRC MDRV-1多重驱动如何解决

建议将SPI数据端口声明为inout而非input

Win10下Platform Cable驱动安装失败

驱动安装不完整，windrvr6缺失，问题未解决

Win10新笔记本无法识别Platform Cable USB II

建议升级到最新Vivado Lab工具以解决兼容性问题

XC7K325T JTAG烧写BPI Flash报RS引脚错误

多角度排查后仍未定位根因，问题待解

XC7Z045启动失败报600C，是efuse问题吗？

问题未定位，需进一步提供FSBL调试打印和寄存器状态

XCZU2EG从SD卡启动报pmu err如何解决？

更换正确版本的SDK工具后问题解决

Z7030在SDK 2019.1下SD卡启动失败

降低SD_CLK至40MHz以下可规避该启动失败

ZC706上如何用PMOD引脚做GPIO通信？

回答仅建议查阅Digilent教程与IP库，未给出具体方案

ZC706从SD卡启动时内核无法挂载rootfs怎么办？

需修正内核启动参数中的root=以指向正确的SD卡分区

ZCU102 PL_ERROR_OUT红灯且SD卡启动失败如何解决

帖中仅询问SD卡分区配置与BOOT.BIN，未给出结论

ZCU102 PYNQ镜像重启后无法启动

问题未解决，建议转至PYNQ论坛咨询

ZCU102上加入R5应用后ATF到uboot交接挂起

加入R5应用导致ATF到uboot交接挂起，原因未明

ZCU102从SD卡启动Petalinux时bitstream未加载且10G信号中断

问题未解决，仅被引导参考Xilinx文章70504

ZCU102启动时SD卡无法读写挂载且无法登录

更换SD卡和读卡器后问题消失，疑似SD卡硬件故障

ZCU102将PS I2C0改为EMIO后SD卡启动失败

I2C0用于FSBL板级配置与时钟初始化，改EMIO后SD启动失败属预期

ZCU102将PS I2C_1改为EMIO后无法从SD卡启动

问题未解决，版主称行为异常待验证

ZCU102生成的BOOT.bin能否用于ZCU106启动？

含板级专用数据的BOOT.bin无法在ZCU106启动，建议重新生成

ZCU102用ADI Linux从SD卡启动出现mmcblk0 error -84

fsck消除了EXT-4报错、换交换机消除了macb报错，但mmcblk0错误仍存在，根因待查

ZCU104 SD卡启动FSBL卡死报CSU_BR_ERROR 0x3B00

相同SD卡和软件在新板子上正常启动，原板硬件损坏，Xilinx已安排更换

ZCU104从SD卡启动卡在FSBL阶段

问题未解决，发帖人未分享最终解决方案

ZCU104用SD卡启动PetaLinux卡在DPDMA探测

问题未解决，仅有人请求分享Block Design及设备树修改

ZCU106 QSPI模式无法启动

QSPI烧写成功且测试通过，但无法从QSPI启动，原因未确定

ZCU106 VCU_TRD改双HDMI后设备树报DMA初始化失败

问题未解决，仍在排查设备树与DP159驱动配置

ZCU208 PYNQ镜像启动后无法访问板卡IP怎么办？

疑似IP冲突、Jupyter未启动或客户端防火墙问题，未定论

ZCU216板SD卡Petalinux镜像无法启动

BOOT.BIN正常且U-Boot已启动，根因尚未确定

ZU11 BootROM从microSD卡启动失败

根因未确定，作者将继续调查

ZYNQ7020串口启动报No Valid Environment Area错误

该报错表示MMC的FAT分区无该设置，使用默认环境运行，非当前日志中的问题

Zedboard运行SD卡示例报FR_NOT_READY如何解决

换4GB卡可解决；示例代码未unmount会导致二次运行失败

ZyNQ 2023.1 QEMU下TPG到帧缓冲写yavta采集报flush未完成

多种修改后问题仍存在，帖中未给出结论

Zynq 7010 QSPI/SD启动无响应，BootROM错误码查不到

疑似eFUSE中RSA认证使能导致非签名镜像启动失败，位定义尚存分歧

Zynq Flash启动JFFS2报Magic bitmask错误

分区重复已确认，但JFFS2 Magic错误根因帖中未给出结论

Zynq GPIO_EMIO出现IBUFCTRL未布局错误如何解决

inout双向端口应在顶层例化IOBUF，需核查assign逻辑

Zynq Linux镜像启动报wrong image format

手动fatload后bootz可启动，但自动启动问题帖中未解决

Zynq MPSoC与SD卡间阻尼电阻致SD启动失败

怀疑时钟反射波内部影响MPSoC，但根因未确认

Zynq UltraScale+ MPSoC 从 SD 卡启动时 FSBL 无法打开 BOOT.BIN

问题未闭环，疑似自定义板 SD 信号完整性或时钟配置导致 FSBL 读取失败

Zynq7000 AXI GPIO Linux中断注册失败(-22)

修改设备树中断类型后可正确注册中断

Zynq7035 SD卡启动无输出如何排查

提问者按建议检查FAT分区与dirty bit，帖中未给出最终结论

ZynqMP 19EG核心板勾选DDR controller后Vitis JTAG与SD启动均失败

问题未定位，讨论停留在确认核心板型号阶段

ZynqMP Flash启动后uboot/Linux阶段reset失败

Flash启动下ZU2CG板reset失败而ZU2EG正常，根因待查

ZynqMP NAND启动失败且SD卡无法识别如何恢复

可尝试写BOOT_MODE_USER寄存器强制SD启动，但掉电不保持

ZynqMP PS PCIe接三星970 EVO Plus出现slave error如何排查

链路正常但NVMe上层异常，根因未确定，需对比lspci属性并加调试打印

Zynq平台内核解压后挂起无法启动

调整加载地址后曾成功启动，但根因未确认

aibox-reid 用 SD 卡 h264 视频无输出怎么办？

需 4K 显示器；RTSP not-linked 问题帖中未给出结论

ati-driver-installer 安装报错不支持该版本

该问题属 AMD/Graphics 类别，建议到对应分类咨询

iMPACT加载微程序失败且无法查询CFI

怀疑Flash未正常工作或连线问题，未确认根因

petalinux 2024.2 报 Network is down 无法启动

PHY 成功匹配后 DHCP 错误消失，问题解决

petalinux-build 报 fakeroot worker Broken pipe 如何解决

根因未确认，官方建议使用受支持的宿主系统版本

petalinux-config 报 Failed to source bitbake 如何排查？

改到更短工程路径后问题可解决，根因未明确

petalinux-package bsp 报错无法创建 /build 目录

按 GitHub 上修复 petalinux-package bsp project 参数的 PR 修改后可成功打包

petalinux2021.2编译qemu-xilinx-native报Taskhash mismatch

在线编译可绕过，离线cache仍报错，根因未确认

resnet50_waa_aie的run.sh为何仅支持32 AI引擎配置

需查看错误日志或V++日志确认是否为资源不足

xazu5ev生成PetaLinux时无法启用OpenAMP

按UG1186步骤配置后remoteproc目录仍为空，原因帖中未给出

xazu5ev生成PetaLinux时无法启用OpenAMP

问题未解决，帖中未给出明确根因

xbmgmt flash 命令不可用怎么办？

建议改用 2021.1 之后的新版指南和更新后的 xbmgmt 命令

xlnx,phy-type 已弃用且获取时钟失败 -2 如何解决

改 phy-mode 可消除警告，但以太网仍无法工作，问题未解决

包含libgpiod库时出现链接错误怎么办？

建议在Makefile中添加-lgpiod链接选项，但提问者未反馈结果

向/dev/uio4写入时返回Invalid argument如何解决

以 root 权限和 O_RDWR 打开后 write 仍返回 -1，问题未解决

固化程序可烧FPGA但无法烧写Flash怎么办？

问题未解决，仍无法将固化程序烧录到Flash

如何从SD卡EXT4第二分区加载rootfs

添加sdhci1设备树节点后可从SD卡EXT4分区启动rootfs，但bootargs被重写等问题仍需排查

如何永久修改SD卡启动设备的PS以太网MAC地址

修改设备树未生效，帖中未给出可行方案

安装PetaLinux后主机cmake工具链被改变如何解决

注释~/.bashrc中相关环境变量后问题解决，更优雅方案未确定

嵌入式Ubuntu上OpenCL平台获取失败(-1001)如何安装xilinx.icd

手动安装xilinx.icd或升级xrt-embedded后OpenCL平台可正常识别

平台设为QSPI启动模式时应用工程无法构建

问题未解决，无明确根因与可行方案

拷贝Kria镜像的Ubuntu为何sctp.ko加载失败？

需用与5.15.0-1015-xilinx-zynqmp内核头文件匹配的方式生成sctp.ko

按UG1209示例启动Linux应用时FPGA Region探测后卡住

问题未解决，怀疑deferred probe，需排查设备树与依赖资源

替换VCK190预构建SD卡文件后resnet18失败

替换文件后DPU未正确加载，xbutil报No devices found，问题未解决

生成比特流时报Common 17-165错误怎么办

回答建议修正show_objects命令中name参数的空格写法

自定义PetaLinux镜像SD卡启动循环且bootscript.service失败

启用CONFIG_watchdog-init后启动循环问题解决

节点锁定许可证如何从Windows迁移到Linux双系统

节点锁定许可证可在Windows或Linux任一环境使用，在Linux中重新加载即可

许可证从Windows重托管到Ubuntu时报错

建议通过技术支持case处理，帖中未给出最终解决

运行 installLibs.sh 提示 command not found 怎么办？

文件存在但直接执行报错，可尝试修改日志路径或使用修改版脚本

PetaLinux 编译太慢怎么提速

缓存、并行度与组件裁剪的实际收益

← 知识库 AMD 社区问答速查 →