OLED/LCD HAT (A)
来自Waveshare Wiki
| |||||||||||||||||||||||||
| |||||||||||||||||||||||||
说明
产品简介
本产品主屏 2 英寸 IPS 屏幕，内置 ST7789VW 驱动芯片，使用 SPI 接口通信，广视角，支持 262K 颜色显示，240×320 分辨率，高清显示。双副屏 0.96 英寸 OLED 屏幕，内置 SSD1315 驱动芯片，使用 I2C 接口通信，支持蓝色显示，128×64 分辨率，可用于显示关键信息、状态指示或小型图形
提供完善的配套树莓派例程（WiringPi 库，以及 python 例程），STM32 例程，Arduino 例程。
产品参数
| 参数名称 | 参数 | |
| 供电电压 | 3.3V | |
| 工作电流 | 840mA | |
| 产品尺寸 | 65.00 x 56.00(mm) | |
| 屏幕类型 | 0.96inch OLED | 2inch IPS |
| 控制芯片 | SSD1315 | ST7789 |
| 通信接口 | I2C | 4-wire SPI |
| 分辨率 | 128 × 64 | 240 × 320 |
| 显示尺寸 | 21.74mm × 11.20mm | 30.60mm × 40.80mm |
| 像素大小 | 0.15mm × 0.15mm | 0.0975mm× 0.0975mm |
功能引脚
| 功能引脚 | Board物理引脚序号 |
| VCC | 3.3V |
| GND | GND |
| MOSI | 19 |
| SCLK | 23 |
| CS | 24 |
| DC | 15 |
| RST | 13 |
| SDA | 3 |
| SCL | 5 |
| KEY1 | 7 |
| KEY2 | 11 |
| KEY3 | 16 |
| KEY4 | 18 |
硬件说明
通信协议
- SPI通信协议
从上的得知使用的是4线SPI通信，查阅数据手册可以得到如下的通信时序图，以传输RGB556为例：
注：与传统的SPI协议不同的地方是：由于是只需要显示，故而将从机发往主机的数据线进行了隐藏。
RESX为复位，模块上电时拉低，通常情况下置1；
CSX为从机片选， 仅当CS为低电平时，芯片才会被使能。
D/CX为芯片的数据/命令控制引脚，当DC = 0时写命令，当DC = 1时写数据
SDA为传输的数据，即RGB数据；
SCL为SPI通信时钟。
对于SPI通信而言，数据是有传输时序的，即时钟相位（CPHA）与时钟极性(CPOL)的组合：
CPHA的高低决定串行同步时钟是在第一时钟跳变沿还是第二个时钟跳变沿数据被采集，当CPHA = 0，在第一个跳变沿进行数据采集；
CPOL的高低决定串行同步时钟的空闲状态电平，CPOL = 0，为低电平。
从图中可以看出，当SCLK第一个下降沿时开始传输数据，一个时钟周期传输8bit数据，使用SPI0，按位传输,高位在前,低位在后。
- I2C通信协议
SSD1315 芯片的 7bit 设备地址方便为 0x1E和0x1F，即设备写地址为0x3C和0x3D，读地址为0x3D和0x3E。
波形介绍：
- 写入单个字节（往 0x1F 寄存器写入 0x01）
- 连续写入多个字节（往 0x1E、0x1F 分别写入 0x20、0x01）
- 读取单个字节（从 0x21 读取单个字节）
- 连续读取多个字节（从 0x21、0x22、0x23 读取 3 个字节）
打开SPI和I2C接口
sudo raspi-config nonint do_spi 0 sudo raspi-config nonint do_i2c 0
安装库
Wiringpi
wget https://www.waveshare.net/w/upload/d/df/WiringPi.zip unzip WiringPi.zip cd WiringPi sudo ./build debian sudo mv debian-template/wiringpi_3.10_arm64.deb . sudo apt install ./wiringpi_3.10_arm64.deb gpio -v
Python
#python2 sudo apt-get update sudo apt-get install python-pip sudo apt-get install python-pil sudo apt-get install python-numpy sudo pip install RPi.GPIO sudo pip install spidev #python3 sudo apt-get update sudo apt-get install python3-pip sudo apt-get install python3-pil sudo apt-get install python3-numpy sudo apt install python3-luma.oled sudo apt install ttf-mscorefonts-installer -y
下载测试程序
打开树莓派终端，执行：
sudo apt-get install unzip -y sudo wget https://www.waveshare.net/w/upload/2/21/OLED_LCD_HAT_A_Demo.zip sudo unzip ./OLED_LCD_HAT_A_Demo.zip cd OLED_LCD_HAT_A_Demo
运行测试程序
以下命令请在RaspberryPi下执行，否则不在索引不到目录；
C语言
- 重新编译，编译过程可能需要几秒
cd c sudo make clean sudo make -j 8
- 运行示例程序
# 单独运行0.96英寸屏幕： sudo ./main 0.96 # 单独运行2英寸屏幕： sudo ./main 2 # 同时运行0.96英寸和2英寸屏幕： sudo ./main all # 运行按键程序： sudo ./main key
python
- 进入python程序目录
cd .. cd ssd1306_oled_python
- 运行示例程序
# 同时运行两个0.96英寸屏幕： sudo python double_ssd1306_128x64.py # 单独运行地址为0x3C的0.96英寸屏幕： sudo python ssd1306_oled_128x64_0x3C.py # 单独运行地址为0x3D的0.96英寸屏幕： sudo python ssd1306_oled_128x64_0x3D.py # 地址为0x3C的0.96屏幕运行检测树莓派状态程序（CPU使用率、CPU温度、内存使用率、磁盘使用率）： sudo python computer_status_oled_0x3C.py # 地址为0x3D的0.96屏幕运行按键程序,按下K4后将退出这个程序： sudo python check_key_oled_0x3D.py # 指令行检测侧边的四个按键的程序 sudo python instruct_key.py #key_definition.py是定义按键的程序
API详解(请选读c或python部分)
RaspberryPi系列均可以共用一套程序，因为他们都是嵌入式系统，兼容性比较强。
程序分为底层硬件接口、中间层液晶屏驱动、上层应用；
C
底层硬件接口
我们进行了底层的封装，由于硬件平台不一样，内部的实现是不一样的，如果需要了解内部实现可以去对应的目录中查看
在DEV_Config.c(.h)可以看到很多定义，在目录：RaspberryPi\c\lib\Config
C语言使用了3种方式进行驱动：分别是BCM2835库、WiringPi库和Dev库 默认使用Dev库进行操作，如果你需要使用BCM2835或者WiringPi来驱动的话，可以打开RaspberryPi\c\Makefile，修改13-15行，如下：
- 数据类型：
#define UBYTE uint8_t #define UWORD uint16_t #define UDOUBLE uint32_t
- 模块初始化与退出的处理：
UBYTE DEV_ModuleInit(void); void DEV_ModuleExit(void); 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理。
- GPIO读写：
void DEV_Digital_Write(UWORD Pin, UBYTE Value); UBYTE DEV_Digital_Read(UWORD Pin);
- SPI写数据
void DEV_SPI_WriteByte(UBYTE Value);
上层应用
对于屏幕而言，如果需要进行画图、显示中英文字符、显示图片等怎么办，这些都是上层应用做的。这有很多小伙伴有问到一些图形的处理，我们这里提供了一些基本的功能
在如下的目录中可以找到GUI，在目录：RaspberryPi\c\lib\GUI\GUI_Paint.c(.h)
在如下目录下是GUI依赖的字符字体，在目录：RaspberryPi\c\lib\Fonts
- 新建图像属性:新建一个图像属性，这个属性包括图像缓存的名称、宽度、高度、翻转角度、颜色
void Paint_NewImage(UBYTE *image, UWORD Width, UWORD Height, UWORD Rotate, UWORD Color) 参数： image : 图像缓存的名称，实际上是一个指向图像缓存首地址的指针； Width : 图像缓存的宽度； Height: 图像缓存的高度； Rotate：图像的翻转的角度 Color ：图像的初始颜色；
- 选择图像缓存:选择图像缓存，选择的目的是你可以创建多个图像属性，图像缓存可以存在多个，你可以选择你所创建的每一张图像
void Paint_SelectImage(UBYTE *image) 参数： image: 图像缓存的名称，实际上是一个指向图像缓存首地址的指针；
- 图像旋转:设置选择好的图像的旋转角度，最好使用在Paint_SelectImage()后，可以选择旋转0、90、180、270
void Paint_SetRotate(UWORD Rotate) 参数： Rotate: 图像选择角度，可以选择ROTATE_0、ROTATE_90、ROTATE_180、ROTATE_270分别对应0、90、180、270度
- 【说明】不同选择角度下，坐标对应起始像素点不同，这里以1.14为例，四张图，按顺序为0°， 90°， 180°， 270°。仅做为参考
- 图像镜像翻转:设置选择好的图像的镜像翻转，可以选择不镜像、关于水平镜像、关于垂直镜像、关于图像中心镜像。
void Paint_SetMirroring(UBYTE mirror) 参数： mirror: 图像的镜像方式，可以选择MIRROR_NONE、MIRROR_HORIZONTAL、MIRROR_VERTICAL、MIRROR_ORIGIN分别对应不镜像、关于水平镜像、关于垂直镜像、关于图像中心镜像
- 设置点在缓存中显示位置和颜色：这里是GUI最核心的一个函数、处理点在缓存中显示位置和颜色；
void Paint_SetPixel(UWORD Xpoint, UWORD Ypoint, UWORD Color) 参数： Xpoint: 点在图像缓存中X位置 Ypoint: 点在图像缓存中Y位置 Color : 点显示的颜色
- 图像缓存填充颜色:把图像缓存填充为某颜色，一般作为屏幕刷白的作用
void Paint_Clear(UWORD Color) 参数： Color: 填充的颜色
- 图像缓存部分窗口填充颜色：把图像缓存的某部分窗口填充为某颜色，一般作为窗口刷白的作用，常用于时间的显示，刷白上一秒
void Paint_ClearWindows(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UWORD Color) 参数： Xstart: 窗口的X起点坐标 Ystart: 窗口的Y起点坐标 Xend: 窗口的X终点坐标 Yend: 窗口的Y终点坐标 Color: 填充的颜色
- 画点:在图像缓存中，在（Xpoint, Ypoint）上画点，可以选择颜色，点的大小，点的风格
void Paint_DrawPoint(UWORD Xpoint, UWORD Ypoint, UWORD Color, DOT_PIXEL Dot_Pixel, DOT_STYLE Dot_Style)
参数：
Xpoint: 点的X坐标
Ypoint: 点的Y坐标
Color: 填充的颜色
Dot_Pixel: 点的大小，提供默认的8种大小点
typedef enum {
DOT_PIXEL_1X1 = 1, // 1 x 1
DOT_PIXEL_2X2 , // 2 X 2
DOT_PIXEL_3X3 , // 3 X 3
DOT_PIXEL_4X4 , // 4 X 4
DOT_PIXEL_5X5 , // 5 X 5
DOT_PIXEL_6X6 , // 6 X 6
DOT_PIXEL_7X7 , // 7 X 7
DOT_PIXEL_8X8 , // 8 X 8
} DOT_PIXEL;
Dot_Style: 点的风格,大小扩充方式是以点为中心扩大还是以点为左下角往右上扩大
typedef enum {
DOT_FILL_AROUND = 1,
DOT_FILL_RIGHTUP,
} DOT_STYLE;
- 画线：在图像缓存中，从 (Xstart, Ystart) 到 (Xend, Yend) 画线，可以选择颜色，线的宽度，线的风格
void Paint_DrawLine(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UWORD Color, LINE_STYLE Line_Style , LINE_STYLE Line_Style)
参数：
Xstart: 线的X起点坐标
Ystart: 线的Y起点坐标
Xend: 线的X终点坐标
Yend: 线的Y终点坐标
Color: 填充的颜色
Line_width: 线的宽度，提供默认的8种宽度
typedef enum {
DOT_PIXEL_1X1 = 1, // 1 x 1
DOT_PIXEL_2X2 , // 2 X 2
DOT_PIXEL_3X3 , // 3 X 3
DOT_PIXEL_4X4 , // 4 X 4
DOT_PIXEL_5X5 , // 5 X 5
DOT_PIXEL_6X6 , // 6 X 6
DOT_PIXEL_7X7 , // 7 X 7
DOT_PIXEL_8X8 , // 8 X 8
} DOT_PIXEL;
Line_Style: 线的风格,选择线是以直线连接还是以虚线的方式连接
typedef enum {
LINE_STYLE_SOLID = 0,
LINE_STYLE_DOTTED,
} LINE_STYLE;
- 画矩形:在图像缓存中，从 (Xstart, Ystart) 到 (Xend, Yend) 画一个矩形，可以选择颜色，线的宽度，是否填充矩形内部
void Paint_DrawRectangle(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UWORD Color, DOT_PIXEL Line_width, DRAW_FILL Draw_Fill)
参数：
Xstart: 矩形的X起点坐标
Ystart: 矩形的Y起点坐标
Xend: 矩形的X终点坐标
Yend: 矩形的Y终点坐标
Color: 填充的颜色
Line_width: 矩形四边的宽度，提供默认的8种宽度
typedef enum {
DOT_PIXEL_1X1 = 1, // 1 x 1
DOT_PIXEL_2X2 , // 2 X 2
DOT_PIXEL_3X3 , // 3 X 3
DOT_PIXEL_4X4 , // 4 X 4
DOT_PIXEL_5X5 , // 5 X 5
DOT_PIXEL_6X6 , // 6 X 6
DOT_PIXEL_7X7 , // 7 X 7
DOT_PIXEL_8X8 , // 8 X 8
} DOT_PIXEL;
Draw_Fill: 填充,是否填充矩形的内部
typedef enum {
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
} DRAW_FILL;
- 画圆:在图像缓存中，以 (X_Center Y_Center) 为圆心，画一个半径为Radius的圆，可以选择颜色，线的宽度，是否填充圆内部
void Paint_DrawCircle(UWORD X_Center, UWORD Y_Center, UWORD Radius, UWORD Color, DOT_PIXEL Line_width, DRAW_FILL Draw_Fill)
参数：
X_Center: 圆心的X坐标
Y_Center: 圆心的Y坐标
Radius：圆的半径
Color: 填充的颜色
Line_width: 圆弧的宽度，提供默认的8种宽度
typedef enum {
DOT_PIXEL_1X1 = 1, // 1 x 1
DOT_PIXEL_2X2 , // 2 X 2
DOT_PIXEL_3X3 , // 3 X 3
DOT_PIXEL_4X4 , // 4 X 4
DOT_PIXEL_5X5 , // 5 X 5
DOT_PIXEL_6X6 , // 6 X 6
DOT_PIXEL_7X7 , // 7 X 7
DOT_PIXEL_8X8 , // 8 X 8
} DOT_PIXEL;
Draw_Fill: 填充,是否填充圆的内部
typedef enum {
DRAW_FILL_EMPTY = 0,
DRAW_FILL_FULL,
} DRAW_FILL;
- 写Ascii字符:在图像缓存中，在 (Xstart Ystart) 为左顶点，写一个Ascii字符，可以选择Ascii码可视字符字库、字体前景色、字体背景色
void Paint_DrawChar(UWORD Xstart, UWORD Ystart, const char Ascii_Char, sFONT* Font, UWORD Color_Foreground, UWORD Color_Background) 参数： Xstart: 字符的左顶点X坐标 Ystart: 字体的左顶点Y坐标 Ascii_Char：Ascii字符 Font: Ascii码可视字符字库，在Fonts文件夹中提供了以下字体： font8：5*8的字体 font12：7*12的字体 font16：11*16的字体 font20：14*20的字体 font24：17*24的字体 Color_Foreground: 字体颜色 Color_Background: 背景颜色
- 写英文字符串:在图像缓存中，在 (Xstart Ystart) 为左顶点，写一串英文字符，可以选择Ascii码可视字符字库、字体前景色、字体背景色
void Paint_DrawString_EN(UWORD Xstart, UWORD Ystart, const char * pString, sFONT* Font, UWORD Color_Foreground, UWORD Color_Background) 参数： Xstart: 字符的左顶点X坐标 Ystart: 字体的左顶点Y坐标 pString：字符串，字符串是一个指针 Font: Ascii码可视字符字库，在Fonts文件夹中提供了以下字体： font8：5*8的字体 font12：7*12的字体 font16：11*16的字体 font20：14*20的字体 font24：17*24的字体 Color_Foreground: 字体颜色 Color_Background: 背景颜色
- 写中文字符串：在图像缓存中，在 (Xstart Ystart) 为左顶点，写一串中文字符，可以选择GB2312编码字符字库、字体前景色、字体背景色；
void Paint_DrawString_CN(UWORD Xstart, UWORD Ystart, const char * pString, cFONT* font, UWORD Color_Foreground, UWORD Color_Background) 参数： Xstart: 字符的左顶点X坐标 Ystart: 字体的左顶点Y坐标 pString：字符串，字符串是一个指针 Font: GB2312编码字符字库，在Fonts文件夹中提供了以下字体： font12CN：ascii字符字体11*21，中文字体16*21 font24CN：ascii字符字体24*41，中文字体32*41 Color_Foreground: 字体颜色 Color_Background: 背景颜色
- 写数字:在图像缓存中，在 (Xstart Ystart) 为左顶点，写一串数字，可以选择Ascii码可视字符字库、字体前景色、字体背景色
void Paint_DrawNum(UWORD Xpoint, UWORD Ypoint, int32_t Nummber, sFONT* Font, UWORD Color_Foreground, UWORD Color_Background) 参数： Xstart: 字符的左顶点X坐标 Ystart: 字体的左顶点Y坐标 Nummber：显示的数字，这里使用的是32位长的int型保存，可以最大显示到2147483647 Font: Ascii码可视字符字库，在Fonts文件夹中提供了以下字体： font8：5*8的字体 font12：7*12的字体 font16：11*16的字体 font20：14*20的字体 font24：17*24的字体 Color_Foreground: 字体颜色 Color_Background: 背景颜色
- 写带小数的数字:在图像缓存中，在 (Xstart Ystart) 为左顶点，写一串数字可以带小数的数字，可以选择Ascii码可视字符字库、字体前景色、字体背景色
void Paint_DrawFloatNum(UWORD Xpoint, UWORD Ypoint, double Nummber, UBYTE Decimal_Point, sFONT* Font, UWORD Color_Foreground, UWORD Color_Background);
参数：
Xstart: 字符的左顶点X坐标
Ystart: 字体的左顶点Y坐标
Nummber：显示的数字，这里使用的是double型保存，足够普通需求
Decimal_Point：显示小数点后几位数字
Font: Ascii码可视字符字库，在Fonts文件夹中提供了以下字体：
font8：5*8的字体
font12：7*12的字体
font16：11*16的字体
font20：14*20的字体
font24：17*24的字体
Color_Foreground: 字体颜色
Color_Background: 背景颜色
- 显示时间:在图像缓存中，在 (Xstart Ystart) 为左顶点，显示一段时间，可以选择Ascii码可视字符字库、字体前景色、字体背景色；
void Paint_DrawTime(UWORD Xstart, UWORD Ystart, PAINT_TIME *pTime, sFONT* Font, UWORD Color_Background, UWORD Color_Foreground) 参数： Xstart: 字符的左顶点X坐标 Ystart: 字体的左顶点Y坐标 pTime：显示的时间，这里定义好了一个时间的结构体，只要把时分秒各位数传给参数； Font: Ascii码可视字符字库，在Fonts文件夹中提供了以下字体： font8：5*8的字体 font12：7*12的字体 font16：11*16的字体 font20：14*20的字体 font24：17*24的字体 Color_Foreground: 字体颜色 Color_Background: 背景颜色
- 读取本地的bmp图片并写到缓存中
对于Raspberry Pi这些Linux操作系统的，可以读写图片
对于Raspberry Pi，在目录：RaspberryPi\c\lib\GUI\GUI_BMPfile.c(.h)
UBYTE GUI_ReadBmp(const char *path, UWORD Xstart, UWORD Ystart) 参数： path：BMP图片的相对路径 Xstart: 图片的左顶点X坐标，一般默认传0 Ystart: 图片的左顶点Y坐标，一般默认传0
Python(适用于Raspberry Pi)
适用于python和python3
对于python而言他的调用没有C复杂
lcdconfig.py
- 模块初始化与退出的处理：
def module_init() def module_exit() 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理。 2.module_init()函数会在液晶屏的init()初始化程序自动调用，但module_exit()需要自行调用
- GPIO读写：
def digital_write(pin, value) def digital_read(pin)
- SPI写数据
def spi_writebyte(data)
关于旋转设置
如果在python程序中你需要设置屏幕旋转，可以通过语句im_r= image1.rotate(270)设置。
im_r= image1.rotate(270)
- 旋转效果，以1.14为例， 按顺序分别为0°， 90°，180°， 270°
画图GUI
由于python有一个image库pil官方库链接，他十分的强大，不需要像C从逻辑层出发编写代码，可以直接引用image库进行图像处理，以下将以1.54inch LCD为例，对程序中使用了的进行简要说明
- 需要使用image库，需要安装库
sudo apt-get install python3-pil 安装库
然后导入库
from PIL import Image,ImageDraw,ImageFont
其中Image为基本库、ImageDraw为画图功能、ImageFont为文字
- 定义一个图像缓存，以方便在图片上进行画图、写字等功能
image1 = Image.new("RGB", (disp.width, disp.height), "WHITE")
第一个参数定义图片的颜色深度，定义为"RGB"说明是RGB888彩色图，第二个参数是一个元组，定义好图片的宽度和高度，第三个参数是定义缓存的默认颜色，定义为“WHITE”。
- 创建一个基于image1的画图对象，所有的画图操作都在这个对象上
draw = ImageDraw.Draw(image1)
- 画线
draw.line([(20, 10),(70, 60)], fill = "RED",width = 1)
第一个参数为一个4个元素的元组，以（20，10）为起始点，（70，60）为终止点，画一条直线，fill="RED"表示线为红色，width=1表示线宽为1个像素。
- 画框
draw.rectangle([(20,10),(70,60)],fill = "WHITE",outline="BLUE")
第一个参数为一个4个元素的元组，（20，10）矩形左上角坐标值，（70，60）为矩形右下角坐标值，fill= "WHITE"表示内部填充黑色，outline="BLUE"表示外边框为蓝色。
- 画圆
draw.arc((150,15,190,55),0, 360, fill =(0,255,0))
在正方形内画一个内切圆，第一个参数为一个4个元素的元组，以（150，15）为正方形的左上角顶点，（190，55）为正方形右下角顶点，规定矩形框的水平中位线为0度角，角度顺时针变大，第二个参数表示开始角度，第三个参数标识结束角度，fill =(0,255,0)表示线为绿色
如果不是正方形，画出来的就是椭圆，这个实际上是圆弧的绘制。
除了arc可以画圆之外，还有ellipse可以画实心圆
draw.ellipse((150,65,190,105), fill = (0,255,0))
实质是椭圆的绘制，第一个参数指定弦的圆外切矩形，fill =(0,255,0)表示内部填充颜色为绿色，如果椭圆的外切矩阵为正方形，椭圆就是圆了。
- 写字符
写字符往往需要写不同大小的字符，需要导入ImageFont模块，并实例化：
Font1 = ImageFont.truetype("../Font/Font01.ttf",25)
Font2 = ImageFont.truetype("../Font/Font01.ttf",35)
Font3 = ImageFont.truetype("../Font/Font02.ttf",32)
为了有比较好的视觉体验，这里使用的是来自网络的免费字体，如果是其他的ttf结尾的字库文件也是支持的。
注：每字库包含的字符均有不同；如果某些字符不能显示，建议根据字库使用的编码集来使用
写英文字符直接使用即可，写中文，由于编码是GB2312所以需要在前面加个u：
draw.text((40, 50), 'WaveShare', fill = (128,255,128),font=Font2) text= u"微雪电子" draw.text((74, 150),text, fill = "WHITE",font=Font3)
第一个参数为一个2个元素的元组，以（40，50）为左顶点，字体为Font2，fill为字体颜色，你可以直接让 fill = "WHITE"，因为常规的颜色的值已经定义好了，当然你也可以使用fill = (128,255,128)，括号里对应的是RGB三种颜色的值，这样你就能精确的控制你想要的颜色。第二句显示微雪电子，使用Font3，字体颜色为白色。
- 读取本地图片
image = Image.open('../pic/LCD_1inch28.jpg')
参数为图片路径。
- 其他功能
python的image库十分强大，如果需要实现其他的更多功能，可以上官网学习https://pillow.readthedocs.io/en/stable/，官方的网站是英文的，如果感觉对你不友好，当然我们国内也有很多的优秀的博客都有讲解。
FBCP移植
如果使用FBCP移植，则不能运行2inch屏幕的示例程序，SPI会被占用！
对于Bullseye系统的配置方法
下载运行驱动
打开树莓派终端，执行：
sudo apt-get install unzip -y sudo apt-get install cmake -y sudo wget https://www.waveshare.net/w/upload/6/6b/OLED_LCD_HAT_A.zip sudo unzip ./OLED_LCD_HAT_A.zip sudo cp OLED_LCD_HAT_A.dtbo /boot/overlays/ sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip sudo unzip ./Rpi-fbcp.zip cd rpi-fbcp/ sudo mkdir build cd build sudo cmake .. sudo make -j8 sudo install fbcp /usr/local/bin/fbcp sudo ./fbcp
编辑config.txt文件
sudo nano /boot/config.txt
屏蔽下图对应的语句
在config.txt最后加入以下代码
dtparam=spi=on dtoverlay=OLED_LCD_HAT_A hdmi_force_hotplug=1 max_usb_current=1 hdmi_group=2 hdmi_mode=1 hdmi_mode=87 hdmi_cvt 640 480 60 6 0 0 0 hdmi_drive=2 display_rotate=0
设置开机自启动
sudo cp ~/rpi-fbcp/build/fbcp /usr/local/bin/fbcp sudo nano /etc/rc.local
在 exit 0 前面添加 fbcp&。注意一定要添加"&" 后台运行，否则可能会出现系统不能启动的情况。
随后需要进行重启
sudo reboot
重启后即可正常显示
对于Bookworm系统的配置方法
必须是基于bookworm-lite版本操作，64位 lite、32位 lite
下载必要的软件
- 更新系统
sudo apt update && sudo apt upgrade && sudo apt full-upgrade -y
- 安装xorg服务
sudo apt-get install --no-install-recommends xserver-xorg -y sudo apt-get install --no-install-recommends xinit -y
- 安装桌面管理器
sudo apt install lightdm -y
- 安装树莓派官方GUI
sudo apt install raspberrypi-ui-mods -y
- 安装浏览器(可选)
sudo apt install chromium-browser -y
下载运行驱动
打开树莓派终端，执行：
sudo apt-get install unzip -y sudo apt-get install cmake -y sudo wget https://www.waveshare.net/w/upload/6/6b/OLED_LCD_HAT_A.zip sudo unzip ./OLED_LCD_HAT_A.zip sudo cp OLED_LCD_HAT_A.dtbo /boot/overlays/ sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip sudo unzip ./Rpi-fbcp.zip cd rpi-fbcp/ sudo rm -rf build sudo mkdir build cd build sudo cmake .. sudo make sudo install fbcp /usr/local/bin/fbcp
编辑config.txt文件
sudo nano /boot/firmware/config.txt
屏蔽下图对应的语句
在config.txt最后加入以下代码
dtparam=spi=on dtoverlay=OLED_LCD_HAT_A:rotate=90 hdmi_force_hotplug=1 max_usb_current=1 hdmi_group=2 hdmi_mode=87 hdmi_cvt 640 480 60 6 0 0 0 hdmi_drive=2 display_rotate=0
设置自启动startx与fbcp
- 打开.bash_profile文件，如果没有.bash_profile文件则自己创建一个
sudo nano ~/.bash_profile
把以下代码加到.bash_profile文件最下面
if [ "$(cat /proc/device-tree/model | cut -d ' ' -f 3)" = "5" ]; then
# rpi 5B configuration
export FRAMEBUFFER=/dev/fb1
startx 2> /tmp/xorg_errors
else
# Non-pi5 configuration
export FRAMEBUFFER=/dev/fb0
fbcp &
startx 2> /tmp/xorg_errors
fi
- 打开99-fbturbo.~文件，若已经存在此文件需要确认fb为fb0
sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.~
把以下代码加到99-fbturbo.~文件里面
Section "Device"
Identifier "Allwinner A10/A13 FBDEV"
Driver "fbturbo"
Option "fbdev" "/dev/fb0"
Option "SwapbuffersWait" "true"
EndSection
设置CLI自动登录
sudo raspi-config nonint do_boot_behaviour B2 sudo raspi-config nonint do_wayland W1 sudo reboot
重启后主屏幕即可正常显示。
Note1：确保树莓派的用户名为pi否则无法正常自动登录
Note2：设置上述所有配置后，系统每次重启期间都会变久一点，SSH也需要等待一会儿才能进入；
资料
文档
数据手册
程序
软件
FAQ
a) 检查打开了SPI；
如果运行wiringPi例程正常，再运行python或者BCM2835可能会屏幕无法正常刷新，因为bcm2835库是树莓派cpu芯片的库函数，底层是直接操作寄存器，而wiringPi库和python的底层都是通过读写linux系统的设备文件操作设备，可能导致GPIO口异常，重启树莓派可完美解决。
C语言控制可以使用函数Paint_SetRotate(Rotate)；但是在C语言中翻转的角度只能为0、90、180、270度；Python可以调用rotate(Rotate)来翻转任意角度。
对于有些树莓派系统可能并没有 image 这个库，运行：sudo apt-get install python-imaging 安装 python-imaging 库
售后
联系人：吴工
EMAIL：3005496359@qq.com
电话：0755-83043099
QQ：3005496359
微信：扫下方二维码添加
说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证