查看“1.5inch RGB OLED Module”的源代码

<div class="tabber">
{{Product
|images=[[File:1_5inch-RGB-OLED-Module-intro.jpg|360px |alt=1.5inch RGB OLED Module | 1.5inch RGB OLED Module]]
|categories=
{{Category|OLED}}
{{Category|显示屏}}
|brand=Waveshare
|features=
* 显示尺寸：1.5英寸
* 分辨率：128×128
|interfaces=
{{Category|SPI接口}}
{{Category|OLED接口}}
|related=
{{OLED-Related}}
}}

<div class="tabbertab" title="说明">
=产品概述=
'''提供树莓派、STM32、Arduino例程'''
==产品特性==
*驱动芯片 :  SSD1351
*支持接口 :  4-wire SPI、3-wire SPI
*分辨率   :  128 * 128
*显示尺寸 :  1.5inch
*显示颜色 :  65K彩色
*工作电压 :  3.3V / 5V

==管脚配置==
{|border=1;
|-style="background:#0000ff; color:white;" align="center"
|功能引脚||描述
|-align="center"
|VCC||电源正
|-align="center"
|GND||电源地
|-align="center"
|DIN||数据输入
|-align="center"
|CLK||时钟输入
|-align="center"
|CS||片选
|-align="center"
|DC||数据/命令信号选择
|-align="center"
|RST||复位信号
|}

==硬件配置==
*本OLED模块提供两种通信方式：4-wire SPI和3wire-SPI，在模块的背面有一个可选择焊接的电阻，通过该电阻来选择通信方式。如下图：
[[file:1.5inch_rgb_oled_module.png|700px]] <br>
<font color="#FF0000">
模块出厂默认使用4线SPI通信，即BS0默认接0
</font>
注：下表为接口连接。<br />
{|border=1; style="width:700px;"
|-style="background:#0000ff; color:white;" align="center"
|通信协议||BS||CS||DC||DIN||CLK
|-align="center"
|4Wire SPI||0||片选||DC||MOSI||SCK
|-align="center"
|3Wire SPI||1||片选||GND||MOSI||SCK
|}
具体硬件配置，如下：<br />
使用4线SPI:即出厂设置,BS接0连接到GND，DIN接控制引脚MOSI, CLK接控制引脚SCK;<br />
使用3线SPI: BS接1连接到VCC，D/C需接地，DIN接控制引脚MOSI, CLK接控制引脚SCK;<br />

==工作原理==
SSD1351是一款128RGB * 128 Dot Matrix OLED/PLED 控制器，其内部有一个128*128*18bit的SRAM作为显示缓存区，支持262k和65k两种颜色深度。并支持8bit 8080并行、8bit 6800并行、3wire-SPI和4wire-SPI等通信方式。<br />
本模块选择了4wire-SPI和3wire-SPI作为通信方式，减小模块的面积，同时节省了控制器的IO资源。<br />

===4WIRE-SPI通信协议===
[[file:1.5inch_rgb_oled_module_4wspi.png|700px]] <br>
在4wire-SPI通信中，先将DC置1或置0，再发送一个或多个字节的数据。 <br>
当DC置1时，发送的字节将作为显示数据存入SSD1351的SRAM中，作为显示数据。在发送数据时，可以连续发送多个字节。 <br>
当DC置0时，发送的字节将作为控制OLED的命令，发送命令时，一般一次只发送一个字节。 <br>
详见SSD1351 Datasheet Figure 8-5。 <br>

===3WIRE-SPI通信协议===
[[file:1.5inch_rgb_oled_module_3wspi.png|700px]] <br>
3wire-SPI和4wire-SPI唯一的区别在于，它去掉了控制发送命令和数据的DC引脚，在每次SPI传输的字节前加一个位来识别该字节是命令还是数据。<br />
故在3wire-SPI中，DC引脚需要接地，此外，每次传输的数据不是8bit，而是9bit。<br />

=树莓派=
'''提供C语言与python例程'''
{{RPI_open_spi}}

==安装库==
{{RPI_C_lib}}
*python
<pre>
sudo apt-get updata
sudo apt-get install python-pip 
sudo pip install RPi.GPIO
sudo pip install spidev
</pre>

==硬件连接==
[[File:1.5inch-rgb-oled-module-rpi-connet.jpg]]
{|border=1; style="width:700px;"
|-style="background:#0000ff; color:white;" align="center"
|LCD||树莓派BCM
|-align="center"
|VCC||5V
|-align="center"
|GND||GND
|-align="center"
|DIN||MOSI
|-align="center"
|CLK||SCK
|-align="center"
|CS||CE0
|-align="center"
|DC||24
|-align="center"
|RST||25
|}

==下载例程==
在树莓派终端运行：<br />
<pre>
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/
</pre>
如果下载很慢，你可以git我们github上的工程：<br />
<pre>
git clone https://github.com/waveshare/1.5inch-RGB-OLED-Module
cd 1.5inch-RGB-OLED-Module
</pre>

==运行例程==
*C语言
<pre>
cd c
make clean
make
sudo ./main
</pre>
*python
<pre>
cd python
sudo python main.py
</pre>

=STM32=
*该例程使用的开发板为：XNUCLEO-F103RB
*示例工程基于MDK-ARM V5，使用STM32CubeMX配置生成
==硬件配置==
{|border=1; style="width:700px;"
|-style="background:#0000ff; color:white;" align="center"
|LCD||树莓派BCM
|-align="center"
|VCC||5V
|-align="center"
|GND||GND
|-align="center"
|DIN||D11(PA7)
|-align="center"
|CLK||D13(PA5)
|-align="center"
|CS||D10(PB6)
|-align="center"
|DC||D7(PA8)
|-align="center"
|RST||D8(PA9)
|}

#下载示例程序，打开/STM32/OLED_Demo/MDK-ARM/OLED_Demo.uvprojx
#编译并选择烧录器
#复位开发，可看到演示效果

=Arduino=
*该例程使用的开发板为：UNO
==硬件配置==
{|border=1; style="width:700px;"
|-style="background:#0000ff; color:white;" align="center"
|LCD||树莓派BCM
|-align="center"
|VCC||5V
|-align="center"
|GND||GND
|-align="center"
|DIN||D11
|-align="center"
|CLK||D13
|-align="center"
|CS||D10
|-align="center"
|DC||D7
|-align="center"
|RST||D8
|}

#下载示例程序，打开Arduino/1.5 inch OLED Demo/OLED_Demo/OLED_Demo.ino
#编译并选择开发板
#复位开发板，可看到演示效果
</div>

<div class="tabbertab" title="资料">
===文档===
*[https://{{SERVERNAME}}/w/upload/a/a3/1.5inch_RGB_OLED_Module_Schematic.pdf 原理图]<br>

===程序===
*[https://{{SERVERNAME}}/w/upload/e/eb/1.5inch_RGB_OLED_Module_Code.7z 示例程序]<br>

===软件===
{{OLED_Software}}
===数据手册===
*[https://{{SERVERNAME}}/w/upload/a/a7/SSD1351-Revision_1.5.pdf SDD1351数据手册]
*[https://{{SERVERNAME}}/w/upload/4/43/UG-2828GDEDF11.pdf UG-2828GDEDF11用户手册]
*[https://{{SERVERNAME}}/w/upload/3/36/1.5inch_RGB_OLED_Module_DS.pdf 1.5inch RGB OLED数据手册]

===应用笔记===
*[[OLED_Draw|显示图片]]


转到：[[#软件]]，[[#程序]]，[[#文档]]

<!--{{Join_us}}-->
</div>

== FAQ ==
<div class="tabbertab" title="FAQ">
{{FAQ|OLED模块的工作电流是多少？|

在3.3V工作电压下:全白约为60mA，全黑约为4mA。|||}}

{{FAQ|OLED模块接上电源为什么不亮？|
OLED是没有背光的，显示属于自发光方式。只接VCC和GND，OLED是不会亮的。
必须用程序控制才能亮点OLED。
|||}}</div>
<div class="tabbertab" title="售后"><br />{{Service08}}</div>