xilinx/smartcam

Kria KV260 SmartCam 示例应用镜像文档

镜像概述

本Docker镜像为Xilinx Kria KV260 Vision AI开发板提供SmartCam示例应用，旨在展示基于FPGA的边缘智能摄像头应用开发流程与功能实现。镜像封装了完整的智能摄像头应用栈，可帮助开发者快速上手Kria平台的视觉AI应用开发。

核心功能与特性

• 摄像头数据处理：支持USB/MIPI摄像头视频流采集与实时处理
• 边缘AI推理：集成轻量级视觉AI模型，支持实时目标检测、人脸识别等基础视觉任务
• 图像处理 pipeline：包含图像预处理（如降噪、缩放）与后处理功能
• 多输出支持：可通过HDMI显示、网络流（RTSP）或本地存储输出处理结果
• 开发兼容性：兼容Kria KV260开发板官方Linux系统环境

适用场景

• Kria KV260开发板新手入门实践
• 智能摄像头应用原型快速验证
• 边缘视觉AI算法开发测试
• 教育机构FPGA+AI视觉教学演示

使用方法

前提条件

• 已部署Docker Engine的Kria KV260开发板（推荐Docker 20.10+）
• 已连接兼容的摄像头设备（USB或MIPI-CSI）
• 开发板已安装FPGA加速驱动与设备树

获取镜像

从Xilinx官方镜像仓库拉取（具体镜像名称以官方发布为准）：

bash
docker pull xilinx/kria-kv260-smartcam:latest

基本运行命令

bash
docker run -it --rm \
  --device /dev/video0:/dev/video0 \  # 挂载摄像头设备（根据实际设备号调整）
  --device /dev/dri:/dev/dri \        # 挂载显示加速设备
  -v /tmp/.X11-unix:/tmp/.X11-unix \  # X11显示转发（用于本地GUI输出）
  -e DISPLAY=$DISPLAY \               # 设置显示环境变量
  --net=host \                        # 启用主机网络（用于网络流输出）
  xilinx/kria-kv260-smartcam:latest

自定义配置

通过环境变量调整应用参数（具体支持参数请参考镜像内置文档）：

bash
docker run -it --rm \
  [基础运行参数] \
  -e CAMERA_RESOLUTION="1280x720" \    # 设置摄像头分辨率
  -e AI_MODEL="yolov3-tiny" \          # 指定AI推理模型
  -e OUTPUT_MODE="rtsp" \              # 设置输出模式（display/rtsp/file）
  xilinx/kria-kv260-smartcam:latest

注意事项

• 首次运行需确保摄像头设备权限正确（可通过chmod 666 /dev/video0临时授权）
• 复杂AI模型运行可能需要额外FPGA加速配置，需参考Kria KV260官方加速指南
• 网络流输出需在路由器中配置端口转发（默认RTSP端口通常为554）

参考资料

• Kria KV260官方文档
• https://hub.docker.com/u/xilinx