当前位置：首页 > news >正文

Arduino库之U8g2lib

news 2026/2/20 11:50:37

某些图片、表格在手机竖屏状态下会显示不全，横屏显示即可。最好是用平板或电脑看。大部分内容摘自官网。

简介

U8g2

U8glib是用于单色显示屏的图形库，它可以用于51、Arduino、ARM控制显示屏，目前作者olikraus已经更新到version2了，也就是U8g2lib（下面简称U8g2）。U8g2这个库实际上包含两个库(api)：U8g2和U8x8，它们有如下特点：

U8g2
- 可处理所有图形
- 支持很多字体（。（几乎）对字体大小没限制
- 微控制器需要一定的存储空间来传递显示
U8x8
- 只能输出文字
- 只能输出固定像素的字体
- 直接输出到显示屏，微控制器无需缓冲区

这两个库还包含一个特殊的类（也能看作一个子库）：U8log，它能模拟一个输出终端，功能如下：

U8log
- Output of boot/startup information 输出初始化信息
- Error logging 载入错误
- Debugging logging 载入debug
- Output of sensor values 输出传感器值（我看上的是这一点）

我在这里只给出Arduino相关的部分，51和ARM大同小异。下面我们结合实际操作来学习。

安装U8g2

进入Arduino IDE，点击上方“工具”-“管理库”，搜索U8g2，选择U8g2 by oliver那个，点击安装即可。

安装U8g2

Hello World!

按照惯例，我们先输出一个Hello World!。点击上方“文件”-“示例”-“U8g2”-“full_buffer”-“HelloWorld”，先不要急着上传到Arduino，要先根据你的屏幕控制器、像素，删掉其中一个注释的//。我的型号是淘宝上常见的0.96 OLED（下图），所以我用的是这句：U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE);。

我的OLED

上传，接好线，上电，就可以看到屏幕上出现”Hello World!“（位置可能和上图不一样）。

配置

虽然上面的”HelloWorld“看起来很长，但实际上只有以下几句：

#include <U8g2lib.h>
#include <Wire.h>
U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE);void setup(void) {u8g2.begin();
}void loop(void) {u8g2.clearBuffer();         // clear the internal memoryu8g2.setFont(u8g2_font_ncenB08_tr); // choose a suitable fontu8g2.drawStr(0,10,"Hello World!");  // write something to the internal memoryu8g2.sendBuffer();          // transfer internal memory to the displaydelay(1000);  
}

开头第一句是引用U8g2，我们着重看第二句，它就是配置”Setup“，具体分成以下几部分：

Description	Example
前缀	`U8G2`
控制器（驱动器）	`SSD1306`
显示屏	`128x64_NONAME`
缓冲区大小	`1`、`2`、或`F`(full)
通信协议	`HW_I2C`
参数	`(U8G2_R0, U8x8_PIN_NONE)`

控制器/显示屏名字

这个没什么好讲的，一般淘宝上都会标出来，实在不知道就问商家，再不行就挨个试一下符合像素的那几句。

缓冲区大小

1表示RAM中只会储存一页画面的缓冲。你需要用一个firstPage()/nextPage()循环来显示。

2和1类似，但会储存两页。官网还说2是1的两倍快，但我实在不知道”快“指的是什么。

F表示“full frame buffer”，储存所有页面，用clearBuffer()来清除缓冲，用sendBuffer()来把缓冲发送到显示屏。

这一部分还没完全弄懂，貌似就是F相当于一本书，你可以预先在书上画很多页，然后要显示哪一页就翻到那里。1就相当于一块黑板，你只能画一页东西，要显示新的东西就要重新擦掉重画。2就是两块黑板。

通信协议

支持常见的SPI、I2C、6800和8080，支持硬件HW和软件SW，具体有下面几种：

通信协议	描述
`4W_SW_SPI`	4线（clock, data, cs and dc）软件模拟SPI
`4W_HW_SPI`	4线（clock, data, cs and dc）硬件SPI（基于SPI库）
`2ND_4W_HW_SPI`	如果板子支持，第二个 4线硬件SPI
`3W_SW_SPI`	3线(clock, data and cs)软件模拟SPI
`SW_I2C`	软件模拟 I2C/TWI
`HW_I2C`	硬件 I2C （基于Wire库）
`2ND_HW_I2C`	如果板子支持，第二个硬件 I2C （基于Wire库）
6800	8-bit并行接口，6800协议
8080	8-bit并行接口，8080协议

软件模拟 I2C 需要设置SCL，SDA对应管脚：..._SW_I2C(clock, data [, reset])。

旋转

这是配置语句的第一个参数，有如下几种选择：

旋转/镜像	描述
`U8G2_R0`	不旋转
`U8G2_R1`	顺时针旋转90度
`U8G2_R2`	顺时针旋转180度
`U8G2_R3`	顺时针旋转270度
`U8G2_MIRROR`	不旋转，镜像翻转

接线

官网上的表格：

Pin Argument	Description	Datasheet Names
clock	SPI or I2C clock line	SCL, SCLK, …
data	SPI or I2C data line	SDA, MOSI, SDIN, …
d0 … d7	Data lines of the parallel interface	D0 … D7
cs	Chip select line	CS
dc	Data/command selection line (register select)	D/C, A0, RS, …
enable	“Write” for the 8080 interface, “enable” for the 6800 interface	8080: WR, 6800: E
reset	Reset line

如果你不需要用某个引脚但又需要一个参数，可以用U8X8_PIN_NONE

16 Bit模式

U8g2默认是8 Bit Mode，如果你的设备支持 256或以上的像素宽，你可以在u8g2.h文件中取消注释//#define U8G2_16BIT。

SSD1306 128X64_NONAME

由于这个模块比较常用，所以我把它的详细介绍搬了过来。其他模块请去官网。（显示不全的话请横屏查看）

Controller “ssd1306”, Display “128x64_noname”	Descirption
U8G2_SSD1306_128X64_NONAME_1_SW_I2C(rotation, clock, data [, reset])	page buffer, size = 128 bytes
U8G2_SSD1306_128X64_NONAME_2_SW_I2C(rotation, clock, data [, reset])	page buffer, size = 256 bytes
U8G2_SSD1306_128X64_NONAME_F_SW_I2C(rotation, clock, data [, reset])	full framebuffer, size = 1024 bytes
U8G2_SSD1306_128X64_NONAME_1_HW_I2C(rotation, [reset [, clock, data]])	page buffer, size = 128 bytes
U8G2_SSD1306_128X64_NONAME_2_HW_I2C(rotation, [reset [, clock, data]])	page buffer, size = 256 bytes
U8G2_SSD1306_128X64_NONAME_F_HW_I2C(rotation, [reset [, clock, data]])	full framebuffer, size = 1024 bytes
U8G2_SSD1306_128X64_NONAME_1_2ND_HW_I2C(rotation, [reset])	page buffer, size = 128 bytes
U8G2_SSD1306_128X64_NONAME_2_2ND_HW_I2C(rotation, [reset])	page buffer, size = 256 bytes
U8G2_SSD1306_128X64_NONAME_F_2ND_HW_I2C(rotation, [reset])	full framebuffer, size = 1024 bytes

控制函数

下面一些控制函数，能对全局进行操作。写得有点乱。

begin

函数原型：

1
2

bool U8G2::begin(void)
bool U8G2::begin(uint8_t menu_select_pin, uint8_t menu_next_pin, uint8_t menu_prev_pin, uint8_t menu_up_pin = U8X8_PIN_NONE, uint8_t menu_down_pin = U8X8_PIN_NONE, uint8_t menu_home_pin = U8X8_PIN_NONE)

描述：用上面的配置设置显示屏，并且会清空显示屏，退出显示屏的省电模式。还可以设置按键：将按键的对应引脚传递到对应参数（按键要求低有效），用getMenuEvent来检查按键事件，从而构建用户交互界面。
这个函数会调用：
1. initDisplay
2. clearDisplay
3. setPowerSave
返回值：永远是1/true
相关：initDisplay, setPowerSave, clearDisplay, U8X8::begin
例子：这个函数一般放在void setup(void)里面：
1 2 3
void setup(void) {u8g2.begin(); }

initDisplay

函数原型：
1
void U8G2::initDisplay(void)
描述：重新设置显示屏。显示前一定要先调用这个函数。它会让屏幕处在省电模式。要让屏幕显示，先取消省电模式（setPowerSave）
相关：setPowerSave, begin

setPowerSave

原型：

1	`void U8G2::setPowerSave(uint8_t is_enable)`

描述：开启（is_enable=1）或关闭（is_enable=0）显示屏的省电模式。当省电模式开启时，屏幕上的内容不可见，屏幕RAM的内容未更改。这个函数在begin被调用。
参数：
- is_enable：开启（1）或关闭（0）显示屏的省电模式。
相关：begin

clear

函数原型：
1
void U8G2::clear(void)
描述：清空屏幕（display）和缓冲区（buffer）的所有像素（说实话我分不清这俩）。将print的指针（cursor）归位到左上角。
这个函数会调用：
1. home
2. clearDisplay
3. clearBuffer
相关：home, clearDisplay, clearBuffer

home

函数原型：
1
void U8G2::home(void)
描述：将print函数的指针（游标cursor）重置到左上角。如果字体的参考点不在上方的话，字体的一部分会看不见。
相关：print, clear, setCursor

clearDisplay

函数原型：
1
void U8G2::clearDisplay(void)
描述：清空内部和显示屏的缓冲区的像素。这个函数在begin函数内被调用，因此除了初始化时之外，无需再调用这个函数。其他函数，如 sendBuffer 和 nextPage) ，也能覆盖/清空显示。
注：
- 这个命令可以对_F_、_1_、_2_三种缓冲区大小都有效
- 不要在单页的循环内使用这个命令（在firstPage和nextPage）
相关：begin

clearBuffer

函数原型：
1
void U8G2::clearBuffer(void)
描述：清空内部缓冲区的所有像素。清楚后，用 sendBuffer 来将新的页面传递给显示屏。这个函数只对_F_（储存所有页面）的情况有效（见上面的缓冲器大小）。它还会发送一个刷新信号（refreshDisplay）给墨水屏。
相关：sendBuffer

示例：

void loop(void) {u8g2.clearBuffer();// ... write something to the buffer u8g2.sendBuffer();delay(1000);

sendBuffer

函数原型：
1
void U8G2::sendBuffer(void)
描述：将内存缓冲区中的内容发送给显示。用 clearBuffer清空缓冲区，用绘画函数向缓冲区添加内容。这个函数只对_F_（储存所有页面）的情况有效（见上面的缓冲器大小）。它还会发送一个刷新信号（refreshDisplay）给墨水屏。
注：有点复杂，把英文抄下来：

Actually this procedure will send the current page to the display. This means, the content of the internal pixel buffer will be placed in the tile row given by the current page position. This means, that this procedure could be used for partial updates on paged devices (constructor with buffer option “1” or “2”). However, this will only work for LCDs. It will not work with most e-Paper/e-Ink devices because of the buffer switch in the display controller. Conclusion: Use this command only together with full buffer constructors. It will then work with all LCDs and e-Paper/e-Ink devices.
相关：clearBuffer, updateDisplay

firstPage

函数原型
1
void U8G2::firstPage(void)
描述：这个和nextPage一起构成图像循环，将内容发送到显示屏。有一些限制：不要在执行循环时更改显示内容。循环时总是重新绘制所有内容，而非一部分。这样能节约ram，参考sendBuffer。
相关：nextPage

示例：

u8g2.firstPage();do {/* all graphics commands have to appear within the loop body. */    u8g2.setFont(u8g2_font_ncenB14_tr);u8g2.drawStr(0,20,"Hello World!");} while ( u8g2.nextPage() );

函数原型：
1
uint8_t U8G2::nextPage(void)
描述：这个和firstPage一起构成图像循环，将内容发送到显示屏。有一些限制：不要在执行循环时更改显示内容。循环时总是重新绘制所有内容，而非一部分。这样能节约ram，参考sendBuffer。完成循环后，这个函数会发送一个刷新命令（refreshDisplay）给墨水屏（在返回0之前）。
返回值：0，在循环完成后（所有数据都传送给屏幕）。
相关：firstPage

示例：

u8g2.firstPage();do {/* all graphics commands have to appear within the loop body. */    u8g2.setFont(u8g2_font_ncenB14_tr);u8g2.drawStr(0,20,"Hello World!");} while ( u8g2.nextPage() );

disableUTF8Print

函数原型：
1
void U8G2::disableUTF8Print(void)
描述：禁止print函数用UTF8。这是默认设置。
相关：print, enableUTF8Print

enableUTF8Print

函数原型：
1
void U8G2::enableUTF8Print(void)
描述：允许print函数用UTF8。当其有效时，可以传递unicode符号的字符串给print函数。通常这个函数在begin后被调用：
1 2 3 4
void setup(void) {u8g2.begin();u8g2.enableUTF8Print(); // enable UTF8 support for the Arduino print() }
相关：print, disableUTF8Print

示例：

void setup(void) {u8g2.begin();u8g2.enableUTF8Print();		// enable UTF8 support for the Arduino print() function
}
void loop(void) {u8g2.setFont(u8g2_font_unifont_t_chinese2);  // use chinese2 for all the glyphs of "你好世界"u8g2.firstPage();do {u8g2.setCursor(0, 40);u8g2.print("你好世界");		// Chinese "Hello World" } while ( u8g2.nextPage() );delay(1000);
}

setI2CAddress

函数原型
1
void U8G2::setI2CAddress(uint8_t adr)
描述：默认情况，U8g2假设显示屏为最不可能的地址（原文为：By default, U8g2 assumes the lowest possible I2C address of the display.）。如果需要设置一个不同的地址，请在begin()之前调用这个函数。
参数：I2C地址乘以2（我也不知道为什么，我用I2C_scan程序扫描到的地址为0x3C，但只有输入0x78（0x3C*2=0x78）才有效），并且最低位必须为0（才能写）
相关：begin
注：U8g2 v2.6.x才可用。

绘图函数

这类函数有一个特点，就是都以draw开头，可以画各种点、线、形。需要注意的是，下面的所有坐标都是以左上角为（0, 0），正方向为向右和向下。测试时可用如下代码：

#include <U8g2lib.h>
#include <Wire.h>
U8G2_SSD1306_128X64_NONAME_1_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE);void setup(void) {u8g2.begin();
}void loop(void) {u8g2.firstPage();do {/*graphics commands*/} while ( u8g2.nextPage() ); 
}

drawPixel

函数原型：

1	`void U8G2::drawPixel(u8g2_uint_t x, u8g2_uint_t y)`

描述：在特定的x/y位置画一个点。(0, 0)为左上角。可能会超出屏幕边界。这个程序会用当前颜色（setDrawColor）来画，颜色0会清除一个像素，颜色1会设置一个像素。
参数：
- x：x坐标
- y：y坐标
相关：setDrawColor

drawBitmap

函数原型：

1	`void U8G2::drawBitmap(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t cnt, u8g2_uint_t h, const uint8_t *bitmap)`

描述：在特定的x/y处画一个位图（x/y对应位图的左上角）。位图的一部分可能会超出屏幕边界。位图由bitmap数组给定。
参数：
- x：x坐标（位图的左上角）
- y：y坐标（位图的左上角）
- cnt：水平方向上位图的字数。位图的宽度=cnt*8。
- h：位图的高度
注：不要再用这个函数，用drawXBM代替。
相关：drawXBM

drawXBM

函数原型：

1
2

void U8G2::drawXBM(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w, u8g2_uint_t h, const uint8_t *bitmap)
void U8G2::drawXBMP(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w, u8g2_uint_t h, const uint8_t *bitmap)

描述：画一个X BitMap （一种单色点阵图），x/y对应点阵图的左上角。颜色由setColorIndex给定。在U8g2 Version 2.15.x中，引进了实/虚模式（solid/transparent），默认是实模式。这个函数的XBMP版本（即drawXBMP）要求点阵图储存在PROGMEM中（ROM内）。有很多工具可以将普通图片转换到XBM，比如开源软件GIMP，在线网站onlineconvertfree。实在不知道，可以参考教程Interfacing & displaying a custom graphic on an 0.96″ I2C OLED with Arduino
参数：
- x/y：点阵图左上角的位置
- w/h：点阵图的宽/高
- bitmap：指向点阵图开头的指针
相关：setBitmapMode
注：XBMP版本要求点阵图数组按下面方式定义：
1
static const unsigned char u8g_logo_bits[] U8X8_PROGMEM = { ...
另外，由于Arduino普遍内存小，尽量

示例：

#define u8g_logo_width 38
#define u8g_logo_height 24
static const unsigned char u8g_logo_bits[] PROGMEN= {//使用PROGMEN储存，不然可能会提示错误0xff, 0xff, 0xff, 0xff, 0x3f, 0xff, 0xff, 0xff, 0xff, 0x3f, 0xe0, 0xe0,
...0xff, 0x3f, 0xff, 0xff, 0xff, 0xff, 0x3f, 0xff, 0xff, 0xff, 0xff, 0x3f };

这个可以直接粘贴到你的代码里。

1	`u8g2.drawXBM( 0, 0, u8g_logo_width, u8g_logo_height, u8g_logo_bits);`

drawLine

函数原型：

1	`void U8G2::drawLine(u8g2_uint_t x0, u8g2_uint_t y0, u8g2_uint_t x1, u8g2_uint_t y1)`

描述：在两点之间画一条直线，这个函数会用当前颜色（setDrawColor）来画。
参数：
- x0、y0：起始点的坐标
- x1、y1：终点的坐标
相关：drawPixel, setDrawColor
示例：
1
u8g2.drawLine(20, 5, 5, 32);
drawLine示例

drawHLine

函数原型：

1	`void U8G2::drawHLine(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w)`

描述：以x/y为左边起点，w为长度向右画水平线。线的一部分可能超出屏幕边界。这个函数会用当前颜色（setDrawColor）来画，颜色0为清除像素，颜色1为设置像素。
参数：
- x/y：左边起点的x/y坐标
- w：水平线的长度
相关：setDrawColor, drawVLine

drawVLine

函数原型：

1	`void U8G2::drawVLine(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t h)`

描述：以x/y为上面起点，h为长度向下画竖直线。线的一部分可能超出屏幕边界。这个函数会用当前颜色（setDrawColor）来画，颜色0为清除像素，颜色1为设置像素。
参数：
- x/y：上面起点的x/y坐标
- h：竖直线的长度
相关：setDrawColor, drawHLine

drawTriangle

函数原型：

1	`void U8G2::drawTriangle(int16_t x0, int16_t y0, int16_t x1, int16_t y1, int16_t x2, int16_t y2)`

描述：画一个实心的三角形。参数为16bit。图形会根据显示屏尺寸裁剪。后面一段看不懂……

Multiple polygons are drawn so that they exactly match without overlap:The left side of a polygon is drawn, the right side is not draw. The upper side is only draw if it is flat.
参数：
- x0/y0：点0的位置
- x1/y1：点1的位置
- x2/y2：点2的位置
示例：
1
u8g2.drawTriangle(20,5, 27,50, 5,32);

drawBox

函数原型：

1	`void U8G2::drawBox(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w, u8g2_uint_t h)`

描述：画一个实心矩形，左上角的位置对应x/y，宽为w，高为h。矩形的一部分可能会超出屏幕边界。这个函数会用当前颜色（setDrawColor）来画，对于单色显示屏，颜色0表示清除像素，颜色1表示显示像素。
参数：
- x：x坐标（框的左上角）
- y：y坐标（框的左上角）
- w：矩形的宽度
- h：矩形的长度
相关：drawFrame, setDrawColor
示例：
1
u8g2.drawBox(3,7,25,15);
drawBox示例

drawFrame

函数原型：

1	`void U8G2::drawFrame(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w, u8g2_uint_t h)`

描述：画一个空心框，左上角的位置对应x/y，宽为w，高为h。矩形的一部分可能会超出屏幕边界。这个函数会用当前颜色（setDrawColor）来画，对于单色显示屏，颜色0表示清除像素，颜色1表示显示像素。
参数：
- x：x坐标（框的左上角）
- y：y坐标（框的左上角）
- w：框的宽度
- h：框的长度
相关：drawBox, setDrawColor
示例：
1
u8g2.drawFrame(3,7,25,15);
drawFrame示例

drawRBox

见drawRFrame

drawRFrame

函数原型：

1 2	`void U8G2::drawRBox(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w, u8g2_uint_t h, u8g2_uint_t r) void U8G2::drawRFrame(u8g2_uint_t x, u8g2_uint_t y, u8g2_uint_t w, u8g2_uint_t h, u8g2_uint_t r)`

描述：画一个有圆角的框/矩形，以x/y为左上角的坐标，以w/h为宽/长。部分可能会超出屏幕边界。圆角半径为r，要求w >= 2*(r+1)且h >= 2*(r+1)，函数不会检查是否满足这个关系，如果w或h小于2*(r+1)，会发生未定义的行为（就是出错…）这个函数会用当前颜色（setDrawColor）来画，对于单色显示屏，颜色0表示清除像素，颜色1表示显示像素。
参数
- x/y：左上角的坐标
- w：框/矩形的宽度
- h：框/矩形的长度
- r：圆角的半径
相关：[setDrawColor]{#setDrawColor}, [drawFrame]{#drawFrame}, [drawBox]{#drawBox}
示例：
1
u8g2.drawRFrame(20,15,30,22,7);
drawRFrame示例

drawCircle

函数原型：

1	`void U8G2::drawCircle(u8g2_uint_t x0, u8g2_uint_t y0, u8g2_uint_t rad, uint8_t opt = U8G_DRAW_ALL)`

描述：以(x0, y0)为圆心，rad为半径，画空心圆。圆的直径为2*rad+1。不同opt参数可以设置画圆的不同部分，可选的参数有：U8G2_DRAW_UPPER_RIGHT、U8G2_DRAW_UPPER_LEFT、U8G2_DRAW_LOWER_LEFT、U8G2_DRAW_LOWER_RIGHT、U8G2_DRAW_ALL，并且这些参数可以用|结合。这个函数会用当前颜色（setDrawColor）来画。
参数：
- x0、y0：圆心的位置
- rad：圆的半径
- opt：选择画圆的哪部分。
  - U8G2_DRAW_UPPER_RIGHT
  - U8G2_DRAW_UPPER_LEFT
  - U8G2_DRAW_LOWER_LEFT
  - U8G2_DRAW_LOWER_RIGHT
  - U8G2_DRAW_ALL
注：不支持Draw color 2（XOR Mode）
相关：drawDisc, setDrawColor

示例：

1	`u8g2.drawCircle(20, 25, 10, U8G2_DRAW_ALL);`

drawCircle示例

drawDisc

函数原型：

1	`void U8G2::drawDisc(u8g2_uint_t x0, u8g2_uint_t y0, u8g2_uint_t rad, uint8_t opt = U8G_DRAW_ALL)`

描述：以(x0, y0)为圆心，rad为半径，画实心圆。圆的直径为2*rad+1。不同opt参数可以设置画圆的不同部分，可选的参数有：U8G2_DRAW_UPPER_RIGHT、U8G2_DRAW_UPPER_LEFT、U8G2_DRAW_LOWER_LEFT、U8G2_DRAW_LOWER_RIGHT、U8G2_DRAW_ALL，并且这些参数可以用|结合。这个函数会用当前颜色（setDrawColor）来画。
参数：
- x0、y0：圆心的位置
- rad：圆的半径
- opt：选择画圆的哪部分。
  - U8G2_DRAW_UPPER_RIGHT
  - U8G2_DRAW_UPPER_LEFT
  - U8G2_DRAW_LOWER_LEFT
  - U8G2_DRAW_LOWER_RIGHT
  - U8G2_DRAW_ALL
注：不支持Draw color 2（XOR Mode）
相关：drawDisc, setDrawColor
示例：（见drawCircle）

drawGlyph

函数原型：

1	`void U8G2::drawGlyph(u8g2_uint_t x, u8g2_uint_t y, uint16_t encoding)`

描述：画一个Unicode象形文字。文字放在x/y像素上方。U8g2只支持Unicode低16位编码的字符（BMP）：encoding的值为0~65535。只有当字体中有对应编码时才能画出来。
参数：
- x/y：字符在屏幕上的位置
- encoding：字符的Unicode值
注：这个绘画函数受setDrawColor和setFontMode控制
相关：setFont
示例：“雪人”是Unicode中的天气符号之一，其Unicode编码为9731（十进制）/2603（2进制）：⛄。“雪人”也是U8g2字体：u8g2_font_unifont_t_symbol中的一个字。
1 2
u8g2.setFont(u8g2_font_unifont_t_symbols);u8g2.drawGlyph(5, 20, 0x2603); /* dec 9731/hex 2603 Snowman */
drawGlyph示例

drawStr

函数原型：

1	`u8g2_uint_t U8g2::drawStr(u8g2_uint_t x, u8g2_uint_t y, const char *s)`

描述：画一个字符串。第一个字符的位置为x/y。调用这个函数前用setFont来指定一种字体。要输入编码为127~255的字符的话，用C/C++/Arduino的转义字符 “\xab”（16进制）或“\xyz”（8进制）。这个函数不能画编码大于等于256的字符，请用drawUTF8或drawGlyph来这种字符。
参数：
- x/y：第一个字符的位置
- s：文本
返回值：字符串的长度
注：
- 这个绘画函数受setDrawColor和setFontMode控制
- 用print来显示出数值型变量
相关：setFont, drawUTF8, drawGlyph, print

示例：

1 2	`u8g2.setFont(u8g2_font_ncenB14_tr);u8g2.drawStr(0,15,"Hello World!");`

drawStr示例

drawUTF8

函数原型：

1	`u8g2_uint_t U8g2::drawUTF8(u8g2_uint_t x, u8g2_uint_t y, const char *s)`

描述：画一个以UTF-8编码的字符串。使用该函数的前提条件有两个：
1. C/C++/Arduino编译器必须支持UTF-8（这是GNU编译器的默认设置，而大多数Arduino用的正是GNU）
2. 代码编辑器必须支持UTF-8（Arduino IDE支持）
如果满足上两条件，你可以使用编码大于127的字符（当然，这个字符要在字体文件中存在，见setFont）。

好处：代码的可读性更好；可直接”复制“-”粘贴“象形文字到代码里。

坏处：代码的移植性差；strLen函数无法返回字符长度，要用getUTF8Len来代替strLen
参数：
- x/y：首字符的位置
- s：UTF-8编码的文本
返回值：字符串的长度
注：
- 这个绘画函数受setDrawColor和setFontMode控制
- 用print来显示出数值型变量
相关：setFont, drawStr, print

示例：

1 2	`u8g2.setFont(u8g2_font_unifont_t_symbols);u8g2.drawUTF8(5, 20, "Snowman: ☃");`

drawUTF8示例

print

函数原型：
1
void U8G2::print(...)
描述：相当书Arduino的 print() 函数，见Arduino官网上的LiquidCrystalPrint和Serial.print()。这个函数会在当前指针处（setCursor），用当前字体（setFont）打印文本（或数字）。要想支持UTF-8，可以用enableUTF8Print
参数：见上面的Arduino官网后俩链接
相关：enableUTF8Print, setCursor, setFont

示例：

1
2
3

u8g2.setFont(u8g2_font_ncenB14_tr);
u8g2.setCursor(0, 15);
u8g2.print("Hello World!");

print示例

设置函数

setAutoPageClear

函数原型：

1	`uint8_t U8G2::setAutoPageClear(uint8_t mode)`

描述：开启（mode=1）或关闭（mode=0）自动清除像素缓冲，通过

setFont

函数原型：

1	`void U8G2::setFont(const uint8_t *font)`

描述：设置u8g2字体。注意u8x8的字体无法使用。字体的最后两个字母决定字体的种类或字符集：

字体名	字体种类
u8g2_xxx_tx	字体透明，宽度可变
u8g2_xxx_mx	等宽字体
u8g2_xxx_hx	宽度可变，普通高度
u8g2_xxx_8x	等宽字体，宽度限制在8x8的格子中

字体名	字符集
u8g2_xxx_xe	Extended：unicode 32~701
u8g2_xxx_xf	Full：unicode 32~255
u8g2_xxx_xr	Restricted：unicode 32~127
u8g2_xxx_xu	Uppercase：数字和大写字母
u8g2_xxx_xn	数字和与日期时间相关的字符
u8g2_xxx_x_something	特殊的字符集，看具体的字体图列

参数：
- font：u8g2字体，具体见这里
相关：drawUTF8, drawStr, drawGlyph, u8g2字体集
示例：字体：u8g2_font_5x7_tr

setFontDirection

函数原型：

1	`void U8G2::setFontDirection(uint8_t dir)`

描述：决定字体显示的方向：

参数旋转描述
0 0 度从左到右
1 90 度从上到下
2 180 度从右到左
3 270 度从下到上
参数
- dir：方向
相关：drawStr

示例：

u8g2.setFont(u8g2_font_ncenB14_tf);
u8g2.setFontDirection(0);
u8g2.drawStr(15, 20, "Abc");
u8g2.setFontDirection(1);
u8g2.drawStr(15, 20, "Abc");

setFontDirection示例

setFontMode

函数原型：

1	`void U8G2::setFontMode(uint8_t is_transparent)`

描述：决定背景是否有颜色（is_transparent = 0无颜色，is_transparent = 1有颜色），默认为0
参数：
- is_transparent：开启（1）或关闭（0）透明模式

注：要选择一个合适的字体：

字体名	字体种类	适用于
u8g2_xxx_tx	透明字体，宽度可变	`is_transparent = 1`, XOR Mode
u8g2_xxx_mx	等宽字体	`is_transparent = 0`
u8g2_xxx_hx	宽度可变，普通高度	`is_transparent = 0`
u8g2_xxx_8x	等宽字体，宽度限制在8x8的格子中	`is_transparent = 0`

示例：展示字体与背景的四种组合（setFontColor）

/* write background pattern, then: */
u8g2.setFontMode(0);
u8g2.setDrawColor(1);
u8g2.drawStr(3, 15, "Color=1, Mode 0");
u8g2.setDrawColor(0);
u8g2.drawStr(3, 30, "Color=0, Mode 0");
u8g2.setFontMode(1);
u8g2.setDrawColor(1);
u8g2.drawStr(3, 45, "Color=1, Mode 1");
u8g2.setDrawColor(0);
u8g2.drawStr(3, 60, "Color=0, Mode 1");

setFontMode示例

setPowerSave

函数原型：

1	`void U8G2::setPowerSave(uint8_t is_enable)`

描述：开启（is_enable = 1）或关闭（is_enable = 0）显示屏的省电模式。开启省电模式时，显示屏上无显示，但不改变RAM。这个函数被begin调用。
参数：
- is_enable：开启（1）或关闭（0）省电模式

参数	旋转	描述
0	0 度	从左到右
1	90 度	从上到下
2	180 度	从右到左
3	270 度	从下到上

某些图片、表格在手机竖屏状态下会显示不全，横屏显示即可。最好是用平板或电脑看。大部分内容摘自官网。

简介

安装U8g2

Hello World!

配置

控制器/显示屏名字

缓冲区大小

通信协议

旋转

接线

16 Bit模式

SSD1306 128X64_NONAME

控制函数

begin

initDisplay

setPowerSave

clear

home

clearDisplay

clearBuffer

sendBuffer

firstPage

nextPage

disableUTF8Print

enableUTF8Print

setI2CAddress

绘图函数

drawPixel

drawBitmap

drawXBM

drawLine

drawHLine

drawVLine

drawTriangle

drawBox

drawFrame

drawRBox

drawRFrame

drawCircle

drawDisc

drawGlyph

drawStr

drawUTF8

print

设置函数

setAutoPageClear

setFont

setFontDirection

setFontMode

setPowerSave

相关文章：