Documentation

中文

English

中文

English

主题

LILYGO T-Keyboard S3 Pro get it now ​

T-Keyboard S3 Pro 正面图
T-Keyboard S3 Pro 实物图
T-Keyboard S3 Pro 引脚图

重要提示：使用时必须要有主机，从机通过磁吸接口与主机连接。

概述 ​

T-Keyboard-S3 Pro 是一款基于双 MCU 架构（ESP32-S3 + STM32G030F6P6）的高端可编程键盘，专为开发者与专业用户打造。其核心亮点包括 4 块 0.85 英寸 RGB LCD 屏幕（分辨率 128×128），支持多屏独立显示快捷指令、系统状态或动态交互界面；4 个热插拔机械按键兼容自定义轴体，搭配 RGB WS2812 灯效与旋转编码器，可编程背光模式及精准参数调节（如音量、滚动控制）。硬件上，主控 ESP32-S3 配备 16MB Flash + 8MB PSRAM，支持 Wi-Fi/蓝牙通信与复杂逻辑运算，外置 STM32 芯片辅助处理实时输入任务，确保低延迟响应。扩展性方面，提供 STEMMA QT/QWIIC 接口及磁吸扩展能力，可连接多个从机设备，打造多功能控制终端。

快速开始 ​

使用注意事项 ​

  1. I2C 通信扩展：默认固件配置为 I2C 通信扩展模式。扩展从设备时，必须确保每个设备具有唯一的 I2C 地址，避免地址冲突。
  2. 设备数量限制：最多可连接 6 个设备。连接多个设备时，需要将板载 LED 的最大亮度调低至 10。
  3. 扩展方向限制：主控板左右两侧各只能扩展一个设备，向下最多可扩展两个设备，最多形成 2×3 的网格布局。

ESP32-S3 主机示例 ​

示例PlatformIO/Arduino描述
GFX✓图形库示例
Keyboard✓键盘输入示例
Rotary_Encoder✓旋转编码器
Shortcut-Keys✓快捷键示例
Lvgl_UI✓出厂 UI 示例
Original_Test_2✓出厂测试程序
T-Keyboard-S3-Pro_IIC_Command✓I2C 命令示例

STM32 从机示例 ​

示例描述
KEY按键测试
Original_Test出厂测试
WS2812BRGB 灯效
T-Keyboard-S3-Pro_IIC_CommandI2C 命令

PlatformIO（ESP32-S3） ​

  1. 安装 Visual Studio Code 并安装 "PlatformIO IDE" 扩展。
  2. 从 GitHub 下载 T-Keyboard-S3-Pro 项目代码。
  3. 在 VS Code 中打开项目文件夹，在 platformio.ini 中取消注释所需示例环境。
  4. 点击 (✔) 编译，连接设备后点击 (→) 烧录。

Arduino（ESP32-S3） ​

  1. 安装 Arduino IDE，安装 Espressif Systems 的 ESP32 开发板支持包。
  2. 将项目 libraries 目录中的所有库复制到 Arduino 库目录。
  3. 在"工具"菜单中选择正确的设置：
Arduino IDE 设置值
BoardESP32S3 Dev Module
Upload Speed921600
USB ModeHardware CDC and JTAG
USB CDC On BootEnabled
USB Firmware MSC On BootDisabled
USB DFU On BootDisabled
CPU Frequency240MHz (WiFi)
Flash ModeQIO 80MHz
Flash Size16MB (128Mb)
Core Debug LevelNone
Partition SchemeDefault (6.25MB APP/3.43MB SPIFFS)
PSRAMOPI PSRAM
Arduino Runs OnCore 1
Events Run OnCore 1

STM32CubeProgrammer（从机固件烧录） ​

  1. 安装 STM32CubeProgrammer。
  2. 选择正确的调试器（STLINK 或 UART），选择 firmware 文件，点击 "Start Programming" 开始下载。

从机调试口位于 "T-Keyboard-S3-Pro_Keyboard" 板背面。

开发平台 ​

  1. Platform IO
  2. Arduino IDE
  3. STM32CubeMX
  4. ARM Keil μVision5

视频 ​

主要特点 ​

  • ESP32-S3-WROOM-1：16 MB Flash，8 MB PSRAM（Octal SPI），Wi-Fi + 蓝牙 5.0
  • STM32G030F6P6：64 KB Flash，8 KB SRAM，负责实时键盘输入处理
  • 4 × 0.85 英寸 GC9107 TFT LCD（128×128），多屏独立显示
  • 4 × 热插拔机械按键（兼容 MX 结构，含屏幕按键）
  • WS2812C RGB 可编程灯效，旋转编码器
  • 磁吸扩展接口，最多连接 6 个从机，支持 2×3 网格布局
  • 2 × STEMMA QT/QWIIC 接口

产品参数 ​

组件描述
主处理器ESP32-S3R8 Dual-core LX7
协处理器STM32G030F6P6
Flash16MB (ESP32-S3) + 64KB (STM32)
PSRAM8MB (ESP32-S3) + 8KB (STM32)
屏幕4 × 0.85 英寸 GC9107 TFT LCD (128×128)
按键4 × 热插拔机械按键 + 旋转编码器
RGBWS2812C
无线2.4 GHz Wi-Fi + Bluetooth 5.0
USB1 × TYPE-C
扩展接口2 × QWIIC + 4 × 磁吸接口
尺寸164 × 46 × 42mm

引脚图 ​

T-Keyboard S3 Pro 引脚图

ESP32-S3 引脚映射 ​

I2C_1ESP32S3 引脚
SDAIO42
SCLIO2
I2C_2（外扩）ESP32S3 引脚
SDAIO6
SCLIO7
LCD 屏幕ESP32S3 引脚
MOSIIO40
SCLKIO41
DCIO39
RSTIO38
BLIO1
旋转编码器ESP32S3 引脚
KNOB_DATA_AIO4
KNOB_DATA_BIO5
KNOB_DATA_KEYIO0

STM32G030 引脚映射 ​

I2CSTM32G0 引脚
SDAPC14/PB9
SCLPB7/PB8
KEYSTM32G0 引脚
KEY1PA1
KEY2PA0
KEY3PC15
KEY4PB3/PB4/PB5/PB6
KEY5PA12[PA10]
LCD CSSTM32G0 引脚
LCD_CS1PA4
LCD_CS2PA11[PA9]
LCD_CS3PB0/PB1/PB2/PA8
LCD_CS4PA6
LCD_CS5PA5
WS2812BSTM32G0 引脚
WS2812B_DATAPA7

尺寸图 ​

原理图 ​

数据手册 ​

软件开发 ​

依赖库 ​

常见问题 ​

  • Q. T-Keyboard S3 Pro 的主要特点是什么？
    A. 高端可编程键盘，具有 4 块独立 LCD 屏幕、热插拔机械按键、RGB 灯效、旋转编码器和双 MCU 架构，支持多设备磁吸扩展。

  • Q. 如何扩展从机设备？
    A. 通过磁吸接口连接从机设备，最多支持 6 个设备组成 2×3 网格布局。注意每个从机必须有唯一的 I2C 地址。

  • Q. 热插拔机械按键支持哪些轴体？
    A. 支持标准的热插拔机械轴体，兼容大多数 MX 结构的机械轴，且按键中间有开孔支持屏幕 FPC 连接。

  • Q. 连接多个设备时需要注意什么？
    A. 需要将 LED 亮度调低至 10，并注意扩展方向限制（左右各 1 个，向下最多 2 个）。

  • Q. 双 MCU 架构有什么优势？
    A. ESP32-S3 处理复杂的图形界面和无线通信，STM32 负责实时输入处理，确保低延迟的按键响应。

版本历史 ​

VersionUpdate dateUpdate description
T-Keyboard-S3-Pro_MCU_V1.12024-09-05初始版本
T-Keyboard-S3-Pro_Keyboard_V1.12024-09-05键盘板初始版本