2.42inch-OLED-Module教程
资料
提供文档、程序、数据手册等全套资料
文档
程序
软件
数据手册
产品简介
本产品为2.42 英寸 OLED 模块，内置 SSD1309 驱动芯片，使用 SPI/I2C 接口通信，提供树莓派、Pico、Arduino、STM32、ESP32和Jetson Nano 等例程资料。 
产品参数
- 工作电压： 5V/3.3V
- 通信接口： SPI/I2C
- 控制芯片： SSD1309
- 分辨率： 128 × 64
- 显示尺寸： 55.01 × 27.49(mm)
- 像素大小： 0.4 × 0.4(mm)
- 主板尺寸： 61.5 × 39.5(mm)
- 显示颜色： 白色
功能引脚
| 功能引脚 | SPI模式 | I2C模式 |
| VCC | 3.3V / 5V 电源正 | |
| GND | 电源地 | |
| DIN | SPI数据输入 | I2C数据输入 |
| CLK | SPI时钟输入 | I2C时钟输入 |
| CS | 片选，低电平有效 | NC |
| DC | 数据/命令，低电平表示命令，高电平表示数据 | 地址选择 |
| RES | 复位，低电平有效 | |
硬件配置
OLED模块提供两种驱动接口：分别为4-wire SPI 和I2C接口，模块背面左下角有两个可选择焊接的电阻， 通过电阻的选择来选择相应的通信方式， 如图：
模块出厂默认使用4线SPI通信模式， 即电阻默认接在SPI位置 具体硬件配置，如下：
- 使用4线SPI：
- 即出厂程序设置：两个0R电阻连接SPI位置，DIN连接至主机MOSI，CLK连接至主机SCLK；
- 即出厂程序设置：两个0R电阻连接SPI位置，DIN连接至主机MOSI，CLK连接至主机SCLK；
- 使用I2C：
- 两个0R电阻连接I2C位置，DIN连接至主机SDA，CLK连接至主机SCL；
- I2C模式DC的高低状态可以切换设备地址，如果为低电平，那么I2C的7位地址为0x3C，为高电平则为0x3D。
- 两个0R电阻连接I2C位置，DIN连接至主机SDA，CLK连接至主机SCL；
PS：程序默认SPI模式，需要切换模式请修改 DEV_Config.h 详见程序说明-底层硬件接口-接口选择
通信协议
SPI协议
- 4线串行接口由串行时钟:SCLK、串行数据:SDIN、D/ c#、CS#组成。4线SPI模式下，D0为SCLK, D1为SDIN。对于未使用的数据引脚，D2应保持打开状态。从D3到D7的引脚，“E”和“R/W# (WR#)#”可以连接到外部接地。
- SDIN在SCLK的每个上升沿上按D7, D6，…的顺序被移位到一个8位移位寄存器中。D0。D/ c#在每8个时钟上采样，移位寄存器中的数据字节写入图形显示数据在同一时钟内的RAM (GDDRAM)或命令寄存器。
RPI使用教程
提供BCM2835、WiringPi、RPI（Python）库例程
硬件连接
连接树莓派的时候，选择用7PIN排线连接，请参考下方的引脚对应表格
| OLED | Raspberry Pi | |
| BCM2835编码 | Board物理引脚序号 | |
| VCC | 3.3V | 3.3V |
| GND | GND | GND |
| DIN | MOSI / SDA | 19 / 3 |
| CLK | SCLK / SCL | 23 / 5 |
| CS | CE0 | 24 |
| DC | 25 | 22 |
| RST | 27 | 13 |
- 四线SPI接线图
开启SPI和I2C接口
- 打开树莓派终端，输入以下指令进入配置界面
sudo raspi-config 选择Interfacing Options -> SPI -> Yes 开启SPI接口
sudo reboot
I2C同理，进入配置界面选择Interfaceing Options -> I2C -> Yes 开启IIC接口，然后重启
安装库
BCM2835
#打开树莓派终端，并运行以下指令 wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz tar zxvf bcm2835-1.71.tar.gz cd bcm2835-1.71/ sudo ./configure && sudo make && sudo make check && sudo make install # 更多的可以参考官网：http://www.airspayce.com/mikem/bcm2835/
wiringPi
#打开树莓派终端，并运行以下指令 cd sudo apt-get install wiringpi #对于树莓派2019年5月之后的系统（早于之前的可不用执行），可能需要进行升级： wget https://project-downloads.drogon.net/wiringpi-latest.deb sudo dpkg -i wiringpi-latest.deb gpio -v # 运行gpio -v会出现2.52版本，如果没有出现说明安装出错 #Bullseye分支系统使用如下命令： git clone https://github.com/WiringPi/WiringPi cd WiringPi ./build gpio -v # 运行gpio -v会出现2.70版本，如果没有出现说明安装出错
- 安装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 sudo apt-get install python-smbus #python3 sudo apt-get update sudo apt-get install python3-pip sudo apt-get install python3-pil sudo apt-get install python3-numpy sudo pip3 install RPi.GPIO sudo pip3 install spidev sudo apt-get install python3-smbus
下载测试程序
打开树莓派终端，执行：
sudo apt-get install p7zip-full sudo wget https://www.waveshare.net/w/upload/2/2c/OLED_Module_Code.7z 7z x OLED_Module_Code.7z -o./OLED_Module_Code cd OLED_Module_Code/RaspberryPi
运行测试程序
以下命令请在RaspberryPi目录下执行，否则索引不到目录；
C语言
- 重新编译，编译过程可能需要几秒
cd c sudo make clean sudo make -j 8
所有屏幕的测试程序，可以直接通过输入对应的尺寸进行调用：
sudo ./main 屏幕尺寸
根据不同OLED，应当输入以下某一条指令：
#0.91inch OLED Module sudo ./main 0.91 ------------------------------ #0.95inch RGB OLED (A)/(B) sudo ./main 0.95rgb ------------------------------ #0.96inch OLED (A)/(B) sudo ./main 0.96 ------------------------------ #0.96inch OLED Module (C)/(D)/(E) sudo ./main 0.96 ------------------------------ #0.96inch RGB OLED Module sudo ./main 0.96rgb ------------------------------ #1.27inch RGB OLED Module sudo ./main 1.27rgb ------------------------------ #1.3inch OLED (A)/(B) sudo ./main 1.3 ------------------------------ #1.3inch OLED Module (C) sudo ./main 1.3c ------------------------------ #1.32inch OLED Module sudo ./main 1.32 ------------------------------ #1.5inch OLED Module sudo ./main 1.5 ------------------------------ #1.5inch OLED Module (B) sudo ./main 1.5b ------------------------------ #1.5inch RGB OLED Module sudo ./main 1.5rgb ------------------------------ #1.51inch Transparent OLED sudo ./main 1.51 ------------------------------ #1.54inch OLED Module sudo ./main 1.54 ------------------------------ #2.42inch OLED Module sudo ./main 2.42
Python
- 进入python程序目录
cd python/example
- 运行对应型号OLED的例程，程序支持python2/3
假如你购买了1.3inch OLED Module （C），请输入：
# python2 sudo python OLED_1in3_c_test.py # python3 sudo python3 OLED_1in3_c_test.py
假如你购买了1.5inch RGB OLED Module ，请输入：
# python2 sudo python OLED_1in5_rgb_test.py # python3 sudo python3 OLED_1in5_rgb_test.py
- 型号指令对应表
#0.91inch OLED Module sudo python OLED_0in91_test.py ------------------------------------ #0.95inch RGB OLED (A)/(B) sudo python OLED_0in95_rgb_test.py ------------------------------------ #0.96inch OLED (A)/(B) sudo python OLED_0in96_test.py ------------------------------------ #0.96inch OLED Module (C)/(D)/(E) sudo python OLED_0in96_test.py ------------------------------------ #0.96inch RGB OLED Module sudo python OLED_0in96_rgb_test.py ------------------------------------ #1.27inch RGB OLED Module sudo python OLED_1in27_rgb_test.py ------------------------------------ #1.3inch OLED (A)/(B) sudo python OLED_1in3_test.py ------------------------------------ #1.3inch OLED Module (C) sudo python OLED_1in3_c_test.py ------------------------------------ #1.32inch OLED Module sudo python OLED_1in32_test.py ------------------------------------ #1.5inch OLED Module sudo python OLED_1in5_test.py ------------------------------------ #1.5inch OLED Module (B) sudo python OLED_1in5_b_test.py ------------------------------------ #1.5inch RGB OLED Module sudo python OLED_1in5_rgb_test.py ------------------------------------ #1.51inch Transparent OLED sudo python OLED_1in51_test.py ------------------------------------ #1.54inch OLED Module sudo python OLED_1in54_test.py ------------------------------------ #2.42inch OLED Module sudo python OLED_2in42_test.py
- 请确保SPI没有被其他的设备占用，你可以在/boot/config.txt中间检查
C语言部分
底层接口简析
C语言使用了3种方式进行驱动：分别是BCM2835库、WiringPi库和Dev库
默认使用Dev库进行操作，如果你需要使用BCM2835或者WiringPi来驱动的话，可以打开RaspberryPi\c\Makefile，修改13-15行，如下：
我们进行了底层的封装，由于硬件平台不一样，内部的实现是不一样的，如果需要了解内部实现可以去对应的目录中查看
在DEV_Config.c(.h)可以看到很多定义，在目录：RaspberryPi\c\lib\Config
- 接口选择：
#define USE_SPI_4W 1 #define USE_IIC 0 注意：切换SPI/I2C直接修改这里
- 数据类型：
#define UBYTE uint8_t #define UWORD uint16_t #define UDOUBLE uint32_t
- 模块初始化与退出的处理：
void DEV_Module_Init(void); void DEV_Module_Exit(void); 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理。
- 写GPIO
void DEV_Digital_Write(UWORD Pin, UBYTE Value)
参数：
UWORD Pin：GPIO引脚号
UBYTE Value：要输出的电平，0或1
- 读GPIO
UBYTE DEV_Digital_Read(UWORD Pin)
参数：
UWORD Pin：GPIO引脚号
返回值：
GPIO的的电平，0或1
- GPIO模式设置
void DEV_GPIO_Mode(UWORD Pin, UWORD Mode)
参数：
UWORD Pin：GPIO引脚号
UWORD Mode：模式，0：输入，1：输出
GUI简析
对于屏幕而言，如果需要进行画图、显示中英文字符、显示图片等怎么办，这些都是上层应用做的。这有很多小伙伴有问到一些图形的处理，我们这里提供了一些基本的功能 在目录：RaspberryPi\c\lib\GUI\GUI_Paint.c(.h)中可以找到GUI
在目录：RaspberryPi\c\lib\Fonts下是GUI依赖的字符字体，
- 新建图像属性:新建一个图像属性，这个属性包括图像缓存的名称、宽度、高度、翻转角度、颜色
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度
- 设置像素点的尺寸
void Paint_SetScale(UBYTE scale) 参数： scale: 像素点的尺寸，2：每个像素点占一位；4：每个像素点占两位
- 图像镜像翻转:设置选择好的图像的镜像翻转，可以选择不镜像、关于水平镜像、关于垂直镜像、关于图像中心镜像。
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, double Nummber, sFONT* Font, UWORD Digit, UWORD Color_Foreground, UWORD Color_Background)
参数：
Xpoint: 字符的左顶点X坐标
Ypoint: 字体的左顶点Y坐标
Nummber：显示的数字，可以是小数
Digit：小数位数，不足补零
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: 背景颜色
Python(适用于Raspberry Pi)
适用于python和python3
对于python而言他的调用没有C复杂
config.py
- 接口选择
Device_SPI = 1 Device_I2C = 0 注意：切换SPI/I2C修改这里
- 模块初始化与退出的处理：
def module_init() def module_exit() 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理。 2.module_init()函数会在液晶屏的init()初始化程序自动调用，但module_exit()需要自行调用
- SPI写数据
def spi_writebyte(data)
- IIC写数据
i2c_writebyte(reg, value):
main.py
主函数,如果你的python版本是python2，在linux命令模式下重新执行如下：
sudo python main.py
如果你的python版本是python3，在linux命令模式下重新执行如下：
sudo python3 main.py
画图GUI
由于python有一个image库pil官方库链接，他十分的强大，不需要像C从逻辑层出发编写代码，可以直接引用image库进行图像处理，以下将以1.54inch OLED为例，对程序中使用了的进行简要说明
- 需要使用image库，需要安装库
sudo apt-get install python3-pil 安装库
然后导入库
from PIL import Image,ImageDraw,ImageFont
其中Image为基本库、ImageDraw为画图功能、ImageFont为文字
- 定义一个图像缓存，以方便在图片上进行画图、写字等功能
image1 = Image.new("1", (disp.width, disp.height), "WHITE")
第一个参数定义图片的颜色深度，定义为"1"说明是一位深度的位图，第二个参数是一个元组，定义好图片的宽度和高度，第三个参数是定义缓存的默认颜色，定义为“WHITE”。
- 创建一个基于image1的画图对象，所有的画图操作都在这个对象上
draw = ImageDraw.Draw(image1)
- 画线
draw.line([(0,0),(127,0)], fill = 0)
第一个参数为一个4个元素的元组，以（0，0）为起始点，（127，0）为终止点，画一条直线，fill="0"表示线为白色。
- 画框
draw.rectangle([(20,10),(70,60)],fill = "WHITE",outline="BLACK")
第一个参数为一个4个元素的元组，（20，10）矩形左上角坐标值，（70，60）为矩形右下角坐标值，fill= "WHITE"表示内部填充黑色，outline="BLACK"表示外边框为黑色。
- 画圆
draw.arc((150,15,190,55),0, 360, fill =(0,255,0))
在正方形内画一个内切圆，第一个参数为一个4个元素的元组，以（150，15）为正方形的左上角顶点，（190，55）为正方形右下角顶点，规定矩形框的水平中位线为0度角，角度顺时针变大，第二个参数表示开始角度，第三个参数标识结束角度，fill = 0表示线为白色
如果不是正方形，画出来的就是椭圆，这个实际上是圆弧的绘制。
除了arc可以话圆之外，还有ellipse可以画实心圆
draw.ellipse((150,65,190,105), fill = 0)
实质是椭圆的绘制，第一个参数指定弦的圆外切矩形，fill = 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((5, 68), 'Hello world', fill = 0, font=Font1) text= u"微雪电子" draw.text((5, 200), text, fill = 0, font=Font3)
第一个参数为一个2个元素的元组，以（5，68）为左顶点，字体为font1，点，fill为字体颜色， fill = 0，所以会显示字体颜色为白色，第二句显示微雪电子，字体颜色为白色。
- 读取本地图片
image = Image.open('../pic/pic.bmp')
参数为图片路径。
- 其他功能
python的image库十分强大，如果需要实现其他的更多功能，可以上官网学习http://effbot.org/imagingbook pil，官方的是英文的，如果感觉对你不友好，当然我们国内也有很多的优秀的博客都有讲解。
STM32使用教程
提供基于STM32F103RBT6的例程
硬件连接
我们提供的例程是基于STM32F103RBT6的，提供的连接方式也是对应的STM32F103RBT6的引脚，如果需要移植程序，请按实际引脚连接
| OLED | STM32 |
| VCC | 3.3V |
| GND | GND |
| DIN | SPI:PA7 / I2C:PB9 / I2C_SOFT：PC8 |
| CLK | SPI:PA5 / I2C:PB8 / I2C_SOFT：PC6 |
| CS | PB6 |
| DC | PA8 |
| RST | PA9 |
- 四线SPI接线图
运行程序
- 下载程序，找到 STM32 程序文件目录，使用 Keil5 打开 \STM32\STM32-F103RBT6\MDK-ARM 目录下的 oled_demo.uvprojx
- 然后根据购买的屏幕型号修改 main.c 中对应的函数注释，最后重新编译下载即可。
- 假如您购买了 1.3inch OLED Module （C）就将105行的注释取消掉（注：不能同时存在多条语句没注释；行号可能有改动，请根据实际情况修改）
- 型号指令对应表
| 屏幕型号 | 例程函数 |
|---|---|
| 0.91inch OLED Module | OLED_0in91_test(); |
| 0.95inch RGB OLED (A)/(B) | OLED_0in95_rgb_test(); |
| 0.96inch OLED (A)/(B) | OLED_0in96_test(); |
| 0.96inch OLED Module (C)/(D)/(E) | OLED_0in96_test(); |
| 0.96inch RGB OLED Module | OLED_0in96_rgb_test(); |
| 1.27inch RGB OLED Module | OLED_1in27_rgb_test(); |
| 1.3inch OLED (A)/(B) | OLED_1in3_test(); |
| 1.3inch OLED Module (C) | OLED_1in3_c_test(); |
| 1.32inch OLED Module | OLED_1in32_test(); |
| 1.5inch OLED Module | OLED_1in5_test(); |
| 1.5inch OLED Module（B） | OLED_1in5_b_test(); |
| 1.5inch RGB OLED Module | OLED_1in5_rgb_test(); |
| 1.54inch OLED Module | OLED_1in54_test(); |
| 2.42inch OLED Module | OLED_2in42_test(); |
软件说明
例程是基于HAL库进行开发的。 下载程序，找到STM32程序文件目录，打开STM32\STM32F103RBT6\MDK-ARM目录下的oled_demo.uvprojx，即可看到程序。
另外，在STM32\STM32-F103RBT6\User\目录下可以看到工程的文件目录，五个文件夹依次为底层驱动、示例程序、字库、GUI、OLED驱动
程序说明
底层硬件接口
我们进行了底层的封装，由于硬件平台不一样，内部的实现是不一样的，如果需要了解内部实现可以去对应的目录中查看 在DEV_Config.c(.h)可以看到很多定义
- 接口选择：
#define USE_SPI_4W 1 #define USE_IIC 0 #define USE_IIC_SOFT 0 注意：切换SPI/I2C直接修改这里
- 数据类型：
#define UBYTE uint8_t #define UWORD uint16_t #define UDOUBLE uint32_t
- 模块初始化与退出的处理：
UBYTE System_Init(void); void System_Exit(void); 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理； 2.System_Exit(void)函数使用后，会关闭OLED显示屏；
- GPIO读写：
void DEV_Digital_Write(UWORD Pin, UBYTE Value); UBYTE DEV_Digital_Read(UWORD Pin);
- SPI写数据:
UBYTE SPI4W_Write_Byte(uint8_t value);
- IIC写数据:
void I2C_Write_Byte(uint8_t value, uint8_t Cmd);
上层应用
对于屏幕而言，如果需要进行画图、显示中英文字符、显示图片等怎么办，这些都是上层应用做的。这有很多小伙伴有问到一些图形的处理，我们这里提供了一些基本的功能
在目录：STM32\STM32F103RB\User\GUI\GUI_Paint.c(.h)中可以找到GUI
在目录STM32\STM32F103RB\User\Fonts下是GUI依赖的字符字体
- 新建图像属性:新建一个图像属性，这个属性包括图像缓存的名称、宽度、高度、翻转角度、颜色
void Paint_NewImage(UWORD Width, UWORD Height, UWORD Rotate, UWORD Color); 参数： Width ：图像缓存的宽度； Height：图像缓存的高度； Rotate：图像的翻转的角度 Color ：图像的初始颜色；
- 设置清屏函数，通常直接调用OLED的clear函数；
void Paint_SetClearFuntion(void (*Clear)(UWORD)); 参数： Clear: 指向清屏函数的指针，用于快速将屏幕清空变成某颜色；
- 设置画像素点函数；
void Paint_SetDisplayFuntion(void (*Display)(UWORD,UWORD,UWORD)); 参数： Display: 指向画像素点函数的指针，用于向OLED内部RAM指定位置写入数据；
- 选择图像缓存:选择图像缓存，选择的目的是你可以创建多个图像属性，图像缓存可以存在多个，你可以选择你所创建的每一张图像
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度
- 图像镜像翻转:设置选择好的图像的镜像翻转，可以选择不镜像、关于水平镜像、关于垂直镜像、关于图像中心镜像。
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, double Nummber, sFONT* Font, UWORD Digit, UWORD Color_Foreground, UWORD Color_Background)
参数：
Xpoint: 字符的左顶点X坐标
Ypoint: 字体的左顶点Y坐标
Nummber：显示的数字，可以是小数
Digit：小数位数，不足补零
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: 背景颜色
Arduino使用教程
提供基于UNO PLUS的例程
硬件连接
我们提供的例程是基于UNO PLUS的，提供的连接方式也是对应的UNO PLUS的引脚，如果需要移植程序，请按实际引脚连接
| OLED | UNO |
| VCC | 3.3V/5V |
| GND | GND |
| DIN | SPI:D11 / I2C:SDA |
| CLK | SPI:D13 / I2C:SCL |
| CS | D10 |
| DC | D7 |
| RST | D8 |
四线SPI接线图:
IDE 安装
运行程序
- 下载程序，打开Arduino程序文件目录，即可看到不同型号OLED的Arduino程序，具体对应关系可以看下方‘型号程序对应表’
- 根据你购买的尺寸和类型选择打开的文件夹，并打开 xxx.ino 文件，我们以1.3inch OLED Module （C）为例：打开OLED_1in3_c，然后双击 OLED_1in3_c.ino 打开Arduino的工程。
- 型号程序对应表
| 屏幕型号 | 程序文件夹 |
|---|---|
| 0.91inch OLED Module | OLED_0in91 |
| 0.95inch RGB OLED (A)/(B) | OLED_0in95_rgb |
| 0.96inch OLED (A)/(B) | OLED_0in96 |
| 0.96inch OLED Module (C)/(D)/(E) | OLED_0in96 |
| 0.96inch RGB OLED Module | OLED_0in96_rgb |
| 1.27inch RGB OLED Module | OLED_1in27_rgb |
| 1.3inch OLED (A)/(B) | OLED_1in3 |
| 1.3inch OLED Module (C) | OLED_1in3_c |
| 1.32inch OLED Module | OLED_1in32 |
| 1.5inch OLED Module | OLED_1in5 |
| 1.5inch OLED Module（B） | OLED_1in5_B |
| 1.5inch RGB OLED Module | OLED_1in5_rgb |
| 1.51inch Transparent OLED | OLED_1in51 |
| 1.54inch OLED Module | OLED_1in54 |
| 2.42inch OLED Module | OLED_2in42 |
程序说明
底层硬件接口
我们进行了底层的封装，由于硬件平台不一样，内部的实现是不一样的，如果需要了解内部实现可以去对应的目录中查看 在DEV_Config.c(.h)可以看到很多定义
- 接口选择：
#define USE_SPI_4W 1 #define USE_IIC 0 注意：切换SPI/I2C直接修改这里
- 数据类型：
#define UBYTE uint8_t #define UWORD uint16_t #define UDOUBLE uint32_t
- 模块初始化与退出的处理：
UBYTE System_Init(void); void System_Exit(void); 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理； 2.System_Exit函数使用后，会关闭OLED显示屏；
- GPIO读写：
void DEV_Digital_Write(UWORD Pin, UBYTE Value); UBYTE DEV_Digital_Read(UWORD Pin);
- SPI写数据
UBYTE SPI4W_Write_Byte(uint8_t value);
- IIC写数据：
void I2C_Write_Byte(uint8_t value, uint8_t Cmd);
上层应用
对于屏幕而言，如果需要进行画图、显示中英文字符、显示图片等怎么办，这些都是上层应用做的。这有很多小伙伴有问到一些图形的处理，我们这里提供了一些基本的功能 在如下的目录中可以找到GUI和其自带的字库，在目录：Arduino\OLED_xxx\GUI_Paint.c(.h)
- 新建图像属性:新建一个图像属性，这个属性包括图像缓存的名称、宽度、高度、翻转角度、颜色
void Paint_NewImage(UWORD Width, UWORD Height, UWORD Rotate, UWORD Color); 参数： Width : 图像缓存的宽度； Height: 图像缓存的高度； Rotate：图像的翻转的角度 Color ：图像的初始颜色；
- 设置清屏函数，通常直接调用OLED的clear函数；
void Paint_SetClearFuntion(void (*Clear)(UWORD)); 参数： Clear : 指向清屏函数的指针，用于快速将屏幕清空变成某颜色；
- 设置画像素点函数；
void Paint_SetDisplayFuntion(void (*Display)(UWORD,UWORD,UWORD)); 参数： Display: 指向画像素点函数的指针，用于向OLED内部RAM指定位置写入数据；
- 选择图像缓存:选择图像缓存，选择的目的是你可以创建多个图像属性，图像缓存可以存在多个，你可以选择你所创建的每一张图像
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度
- 图像镜像翻转:设置选择好的图像的镜像翻转，可以选择不镜像、关于水平镜像、关于垂直镜像、关于图像中心镜像。
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, double Nummber, sFONT* Font, UWORD Digit, UWORD Color_Foreground, UWORD Color_Background)
参数：
Xpoint: 字符的左顶点X坐标
Ypoint: 字体的左顶点Y坐标
Nummber：显示的数字，可以是小数
Digit：小数位数，不足补零
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: 背景颜色
ESP32使用教程
提供基于ESP32的例程
硬件连接
我们提供的例程是基于ESP32-S3的，提供的连接方式也是对应的ESP32-S3的引脚，如果需要移植程序，请按实际引脚连接
| OLED | ESP32 |
| VCC | 3.3V/5V |
| GND | GND |
| DIN | SPI:IO11 / I2C:IO17 |
| CLK | SPI:IO12 / I2C:IO16 |
| CS | IO10 |
| DC | IO46 |
| RST | IO3 |
IDE安装
运行程序
- 下载程序，打开ESP32程序文件目录，即可看到1in54型号OLED的Arduino程序
- 根据你购买的尺寸和类型选择打开的文件夹，然后双击 OLED_1in54.ino 打开Arduino的工程。
程序说明
底层硬件接口
我们进行了底层的封装，由于硬件平台不一样，内部的实现是不一样的，如果需要了解内部实现可以去对应的目录中查看 在DEV_Config.c(.h)可以看到很多定义
- 接口选择：
#define USE_SPI_4W 1 #define USE_IIC 0 注意：切换SPI/I2C直接修改这里
- 数据类型：
#define UBYTE uint8_t #define UWORD uint16_t #define UDOUBLE uint32_t
- 模块初始化与退出的处理：
UBYTE System_Init(void); void System_Exit(void); 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理； 2.System_Exit函数使用后，会关闭OLED显示屏；
- GPIO读写：
void DEV_Digital_Write(UWORD Pin, UBYTE Value); UBYTE DEV_Digital_Read(UWORD Pin);
- SPI写数据
UBYTE SPI4W_Write_Byte(uint8_t value);
- IIC写数据：
void I2C_Write_Byte(uint8_t value, uint8_t Cmd);
上层应用
对于屏幕而言，如果需要进行画图、显示中英文字符、显示图片等怎么办，这些都是上层应用做的。这有很多小伙伴有问到一些图形的处理，我们这里提供了一些基本的功能 在如下的目录中可以找到GUI和其自带的字库，在目录：ESP32\OLED_xxx\GUI_Paint.c(.h)
- 新建图像属性:新建一个图像属性，这个属性包括图像缓存的名称、宽度、高度、翻转角度、颜色
void Paint_NewImage(UWORD Width, UWORD Height, UWORD Rotate, UWORD Color); 参数： Width ：图像缓存的宽度； Height：图像缓存的高度； Rotate：图像的翻转的角度； Color ：图像的初始颜色；
- 设置清屏函数，通常直接调用OLED的clear函数；
void Paint_SetClearFuntion(void (*Clear)(UWORD)); 参数： Clear : 指向清屏函数的指针，用于快速将屏幕清空变成某颜色；
- 设置画像素点函数；
void Paint_SetDisplayFuntion(void (*Display)(UWORD,UWORD,UWORD)); 参数： Display: 指向画像素点函数的指针，用于向OLED内部RAM指定位置写入数据；
- 选择图像缓存:选择图像缓存，选择的目的是你可以创建多个图像属性，图像缓存可以存在多个，你可以选择你所创建的每一张图像
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度
- 图像镜像翻转:设置选择好的图像的镜像翻转，可以选择不镜像、关于水平镜像、关于垂直镜像、关于图像中心镜像。
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, double Nummber, sFONT* Font, UWORD Digit, UWORD Color_Foreground, UWORD Color_Background)
参数：
Xpoint： 字符的左顶点X坐标
Ypoint： 字体的左顶点Y坐标
Nummber：显示的数字，可以是小数
Digit：小数位数，不足补零
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： 背景颜色
Pico使用教程
提供基于Pico的例程
硬件连接
我们提供的例程是基于Pico的，提供的连接方式也是对应的Pico的引脚，如果需要移植程序，请按实际引脚连接
| OLED | Pico |
| VCC | 3.3V/5V |
| GND | GND |
| DIN | SPI:GP11 / I2C:GP8 |
| CLK | SPI:GP10 / I2C:GP9 |
| CS | GP13 |
| DC | GP14 |
| RST | GP12 |
IDE安装
运行程序
1): 按住Pico板上的按键，将pico通过Micro USB线接到电脑的USB接口，然后松开按键。
接入之后，电脑会自动识别到一个可移动盘（RPI-RP2）
2): 将micropython目录中rp2-pico-20210418-v1.15.uf2 文件复制到识别的可移动盘（RPI-RP2）中
3): 更新Thonny IDE
sudo apt upgrade thonny
4): 打开Thonny IDE （点击树莓logo -> Programming -> Thonny Python IDE ）
选择Tools -> Options... -> Interpreter
选择MicroPython(Raspberry Pi Pico 和ttyACM0端口
5): 在Thonny IDE中打开Code\Pico\micropython\Pico-OLED-1.54(spi).py文件
然后运行当前脚本（绿色小三角）即可
程序说明
底层硬件接口
- SPI/I2C写指令
def write_cmd(self, cmd)
- SPI/I2C写数据
def write_data(self, buf)
- 显示初始化
def init_display(self)
- 显示像素点
def show(self)
Jetson Nano使用教程
硬件连接
连接Jetson Nano的时候，选择用7PIN排线连接，请参考下方的引脚对应表格
| OLED | Jetson Nano | |
| BCM编码 | Board物理引脚序号 | |
| VCC | 3.3V | 3.3V |
| GND | GND | GND |
| DIN | MOSI / SDA | 19 / 3 |
| CLK | SCLK / SCL | 23 / 5 |
| CS | CE0 | 24 |
| DC | 25 | 22 |
| RST | 27 | 13 |
- 四线SPI接线图
开启SPI和I2C接口
- 打开Jetson Nano终端，按照以下步骤打开SPI
I2C同理，打开Jetson Nano终端，按照以下步骤打开I2C
安装库
- 安装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 Jetson.GPIO sudo pip install spidev sudo apt-get install python-smbus #python3 sudo apt-get update sudo apt-get install python3-pip sudo apt-get install python3-pil sudo apt-get install python3-numpy sudo pip install Jetson.GPIO sudo pip3 install spidev sudo apt-get install python3-smbus
下载测试程序
打开Jetson Nano终端，执行：
sudo apt-get install p7zip-full sudo wget https://www.waveshare.net/w/upload/2/2c/OLED_Module_Code.7z 7z x OLED_Module_Code.7z -o./OLED_Module_Code cd OLED_Module_Code/RaspberryPi
运行测试程序
以下命令请在Jetson Nano目录下执行，否则索引不到目录；
Python
- 进入python程序目录
cd python/example
- 运行对应型号OLED的例程，程序支持python2/3
假如你购买了1.54inch OLED Module，请输入：
# python2 sudo python OLED_1in54_test.py # python3 sudo python3 OLED_1in54_test.py
- 型号指令对应表
#1.54inch OLED Module sudo python OLED_1in54_test.py ------------------------------------ #2.42inch OLED Module sudo python OLED_2in42_test.py
- 请确保SPI没有被其他的设备占用，你可以在/boot/config.txt中间检查
Python
适用于python和python3
config.py
- 接口选择
Device_SPI = 1 Device_I2C = 0 注意：切换SPI/I2C修改这里
- 模块初始化与退出的处理：
def module_init() def module_exit() 注意： 1.这里是处理使用液晶屏前与使用完之后一些GPIO的处理。 2.module_init()函数会在液晶屏的init()初始化程序自动调用，但module_exit()需要自行调用
- SPI写数据
def spi_writebyte(data)
- IIC写数据
i2c_writebyte(reg, value):
main.py
主函数,如果你的python版本是python2，在linux命令模式下重新执行如下：
sudo python main.py
如果你的python版本是python3，在linux命令模式下重新执行如下：
sudo python3 main.py
画图GUI
由于python有一个image库pil官方库链接，他十分的强大，不需要像C从逻辑层出发编写代码，可以直接引用image库进行图像处理，以下将以1.54inch OLED为例，对程序中使用了的进行简要说明
- 需要使用image库，需要安装库
sudo apt-get install python3-pil 安装库
然后导入库
from PIL import Image,ImageDraw,ImageFont
其中Image为基本库、ImageDraw为画图功能、ImageFont为文字
- 定义一个图像缓存，以方便在图片上进行画图、写字等功能
image1 = Image.new("1", (disp.width, disp.height), "WHITE")
第一个参数定义图片的颜色深度，定义为"1"说明是一位深度的位图，第二个参数是一个元组，定义好图片的宽度和高度，第三个参数是定义缓存的默认颜色，定义为“WHITE”。
- 创建一个基于image1的画图对象，所有的画图操作都在这个对象上
draw = ImageDraw.Draw(image1)
- 画线
draw.line([(0,0),(127,0)], fill = 0)
第一个参数为一个4个元素的元组，以（0，0）为起始点，（127，0）为终止点，画一条直线，fill="0"表示线为白色。
- 画框
draw.rectangle([(20,10),(70,60)],fill = "WHITE",outline="BLACK")
第一个参数为一个4个元素的元组，（20，10）矩形左上角坐标值，（70，60）为矩形右下角坐标值，fill= "WHITE"表示内部填充黑色，outline="BLACK"表示外边框为黑色。
- 画圆
draw.arc((150,15,190,55),0, 360, fill =(0,255,0))
在正方形内画一个内切圆，第一个参数为一个4个元素的元组，以（150，15）为正方形的左上角顶点，（190，55）为正方形右下角顶点，规定矩形框的水平中位线为0度角，角度顺时针变大，第二个参数表示开始角度，第三个参数标识结束角度，fill = 0表示线为白色
如果不是正方形，画出来的就是椭圆，这个实际上是圆弧的绘制。
除了arc可以话圆之外，还有ellipse可以画实心圆
draw.ellipse((150,65,190,105), fill = 0)
实质是椭圆的绘制，第一个参数指定弦的圆外切矩形，fill = 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((5, 68), 'Hello world', fill = 0, font=Font1) text= u"微雪电子" draw.text((5, 200), text, fill = 0, font=Font3)
第一个参数为一个2个元素的元组，以（5，68）为左顶点，字体为font1，点，fill为字体颜色， fill = 0，所以会显示字体颜色为白色，第二句显示微雪电子，字体颜色为白色。
- 读取本地图片
image = Image.open('../pic/pic.bmp')
参数为图片路径。
- 其他功能
python的image库十分强大，如果需要实现其他的更多功能，可以上官网学习http://effbot.org/imagingbook pil，官方的是英文的，如果感觉对你不友好，当然我们国内也有很多的优秀的博客都有讲解。
TAG：
宽电压
树莓派64MP摄像头
Raspberry Pi
树莓派2.15寸电子墨水屏(G) 红黄黑白 e-Paper 296×160 适用于Arduino/STM32
ESP32-S3-Nano开发板 兼容Arduino Nano ESP32搭载ESP32-S3R8
Luckfox Pico LVGL教程
e-paper驱动板
JETSON NANO MINI
树莓派5 802.3af
ESP32-S3
Arducam
Arducam
斑梨
树莓派5 8寸DSI MIPI显示屏LCD工业一体触摸平板电脑1280x800带摄像头
240x280
英伟达Jetson AGX Orin 32/64GB 开发板套件AI 275TOPS
树莓派红外摄像头
斑梨
树莓派5外壳
Google恐龙小游戏
TAG：
充电模块
树莓派5
Raspberry Pi 5
树莓派Zero外壳
英伟达NVIDIA Jetson Xavier NX AI 21TOPS人工智能开发板 RAM-8/16GB eMMC-16GB
ESP32-S3显示屏
红外热像仪
DC-DC 50A
机箱副屏
SpeedyBee F405 V4 60A 电调飞塔 F4飞控DJI FPV穿越机
刷机线
sipeed荔枝派M2dock人工智能 Linux V831 Python AI视觉AIoT开发板摄像头
wifi蓝牙
USB转RS232 485 FT232RNL
SpeedyBee BLS ESC35A V2 电调 飞控 DJI FPV穿越机无人机
树莓派5电源
串口通信激光雷达
树莓派5电源
树莓派5
树莓派