xilinx/aibox-reid

Kria KV260 AI-Box ReID示例应用镜像

镜像概述

本镜像为Xilinx Kria KV260 AI-Box平台设计，提供行人重识别（Person Re-identification, ReID）示例应用，旨在演示和开发基于该硬件平台的ReID功能，帮助开发者快速评估和上手KV260在边缘AI视觉领域的应用能力。

核心功能与特性

• 平台适配：专为Kria KV260 AI-Box硬件平台优化，充分利用其嵌入式处理器与AI加速资源
• ReID算法集成：内置行人重识别基础算法示例，实现跨场景、跨摄像头的行人特征匹配功能
• 即演示性：提供可直接运行的示例应用，直观展示ReID算法在KV260上的运行效果
• 开发支持：可作为基础框架，支持开发者在此基础上扩展和优化ReID模型与应用逻辑

使用场景

• 嵌入式AI开发者学习Kria KV260平台上ReID应用开发
• 边缘视觉系统原型验证，快速评估ReID算法在嵌入式环境的性能
• AI视觉应用教学与演示，展示硬件加速对边缘AI任务的提升效果

使用方法与配置说明

前提条件

• 已部署Kria KV260 AI-Box开发平台，且系统已安装Docker运行环境
• 已配置KV260平台的FPGA bitstream与相关驱动，确保硬件加速功能可用
• 本地环境已安装适配ARM架构的Docker引擎（KV260为ARM Cortex-A53架构）

镜像获取

通过以下命令拉取镜像（假设镜像仓库地址为xilinx/kria-kv260-reid-example）：

bash
docker pull docker.xuanyuan.run/xilinx/kria-kv260-reid-example:latest

运行示例

使用以下命令启动ReID示例应用：

bash
docker run --rm \
  --device /dev/xlnx_dma \
  --device /dev/xlnx_video \
  -v /opt/xilinx/kv260-reid/data:/app/data \
  -p 8080:8080 \
  docker.xuanyuan.run/xilinx/kria-kv260-reid-example:latest

参数说明：

• --device /dev/xlnx_dma：挂载KV260 DMA设备，支持数据传输加速
• --device /dev/xlnx_video：挂载视频输入设备，用于处理摄像头或视频流数据
• -v /opt/xilinx/kv260-reid/data:/app/data：挂载本地数据目录，用于存放输入图像/视频及输出结果
• -p 8080:8080：映射Web端口（如示例应用提供Web界面）

应用访问与操作

1. 应用启动后，通过浏览器访问 http://<kv260-ip>:8080 打开示例界面
2. 上传测试图像或连接摄像头，启动ReID匹配演示
3. 查看算法输出结果，包括行人特征提取、跨图像匹配等功能展示

注意事项

• 本镜像为示例应用，主要用于开发与演示，不建议直接用于生产环境
• 运行前需确保KV260平台已加载正确的FPGA配置文件（bitstream）
• 如需调整ReID模型或算法参数，可通过挂载自定义配置文件至/app/config目录实现