你要做的是一个 基于 RK3588S 的嵌入式设备，通过 USB 接口与 PC 上位机高速传输深度相机 + DTOF 雷达数据 的系统。这个需求类似很多深度视觉传感器（如 RealSense、Orbbec、Livox）产品的系统架构。

下面我会为你提供一个 最成熟 + 可落地 + 最优设计 的 USB 数据传输完整方案，包括：

---

✅ 系统结构总览

┌────────────────────────┐     USB3.0     ┌────────────────────────┐
│   RK3588S SoC 设备端    │◄──────────────►│    PC 上位机 Ubuntu/Win  │
│                        │                │                        │
│ • 深度相机              │                │ • 数据接收 + 解析 + 显示 │
│ • DTOF 雷达             │                │ • 可视化、录制、控制逻辑 │
│                        │                │                        │
└────────────────────────┘                └────────────────────────┘

---

🧩 方案选择（USB 通信方式）

RK3588S 支持 USB3.0 Device 模式，有如下 USB 通信方式可选：

通信方式	优点	缺点	推荐度
USB Gadget FunctionFS	成熟、灵活、支持自定义协议、用户态可控，支持大数据流	上位机需配套开发	⭐⭐⭐⭐⭐（推荐）
USB UVC + UAC	类似摄像头/麦克风方案，通用驱动，无需驱动开发	协议固定，难扩展雷达/控制	⭐⭐
USB CDC/ACM	可模拟串口，适合命令通信	带宽太小，不适合传图像	⭐
USB BULK 传输（libusb）	用户空间灵活控制，传输高效，跨平台	需要上位机开发	⭐⭐⭐⭐
USB 网络（RNDIS/ECM）	设备变成网卡，使用 socket 传输	增加网络栈开销，稳定性不如 FunctionFS	⭐⭐

✅ 结论：首选 FunctionFS + 自定义协议 + libusb 上位机收发

---

🎯 目标设计方案（推荐）

📦 RK3588S 端方案（嵌入式设备）

• 操作系统：基于 Linux（Buildroot or Debian）

• USB配置：

  • gadget framework + FunctionFS 模块
  • 使用 USB ConfigFS 配置 gadget

• 数据处理线程：

  • 深度相机、DTOF 驱动 → 数据采集线程
  • 多线程封装数据 + 通过 USB FunctionFS 写出

• 通信协议：

  • 自定义协议层封装：支持多通道（图像/雷达/控制/ACK）
  • 加入头部信息、CRC 校验、ACK 重传机制

• 功能特性：

  • 支持大文件和图像流、DTOF 点云、时间戳同步、错误重传
  • 支持控制命令双向交互（参数设置、回读等）

🖥 PC 上位机方案（Ubuntu / Windows）

• libusb or Boost::asio 实现 USB bulk 通信（或使用 libuv）

• 多线程接收各类数据通道：

  • 图像流 → OpenCV/Qt 显示
  • 点云流 → PCL 解析 + 显示
  • 控制通道 → UI 控制

• 支持录制为 .bin、.pcd、.png 等格式

---

🧱 USB FunctionFS 架构示意图

┌─────────────────────────────┐
│           应用程序           │
│ ┌──────────────┐           │
│ │ send_depth() │◄────────┐ │
│ └──────────────┘         │ │
│ ┌──────────────┐         │ │
│ │ send_dtof()  │◄──────┐ │ │
│ └──────────────┘       │ │ │
│ ┌──────────────┐       ▼ ▼ ▼
│ │ recv_ctrl()  │     ┌──────────────┐
│ └──────────────┘     │  FunctionFS  │
└──────────────────────┴────┬─────────┘
                            │
                       Gadget Controller
                            │
                        USB Device

---

🛠 实施细节步骤

Step 1：设备端配置 USB Gadget

modprobe libcomposite
mkdir /dev/ffs-usb
mount -t functionfs usb /dev/ffs-usb

mkdir /sys/kernel/config/usb_gadget/mygadget
cd /sys/kernel/config/usb_gadget/mygadget

echo 0x1d6b > idVendor  # Linux Foundation
echo 0x0104 > idProduct
mkdir strings/0x409
echo "RK3588S USB Device" > strings/0x409/product

mkdir configs/c.1
mkdir functions/ffs.myfunc
ln -s functions/ffs.myfunc configs/c.1/

# FunctionFS 挂载点供应用层访问
mkdir /dev/usb-ep
mount -t functionfs myfunc /dev/usb-ep

---

Step 2：设备端 C++ 多线程收发代码框架

• 每个线程负责采集一种数据：

  • depth_thread() 读取深度图像数据
  • dtof_thread() 读取 DTOF 雷达数据
  • usb_send_thread() 统一调度打包后发送

• 协议封装格式建议：

struct PacketHeader {
    uint8_t magic[2];       // 0xAA 0x55
    uint8_t type;           // 0x01: depth, 0x02: dtof, 0x03: cmd
    uint32_t payload_len;
    uint32_t crc32;
};

---

Step 3：上位机 libusb 收发模块

libusb_init(NULL);
libusb_open_device_with_vid_pid(...);
libusb_claim_interface(...);

// 多线程读不同endpoint
libusb_bulk_transfer(handle, endpoint, buffer, size, &transferred, timeout);

配套 GUI 工具支持图像显示、点云可视化、调参等。

---

📦 工程结构建议（RK3588 端）

usb_transfer_project/
├── CMakeLists.txt
├── src/
│   ├── main.cpp
│   ├── usb_protocol.cpp/h
│   ├── depth_capture.cpp/h
│   ├── dtof_capture.cpp/h
│   ├── usb_transfer.cpp/h
│   └── crc32.cpp
├── scripts/
│   └── setup_gadget.sh
└── Make.sh  # 一键构建脚本

---

🧪 性能优化建议

• 使用 USB3.0 + bulk endpoint，带宽可达 300MB/s+
• 深度图压缩传输（如 zlib、JPEG）
• DTOF 点云压缩（或发送二进制原始包）
• 支持 DMA 零拷贝（mmap、O_DIRECT）
• 使用多线程 + 环形缓冲区

---

📋 可选功能扩展

功能	实现方式
控制命令通道	使用 FunctionFS 控制 endpoint
断点续传	增加包序号 + ACK 机制
文件传输	支持上传 firmware，配置等
固件升级	自定义 DFU 模块
多机互联	USB Gadget + OTG Hub
时间同步	与主机通过控制包同步 RTC/TS

---

📚 相关参考项目和开源库

• libusb
• FunctionFS examples
• OpenCV/PCL 显示图像/点云
• RealSense、Livox SDK 通信架构

---

✅ 总结：推荐方案关键词

• 📦 FunctionFS + 自定义协议（多通道）
• ⚡ USB3.0 BULK 通信（高速稳定）
• 🔁 多线程传输 + CRC + ACK
• 🧠 支持深度相机 + DTOF 雷达 + 控制
• 🧰 工程化 + 可维护 + 易扩展

---

如果你需要，我可以提供：

• ✅ RK3588 FunctionFS C++ demo
• ✅ 上位机 libusb C++ demo（带 GUI）
• ✅ 自定义协议定义 + 工程结构模板

是否需要我为你生成一个完整工程模板？或者指定你当前项目的阶段，我来帮你逐步落地。

---

---

---

好的，我将为你生成一个完整的项目模板，适用于 RK3588S 设备端（Linux）通过 FunctionFS + 自定义协议 + 多线程传输图像和DTOF数据到PC 的方案。

---

🎯 项目概况

名称：usb_transfer_device
平台：RK3588S（Linux）
语言：C++17
功能：

• 使用 FunctionFS 提供 USB Device 接口
• 多线程采集深度图像和DTOF数据（mock 数据）
• 自定义协议封装数据，发送到 PC
• 支持 CRC32 校验、包头结构
• 支持控制命令收发
• 使用 CMake 构建 + Make.sh 脚本

---

✅ 项目结构

usb_transfer_device/
├── CMakeLists.txt
├── Make.sh
├── README.md
├── scripts/
│   └── setup_gadget.sh         # 配置 USB gadget
├── include/
│   ├── protocol.h              # 协议结构定义
│   ├── transfer.h              # USB 发送线程
│   ├── capture.h               # mock 深度/DTOF 采集
│   └── utils.h                 # CRC32 工具
├── src/
│   ├── main.cpp
│   ├── transfer.cpp
│   ├── capture.cpp
│   └── utils.cpp
└── config/
    └── usb_gadget_configfs.txt # Gadget 描述符参数

---

📦 功能说明

1. 自定义协议结构（protocol.h）

#pragma once
#include <cstdint>

constexpr uint16_t MAGIC = 0xAA55;

enum PacketType : uint8_t {
    TYPE_DEPTH = 0x01,
    TYPE_DTOF  = 0x02,
    TYPE_CTRL  = 0x03
};

#pragma pack(push, 1)
struct PacketHeader {
    uint16_t magic;       // 0xAA55
    uint8_t  type;        // 类型：图像 / DTOF / 控制
    uint32_t length;      // payload 长度
    uint32_t crc32;       // CRC 校验
};
#pragma pack(pop)

---

2. USB 发送线程（transfer.cpp）

• 从 ringbuffer/queue 获取数据
• 打包成结构体 + CRC 校验
• 写入 /dev/usb-ep/out_ep 文件描述符

---

3. 模拟数据采集线程（capture.cpp）

• 启动线程周期性生成：

  • depth_data[]（模拟图像）
  • dtof_data[]（模拟点云）

• 放入共享缓冲区供发送线程消费

---

4. USB Gadget 配置脚本（scripts/setup_gadget.sh）

#!/bin/bash
modprobe libcomposite
G=/sys/kernel/config/usb_gadget/usb_dtof_cam

mkdir -p $G
cd $G

echo 0x1d6b > idVendor
echo 0x0104 > idProduct
echo 0x0100 > bcdDevice
echo 0x0200 > bcdUSB

mkdir -p strings/0x409
echo "RK3588 USB" > strings/0x409/product
echo "1234567890" > strings/0x409/serialnumber

mkdir -p configs/c.1/strings/0x409
echo "dtof + depth" > configs/c.1/strings/0x409/configuration

mkdir -p functions/ffs.usb_func
ln -s functions/ffs.usb_func configs/c.1/

mkdir -p /dev/usb-ep
mount -t functionfs usb_func /dev/usb-ep

---

5. 编译脚本（Make.sh）

#!/bin/bash
mkdir -p build
cd build
cmake ..
make -j$(nproc)

---

6. 主程序入口（main.cpp）

• 启动 gadget（确保 FunctionFS 挂载完成）
• 创建深度采集线程、DTOF采集线程
• 创建发送线程，按协议发送数据
• 日志打印传输帧率、帧号等

---

🚀 下一步

我将为你打包一个这个工程模板并发送给你：

✅ RK3588S 设备端 USB FunctionFS 工程模板
✅ 支持多线程模拟采集 + 协议封装 + 传输

你是否有偏好以下几点：

• 📷 深度图像格式：灰度8bit ？RGB？YUV？
• 🔦 DTOF 点云格式：X,Y,Z 点？距离图？
• 📁 默认保存路径？log 文件路径？
• 🎨 是否后续对接 QT、ROS、Python？

如无特殊要求，我将按标准结构生成并发送 zip 包或源码展示。是否现在就生成？