U8G2库移植到STM32平台上

最新推荐文章于 2024-08-17 00:24:17 发布
最新推荐文章于 2024-08-17 00:24:17 发布
阅读量7.7k 收藏 73
点赞数 11
文章标签： 嵌入式 单片机 stm32
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_42150905/article/details/118108327
版权

U8G2库简介

U8g2是嵌入式设备的单色图形库，一句话简单明了。主要应用于嵌入式设备，包括我们常见的单片机；

建议先看这篇博客的介绍，写的比较好u8g2库的使用
这篇博客介绍了对于u8g2的使用，但是是针对arduino平台的，但是使用方法在stm32平台上也是大同小异。

U8G2库的下载及硬件平台

U8G2库是一个开源的github项目，通过github可以直接下载 。下载地址

此次使用的mcu是stm32f407vet6，屏幕是IIC接口的oled12864屏幕，屏幕驱动芯片是ssd1306.，使用的是cubeide进行开发。

移植到stm32

首先我们需要建立一份工程，关于工程的建立，再这里就不在赘述了，记住要初始化一个IIC，不然就没有办法驱动屏幕了。

打卡我们下载的u8g2源码，可以看到里面有许多文件夹。其他的文件夹里面都是一些说明文档，可以不用关注，注意我用红框标注的，csrc文件夹，这里面存放的都是我们所需要的源码。
u8g2源码
打开csrc文件夹，可以看到里面有许多.c文件。注意到有许多U8x8_d_*****类型的c文件，这是针对不同的驱动芯片所写的驱动程序，我们只需要选择我们需要的就行了，其他的在移植到自己的工程的时候，可以把删除。我们此次使用的是ssd1306，因此在移植的时候，只保留ssd1306相关的驱动程序就可以了（图中画红线的部分）。

**注意：移植的时候，把不同的驱动芯片的c文件删除即可，不要删除其他的
在这里插入图片描述

然后将csrc文件夹下面的文件都复制到cubeide的工程中，建立好的工程如下图。
cubeide

到这一步就距离成功仅有一步之遥了，接下来编写我们需要的底层函数。

编写一个oled.c和oled.h的文件

oled .c

#include "oled.h"
#include "i2c.h"

uint8_t u8x8_byte_hw_i2c(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int, void *arg_ptr)
{
    /* u8g2/u8x8 will never send more than 32 bytes between START_TRANSFER and END_TRANSFER */
    static uint8_t buffer[128];
    static uint8_t buf_idx;
    uint8_t *data;

    switch (msg)
    {
    case U8X8_MSG_BYTE_INIT:
    {
        /* add your custom code to init i2c subsystem */
        MX_I2C1_Init(); //I2C初始化
    }
    break;

    case U8X8_MSG_BYTE_START_TRANSFER:
    {
        buf_idx = 0;
    }
    break;

    case U8X8_MSG_BYTE_SEND:
    {
        data = (uint8_t *)arg_ptr;

        while (arg_int > 0)
        {
            buffer[buf_idx++] = *data;
            data++;
            arg_int--;
        }
    }
    break;

    case U8X8_MSG_BYTE_END_TRANSFER:
    {
        if (HAL_I2C_Master_Transmit(&hi2c1, (OLED_ADDRESS), buffer, buf_idx, 1000) != HAL_OK)
            return 0;
    }
    break;

    case U8X8_MSG_BYTE_SET_DC:
        break;

    default:
        return 0;
    }

    return 1;
}

void delay_us(uint32_t time)
{
    uint32_t i = 8 * time;
    while (i--)
        ;
}

uint8_t u8x8_gpio_and_delay(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int, void *arg_ptr)
{
    switch (msg)
    {
    case U8X8_MSG_DELAY_100NANO: // delay arg_int * 100 nano seconds
        __NOP();
        break;
    case U8X8_MSG_DELAY_10MICRO: // delay arg_int * 10 micro seconds
        for (uint16_t n = 0; n < 320; n++)
        {
            __NOP();
        }
        break;
    case U8X8_MSG_DELAY_MILLI: // delay arg_int * 1 milli second
        HAL_Delay(1);
        break;
    case U8X8_MSG_DELAY_I2C: // arg_int is the I2C speed in 100KHz, e.g. 4 = 400 KHz
        delay_us(5);
        break;                    // arg_int=1: delay by 5us, arg_int = 4: delay by 1.25us
    case U8X8_MSG_GPIO_I2C_CLOCK: // arg_int=0: Output low at I2C clock pin
        break;                    // arg_int=1: Input dir with pullup high for I2C clock pin
    case U8X8_MSG_GPIO_I2C_DATA:  // arg_int=0: Output low at I2C data pin
        break;                    // arg_int=1: Input dir with pullup high for I2C data pin
    case U8X8_MSG_GPIO_MENU_SELECT:
        u8x8_SetGPIOResult(u8x8, /* get menu select pin state */ 0);
        break;
    case U8X8_MSG_GPIO_MENU_NEXT:
        u8x8_SetGPIOResult(u8x8, /* get menu next pin state */ 0);
        break;
    case U8X8_MSG_GPIO_MENU_PREV:
        u8x8_SetGPIOResult(u8x8, /* get menu prev pin state */ 0);
        break;
    case U8X8_MSG_GPIO_MENU_HOME:
        u8x8_SetGPIOResult(u8x8, /* get menu home pin state */ 0);
        break;
    default:
        u8x8_SetGPIOResult(u8x8, 1); // default return value
        break;
    }
    return 1;
}
void u8g2Init(u8g2_t *u8g2)
{
	u8g2_Setup_ssd1306_i2c_128x64_noname_f(u8g2, U8G2_R0, u8x8_byte_hw_i2c, u8x8_gpio_and_delay); // 初始化 u8g2 结构体
	u8g2_InitDisplay(u8g2);                                                                       // 根据所选的芯片进行初始化工作，初始化完成后，显示器处于关闭状态
	u8g2_SetPowerSave(u8g2, 0);                                                                   // 打开显示器
	u8g2_ClearBuffer(u8g2);
}

oled.h文件

#ifndef __oled_H
#define __oled_H
#ifdef __cplusplus
 extern "C" {
#endif

/* Includes ------------------------------------------------------------------*/
#include "main.h"
#include "u8g2.h"
/* USER CODE BEGIN Includes */

/* USER CODE END Includes */



/* USER CODE BEGIN Private defines */

/* USER CODE END Private defines */
#define u8         unsigned char  // ?unsigned char ????
#define MAX_LEN    128  //
#define OLED_ADDRESS  0x78 // oled模块从机地址
#define OLED_CMD   0x00  // 写命令
#define OLED_DATA  0x40  // 写数据
 
/* USER CODE BEGIN Prototypes */
 uint8_t u8x8_byte_hw_i2c(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int, void *arg_ptr);
 uint8_t u8x8_gpio_and_delay(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int, void *arg_ptr);
 void u8g2Init(u8g2_t *u8g2);
 #ifdef __cplusplus
}
#endif
#endif /*__ i2c_H */
/* USER CODE END Prototypes */

主函数

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ******************************************************************************
  * @attention
  *
  * <h2><center>&copy; Copyright (c) 2021 STMicroelectronics.
  * All rights reserved.</center></h2>
  *
  * This software component is licensed by ST under BSD 3-Clause license,
  * the "License"; You may not use this file except in compliance with the
  * License. You may obtain a copy of the License at:
  *                        opensource.org/licenses/BSD-3-Clause
  *
  ******************************************************************************
  */
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"
#include "i2c.h"
#include "usart.h"
#include "gpio.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "oled.h"
#include "u8g2.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();
  MX_USART1_UART_Init();
  /* USER CODE BEGIN 2 */
  u8g2_t u8g2; // a structure which will contain all the data for one display
  u8g2Init(&u8g2);

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
	  //u8g2_DrawCircle(&u8g2, 64, 32, 30, U8G2_DRAW_ALL);
	   u8g2_SendBuffer(&u8g2);
	   u8g2_DrawBox(&u8g2,0,0,20,20);
	   u8g2_DrawBox(&u8g2,20,20,20,20);
	   u8g2_SendBuffer(&u8g2);
	   u8g2_DrawFrame(&u8g2,10,40,20,20);
	   u8g2_SendBuffer(&u8g2);
	   u8g2_SetFont(&u8g2,u8g2_font_DigitalDiscoThin_tf);
	   u8g2_DrawStr(&u8g2,30,10,"free");
	   u8g2_SendBuffer(&u8g2);


	   HAL_Delay(1000);
    /* 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};

  /** 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_HSE;
  RCC_OscInitStruct.HSEState = RCC_HSE_ON;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
  RCC_OscInitStruct.PLL.PLLM = 4;
  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 */

  /* 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,
     tex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
  /* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */

/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

按照以上进行移植，就可以使用U8G2库了。

成品效果图

在这里插入图片描述

在这里插入图片描述
到这里 u8g2就顺利的移植到 stm32平台上了，
欢迎观看，
有什么问题留言给我哦。

欲买桂花
关注
初试--移植u8g2库到stm32
apple的博客
07-13 9456
无独有偶来想来移植u8g2来玩玩 硬件清单： stm32f334核心板一块（没用stm32f1是因为f1的排针焊反了，不好直插，f1类似） 0.96寸的Oled屏，为4线SPI连接 还有一个下载器DAP 软件清单： keil5和cubemx 先在cubemx创建一个相关的工程并生成代码，用软件模拟spi：（总览） 然后去u8g2的githu...
u8g2移植 stm32
01-03
stm32模拟i2c下U8g2的移植工程； 使用stm32l431rbt，为了减小内存屏蔽了不用的函数
u8g2 图形库（3）：u8g2 移植到 STM32 平台
热门推荐
白杨木屋
03-31 1万+
本文开发环境： MCU型号：STM32F1.03ZET6 IDE环境： TrueStuido 9.3.0 / MDK 5.27 代码生成工具：STM32CubeMx 5.0.1 HAL库版本：STM32Cube_FW_F1_V1.8.0 本文内容： STM32CubeMx 配置模板工程河 GPIO 口 移植 u8g2 到 MCU 附件： MDK工程/TrueStuidio 工程（模......
【STM32 CubeMX】移植u8g2(一次成功)
m0_62599305的博客
09-30 4445
在本文中，我们将介绍如何在STM32上成功地移植u8g2图形库，以便能够轻松地控制OLED或LCD显示屏。u8g2库提供了一个灵活、功能强大的框架，可以简化图形界面的开发过程。通过合理地配置STM32 CubeMX以及适当的硬件连接，我们可以使得u8g2与STM32微控制器完美结合。我们将逐步引导您完成整个移植过程，从STM32 CubeMX的项目创建，到u8g2库的集成和配置，最终实现一个简单的示例程序，以确保整个过程的顺利进行。让我们一起开始吧！
基于STM32移植u8g2图形库至OLED（HAL库）
最新发布
qq_54616393的博客
08-17 1205
2、感兴趣的各位，可以详细去了解一下，本次分享结束。
U8G2移植到STM32，SSD13XXXOLED(硬件SPI DMA通讯)
Lim的博客
05-28 1462
在嵌入式开发中，显示屏是常见的外设之一。OLED屏幕因其高对比度和低功耗，被广泛应用于各种嵌入式系统中。本文将详细介绍如何在STM32平台上使用SPI DMA方式移植U8G2库到屏幕。
STM32移植U8G2（0.96寸IIC屏幕）
weixin_62656772的博客
02-18 2025
偶然发现U8G2这个图像库，发现这个库能实现许多好玩有趣的动画，因此花了一晚上时间将其移植到STM32中，趁着还有些印象记录一下。
移植 U8g2 到 STM32 中
Toutiegongzhu的博客
12-01 1287
因为我们只调用了u8g2_Setup_ssd1306_i2c_128x64_noname_f()这个函数，所以只保留他用到的函数即可。3、进入Keil5，创建一个U8g2文件夹，把刚刚裁剪的文件放入U8g2中，并且把MyLibrary路径给放入STM32路径中。，多余带有u8x8_d_的文件删除。ssd1306是驱动芯片，128x64是分辨率。这里有个小问题，如果遇到跟我一样的情况，修改这个选项即可。这是笔主裁剪过后的文件，就少了带u8x8_d_的文件。2、去掉多余的驱动文件，只保留。
u8g2库移植stm32f103c8t6(0.96英寸oled屏)
Gracelsd的博客
12-25 629
U8g2对stm32f103的移植
stm32f103c8t6移植u8g2库，烧录程序接好线即可。
04-08
在本项目中，我们将讨论如何将U8g2图形库移植到STM32F103C8T6上，以便驱动SSD1306 OLED显示屏。 U8g2是一个强大的开源图形库，专为低功耗显示设备如OLED、LCD等设计，支持多种控制器和接口。它提供了丰富的图形功能...
基于江科大教程stm32f103c8t6最小系统板u8g2库移植
01-30
在这个教程中，我们将深入探讨如何将U8g2库移植到基于江科大教程的STM32F103C8T6最小系统板上，以实现图形显示功能。 U8g2是一个开源的C++图形库，专为各种单色液晶显示器（LCD）和 OLED 显示屏设计，支持包括SPI、...
STM32移植U8G2库1.3四线SPIOLED
07-12
一直大神的U8g2GUI库，比周立功的库要好一些，但比不上STenwin，比较是适配单色屏驱动比较全，移植可以看https://blog.csdn.net/perfugee/article/details/79092075
STM32移植u8g2库（HAL库）（硬件SPI）（sh1106_128x64）
01-07
STM32移植u8g2库（HAL库）（硬件SPI）（sh1106_128x64）MCU型号为STM32F103RCT6，OLED屏为中景园电子1.3寸屏，驱动芯片为sh1106，分辨率为128x64，MDK版本为V5.34。
u8g2_STM32_HAL_CLUB_IIC_SS1306.zip
02-26
移植u8g2 到 STM32 用 HAL CLUB 库 基于 硬件IIC 驱动芯片SS1306
STM32 使用U8G2库驱动SSD1306 工程（基于HAL库）
10-05
STM32 H使用U8G2库 软件I2C驱动SSD1306
STM32移植U8g2显示库，硬件SPI连接并显示。
01-26
U8g2 STM32 SPI 0.96寸OLED 1.3寸OLED
STM32HAL库OLED移植U8g2库
04-04
在STM32HAL库上移植U8g2库，可以方便地在STM32微控制器上实现OLED显示屏的图形化操作。 首先，你需要确保你的开发环境已经搭建好。这里提到使用的是CLion，这是一个基于JetBrains的C++ IDE，支持STM32开发。你需要...
STM32移植U8g2图形库
angers11的博客
05-04 1153
一直想找一个可移值性强的显示驱动，偶然发现U8G2这个图像库，发现这个库能实现许多好玩有趣的动画，可以编一些界面，作为知识储备。U8g2 是一个用于嵌入式设备的简易图形库，可以在多种 OLED 和 LCD 屏幕上，支持包括 SSD1306 (新版型号为SSD1315)等多种类型的底层驱动，并可以很方便地移植到 Arduino 、树莓派、NodeMCU 和 ARM 上。
30秒学会U8G2库移植到STM32平台上
u014428915的博客
07-01 1100
如果移植过程中出现u8x8_GetMenuEvent(u8x8_t *u8x8)未定义错误，则自己重新写一个空函数即可。2)u8g2_d_memory.c 屏蔽里面所有文件，只留对应文件（ssd1306只留这个函数），其余屏蔽。1)u8g2_setup.c 屏蔽里面所有文件，只留对应文件（ssd1306只留这个函数），其余屏蔽。1）如果你是使用的spi。需要重新是实现下这个函数：根据自己的实际使用的管脚来修改。然后根据自己的驱动添加u8x8_d_找到src文件夹，把里面的所有文件。
u8g2库的使用stm32
07-27
您好！关于u8g2库在STM32上的使用，以下是一般的步骤： 1. 首先，确保您的STM32开发板已连接到您的计算机，并且您已经安装了适当的开发环境（如Keil、STM32CubeIDE等）。 2. 下载u8g2库的最新版本，可以从u8g2官方网站（https://github.com/olikraus/u8g2）上找到源代码。 3. 将下载的库文件解压缩，并将u8g2文件夹复制到您的项目目录中。 4. 打开您的开发环境，并创建一个新的STM32项目。 5. 在您的项目中包含u8g2库的头文件。根据您的开发环境不同，可能有不同的方法。例如，在Keil中，您可以通过右键单击项目->Options for Target->C/C++选项卡->Include Paths and Symbols来添加路径。 6. 在您的代码中，使用合适的接口初始化u8g2库。根据您使用的显示设备类型（如OLED、LCD等），选择适当的初始化函数。例如，如果您使用I2C接口的OLED显示屏，可以使用以下代码进行初始化： ```c #include "u8g2.h" u8g2_t u8g2; void u8g2_init(void) { u8g2_Setup_ssd1306_i2c_128x64_noname_f(&u8g2, U8G2_R0, u8x8_byte_sw_i2c, u8x8_gpio_and_delay_stm32cube_hal); u8x8_SetI2CAddress(&u8g2.u8x8, 0x78); u8g2_InitDisplay(&u8g2); u8g2_SetPowerSave(&u8g2, 0); } ``` 7. 使用u8g2库提供的函数来控制显示设备。例如，您可以使用以下代码在屏幕上绘制文本： ```c u8g2_DrawStr(&u8g2, 0, 10, "Hello, World!"); u8g2_SendBuffer(&u8g2); ``` 这是一个简单的示例，演示了如何在STM32上使用u8g2库。您可以根据自己的需求使用其他u8g2库的功能和函数来绘制图形、显示图像等。 希望这可以帮助到您！如有其他问题，请随时提问。
评论 11
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值