ESP32-C3 舵机 + OLED 控制项目说明
强哥在变强
编辑于 2026年02月24日 22:42

项目概述

本项目基于 ESP32-C3 Super Mini 开发板,实现单按键循环切换舵机角度 + 0.91 寸 OLED 屏幕实时显示角度 的功能。按下按键可循环切换舵机至 0°/90°/180°,OLED 屏幕同步显示当前舵机角度,全程无引脚冲突、按键消抖稳定。

硬件清单

器件规格 / 型号数量ESP32-C3 Super Mini开发板1180° 舵机SG90 或同规格微型舵机10.91 寸 OLED 屏幕I2C 接口(128×32 分辨率)1轻触按键4 脚 / 2 脚通用1杜邦线公对公 / 公对母若干5V 电源(可选)给舵机单独供电1

硬件接线

核心接线表(无引脚冲突)

器件引脚ESP32-C3 引脚备注舵机 VCC5V舵机转动无力时建议外接 5V 电源舵机 GNDGND必须与 OLED、开发板共地舵机 信号GPIO10避开 I2C 引脚,防止冲突OLED VCC3.3V绝对不能接 5V(会烧毁屏幕)OLED GNDGND共地!共地!共地!OLED SDAGPIO9匹配开发板原生 I2C SDA 引脚OLED SCLGPIO8匹配开发板原生 I2C SCL 引脚按键 引脚 1GPIO21启用内部上拉电阻按键 引脚 2GND无需外接上拉 / 下拉电阻

接线注意事项

  1. 所有 GND 必须接在一起(共地),否则会出现通信异常、舵机抖动、屏幕不亮等问题;

  2. 舵机优先接开发板 5V,若转动无力 / 抖动,需外接 5V 电源(仅 VCC 外接,GND 仍与开发板共地);

  3. OLED 必须接 3.3V,接 5V 会直接烧毁屏幕。

软件环境

开发工具

  • Arduino IDE(推荐版本:2.x 或 1.8.19+)

依赖库安装

在 Arduino IDE 中通过「项目 → 加载库 → 管理库」安装以下库:

库名称作用ESP32Servo控制 ESP32-C3 舵机Adafruit GFX LibraryOLED 图形显示基础库Adafruit SSD1306OLED 屏幕驱动库WireI2C 通信库(ESP32 自带)

开发板配置

  1. 打开 Arduino IDE,依次点击「工具 → 开发板 → ESP32 Arduino → ESP32-C3 Dev Module」;

  2. 配置开发板参数:

    • Upload Speed:921600

    • CDC On Boot:Enabled

    • CPU Frequency:160MHz

    • Flash Size:4MB

    • Flash Mode:QIO

核心代码功能说明