U8g2单色显示图形库

U8g2是嵌入式设备的单色图形库,主要应用于嵌入式平台,如Arduino、STM32。几乎所有Arduino API的主板都得到U8g2的支持,U8g2支持大多数主流的单色OLED和LCD显示控制器 。上图是ESP8266 NodeMCU通过U8g2在SSD1306(0.96寸 128X64)展示出的效果,物理总线使用的是I2C总线。
下载U8g2 Library
如果用的是platformio平台的话,直接搜这个库即可:
platformio.ini:
lib_deps = olikraus/U8g2@^2.28.8
如果是ArduinoIDE平台的话,直接用库管理器添加即可。
U8g2使用步骤
图像信息是通过物理总线方式发给OLED显示器, 具体的OLED使用什么物理总线,需要查阅各自的数据手册。比如,SSD1306就是I2C总线。
U8g2初始化
初始化可以参考 https://github.com/olikraus/u8g2/wiki/u8g2setupcpp/
U8g2 API 参考
https://github.com/olikraus/u8g2/wiki/u8g2reference
U8g2 Demo
#include <Arduino.h>
#include <U8g2lib.h>
#include <Wire.h>
// Full screen buffer mode 全屏缓存模式
U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, U8X8_PIN_NONE, D1, D2);
void setup() {
u8g2.begin();
// 支持UTF-8
u8g2.enableUTF8Print();
// 支持中文
u8g2.setFont(u8g2_font_unifont_t_chinese2);
u8g2.setFontDirection(0);
Serial.begin(9600);
}
int i = 0;
void loop() {
Serial.println(i);
// 绘制文字
u8g2.clearBuffer();
u8g2.setCursor(4, 15);
u8g2.print("Hello World!");
u8g2.setCursor(4, 35);
u8g2.print("你好世界");
// 重置光标位置到0,0
u8g2.home();
// 绘制屏幕边框
u8g2.drawFrame(0, 0, 128, 64);
// 绘制圆弧
u8g2.home();
if(i == 0) {
u8g2.drawCircle(80, 30, 7, U8G2_DRAW_UPPER_LEFT);
}else if(i == 1) {
u8g2.drawCircle(80, 30, 7, U8G2_DRAW_UPPER_RIGHT);
}else if(i == 2) {
u8g2.drawCircle(80, 30, 7, U8G2_DRAW_LOWER_RIGHT);
}else if(i == 3) {
u8g2.drawCircle(80, 30, 7, U8G2_DRAW_LOWER_LEFT);
}
// 绘制正在充电电池图标
u8g2.home();
u8g2.drawFrame(90, 50, 20, 10);
u8g2.home();
u8g2.drawFrame(88, 54, 2, 4);
u8g2.home();
if(i == 0) {
u8g2.drawBox(105, 50, 5, 10);
}else if(i == 1) {
u8g2.drawBox(100, 50, 10, 10);
}else if(i == 2) {
u8g2.drawBox(95, 50, 15, 10);
}else if(i == 3) {
u8g2.drawBox(90, 50, 20, 10);
}
i = (i+1)%4;
u8g2.sendBuffer();
delay(100);
}
都是API,参考官方文档即可!
https://github.com/olikraus/u8g2/wiki/u8g2reference 【Github】
https://github.com/olikraus/u8g2/wiki/u8g2reference 【Github MirrorFast】