U8g2库的STM32硬件SPI（DMA）移植教程（HAL、OLED显示、四线SPI、DMA）

已于 2023-04-21 00:33:14 修改
阅读量5.1k 收藏 88
点赞数 19
文章标签： stm32 单片机 嵌入式硬件 笔记 迁移学习
于 2023-04-17 13:46:41 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_51096702/article/details/130185443
版权

U8g2库的STM32硬件SPI（DMA）移植教程

U8g2库的STM32硬件SPI移植教程（HAL、OLED显示、四线SPI）

前言

//----------------------------------------------------------------
本次用的是SPI1、DMA、全双工(当然半双工也没什么问题、CS、DC、RS是普通GPIO，自行切换)
GND -----------> 电源地
VCC -----------> 接5V或3.3v电源
D0 -----------> 接PA5（SCL）
D1 -----------> 接PA7（SDA）
RES -----------> 接PB0
DC -----------> 接PB1
CS -----------> 接PA4              
//----------------------------------------------------------------

U8g2简介

出自此篇基于STM32移植U8g2图形库——OLED显示

U8g2是什么

   U8g2是GitHub上一款十分优秀的开源图形库（GUI库），其本质是嵌入式设备的单色图形库。在 Github 上超过3.2K Star，2.6K Commit。其开发语言90%为C语言，且代码简洁干练便于移植与后期修改。

U8g2支持的显示控制器

   U8g2支持单色OLED和LCD，包括以下控制器：

SSD1305SSD1306SSD1309SSD1312SSD1316SSD1320
SSD1322SSD1325SSD1327SSD1329SSD1606SSD1607
SH1106SH1107SH1108SH1122T6963RA8835
LC7981PCD8544PCF8812HX1230UC1601UC1604
UC1608UC1610UC1611UC1617UC1638UC1701
ST7511ST7528ST7565ST7567ST7571ST7586
ST7588ST75256ST75320NT7534ST7920IST3020
IST7920LD7032KS0108KS0713HD44102T7932
SED1520SBN1661IL3820MAX7219

   可以说，基本上主流的显示控制器都支持，比如我们常见的SSD1306等，读者在使用该库之前请查阅自己的OLED显示控制器是否处于支持列表中。

U8g2的优势

  • U8g2库平台支持性好，基本上支持绝大部分Arduino与STM32开发板，也包含物联网比较常用的esp8266；
  • U8g2库显示控制器支持性好，基本上市面上的OLED都完美支持；
  • U8g2库 API函数众多，特别支持了中文，支持了不同字体，这是一个对于开发者俩说不小的福利；
  • U8g2 库移植简单，容易使用（这一点也是笔者比较钟意的）；

  其实，我们可以把U8g2当作一个工具箱，需要使用的时候就去打开工具箱，使用里面的已经写好的API函数去实现我们需要达到的显示效果。（当然，前提是需要熟悉U8g2的使用，这一点网上有很多用法博客写得都很详细，感兴趣的读者朋友可以去看看这篇：深入学习Arduino u8g2 OLED库，一篇就够）

CubexMX的配置

RCC配置外部高速晶振（精度更高）——HSE：

RCC配置外部高速晶振（精度更高）——HSE

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

Debug设置成Serial Wire

时钟树配置：

时钟树配置

SPI1配置半双工（全双工）：作为OLED的通讯方式：（注意这里的配置）

  半双工：
SPI1配置半双工
  全双工：
SPI1配置全双工

DMA配置：

DMA配置

工程配置：

工程命名
  这里我们不用的库不加，减小代码体积
工程配置
然后生成

U8g2移植

准备U8g2库文件

  • 准备U8g2库文件---------->U8g2下载地址: https://github.com/olikraus/u8g2 下载压缩包
  • Git用---------->git clone https://ghproxy.com/https://github.com/olikraus/u8g2.git

精简U8g2库文件

  • U8g2支持多种显示驱动的屏幕，因为源码中也包含了各个驱动对应的文件（因此不需要自己去写屏幕底层驱动了），为了减小整个工程的代码体积和芯片资源占用，在移植U8g2时，可以删除一些无用的文件。
  • 这里我们主要关注的是U8g2库文件中的csrc文件夹 csrc文件夹
去掉csrc文件夹中无用的驱动文件

  这些驱动文件通常是u8x8_d_xxx.c，xxx包括驱动的型号和屏幕分辨率。ssd1306驱动芯片的OLED，使用u8x8_ssd1306_128x64_noname.c这个文件，其它的屏幕驱动和分辨率的文件可以删掉。
去掉csrc文件夹中无用的驱动文件
u8x8_d_xxx.c文件中留下u8x8_ssd1306_128x64_noname.c即可

精简u8g2_d_setup.c（注意不是u8x8_setup.c）

  由于本文使用的OLED是SPI接口，只留一个本次要用到u8g2_Setup_ssd1306_128x64_noname_f就好（如果是IIC接口，需要使用u8g2_Setup_ssd1306_i2c_128x64_noname_f这个函数，多了i2c注意区分），其它的可以删掉或注释掉。
精简u8g2_d_setup.c

注意，与这个函数看起来十分相似的函数的有：

  • u8g2_Setup_ssd1306_128x64_noname_1
  • u8g2_Setup_ssd1306_128x64_noname_2
  • u8g2_Setup_ssd1306_128x64_noname_f
  • u8g2_Setup_ssd1306_i2c_128x64_noname_1
  • u8g2_Setup_ssd1306_i2c_128x64_noname_2
  • u8g2_Setup_ssd1306_i2c_128x64_noname_f

其中，前面3个，是给SPI接口的OLED用的，后面3个，是给I2C用的函数最后的数字或字母，代表显示时的buf大小：

  • 1：128字节
  • 2：256字节
  • f：1024字节
精简u8g2_d_memory.c

  u8g2_d_memory.c文件中，由于用到的u8g2_Setup_ssd1306_128x64_noname_f函数中，只调用了u8g2_m_16_8_f这个函数，所以只用留下这个函数，如果你用的其他函数，在u8g2_d_memory.c留下它相对应调用到的函数即可，其它的函数要删掉或注释，否则编译时很可能会导致内存不足。
其它的函数要删掉或注释
精简u8g2_d_memory.c

将精简后的U8g2库添加至Keil

  Keil工程目录添加精简后U8g2库文件中的csrc文件夹，然后再添加U8g2的头文件搜寻目录（U8g2_lib里都是csrc文件里面的文件，可以根据自己的需要删减），如下：
将精简后的U8g2库添加至Keil
精简后U8g2库

代码

Oled回调函数

oled_driver.c：

#include "oled_driver.h"
#include "stdlib.h"
#include "spi.h"
#include "dma.h"
#include "u8g2.h"

uint8_t u8x8_byte_4wire_hw_spi(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int,void *arg_ptr)
{
    switch (msg)
    {
        case U8X8_MSG_BYTE_SEND: /*通过SPI发送arg_int个字节数据*/
//           HAL_SPI_Transmit_DMA(&hspi1, (uint8_t *)arg_ptr, arg_int);while(hspi1.TxXferCount);
			/*配置了DMA取消上一行注释即可*/
			HAL_SPI_Transmit(&hspi1,(uint8_t *)arg_ptr,arg_int,200);
			/*这是CubeMX生成的初始化*/
            break;
        case U8X8_MSG_BYTE_INIT: /*初始化函数*/
            break;
        case U8X8_MSG_BYTE_SET_DC: /*设置DC引脚,表明发送的是数据还是命令*/
			HAL_GPIO_WritePin(OLED_DC_GPIO_Port,OLED_DC_Pin,arg_int);
            break;
        case U8X8_MSG_BYTE_START_TRANSFER: 
            u8x8_gpio_SetCS(u8x8, u8x8->display_info->chip_enable_level);
            u8x8->gpio_and_delay_cb(u8x8, U8X8_MSG_DELAY_NANO, u8x8->display_info->post_chip_enable_wait_ns, NULL);
            break;
        case U8X8_MSG_BYTE_END_TRANSFER: 
            u8x8->gpio_and_delay_cb(u8x8, U8X8_MSG_DELAY_NANO, u8x8->display_info->pre_chip_disable_wait_ns, NULL);
            u8x8_gpio_SetCS(u8x8, u8x8->display_info->chip_disable_level);
            break;
        default:
            return 0;
    }
    return 1;
}

uint8_t u8x8_stm32_gpio_and_delay(U8X8_UNUSED u8x8_t *u8x8,
    U8X8_UNUSED uint8_t msg, U8X8_UNUSED uint8_t arg_int,
    U8X8_UNUSED void *arg_ptr) 
{
    switch (msg)
    {
        case U8X8_MSG_GPIO_AND_DELAY_INIT: /*delay和GPIO的初始化，在main中已经初始化完成了*/
            break;
        case U8X8_MSG_DELAY_MILLI: /*延时函数*/
            HAL_Delay(arg_int);     //调用谁stm32系统延时函数
            break;
        case U8X8_MSG_GPIO_CS: /*片选信号*/ //由于只有一个SPI设备，所以片选信号在初始化时已经设置为常有效
            HAL_GPIO_WritePin(OLED_CS_GPIO_Port, OLED_CS_Pin, arg_int);
            break;
        case U8X8_MSG_GPIO_DC: /*设置DC引脚,表明发送的是数据还是命令*/
            HAL_GPIO_WritePin(OLED_DC_GPIO_Port,OLED_DC_Pin,arg_int);
            break;
        case U8X8_MSG_GPIO_RESET:
            break;
    }
    return 1;
}

void u8g2Init(u8g2_t *u8g2)
{
/********************************************     
U8G2_R0     //不旋转，不镜像     
U8G2_R1     //旋转90度
U8G2_R2     //旋转180度   
U8G2_R3     //旋转270度
U8G2_MIRROR   //没有旋转，横向显示左右镜像
U8G2_MIRROR_VERTICAL    //没有旋转，竖向显示镜像
********************************************/
//    u8g2_Setup_sh1106_128x64_noname_2(u8g2, U8G2_R0, u8x8_byte_4wire_hw_spi, u8x8_stm32_gpio_and_delay);  // 初始化1.3寸OLED u8g2 结构体
	u8g2_Setup_ssd1306_128x64_noname_f(u8g2, U8G2_R0, u8x8_byte_4wire_hw_spi, u8x8_stm32_gpio_and_delay);  // 初始化0.96寸OLED u8g2 结构体
	u8g2_InitDisplay(u8g2);     //初始化显示
	u8g2_SetPowerSave(u8g2, 0); //开启显示
}
/*官方logo的Demo*/
void draw(u8g2_t *u8g2)
{
    u8g2_SetFontMode(u8g2, 1); /*字体模式选择*/
    u8g2_SetFontDirection(u8g2, 0); /*字体方向选择*/
    u8g2_SetFont(u8g2, u8g2_font_inb24_mf); /*字库选择*/
    u8g2_DrawStr(u8g2, 0, 20, "U");
    
    u8g2_SetFontDirection(u8g2, 1);
    u8g2_SetFont(u8g2, u8g2_font_inb30_mn);
    u8g2_DrawStr(u8g2, 21,8,"8");
        
    u8g2_SetFontDirection(u8g2, 0);
    u8g2_SetFont(u8g2, u8g2_font_inb24_mf);
    u8g2_DrawStr(u8g2, 51,30,"g");
    u8g2_DrawStr(u8g2, 67,30,"\xb2");
    
    u8g2_DrawHLine(u8g2, 2, 35, 47);
    u8g2_DrawHLine(u8g2, 3, 36, 47);
    u8g2_DrawVLine(u8g2, 45, 32, 12);
    u8g2_DrawVLine(u8g2, 46, 33, 12);
  
    u8g2_SetFont(u8g2, u8g2_font_4x6_tr);
    u8g2_DrawStr(u8g2, 1,54,"github.com/olikraus/u8g2");
}
/********************************* end_of_file **********************************/

GPIO定义的时候在CubeMX设置别名能更容易的切换IO口，CS拉高，如下
GPIO设置别名
oled_driver.h：

#ifndef __MD_OLED_DRIVER_H
#define __MD_OLED_DRIVER_H

#include "stdlib.h"	  
#include "main.h"
#include "gpio.h"
#include "u8g2.h"

//-----------------OLED端口定义----------------  					   
#define MD_OLED_RST_Clr() HAL_GPIO_WritePin(OLED_RES_GPIO_Port,OLED_RES_Pin,GPIO_PIN_RESET) //oled 复位端口操作
#define MD_OLED_RST_Set() HAL_GPIO_WritePin(OLED_RES_GPIO_Port,OLED_RES_Pin,GPIO_PIN_SET)

//OLED控制用函数
uint8_t u8x8_byte_4wire_hw_spi(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int,void *arg_ptr);
uint8_t u8x8_stm32_gpio_and_delay(U8X8_UNUSED u8x8_t *u8x8,U8X8_UNUSED uint8_t msg, U8X8_UNUSED uint8_t arg_int,U8X8_UNUSED void *arg_ptr) ;
void u8g2Init(u8g2_t *u8g2);
void draw(u8g2_t *u8g2);

#endif

  上述编写的移植函数代码属于HAL库下的代码，标准库的代码其实差不多，有个别地方需要注意修改。有一定MCU编程基础的朋友应该很简单就可以做到仿写。移植代码的本质：这些函数代码就是对应的U8g2图形库的接口函数，通过这些函数去启用U8g2图形库。

main函数

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_SPI1_Init();

  /* Initialize interrupts */
  MX_NVIC_Init();
  /* USER CODE BEGIN 2 */
  u8g2_t u8g2; // 显示器初始化结构体
  MD_OLED_RST_Set(); //显示器复位拉高
  u8g2Init(&u8g2);   //显示器调用初始化函数
  /* USER CODE END 2 */

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

    /* USER CODE BEGIN 3 */
       u8g2_FirstPage(&u8g2);
       do
       {
   			draw(&u8g2);
           
       } while (u8g2_NextPage(&u8g2));
  }
  /* USER CODE END 3 */
}

最终效果

U8g2最终效果

总结

  U8g2图形库可以说目前小尺寸OLED首选的GUI，其可以呈现出的图形远不止上述中的图形，更多的功能还需要读者朋友们自己去好好发掘。优秀GUI的移植是一名合格嵌入式工程师必须掌握的技能之一，其可以达到大大缩短开发周期，优化UI界面等目的。LCD屏幕也存在类似的优秀开源GUI库，后续笔者会进行更新，感兴趣的读者朋友可以点波关注，感谢！！！
————————————————
原文链接：https://blog.csdn.net/black_sneak/article/details/126312657

深藏ぺblue
关注
  • 19
    点赞
  • 踩
  • 88
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 4
    评论
STM32 SPI DMA 的使用
08-03
一是想总结一下SPI总线的特点与注意点，二是总结一下SPI DMA的使用。
STM32F103驱动SSD1353主控OLED程序 使用硬件SPI+DMA，帧率可达50Hz
04-02
STM32F103驱动SSD1353OLED程序，使用硬件SPI+DMA，帧率50Hz左右
stm32cubemx生成的HAL移植硬件SPI的u8g2（保姆级教学）
最新发布
weixin_45633002的博客
03-24 445
本文介绍了stm32cubemx移植7针SPi的0.96寸OLED屏u8g2的保姆级教学
lame库移植
09-10
lame库移植 涉及底层NDK 值得学习.............................................................................................................................................
ST7735+stm32硬件SPI+DMA.zip
04-01
使用STM32f103单片机驱动TFT液晶彩屏，使用硬件SPI1 CLK 36MHz + DMA，液晶屏驱动芯片ST7735，分辨率128*160（程序内宏控制，不同分辨率改一下宏就行），实测全屏刷新时间12ms左右，每秒可刷75帧左右，主要代码有中文注释
STM32移植U8g2显示库，硬件SPI连接并显示。
01-26
U8g2 STM32 SPI 0.96寸OLED 1.3寸OLED
STM32驱动LCD屏幕
10-02
详细介绍请参考 https://blog.csdn.net/weixin_36815313/article/details/120516778?spm=1001.2014.3001.5501
STM32使用SPI+DMA（标准库）
m0_67530207的博客
10-07 1万+
因为DMA_Mode_Normal模式使用一次后DMA_BufferSize会清零，如下代码用于重置DMA_BufferSize。注意：DMA_PeripheralBaseAddr不是SPI外设的地址，而是SPI1->DR即SPI数据寄存器的地址。既然使用的是SPI+DMA,必定要使能SPI，详细请参考。配置完SPI后，配置DMA，如下。
基于STM32的u8g2移植以及学习
m0_51274562的博客
11-28 4776
U8g2是嵌入式设备的单色图形库。主要应用于嵌入式设备，包括我们常见的单片机使用，最常用的是OLED屏或者LCD屏进行使用的一个库；我们常用的OLED屏其内部原理一个M x n 的像素点阵，想显示什么就得把具体位置的像素点亮起来。对于每一个像素点，有可能是1点亮，也有可能是0点亮；其坐标系如下所示。
U8g2库的详细使用
热门推荐
m0_62236205的博客
03-15 2万+
Arduino~U8g2库使用保姆级教程
u8g2介绍
qq_39239990的博客
10-22 1346
​知识整理U8G2简要说明u8g2显示分为全页显示与分页显示和U8X8的无ram显示全页显示需要单片机提供1024字节的ram，分页显示分为需要256字节和125字节的ramU8X8不需要ram,但不可画图，只能显示文字全页使用 clearbuff senddbuff分页使用 U8G2.fisrt Page while(u8g2.next page)参考arduino u8g2示列接口方式分为spi和IIC ，8080，8060控制方式SPI 可以分为硬件SPI和软件SPI。
stm32f103c8t6移植u8g2库，烧录程序接好线即可。
04-08
stm32f103c8t6移植u8g2库，使用cubemx+hal库，已经完成配置，驱动ssd1306的0.96寸oled。在cubemx里查看接线，烧录好程序就可以直接用。
FPS.zip_U8G2_SSD1306_ssd1306刷新_ssd1306局部刷新_u8g2 速度_刷新测试
09-21
U8G2 可实现使用SSD1306驱动的OLED屏幕测试刷新速度
STM32HAL库OLED移植U8g2库
04-04
STM32HAL库开发移植U8g2库，编译软件为CLion,OLED为IIC通信
STM32移植U8G2库1.3四线SPIOLED
07-12
一直大神的U8g2GUI库，比周立功的库要好一些，但比不上STenwin，比较是适配单色屏驱动比较全，移植可以看https://blog.csdn.net/perfugee/article/details/79092075
STM32 HAL 硬件IIC+DMA控制OLED参考程序
03-14
所用开发板 野火指南者STM32F103VET6
STM32G0 硬件SPI+DMA+LL库，最高通讯速率32MBit/s
04-03
STM32G0 硬件SPI+DMA+LL库，最高通讯速率32MBit/s，经过逻辑分析仪验证，数组正确无误。
STM32移植u8g2库（HAL库）（硬件SPI）（sh1106_128x64）
01-07
STM32移植u8g2库（HAL库）（硬件SPI）（sh1106_128x64）MCU型号为STM32F103RCT6，OLED屏为中景园电子1.3寸屏，驱动芯片为sh1106，分辨率为128x64，MDK版本为V5.34。
stm32开发总结(一) - SPI+DMA
q2108059136的博客
09-23 3437
​
stm32 hal库spi dma
09-20
### 回答1： 很高兴为您服务！STM32 HAL库的SPI DMA功能可帮助您在不使用CPU的情况下转移数据，从而节省CPU的资源。DMA可以自动地将数据从SPI口发送到内存，而无需CPU的参与。它可以提高系统的性能和数据传输速度。 ### 回答2： STM32 HAL库中的SPI DMA是指通过直接内存访问(DMA)来实现SPI数据传输的功能。 SPI (串行外设接口)是一种常用的串行通信协议，它可以连接MCU与外部设备进行通信。而DMA是一种直接内存访问技术，它可以在不经过CPU的干预下，直接将数据从一个地方传输到另一个地方。通过使用DMA进行SPI数据传输，可以提高效率和性能。 在STM32 HAL库中，使用SPI DMA可以通过以下步骤来实现SPI数据传输： 1. 配置SPI外设和DMA通道：首先要配置SPI外设的参数，例如设置SPI通信模式、数据大小、时钟极性和相位等。然后要配置DMA通道的参数，例如选择DMA传输方向、传输数据大小和MODE模式等。 2. 配置DMA传输缓冲区：为SPI和DMA设置传输缓冲区，这些缓冲区将用于存储传输的数据。 3. 启动DMA传输：使用HAL库中的函数来启动DMA传输。这将使DMA开始从传输缓冲区中读取数据并将其传输到SPI外设中。 4. 等待传输完成：使用HAL库中的函数来等待DMA传输完成。一旦传输完成，可以触发一个传输完成中断。 通过以上步骤，我们可以在STM32 HAL库中实现SPI DMA数据传输。这种方式可以使CPU更有效地利用时间来执行其他任务，提高系统的性能和效率。同时，SPI DMA也可以更好地支持大容量数据传输，减少了CPU的负载，提供了更好的实时性能。 ### 回答3： STM32 HAL库提供了一种简化SPI DMA（Direct Memory Access，直接内存存取）传输的方法。SPI是串行外设接口的一种通信协议，它能够同时传输和接收数据，而DMA是一种无需CPU参与的数据传输方法，可以提高数据传输效率和系统性能。 STM32 HAL库中的SPI DMA功能主要通过一系列API函数来实现。首先，我们需要初始化SPI外设的基本参数，包括通信模式（全双工、单工等）、时钟极性和相位配置、主从模式等。然后，开启DMA传输和中断以及SPI外设本身。接下来，通过调用HAL_SPI_Transmit_DMA和HAL_SPI_Receive_DMA函数来配置DMA传输缓冲区和传输长度，并启动传输。在传输完成后，通过检查相关中断标志位或回调函数来检测传输状态。 SPI DMA的优点在于减少了CPU的工作负担，使得CPU在数据传输期间可以处理其他任务，提高了系统的实时性和效率。同时，DMA传输还可以减少因CPU参与而产生的传输延迟，加快数据传输速度。此外，SPI DMA应用于具有高速数据传输需求的场景，如存储器读写、音频、图形显示等，能够更好地满足系统对快速、稳定数据传输的要求。 需要注意的是，在使用SPI DMA时，需要仔细考虑数据的传输顺序和互斥访问问题，以免造成数据冲突和错误。此外，DMA传输涉及到DMA缓冲区的管理和回调函数的设置，需要仔细调试和测试，以确保数据的正确传输和处理。 总之，STM32 HAL库提供了一种方便简化的SPI DMA传输方法，通过充分利用DMA传输的特点，可以提高系统性能和数据传输效率，适用于高速数据传输的应用场景。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

深藏ぺblue

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值