3. KV260视觉入门套件开箱与系统启动
KV260视觉入门套件（Kria KV260 Vision AI Starter Kit）是一块面向视觉边缘计算的开发板，核心为K26 SOM（System-on-Module），载板提供MIPI摄像头接口、DisplayPort、千兆以太网、USB、microSD卡槽以及一个用于系统启动模式选择的拨码开关。拿到套件后，第一件要做的事不是直接写代码，而是让板子“活起来”：把官方Ubuntu/Debian镜像烧录到microSD卡，正确设置启动模式，通过串口或网络登录系统，并验证基础环境是否可用。这一节按实际动手顺序展开，重点讲清楚每一步的输入、操作和判断依据。
一、开箱清单与硬件准备
标准套件通常包含：K26 SOM已安装在KV260载板上、散热片与风扇、12V电源适配器、microSD卡（部分批次不含，需自备）、USB Type-C数据线（用于串口）、以太网线。此外需要一台主机（Windows/Linux/macOS均可）用于烧录镜像和串口连接。建议准备一张容量不小于16GB、Class 10以上的microSD卡，容量过小会导致Ubuntu镜像解压后空间不足。
上电前先做两件事：一是确认SOM与载板连接牢固，二是确认散热片已安装。K26 SOM在无散热条件下运行Ubuntu会迅速触发温度保护，表现为启动中途反复重启或串口输出异常，这是新手最常见的“假故障”。
二、官方镜像烧录
AMD为KV260提供两类官方镜像：Ubuntu 22.04 LTS桌面版和Debian（基于PetaLinux）版本。桌面版适合快速体验和图形化开发，Debian版更贴近嵌入式量产环境。镜像可从AMD官网Kria页面下载，文件名形如iot-limerick-kria-classic-desktop-2204-x07-20230802-118.img.gz。
烧录推荐使用Balena Etcher（跨平台）或Raspberry Pi Imager。以Etcher为例：选择下载的.img.gz文件（Etcher可直接识别压缩包，无需手动解压），选择目标microSD卡，点击Flash。烧录完成后Etcher会自动校验，校验通过即表示镜像写入完整。若使用Linux命令行，可用：
gunzip -c iot-limerick-kria-classic-desktop-2204-x07-20230802-118.img.gz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
其中/dev/sdX需替换为实际的SD卡设备名，务必确认不要写错到主机硬盘。烧录完成后，Ubuntu镜像会自动扩展根分区，首次启动会占用较长时间（约1~3分钟），这是正常现象。
三、启动模式配置
KV260载板上有一个4位拨码开关SW1，用于选择启动介质。K26 SOM支持从QSPI、SD卡、eMMC等启动。使用SD卡启动时，SW1的设置通常为：1=ON，2=OFF，3=OFF，4=ON（具体以官方文档为准，不同批次可能略有差异）。拨码开关的“ON”方向一般朝向板边，操作时用指甲或小螺丝刀轻拨即可，不要用力过猛。
设置完成后插入microSD卡，连接12V电源。此时板上的电源指示灯（绿色）应常亮，若指示灯不亮或闪烁异常，先检查电源适配器规格是否为12V/3A以上。启动过程中，风扇会转动，这是正常散热行为。
四、串口与网络连接
串口是调试阶段最可靠的通道。KV260的USB-C接口（标有UART）连接到主机后，主机会识别出一个USB转串口设备。Windows下在设备管理器中查看COM号，Linux下通常为/dev/ttyUSB0或/dev/ttyACM0。使用PuTTY、minicom或screen连接，参数固定为115200波特率、8数据位、无校验、1停止位、无流控。Linux下命令示例：
sudo screen /dev/ttyUSB0 115200
上电后串口会持续输出U-Boot和内核日志。看到kria login:提示即表示系统已启动到登录界面。默认用户名和密码均为ubuntu，首次登录会强制要求修改密码。修改完成后，系统会提示是否安装桌面环境或进行网络配置。
网络连接方面，KV260板载千兆以太网口。将网线接入路由器或交换机，系统默认通过DHCP获取IP。在串口终端中执行ip addr show eth0可查看分配的IP地址。若网络中没有DHCP服务器，可手动配置静态IP：
sudo ip addr add 192.168.1.100/24 dev eth0
sudo ip link set eth0 up
sudo ip route add default via 192.168.1.1
获取IP后，即可从主机通过SSH登录：ssh ubuntu@192.168.1.100。SSH登录比串口更方便复制粘贴和传输文件，建议在串口首次登录后立即确认SSH服务已启用。
五、首次登录与基础环境验证
登录成功后，不要急着跑AI例程，先做几项基础验证，确认系统处于可用状态。
1. 内核与系统版本：执行uname -a，应看到类似Linux kria 5.15.0-1026-xilinx-zynqmp的输出，确认是Xilinx定制内核。执行lsb_release -a确认Ubuntu版本为22.04。
2. 摄像头节点：执行ls /dev/video*，若接入了MIPI摄像头（如AP1302），应能看到/dev/video0等节点。若没有摄像头，该命令可能无输出，这属于正常情况，不代表系统异常。
3. 固件与加速器状态：执行xmutil listapps，应列出可用的加速应用（如kria-dashboard、smartcam等）。若命令不存在，说明固件包未安装，可通过sudo apt install xmutil补装。执行sudo xmutil getpkgs可查看已加载的固件包。
4. 网络与时间：执行ping -c 3 8.8.8.8确认外网连通，执行date确认系统时间正确。时间错误会导致apt更新失败，可用sudo timedatectl set-ntp true启用NTP同步。
5. 存储空间：执行df -h，确认根分区已扩展至SD卡全部容量。若根分区仍为几GB，说明自动扩展未生效，可手动执行sudo /usr/share/initramfs-tools/scripts/init-premount/resize或参考官方脚本处理。
sudo apt update && sudo apt upgrade，但注意升级内核或固件包后需要重启，且部分升级可能影响已加载的加速器固件，建议在确认基础功能正常后再进行。六、可参考的首次启动检查清单
| 检查项 | 命令/观察点 | 预期结果 |
|---|---|---|
| 电源指示 | 绿色LED | 常亮，风扇转动 |
| 串口输出 | 115200 8N1 | U-Boot日志 → 登录提示 |
| 系统版本 | uname -a | Xilinx ZynqMP内核 |
| 网络 | ip addr show eth0 | 获得192.168.x.x地址 |
| SSH | ssh ubuntu@IP | 成功登录 |
| 加速器 | xmutil listapps | 列出可用应用 |
| 存储 | df -h | 根分区接近SD卡容量 |
完成以上验证后，KV260就具备了运行视觉AI例程的基础条件。下一阶段可以加载smartcam固件，接入摄像头，在DisplayPort显示器上观察实时目标检测结果。但在此之前，请确保串口和SSH两条通道都能稳定登录，这样后续调试时无论网络是否可用，都能通过串口恢复操作。