ESP32-S3 USB/BLE 键盘驱动项目教程

1. 项目目录结构及介绍

esp32s3-keyboard/
├── components/
│   └── tinyusb/
├── hardware/
├── img/
├── main/
│   ├── CMakeLists.txt
│   ├── keyboard_pm.c
│   ├── keyboard_pm.h
│   ├── main.c
│   ├── ps2.c
│   ├── ps2.h
│   ├── trackpoint.c
│   └── trackpoint.h
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
└── sdkconfig.defaults

目录结构说明

• components/: 包含第三方组件，如 tinyusb，用于支持 USB 功能。
• hardware/: 包含硬件相关的文件，如电路图和 PCB 设计。
• img/: 包含项目相关的图片文件。
• main/: 包含项目的主要源代码文件。
  • CMakeLists.txt: 用于构建项目的 CMake 配置文件。
  • keyboard_pm.c/.h: 键盘电源管理相关的源代码和头文件。
  • main.c: 项目的主程序文件。
  • ps2.c/.h: PS2 接口相关的源代码和头文件。
  • trackpoint.c/.h: 轨迹球（Trackpoint）相关的源代码和头文件。
• .gitignore: Git 忽略文件配置。
• CMakeLists.txt: 顶层 CMake 配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• sdkconfig.defaults: 项目的默认配置文件。

2. 项目启动文件介绍

main/main.c

main.c 是项目的启动文件，包含了项目的初始化代码和主循环。以下是文件的主要内容：

#include "keyboard_pm.h"
#include "ps2.h"
#include "trackpoint.h"

void app_main(void) {
    // 初始化键盘电源管理
    keyboard_pm_init();
    
    // 初始化 PS2 接口
    ps2_init();
    
    // 初始化轨迹球
    trackpoint_init();
    
    // 主循环
    while (1) {
        // 处理键盘扫描
        keyboard_scan();
        
        // 处理轨迹球数据
        trackpoint_process();
        
        // 其他任务
        vTaskDelay(10 / portTICK_PERIOD_MS);
    }
}

主要功能

• 初始化: 初始化键盘电源管理、PS2 接口和轨迹球。
• 主循环: 在主循环中处理键盘扫描和轨迹球数据，并执行其他任务。

3. 项目的配置文件介绍

sdkconfig.defaults

sdkconfig.defaults 是项目的默认配置文件，用于配置 ESP-IDF 构建系统。以下是文件的部分内容：

# 启用 USB 功能
CONFIG_USB_ENABLED=y

# 启用 BLE 功能
CONFIG_BT_ENABLED=y

# 设置时钟频率
CONFIG_ESP32_DEFAULT_CPU_FREQ_MHZ=240

# 启用低功耗模式
CONFIG_ESP32_ENABLE_LOW_POWER_MODE=y

主要配置项

• USB 功能: 启用 USB 功能，使 ESP32-S3 能够作为 USB 设备。
• BLE 功能: 启用蓝牙低功耗（BLE）功能，使 ESP32-S3 能够作为 BLE 设备。
• 时钟频率: 设置 CPU 的时钟频率为 240MHz。
• 低功耗模式: 启用低功耗模式，以延长电池寿命。

通过这些配置项，可以灵活地调整项目的功能和性能。