Palm Portable Keyboard Bluetooth Adapter 项目下载及安装教程

1. 项目介绍

Palm Portable Keyboard Bluetooth Adapter 是一个 DIY 蓝牙模块项目，旨在为 Palm Portable Keyboards (PPK) 提供蓝牙功能，使其能够与支持 BLE（Bluetooth 4.0 及更高版本）的任何主机设备配合使用。该项目由 pymo 开发，提供了多个版本的适配器，包括基于 Adafruit Feather nRF52840 Express 板、LilyGo-T-OI-PLUS ESP32-C3 板以及自定义设计的 CH582F 板。每个版本都有其特点和适用场景，用户可以根据自己的需求选择合适的版本进行 DIY。

2. 项目下载位置

要下载 Palm Portable Keyboard Bluetooth Adapter 项目，请按照以下步骤操作：

1. 打开终端或命令提示符。
2. 输入以下命令以克隆项目仓库：

git clone https://github.com/pymo/ppk_bluetooth.git

3. 等待项目克隆完成。完成后，您将在当前目录下看到一个名为 ppk_bluetooth 的文件夹，其中包含项目的所有文件。

3. 项目安装环境配置

在开始安装项目之前，您需要配置相应的开发环境。以下是所需的软件和工具：

• Arduino IDE：用于编译和上传固件。
• nRF52840 开发板驱动：如果您选择使用 Adafruit Feather nRF52840 Express 板。
• ESP32-C3 开发板驱动：如果您选择使用 LilyGo-T-OI-PLUS ESP32-C3 板。
• CH582F 开发板驱动：如果您选择使用自定义设计的 CH582F 板。

环境配置示例

以下是配置 Arduino IDE 以支持 nRF52840 开发板的步骤：

1. 打开 Arduino IDE。
2. 进入 文件 -> 首选项，在 附加开发板管理器网址 中添加以下 URL：

https://adafruit.github.io/arduino-board-index/package_adafruit_index.json

3. 进入 工具 -> 开发板 -> 开发板管理器，搜索并安装 Adafruit nRF52 by Adafruit。
4. 安装完成后，选择 工具 -> 开发板 -> Adafruit nRF52840 Express。

4. 项目安装方式

根据您选择的开发板，安装方式略有不同。以下是基于 Adafruit Feather nRF52840 Express 板的安装步骤：

1. 打开 Arduino IDE。
2. 进入 文件 -> 打开，选择 ppk_bluetooth 文件夹中的 version1_tutorial.ino 文件。
3. 连接 Adafruit Feather nRF52840 Express 板到计算机。
4. 选择正确的端口（工具 -> 端口）。
5. 点击 上传 按钮，等待固件上传完成。

5. 项目处理脚本

项目中包含多个版本的教程脚本，分别位于 version1_tutorial.ino、version2_tutorial.ino 和 version3_tutorial.ino 文件中。您可以根据选择的开发板打开相应的脚本进行编译和上传。

例如，如果您选择使用 Adafruit Feather nRF52840 Express 板，请打开 version1_tutorial.ino 文件并按照上述步骤进行操作。

---

通过以上步骤，您可以成功下载、配置和安装 Palm Portable Keyboard Bluetooth Adapter 项目。根据您的需求选择合适的版本，并按照相应的教程进行操作即可。