产品概述
提供树莓派、STM32、Arduino例程
产品特性
- 驱动芯片 : SSD1351
- 支持接口 : 4-wire SPI、3-wire SPI
- 分辨率 : 128 * 128
- 显示尺寸 : 1.5inch
- 显示颜色 : 65K彩色
- 工作电压 : 3.3V / 5V
管脚配置
| 功能引脚 |
描述
|
| VCC |
电源正
|
| GND |
电源地
|
| DIN |
数据输入
|
| CLK |
时钟输入
|
| CS |
片选
|
| DC |
数据/命令信号选择
|
| RST |
复位信号
|
硬件配置
- 本OLED模块提供两种通信方式：4-wire SPI和3wire-SPI，在模块的背面有一个可选择焊接的电阻，通过该电阻来选择通信方式。如下图：
模块出厂默认使用4线SPI通信，即BS0默认接0
注：下表为接口连接。
| 通信协议 |
BS |
CS |
DC |
DIN |
CLK
|
| 4Wire SPI |
0 |
片选 |
DC |
MOSI |
SCK
|
| 3Wire SPI |
1 |
片选 |
GND |
MOSI |
SCK
|
具体硬件配置，如下：
使用4线SPI:即出厂设置,BS接0连接到GND，DIN接控制引脚MOSI, CLK接控制引脚SCK;
使用3线SPI: BS接1连接到VCC，D/C需接地，DIN接控制引脚MOSI, CLK接控制引脚SCK;
工作原理
SSD1351是一款128RGB * 128 Dot Matrix OLED/PLED 控制器，其内部有一个128*128*18bit的SRAM作为显示缓存区，支持262k和65k两种颜色深度。并支持8bit 8080并行、8bit 6800并行、3wire-SPI和4wire-SPI等通信方式。
本模块选择了4wire-SPI和3wire-SPI作为通信方式，减小模块的面积，同时节省了控制器的IO资源。
4WIRE-SPI通信协议
在4wire-SPI通信中，先将DC置1或置0，再发送一个或多个字节的数据。
当DC置1时，发送的字节将作为显示数据存入SSD1351的SRAM中，作为显示数据。在发送数据时，可以连续发送多个字节。
当DC置0时，发送的字节将作为控制OLED的命令，发送命令时，一般一次只发送一个字节。
详见SSD1351 Datasheet Figure 8-5。
3WIRE-SPI通信协议
3wire-SPI和4wire-SPI唯一的区别在于，它去掉了控制发送命令和数据的DC引脚，在每次SPI传输的字节前加一个位来识别该字节是命令还是数据。
故在3wire-SPI中，DC引脚需要接地，此外，每次传输的数据不是8bit，而是9bit。
树莓派
提供C语言与python例程
开启SPI接口
sudo raspi-config
选择Interfacing Options -> SPI -> Yes 开启SPI接口
然后重启树莓派：
sudo reboot
请确保SPI没有被其他的设备占用，你可以在/boot/config.txt中间检查
安装库
- 安装BCM2835， 打开树莓派终端，并运行一下指令
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.60.tar.gz
tar zxvf bcm2835-1.60.tar.gz
cd bcm2835-1.60/
sudo ./configure
sudo make
sudo make check
sudo make install
# 更多的可以参考官网：http://www.airspayce.com/mikem/bcm2835/
sudo apt-get install wiringpi
#对于树莓派4B可能需要进行升级：
cd /tmp
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版本，如果没有出现说明安装出错
sudo apt-get updata
sudo apt-get install python-pip
sudo pip install RPi.GPIO
sudo pip install spidev
硬件连接
| LCD |
树莓派BCM
|
| VCC |
5V
|
| GND |
GND
|
| DIN |
MOSI
|
| CLK |
SCK
|
| CS |
CE0
|
| DC |
24
|
| RST |
25
|
下载例程
在树莓派终端运行：
sudo apt-get install p7zip
wget http://wiki.diustou.com/w/upload/e/eb/1.5inch_RGB_OLED_Module_Code.7z
7zr x 1.5inch_RGB_OLED_Module_Code.7z -r -o./1.5inch_RGB_OLED_Module_Code
sudo chmod 777 -R 1.5inch_RGB_OLED_Module_Code
cd /1.5inch_RGB_OLED_Module_Code/RaspberryPi/
如果下载很慢，你可以git我们github上的工程：
git clone https://github.com/waveshare/1.5inch-RGB-OLED-Module
cd 1.5inch-RGB-OLED-Module
运行例程
cd c
make clean
make
sudo ./main
cd python
sudo python main.py
STM32
- 该例程使用的开发板为：XNUCLEO-F103RB
- 示例工程基于MDK-ARM V5，使用STM32CubeMX配置生成
硬件配置
| LCD |
树莓派BCM
|
| VCC |
5V
|
| GND |
GND
|
| DIN |
D11(PA7)
|
| CLK |
D13(PA5)
|
| CS |
D10(PB6)
|
| DC |
D7(PA8)
|
| RST |
D8(PA9)
|
- 下载示例程序，打开/STM32/OLED_Demo/MDK-ARM/OLED_Demo.uvprojx
- 编译并选择烧录器
- 复位开发，可看到演示效果
Arduino
硬件配置
| LCD |
树莓派BCM
|
| VCC |
5V
|
| GND |
GND
|
| DIN |
D11
|
| CLK |
D13
|
| CS |
D10
|
| DC |
D7
|
| RST |
D8
|
- 下载示例程序，打开Arduino/1.5 inch OLED Demo/OLED_Demo/OLED_Demo.ino
- 编译并选择开发板
- 复位开发板，可看到演示效果
