STM32移植U8g2图形库

目录标题

前言

一直想找一个可移值性强的显示驱动，偶然发现U8G2这个图像库，发现这个库能实现许多好玩有趣的动画，可以编一些界面，作为知识储备。

U8G2图形库介绍

U8g2 是一个用于嵌入式设备的简易图形库，可以在多种 OLED 和 LCD 屏幕上，支持包括 SSD1306 (新版型号为SSD1315)等多种类型的底层驱动，并可以很方便地移植到 Arduino 、树莓派、NodeMCU 和 ARM 上。
U8g2 库同时包含了 U8x8 绘图库，两者的区别为：
U8g2 包含各种简单及复杂图形的绘制，并支持各种形式的字体，但需要占用一定单片机的内存作为绘图缓存
U8x8 只包含简单的显示文本功能，且只支持简单、定宽的字体。它直接绘制图形，没有缓存功能
U8g2 库的 GitHub 地址为：https://github.com/olikraus/u8g2 ，可以从中获取到源码与文档帮助

移值

本次以将 U8g2 移植到 STM32 单片机与 SSD1306 通过 I2C 驱动的 128x64 OLED 为例，介绍移植的方法。不同单片机和驱动的移植可以参考这一过程，也可以参考 U8g2 的官方移植教程。
https://github.com/olikraus/u8g2/wiki/Porting-to-new-MCU-platform 首先下载或克隆 U8g2 的源码，这里主要是使用 C 语言编写，所以只需要用到 csrc 目录下的文件。
下载完成后，将 csrc 目录拷贝或移动到工程目录里，并重命名为合适的目录名例如 u8g2lib 。

精简c源码

U8g2支持多种显示驱动的屏幕，因为源码中也包含了各个驱动对应的文件，为了减小整个工程的代码体积，在移植U8g2时，可以删除一些无用的文件。
去掉无用的驱动文件

精简u8g2_d_setup.c

由于我的OLED是IIC接口，只留一个本次要用到的u8g2_Setup_ssd1306_i2c_128x64_noname_f就好（如果是SPI接口，需要使用u8g2_Setup_ssd1306_128x64_noname_f这个函数），其它的可以删掉或注释掉

#include "u8g2.h"

/* ssd1306 f */
void u8g2_Setup_ssd1306_i2c_128x64_noname_f(u8g2_t *u8g2, const u8g2_cb_t *rotation, u8x8_msg_cb byte_cb, u8x8_msg_cb gpio_and_delay_cb)
{
   
  uint8_t tile_buf_height;
  uint8_t *buf;
  u8g2_SetupDisplay(u8g2, u8x8_d_ssd1306_128x64_noname, u8x8_cad_ssd13xx_fast_i2c, byte_cb, gpio_and_delay_cb);
  buf = u8g2_m_16_8_f(&tile_buf_height);
  u8g2_SetupBuffer(u8g2, buf, tile_buf_height, u8g2_ll_hvline_vertical_top_lsb, rotation);
}

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

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用的，函数最后的数字或字母，代表显示时的buf大小：

1：128字节
2：256字节
f：1024字节

精简u8g2_d_memory.c

由于用到的u8g2_Setup_ssd1306_i2c_128x64_noname_f函数中，只调用了u8g2_m_16_8_f这个函数，所以留下这个函数，其它的函数一定要删掉或注释掉，否则编译时很可能会提示内存不足！！！

#include "u8g2.h"

uint8_t *u8g2_m_16_8_f(uint8_t *page_cnt)
{
   
  #ifdef U8G2_USE_DYNAMIC_ALLOC
  *page_cnt = 8;
  return 0;
  #else
  static uint8_t buf[1024];
  *page_cnt = 8;
  return buf;<