1. KV260视觉入门套件开箱与硬件准备KV260视觉AI入门套件是Xilinx现AMD推出的面向边缘视觉计算的开发平台基于Kria K26自适应系统模块SOM。拆开包装后你会看到以下核心组件主开发板搭载K26 SOM含Zynq UltraScale MPSoC电源适配器12V/3A DC电源散热套件包含散热片和风扇快速入门指南和保修卡注意建议在防静电工作台操作触摸金属表面释放静电后再接触电路板硬件连接步骤如下将K26 SOM插入载板的SO-DIMM连接器听到咔嗒声表示安装到位连接散热片已预涂导热硅脂将风扇插头接入载板的4针风扇接口准备一张至少16GB的microSD卡建议选择UHS-I U3规格2. 系统镜像烧录与启动2.1 下载官方Ubuntu镜像Xilinx为KV260提供了预配置的Ubuntu 20.04 LTS镜像包含所有必要的驱动和工具链wget https://people.canonical.com/~platform/images/xilinx/kria/iot-kria-classic-desktop-2004-x03-20211110-98.img.xz镜像校验确保下载完整性sha256sum iot-kria-classic-desktop-2004-x03-20211110-98.img.xz # 应输出a1b2c3d4...具体值参考官网2.2 烧录镜像到SD卡推荐使用BalenaEtcher工具跨平台支持插入SD卡到读卡器打开Etcher选择下载的.img.xz文件选择正确的SD卡设备注意不要选错点击Flash!开始烧录Linux命令行烧录方法xzcat iot-kria-classic-desktop-2004-x03-20211110-98.img.xz | sudo dd of/dev/sdX bs4M statusprogress sudo sync警告务必确认of参数指向正确的SD卡设备如/dev/sdb错误的设备选择可能导致数据丢失3. 首次启动与基础配置3.1 硬件连接将烧录好的SD卡插入KV260的卡槽连接HDMI显示器支持1080p输出插入USB键盘鼠标接通以太网线或准备WiFi适配器最后连接电源适配器上电后板载LED会按以下顺序亮起红色电源指示蓝色FPGA配置中绿色系统启动完成3.2 初始系统设置首次启动会进入Ubuntu初始化界面创建用户账户建议使用ubuntu/ubuntu配置网络连接更新软件包sudo apt update sudo apt upgrade -y关键系统信息检查# 查看SoC温度 cat /sys/class/thermal/thermal_zone0/temp # 查看CPU频率 watch -n 1 cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq4. 开发环境准备4.1 安装Xilinx工具链KV260需要特定的工具链管理实用程序sudo apt install xlnx-config验证安装xlnx-config --version4.2 部署Vitis-AI运行环境安装预构建的AI加速器叠加层sudo xlnx-config --snap --install xlnx-nlp-smartvision sudo snap install xlnx-vai-lib-samples加载DPU加速器sudo xlnx-config --xmutil unloadapp sudo xlnx-config --xmutil loadapp nlp-smartvision sudo ln -sf /var/snap/xlnx-config/current/assets/dpu.xclbin /usr/lib/dpu.xclbin验证DPU状态dexplorer -w正常输出应显示DPU型号如B3136和工作频率。5. 测试摄像头与视觉应用5.1 USB摄像头测试连接USB摄像头后检查设备节点v4l2-ctl --list-devices运行人员检测示例xlnx-vai-lib-samples.test-video refinedet refinedet_pruned_0_96 /dev/video05.2 MIPI摄像头配置需附件包设置媒体管道参数media-ctl -d /dev/media1 -V ap1302.4-003c:2 [fmt:UYVY8_1X16/1280x720] media-ctl -d /dev/media1 -V b0100000.scaler:0 [fmt:UYVY8_1X16/1280x720] media-ctl -d /dev/media1 -V b0100000.scaler:1 [fmt:RBG24/1280x720]运行MIPI摄像头测试xlnx-vai-lib-samples.test-video refinedet refinedet_pruned_0_96 \ v4l2src device/dev/video2 ! video/x-raw, width1280, height720, formatBGR, framerate30/1 ! queue ! appsink6. 编译自定义应用示例6.1 准备开发工具安装编译依赖sudo apt install build-essential libopencv-dev libgoogle-glog-dev6.2 人员检测程序编译创建项目目录mkdir -p ~/person_detect cd ~/person_detect下载示例代码wget https://example.com/person_detect_sample.cpp -O main.cpp编译命令g -stdc17 -O3 main.cpp -o person_detect \ -I/usr/include/opencv4 \ -lopencv_core -lopencv_video -lopencv_videoio \ -lopencv_imgproc -lopencv_imgcodecs -lopencv_highgui \ -lvitis_ai_library-refinedet创建模型符号链接ln -sf ~/snap/xlnx-vai-lib-samples/current/models/refinedet_pruned_0_96 .运行自定义程序./person_detect /dev/video07. 常见问题排查7.1 启动问题现象HDMI无输出检查电源LED是否亮起重新插拔SD卡确保接触良好尝试不同的HDMI线缆现象系统卡在启动阶段检查SD卡烧录是否完整重新烧录尝试更换SD卡某些品牌兼容性问题7.2 DPU加载失败检查日志sudo journalctl -u xlnx-config -f常见解决方法# 重新加载服务 sudo systemctl restart xlnx-config # 强制重新安装snap sudo snap remove xlnx-nlp-smartvision sudo xlnx-config --snap --install xlnx-nlp-smartvision7.3 摄像头帧率低优化建议检查摄像头支持的分辨率v4l2-ctl -d /dev/video0 --list-formats-ext降低处理分辨率// 在代码中添加 cv::resize(frame, frame, cv::Size(640,360));8. 进阶配置建议8.1 远程开发配置启用SSHsudo systemctl enable ssh sudo systemctl start ssh配置VSCode远程开发安装Remote-SSH插件连接ubuntu板子IP安装C扩展8.2 性能监控工具安装sysstatsudo apt install sysstat实时监控# CPU使用率 mpstat -P ALL 1 # 内存使用 free -h # DPU利用率 dexplorer -m8.3 自定义Overlay创建准备开发环境sudo apt install device-tree-compiler fpga-manager-xlnx典型开发流程使用Vivado创建硬件设计导出XSA文件使用PetaLinux构建镜像打包为PAC格式我在实际使用中发现KV260的散热设计对持续AI推理至关重要。长时间高负载运行时建议确保环境通风良好监控SoC温度应85℃考虑添加辅助散热措施对于视觉项目开发合理设置视频采集参数可以显著提升性能。例如将MIPI摄像头配置为720p30fps通常能在精度和速度间取得良好平衡。当需要更高分辨率时可以考虑在DPU前添加硬件resize模块这比软件resize效率高得多。
