参考keysking基于 STM32C8T6 与 CubeIDE 开发 OLED 屏幕

目录

一、前言

二、博主定位与技术影响力

三、开发环境与硬件准备

3.1 开发环境(二者选其一)

3.2 硬件

四、CubeMX 配置

4.1 新建工程

4.2 时钟配置

4.3 引脚配置

4.4配置sys

4.5 生成代码

五、代码实现

5.1 OLED 驱动代码

5.2 在 main 函数中调用初始化函数

六、编译与下载

七、取模助手的使用

八、总结

---

一、前言

        OLED（Organic Light - Emitting Diode）即有机发光二极管，因其自发光、视角广、响应速度快等优点，在嵌入式开发中得到了广泛应用。本文将详细介绍如何使用 STM32C8T6 芯片和 CubeIDE 开发环境来驱动 OLED 屏幕，参考B站up主Keysking的oled教学视频，对操作进行简单修改，把 PB10 和 PB11 设置为开漏输出，用 PB10 模拟 CSL（片选信号），PB11 模拟 SDA（数据信号）实现一样的效果，教大家如何使用取模助手实现自定义图片。

二、博主定位与技术影响力

        keysking 是 B 站嵌入式开发领域的头部技术博主，其核心内容聚焦于STM32 开发、物联网应用、硬件驱动优化三大方向。根据第三方数据平台统计，其主账号（UID:6100925）累计播放量已突破1600 万，单期视频最高播放量达120 万，粉丝画像中学生群体占比 58%，工程师群体占比 32%，形成了从入门到进阶的完整知识体系。

技术特色：

1. 底层原理可视化：通过示波器波形分析、寄存器配置动画等手段，将抽象的硬件原理转化为直观的动态演示。例如在讲解 SPI 通信时，用 LED 灯阵列模拟时钟信号与数据传输过程。
2. 项目实战导向：所有教程均配套开源代码和硬件方案，典型案例包括：
   • 智能家居中控系统：基于 STM32F407+ESP8266 实现温湿度监测、语音控制、远程 OTA 升级
   • 工业级数据采集器：通过 DMA + 双缓冲技术实现 100kHz 高速 ADC 采样
   • 开源四轴飞行器：整合 MPU6050 传感器融合算法与 PID 控制
3. 工具链整合能力：
   • 自研取模工具支持UTF-8 编码中文直接输出（兼容 Arduino/STM32）
   • 开发 STM32CubeMX 代码生成插件，可自动生成带注释的 HAL 库工程
   • 设计 PCB 版图时采用 KiCad+Altium Designer 混合工作流

三、开发环境与硬件准备

3.1 开发环境(二者选其一)

• STM32CubeIDE：这是 ST 公司推出的集成开发环境，集成了 STM32CubeMX 的配置功能和 GCC 编译器，能极大提升开发效率。
• STM32CubeMX：用于图形化配置 STM32 芯片的引脚、时钟、外设等参数。

3.2 硬件

• STM32C8T6 开发板：一款常用的 STM32 开发板，资源丰富，适合初学者。
• OLED 屏幕：本文以 128x64 的 I2C 接口 OLED 为例。

四、CubeMX 配置

4.1 新建工程

        打开 STM32CubeMX，选择 “New Project”，然后选择 STM32C8T6 芯片，点击 “Start Project”。

4.2 时钟配置

        在 “RCC” 选项中，将 “HSE” 设置为 “Crystal/Ceramic Resonator”，同时配置系统时钟，可将系统时钟设置为 72MHz。

4.3 引脚配置

        在 “Pinout & Configuration” 中，把 PB10 和 PB11 设置为 “GPIO_Output”。接着，点击 PB10 和 PB11 引脚，在 “GPIO mode” 中选择 “Output Open - Drain”，将其设置为开漏输出模式。我们将 PB10 用于模拟 CSL 信号，PB11 用于模拟 SDA 信号。

配置PB10和PB11引脚,同时可以右键修改用户标签

然后配置PB10和PB11GPIO,这里配置PB10的,PB11完全一样,别忘了哈

这里这个选浮空

4.4配置sys

没有配置就烧录会锁住芯片

4.5 生成代码

        完成配置后，点击 “Project Manager”，设置工程名称和路径，选择 “STM32CubeIDE” 作为工具链，最后点击 “Generate Code” ,或者ctrl+s生成代码并在 CubeIDE 中打开。

五、代码实现

5.1 OLED 驱动代码

        我们需要实现 OLED 的初始化、写命令、写数据等函数。这个我们使用Keysking的驱动：

进入网站波特律动 | 波特律动点击开始

点击资料包,OLED驱动和取模助手我们都要用到

先打开驱动下载驱动,这里根据oled型号下载驱动

下载后打开按第一个方框路径打开Core文件,然后Inc是库文件,Src是源文件,分别进入会看到font.h , oled.h 和font.c , oled.c文件,这些就是驱动文件了

我们需要在工程添加font.h , oled.h 和font.c , oled.c

以cubeide为例复制粘贴后文件是这样的

5.2 在 main 函数中调用初始化函数

c

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2025 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"
#include "gpio.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "oled.h"

/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */

/* USER CODE END PTD */

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */

/* USER CODE END PD */

/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */

/* USER CODE END PM */

/* Private variables ---------------------------------------------------------*/

/* USER CODE BEGIN PV */

/* USER CODE END PV */

/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
/* USER CODE BEGIN PFP */

/* USER CODE END PFP */

/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */

/* USER CODE END 0 */

/**
  * @brief  The application entry point.
  * @retval int
  */
int main(void)
{

  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  /* USER CODE BEGIN 2 */
  HAL_Delay(100); // 延时100ms，等待OLED上电稳定
  OLED_Init(); // 初始化OLED
//  OLED_NewFrame(); // 开始新的一帧
//  OLED_ShowFrame(); // 显示当前帧
//

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
for (uint8_t i = 0; i < 64; i++) {
    OLED_NewFrame();                         // 创建新画布
    OLED_DrawImage(..., &bilibiliImg, ...);  // 绘制居中图片
    OLED_PrintString(128 - i, ..., "波特律动hello", ...); // 绘制滚动文字
    OLED_ShowFrame();                        // 刷新显示
    HAL_Delay(100);                          // 控制动画速度
}
// 横向滚动文字效果：
// 128 - i 作为X坐标会使字符串"波特律动hello"从屏幕右侧（i=0时X=128）逐渐向左平移
// 每次循环i增加1，文字向左移动1像素
// Y坐标64 - 16表示在64像素高度的屏幕上，从底部向上16像素的位置显示
// 静态图片显示：
// (128 - (bilibiliImg.w)) / 2 计算图片的水平居中位置
// 图片始终显示在屏幕顶部（Y坐标0）
// 使用OLED_COLOR_NORMAL保持正常显示颜色
// 动画控制：
// 每次循环创建新帧 → 绘制内容 → 显示帧 → 延时100ms
// 循环64次后文字将完全移出屏幕左侧（i=63时X=65）
// 这段代码在OLED上实现了一个包含滚动文字和静态图片的动画效果，整体效果是文字从右向左平滑滚动，同时屏幕顶部保持显示居中图片。

    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */

 }
/**
  * @brief System Clock Configuration
  * @retval None
  */
void SystemClock_Config(void)
{
  RCC_OscInitTypeDef RCC_OscInitStruct = {0};
  RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

  /** Initializes the RCC Oscillators according to the specified parameters
  * in the RCC_OscInitTypeDef structure.
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
  RCC_OscInitStruct.HSEState = RCC_HSE_ON;
  RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
  RCC_OscInitStruct.HSIState = RCC_HSI_ON;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
  RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
  {
    Error_Handler();
  }

  /** Initializes the CPU, AHB and APB buses clocks
  */
  RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                              |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
  RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
  RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
  RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
  {
    Error_Handler();
  }
}

/* USER CODE BEGIN 4 */

/* USER CODE END 4 */

/**
  * @brief  This function is executed in case of error occurrence.
  * @retval None
  */
void Error_Handler(void)
{
  /* USER CODE BEGIN Error_Handler_Debug */
  /* User can add his own implementation to report the HAL error return state */
  __disable_irq();
  while (1)
  {
  }
  /* USER CODE END Error_Handler_Debug */
}

#ifdef  USE_FULL_ASSERT
/**
  * @brief  Reports the name of the source file and the source line number
  *         where the assert_param error has occurred.
  * @param  file: pointer to the source file name
  * @param  line: assert_param error line source number
  * @retval None
  */
void assert_failed(uint8_t *file, uint32_t line)
{
  /* USER CODE BEGIN 6 */
  /* User can add his own implementation to report the file name and line number,
     ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
  /* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */

六、编译与下载

        在 CubeIDE 中，点击 “Build” 按钮编译代码。若编译成功，将 STM32C8T6 开发板通过 ST - Link 连接到电脑，点击 “Debug” 或 “Run” 按钮将代码下载到开发板中。

我们的oled会显示这个图案了, 恭喜你成功80%了

七、取模助手的使用

 打开取模助手, 上传图片, 图片名称最好修改,这里我修改成doubao , 大家可以在这里看看不同功能, 有什么效果, 最后点击绿色图标生成代码。

回到cubeide复制代码并调用, 首先复制到font.c

然后到font.h申明一下

回到取模助手, 我们再生成汉字

回到cubeide复制代码并调用, 首先复制到font.c ,这里可以对比一下驱动的示例, 这个不需要去.h申明了

最后修改原来的代码

for (uint8_t i = 0; i < 64; i++) {
  	    	  OLED_NewFrame();
  	    	  OLED_DrawImage((128 - (doubaoImg.w)) / 2, 0, &doubaoImg, OLED_COLOR_NORMAL);
  	    	  OLED_PrintString(128 - i, 64 - 16, "我叫小朱,hello", &font16x16, OLED_COLOR_NORMAL);
  	    	  OLED_ShowFrame();
  	    	  }

 编辑上传, 你就可以得到自定义的oled

八、总结

通过以上步骤，我们使用 STM32C8T6 和 CubeIDE 成功驱动了 OLED 屏幕。关键在于 CubeMX 的引脚配置和 OLED 驱动代码的实现。在实际开发中，你可以根据需求扩展显示内容，如显示图片、文字等。

希望本文能帮助你顺利完成 OLED 屏幕的开发，若在开发过程中遇到问题，可参考 STM32 的官方文档和Keysking相关资料。