查看“1.3inch OLED HAT”的源代码

<div class="tabber">
{{外围模块|colorscheme=blue
|name = 1.3inch OLED HAT
|img=[[File:1.3inch-OLED-HAT-1.jpg|360px |alt=1.3inch-OLED-HAT | 1.3inch OLED HAT]]
|category1=OLED
|category2=显示屏
|brand=Waveshare
|feature-name1= 显示尺寸
|feature-value1=1.3英寸
|feature-name2= 分辨率
|feature-value2=128×64
| interface1 =SPI
| interface2 =I2C
| interface3 =OLED
| Product1 = [[1.3inch SH1106 OLED]]
| Product2 =[[1.3inch OLED (A)]]
| Product3 =[[1.3inch OLED (B)]]
}}

<div class="tabbertab" title="说明">
=产品简介=
'''提供树莓派和Jetson nano示例程序'''
==产品参数==
*驱动芯片： SH1106
*支持接口： 3-wire SPI, 4-wire SPI, I2C
*分辨率： 128*64
*显示尺寸： 1.3inch
*外形尺寸： 65mm*30mm
*显示颜色： 蓝色
*视角：       >160°
*工作温度： -20°C ~ 70°C
*存储温度： -30°C ~ 80°C

==功能引脚==
{|border=1; style="width:400px;" align="center"
|-style="background:#0000ff; color:white;" align="center"
|功能引脚||树莓派接口(BCM)||描述
|-align="center"
|KEY1||P21||按键1GPIO
|-align="center"
|KEY2||P20||按键2GPIO
|-align="center"
|KEY3||P16||按键3GPIO
|-align="center"
|摇杆UP||P6||摇杆上
|-align="center"
|摇杆Down||P19||摇杆下
|-align="center"
|摇杆Left||P5||摇杆左
|-align="center"
|摇杆Right||P26||摇杆右
|-align="center"
|摇杆Press||P13||摇杆按下
|-align="center"
|SCLK||P11/SCLK||SPI时钟线
|-align="center"
|MOSI||P10/MOSI||SPI数据线
|-align="center"
|SCL||P3/SCL1||I2C时钟线
|-align="center"
|SDA||P2/SDA1||I2C数据线
|-align="center"
|DC||P24||数据/命令选择
|-align="center"
|CS||P8/CE0||片选
|-align="center"
|RST||P25||复位
|}

==硬件配置==
OLED模块提供三种驱动接口：分别为3-wire SPI、4-wire SPI 和I2C接口，模块背面有六个可选择焊接的电阻， 通过电子的选择来选择相应的通信方式， 如图：<br />
[[file:1.3inch_oled_hat.png|900px]]<br />
模块出厂默认使用4线SPI通信模式， 即BS0，BS1，DC，CS，CLK，DIN默认接0（1和0不全代表电平，只是电阻接上或者接下的焊接方式，具体硬件链接见下表）：<br />
注：上图为硬件上的焊接， 下表为实际的硬件连接<br />
{|border=1; style="width:400px;" align="center"
|-style="background:#0000ff; color:white;" align="center"
|通信方式||BS1/BS0||CS||DC||DIN||CLK
|-align="center"
|3-wire SPI||0/1||CS||1||MOSI||SCLK
|-align="center"
|4-wire SPI||0/0||CS||DC||MOSI||SCLK
|-align="center"
|I2C||1/0||0||1||SDA||SCL
|}
具体硬件配置，如下：<br />
*使用4线SPI：
即出厂程序设置：BS0与BS1接0连接到地，CS接0连接到树莓派CE0（使能管脚），D/C接0连接到树莓派的P24（数据/命令管脚），DIN接0连接至树莓派MOSI，CLK接0连接至树莓派SCLK；<br />
*使用3线SPI：
BS0接1连接到VCC，BS1接0连接至GND，CS接0连接至树莓派CE0，D/C接1连接值GND，DIN接0连接至树莓派MOSI，CLK接0来连接至树莓派SCLK；<br />
*使用I2C：
BS0接0连接至GND，BS1接1连接至VCC（3.3V），CS接1连接GND，D/C接1来连接至GND，DIN接1连接至树莓派SDA，CLK接1连接至树莓派SCL；使用I2C时：DC的高低状态可以控制从设备的地址，这里接到了GND，那么I2C的7位地址为：0x3C<br />

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

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

==下载例程==
在树莓派终端运行：<br />
<pre>
sudo apt-get install p7zip
wget http://wiki.diustou.com/w/upload/5/53/1.3inch-OLED-HAT-Code.7z
7z x 1.3inch-OLED-HAT-Code.7z
sudo chmod 777 -R  1.3inch-OLED-HAT-Code
cd 1.3inch-OLED-HAT-Code/RaspberryPi/
</pre>

==运行测试程序==
*C语言
<pre>
cd C
make clean
make
sudo ./main
</pre>
*python
<pre>
#python2
cd python2
sudo python main.py
sudo python key_demo.py
#python3
cd python3
sudo python3 main.py
sudo python3 key_demo.py
</pre>
*对于树莓派4B及raspbian_lite-2019-06-20系统之后需要设置如下，按键才能正常输入<br />
<pre>
sudo nano /boot/config.txt
#添加如下：
gpio=6,19,5,26,13,21,20,16=pu
</pre>

==I2C控制==
*默认使用的4线SPI，如果硬件上修改成I2C的，需要修改程序<br />
===C语言===
打开C\obj\DEV_Config.h，把如下：<br />
<pre>
#define USE_SPI 1
#define USE_IIC 0
</pre>
改成<br />
<pre>
#define USE_SPI 0
#define USE_IIC 1
</pre>
然后重新执行：<br />
<pre>
make clean
make
sudo ./main
</pre>
===python===
打开python2/config.py，把如下：<br />
<pre>
Device_SPI = 1
Device_I2C = 0
</pre>
改成<br />
<pre>
Device_SPI = 0
Device_I2C = 1
</pre>
然后重新执行：<br />
<pre>
sudo python main.py
</pre>
python3同理<br />

=Jetson nano=
==安装库==
{{JetsonNano python lib}}

==下载程序==
<pre>
sudo apt-get install p7zip
wget http://wiki.diustou.com/w/upload/5/53/1.3inch-OLED-HAT-Code.7z
7zr x 1.3inch-OLED-HAT-Code.7z -r -o./1.3inch-OLED-HAT-Code
sudo chmod 777 -R  1.3inch-OLED-HAT-Code
cd 1.3inch-OLED-HAT-Code/JetsonNano/
</pre>

==运行测试程序==
<font color="#FF0000">
由于JetsonNano的GPIO驱动能力弱，只能使用SPI进行控制
</font>
*C语言
<pre>
cd C
make clean
make
sudo ./main
</pre>
*python
<pre>
#python2
cd python2
sudo python main.py
sudo python key_demo.py
#python3
cd python3
sudo python3 main.py
sudo python3 key_demo.py
</pre>

</div>

<div class="tabbertab" title="资料">
===文档===
*[http://{{SERVERNAME}}/w/upload/c/c8/1.3inch-OLED-HAL-Schematic.pdf 原理图]<br>

===程序===
*[http://{{SERVERNAME}}/w/upload/5/53/1.3inch-OLED-HAT-Code.7z 示例程序]<br>

===软件===
{{OLED_Software}}
===数据手册===
*[http://{{SERVERNAME}}/w/upload/e/e3/1.3inch-SH1106-OLED.pdf 1.3inch SH1106 OLED数据手册]
*[http://{{SERVERNAME}}/w/upload/0/08/SH1106_V2.3.pdf  SH1106 手册]

===相关资料===
*[https://github.com/PiSugar/pisugar-case-pihat-cap 外壳图纸(PiSugar)]



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

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

== FAQ ==
<div class="tabbertab" title="FAQ">{{0.96inch-OLED-FAQ}}</div>
<div class="tabbertab" title="售后"><br />{{Service08}}</div>