STM32F103基于HAL库I2C/SPI硬件接口+DMA驱动 SSD1306 Oled

STM32F103基于HAL库I2C/SPI硬件接口+DMA驱动 SSD1306 Oled

• ✨由于手上只有I2C接口的SSD1306 OLED屏幕，仅测试了硬件I2C驱动显示功能，实际测试的FPS帧率在37或38变化。

• 📢本项目从Github开源项目中移植过来，开源地址：https://github.com/lamik/OLED_SSD1306_STM32_HAL
• 🎞 I2C + DMA实测效果;
  

📑硬件接口说明

• 🌿采用的是STM32F103VC,配置的是：I2C1和SPI1

    PB8     ------> I2C1_SCLPB9     ------> I2C1_SDA

    PA4     ------> SPI1_NSSPA5     ------> SPI1_SCKPA7     ------> SPI1_MOSI

🛠STM32cubemx配置参数

• 🌿I2C接口配置参数：Fast-mode,比特速率最高400 kbit/s.
  
• 🌿添加I2C DMA数据发送选项

• 🌿SPI接口配置
  
• 🌿SPI DMA配置
  
• 🌿NVIC配置
  
• 🌿相关引脚配置和定义
  
  
  

⛳业务代码注意事项

• 🌿原工程是使用了抵达定时器中断的，在STM32cubemx中该接口函数是没有进行初始化的。需要手动添加,如果没有手动添加，OLED显示会卡在一个固定的显示画面上。
  

• 🧲调用关系：SysTick_Handler() --> HAL_SYSTICK_IRQHandler() --> HAL_SYSTICK_Callback()

• 🌿在stm32f1xx_it.c文件中找到下面的函数，并在对应位置添加相应的函数：

void SysTick_Handler(void)
{/* USER CODE BEGIN SysTick_IRQn 0 *//* USER CODE END SysTick_IRQn 0 */HAL_IncTick();/* USER CODE BEGIN SysTick_IRQn 1 */HAL_SYSTICK_IRQHandler();			// 需手动添加，stm32cubemx不能自动生成/* USER CODE END SysTick_IRQn 1 */
}

🌿I2C/SPI接口切换说明

• 🔰在OLED_SSD1306.h头文件中启用和注释相对应的宏，即可实现接口切换。

/*    SETTINGS*		设置ssd1306对应的接口，启用相对应的宏*    Please set only one interface. It won't work with both one time./
//#define SSD1306_SPI_CONTROL
#define SSD1306_I2C_CONTROL		#ifdef SSD1306_I2C_CONTROL
#define SSD1306_I2C_DMA_ENABLE
#define SSD1306_I2C_ADDRESS   0x78
#endif
#ifdef SSD1306_SPI_CONTROL
#define SSD1306_RESET_USE
#define SSD1306_SPI_DMA_ENABLE
#define SPI_CS_HARDWARE_CONTROL
#endif

📝main主程序代码

/* 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 "dma.h"
#include "i2c.h"
#include "spi.h"
#include "gpio.h"/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "stdio.h"
#include "stdlib.h"
#include "string.h"
#include "OLED_SSD1306.h"
#include "GFX_BW.h"
#include "fonts/fonts.h"
#include "picture.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 */
volatile uint16_t timer_1s;
/* 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 */
void HAL_SYSTICK_Callback(void)
{if(timer_1s){--timer_1s;}
}void I2C_DMAError(void)
{while(1){
HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);}
}
void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef* hspi)
{
#if defined(SSD1306_SPI_CONTROL) && !defined(SSD1306_SPI_DMA_ENABLE)SSD1306_DmaEndCallback(hspi);
#endif
}
/* 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_DMA_Init();MX_I2C1_Init();MX_SPI1_Init();/* USER CODE BEGIN 2 */
#ifdef SSD1306_I2C_CONTROLSSD1306_I2cInit(&hi2c1);
#endif
#ifdef SSD1306_SPI_CONTROLSSD1306_SpiInit(&hspi1);
#endif
//    SSD1306_Bitmap((uint8_t*)picture);HAL_Delay(1000);GFX_SetFont(font_8x5);GFX_SetFontSize(1);//SSD1306_StartScrollLeftUp(0,7,SCROLL_EVERY_4_FRAMES, 1);
//SSD1306_StartScrollLeft(0,7,SCROLL_EVERY_4_FRAMES);
//SSD1306_StartBlinking(1);
//SSD1306_ZoomIn(1);uint16_t frames = 0, fps = 0;uint32_t loops = 0, loops_overal = 0;char fps_c[20];/* USER CODE END 2 *//* Infinite loop *//* USER CODE BEGIN WHILE */while(1){/* USER CODE END WHILE *//* USER CODE BEGIN 3 */if(!timer_1s){timer_1s = 1000;fps = frames;frames = 0;loops_overal = loops;loops = 0;}#ifdef SSD1306_I2C_DMA_ENABLEif(hi2c1.hdmatx->State == HAL_DMA_STATE_READY){
#endif
#ifdef SSD1306_SPI_DMA_ENABLEif(hspi1.hdmatx->State == HAL_DMA_STATE_READY){
#endifsprintf(fps_c, "loops: %02d", (int)loops_overal);SSD1306_Clear(BLACK);GFX_DrawString(10, 10, fps_c, WHITE, BLACK);sprintf(fps_c, "FPS: %02d", fps);GFX_DrawString(10, 20, fps_c, WHITE, BLACK);GFX_DrawString(19, 40, "www.msalamon.pl", WHITE, BLACK);frames++;HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);SSD1306_Display();
#if  defined(SSD1306_I2C_DMA_ENABLE) || defined(SSD1306_SPI_DMA_ENABLE)}
#endif
////	  SSD1306_Bitmap((uint8_t*)picture);HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);
//	  HAL_Delay(500);loops++;}/* 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 */

📚工程源码

链接: https://pan.baidu.com/s/1rpXl_jEfdYW0Q5On20lMkg
提取码: syjh