OLED12864扩展库（型号：GME12864-71）

LZY825597017

1.扩展库介绍

本扩展库适用于OLED12864，驱动方式为IIC（软件）,设备地址为0X3C ,请在使用本扩展库之前确定好自己所使用的OLED屏幕型号是否对应。
默认驱动是SSD1106，若12864驱动为SSD1306则需要更改库函数中的void SSD_OLED12864:led_display(void)函数，

若选择错误会出现花边现象
图形化模块
（1）OLED初始化 SDA和SCL引脚，设备地址默认0X3C


（2）OLED更新显示（将显存数据发送到屏幕，使用显示模块后必须调用更新显示，否则无法显示或者屏幕不刷新）



（3）OLED清屏（不是屏幕清屏而是清空显存）


（4）OLED显示字符（在屏幕坐标为(X,Y)的位置显示单个字符，大小可调整（12/16/24/32））
注意：使用不同的字体大小需要开启不同的字库（字库会占用很多内存空间），因此尽量使用相同字体大小，否则可能会出现内存不够的情况，后续不再赘述
这里的X范围为（0-127）Y范围（0-63）


（5）OLED显示字符串（在屏幕坐标为(X,Y)的位置显示开始字符串，大小可调整（12/16/24/32））


（6）OLED显示数字（在屏幕坐标为(X,Y)的位置显示开始数字，大小可调整（12/16/24/32））


（7）OLED显示小数（在屏幕坐标为(X,Y)的位置显示开始小数，精度可调（1-4），大小可调整（12/16/24/32））


（8）OLED显示汉字（在屏幕坐标为(X,Y)的位置开始显示汉字），大小可调整（12/16/24/32））


（9）OLED画线段/矩形框/填充矩形 （线段起点（X0,Y0）线段终点（X1,Y1））（矩形框起点即左上角位置（X0,Y0），矩形框终点即右下角位置（X1,Y1））


（10）OLED画圆/填充圆 （以（X0,Y0）为圆心，指定半径画圆或者填充圆）


（11）OLED画三角形/填充三角形 （三角形三个点（X0,Y0）、（X0,Y0）、（X0,Y0））


（12）OLED显示图片 （从（X,Y）位置开始显示指定宽度和高度的图片，首个参数为显示的图片数组指针）


2.扩展库使用范例

（1）硬件连接（CH32V003）



（2）范例（CH32V003）

启用上面初始化框，屏幕依次显示字符、字符串数字等等，启用下面初始化框，屏幕显示图片。

显示字符等不做过多说明，注意不要超出屏幕范围即可

下面介绍图片显示（建议使用最新版本）
第一步：准备一张需要显示的图片
第二步：使用Image2Lcd软件获取图片数组 注意：图像像素宽度和高度不要超过128*64 软件设置如下所示
旧版显示图片：

新版版显示图片：



第三步：保存文件，名字自定义即可，注意删除逗号，复制粘贴数组到程序



第四步：使用图形化显示




常见问题与注意事项
1、连接线路检查，杜邦线等确定能正常使用。
2、驱动方式为软件IIC，需要上拉电阻，否则可能无法显示。
3、旧版显示内容超出界限。X（0-127）Y（0-63）,新版可以超过边界，超出边界则不显示
4、某些IO被用作特殊功能，如串口、SWIO等，不能用作SDA和SCL。如有需要可以关闭特殊功能，复用成普通IO即可。
5、型号选择错误，可能出现显示异常等情况