stm32移植1.92寸oled屏幕标准库代码到hal库

本文链接：https://blog.csdn.net/2303_77805026/article/details/134482107

本文详细描述了如何在STM32F407开发板上移植1.92寸OLED屏幕，使用模拟SPI和HAL库进行驱动，包括Cubemx配置、代码修改和测试过程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、前言

为了实现我的一个项目，我需要用到一个两寸左右大小的屏幕，选来选去最后决定使用中景元电子的1.92寸的oled屏，（官方资料，只有库函数https://pan.baidu.com/s/170C893DkMRKz7KKC0fXqBw 提取码：8888）之所以用oled屏幕主要是我比较喜欢oled屏幕的风格。然后呢stm32我比较喜欢用hal库，下一步就是痛苦的代码移植了。

二、移植前的准备

这个屏幕既可以使用I2C驱动，也可以SPI驱动，这里我们使用SPI通信。

这里我使用的是stm32f407zgt6的开发板，所以打开f407的例程。

观察官方的例程，我们可以看到官方使用的是模拟SPI，这样我们使用Cubemx配置时就要注意配置IO口而不是打开spi。

下一步大概浏览一下官方的文件，移植的画我们需要把下面这个文件放在我们自己的工程文件里

下一步就是Cubemx的配置了

三、Cubemx配置

首先是使用外部时钟

SYS配置：Debug设置成Serial Wire（否则可能导致芯片自锁）

配置IO口，选择下图几个io口，因为我们使用的是模拟spi，所以我们可以自由选自io口，这里我就选择官方例程的io口了，注意要按照下面的图片配置。

时钟树配置

工程配置

四、代码

我们把这些文件复制到我们工程文件里面后，就开始移植了。

首先是把下面的宏定义改为hal库格式的

改后的

下一步是把代码里面的u8 u16 u32全部替换为uint8_t uint16_t uint32_t .

然后就是删掉oled初始化代码里面的配置io口的部分

再把所有的delay_ms();改为HAL_Delay();

到这一步代码移植基本就没有问题了，下一步就是在主函数里把头文件和oled初始化还有测试代码给加上

头文件

#include "sys.h"
#include "oled.h"
#include "bmp.h"

初始化

 	OLED_Init();				//初始化OLED

测试代码

        OLED_ShowPicture(0,0,128,160,BMP1,1);
		OLED_Refresh();
		HAL_Delay(500);
		OLED_Clear();
		OLED_ShowPicture(0,0,128,160,BMP2,1);
		OLED_Refresh();
		HAL_Delay(500);
		OLED_Clear();
		OLED_ShowChinese(0,40,0,16,1);//中
		OLED_ShowChinese(18,40,1,16,1);//景
		OLED_ShowChinese(36,40,2,16,1);//园
		OLED_ShowChinese(54,40,3,16,1);//电
		OLED_ShowChinese(72,40,4,16,1);//子
		OLED_ShowChinese(90,40,5,16,1);//技
		OLED_ShowChinese(108,40,6,16,1);//术
		OLED_ShowString(8,56,"ZHONGJINGYUAN",16,1);
		OLED_ShowString(20,72,"2014/05/01",16,1);
		OLED_ShowString(0,88,"ASCII:",16,1);  
		OLED_ShowString(63,88,"CODE:",16,1);
		OLED_ShowChar(48,88,t,16,1);//显示ASCII字符	   
		t++;
		if(t>'~')t=' ';
		OLED_ShowNum(103,88,t,3,16,1);
		OLED_Refresh();
		HAL_Delay(500);
		OLED_Clear();

整体代码如下

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2023 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 "i2c.h"
#include "gpio.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "sys.h"
#include "oled.h"
#include "bmp.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();
  MX_I2C1_Init();
  /* USER CODE BEGIN 2 */
	uint8_t t=' ';
 	OLED_Init();				//初始化OLED
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
		OLED_ShowPicture(0,0,128,160,BMP1,1);
		OLED_Refresh();
		HAL_Delay(500);
		OLED_Clear();
		OLED_ShowPicture(0,0,128,160,BMP2,1);
		OLED_Refresh();
		HAL_Delay(500);
		OLED_Clear();
		OLED_ShowChinese(0,40,0,16,1);//中
		OLED_ShowChinese(18,40,1,16,1);//景
		OLED_ShowChinese(36,40,2,16,1);//园
		OLED_ShowChinese(54,40,3,16,1);//电
		OLED_ShowChinese(72,40,4,16,1);//子
		OLED_ShowChinese(90,40,5,16,1);//技
		OLED_ShowChinese(108,40,6,16,1);//术
		OLED_ShowString(8,56,"ZHONGJINGYUAN",16,1);
		OLED_ShowString(20,72,"2014/05/01",16,1);
		OLED_ShowString(0,88,"ASCII:",16,1);  
		OLED_ShowString(63,88,"CODE:",16,1);
		OLED_ShowChar(48,88,t,16,1);//显示ASCII字符	   
		t++;
		if(t>'~')t=' ';
		OLED_ShowNum(103,88,t,3,16,1);
		OLED_Refresh();
		HAL_Delay(500);
		OLED_Clear();
  }
  /* USER CODE END 3 */
}

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

  /** Configure the main internal regulator output voltage
  */
  __HAL_RCC_PWR_CLK_ENABLE();
  __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1);

  /** Initializes the RCC Oscillators according to the specified parameters
  * in the RCC_OscInitTypeDef structure.
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
  RCC_OscInitStruct.HSIState = RCC_HSI_ON;
  RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSI;
  RCC_OscInitStruct.PLL.PLLM = 8;
  RCC_OscInitStruct.PLL.PLLN = 168;
  RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
  RCC_OscInitStruct.PLL.PLLQ = 4;
  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_DIV4;
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV2;

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_5) != 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 */