USBvalve 项目下载及安装教程

1. 项目介绍

USBvalve 是一个开源项目，旨在帮助用户快速检测 USB 设备的活动。通过使用廉价的现成硬件，用户可以迅速测试任何 USB 文件系统的活动，并了解设备在后台的操作。USBvalve 不仅可以检测文件系统的读写操作，还可以检测 HID 设备（如 BADUSB）的活动。

2. 项目下载位置

要下载 USBvalve 项目，请访问项目的 GitHub 仓库。您可以通过以下步骤进行下载：

1. 打开终端或命令提示符。

2. 使用 git clone 命令下载项目：

   git clone https://github.com/cecio/USBvalve.git
   

3. 下载完成后，项目文件将保存在当前目录下的 USBvalve 文件夹中。

3. 项目安装环境配置

在安装 USBvalve 之前，您需要配置相应的开发环境。以下是所需的软件和硬件配置：

硬件配置

• Raspberry Pi Pico（或其他基于 RP2040 的开发板）
• I2C OLED 屏幕（128x64 或 128x32，SSD1306）
• USBvalve PCB 或面包板（可选）
• 3D 打印的隔离支架（可选）

软件配置

• Arduino IDE 2.3.3
• Adafruit TinyUSB Library 版本 3.4.0
• Pico-PIO-USB 版本 0.6.1
• Adafruit_SSD1306 OLED 库 版本 2.5.12

配置步骤

1. 安装 Arduino IDE：

   • 下载并安装 Arduino IDE 2.3.3。
   • 打开 Arduino IDE，进入 文件 -> 首选项，在 附加开发板管理器网址 中添加以下 URL：

     https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json
     

   • 进入 工具 -> 开发板 -> 开发板管理器，搜索并安装 Raspberry Pi RP2040 开发板。

2. 安装库：

   • 进入 工具 -> 管理库，搜索并安装以下库：
     • Adafruit TinyUSB Library 版本 3.4.0
     • Pico-PIO-USB 版本 0.6.1
     • Adafruit_SSD1306 OLED 库 版本 2.5.12

3. 配置开发板：

   • 选择 工具 -> 开发板 -> Raspberry Pi RP2040。
   • 设置 工具 -> CPU 速度 为 133MHz。
   • 设置 工具 -> USB 堆栈 为 Adafruit TinyUSB。

4. 项目安装方式

硬件连接

1. 将 Raspberry Pi Pico 连接到计算机。
2. 将 I2C OLED 屏幕连接到 Raspberry Pi Pico 的相应引脚（参考项目文档中的引脚映射）。
3. 如果使用 USBvalve PCB，请按照 PCB 上的指示进行焊接和连接。

软件安装

1. 打开 Arduino IDE，加载 USBvalve 项目中的 USBvalve.ino 文件。
2. 确保所有库已正确安装并配置。
3. 点击 上传 按钮，将固件上传到 Raspberry Pi Pico。

5. 项目处理脚本

USBvalve 项目包含多个处理脚本，用于构建和测试固件。以下是一些关键脚本：

• firmware/USBvalve.ino：主固件文件，包含 USBvalve 的核心功能。
• utils/build_firmware.sh：用于构建固件的脚本，适用于高级用户。
• docs/build_instructions.md：包含详细的构建和安装说明。

通过这些脚本和文档，您可以自定义和扩展 USBvalve 的功能，以满足特定的需求。

---

通过以上步骤，您可以成功下载、配置和安装 USBvalve 项目，并开始使用它来检测 USB 设备的活动。