1.3inch OLED HAT

来自Waveshare Wiki
跳转至： 导航、 搜索
1.3inch-OLED-HAT
{{{name2}}}
{{{name3}}}
功能简介
特性 无特性，不解释
显示尺寸 1.3英寸
分辨率 128×64
' 无特性，不解释
' 无特性，不解释
接口 OLED I2C SPI

产品简介

提供树莓派和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

功能引脚

功能引脚 树莓派接口(BCM) 描述
KEY1 P21 按键1GPIO
KEY2 P20 按键2GPIO
KEY3 P16 按键3GPIO
摇杆UP P6 摇杆上
摇杆Down P19 摇杆下
摇杆Left P5 摇杆左
摇杆Right P26 摇杆右
摇杆Press P13 摇杆按下
SCLK P11/SCLK SPI时钟线
MOSI P10/MOSI SPI数据线
SCL P3/SCL1 I2C时钟线
SDA P2/SDA1 I2C数据线
DC P24 数据/命令选择
CS P8/CE0 片选
RST P25 复位

硬件配置

OLED模块提供三种驱动接口：分别为3-wire SPI、4-wire SPI 和I2C接口，模块背面有六个可选择焊接的电阻， 通过电子的选择来选择相应的通信方式， 如图：
1.3inch oled hat.png
模块出厂默认使用4线SPI通信模式， 即BS0，BS1，DC，CS，CLK，DIN默认接0（1和0不全代表电平，只是电阻接上或者接下的焊接方式，具体硬件链接见下表）：
注：上图为硬件上的焊接， 下表为实际的硬件连接

通信方式 BS1/BS0 CS DC DIN CLK
3-wire SPI 0/1 CS 1 MOSI SCLK
4-wire SPI 0/0 CS DC MOSI SCLK
I2C 1/0 0 1 SDA SCL

具体硬件配置，如下：

  • 使用4线SPI：

即出厂程序设置：BS0与BS1接0连接到地，CS接0连接到树莓派CE0（使能管脚），D/C接0连接到树莓派的P24（数据/命令管脚），DIN接0连接至树莓派MOSI，CLK接0连接至树莓派SCLK；

  • 使用3线SPI：

BS0接1连接到VCC，BS1接0连接至GND，CS接0连接至树莓派CE0，D/C接1连接值GND，DIN接0连接至树莓派MOSI，CLK接0来连接至树莓派SCLK；

  • 使用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
使用I2C修改后电阻如下图所示
1.3inch oled hat 01.jpg

树莓派

提供C语言与python例程

开启SPI接口

  • 打开树莓派终端，输入以下指令进入配置界面：
sudo raspi-config
选择Interfacing Options -> SPI -> Yes 开启SPI接口

RPI open spi.png

  • 重启树莓派：
sudo reboot
  • 检查 /boot/config.txt，可以看到 'dtparam=spi=on' 已被写入

RPI open spi 1.jpg

  • 为了确保 SPI 没有被占用，建议其他的驱动覆盖暂时先关闭。可以使用 ls /dev/spi* 来检查 SPI 占用情况，终端输出 /dev/spidev0.0 和 /dev/spidev0.1 表示 SPI 情况正常

RPI open spi 2.jpg

开启I2C接口

  • 打开树莓派终端，输入以下指令进入配置界面
sudo raspi-config 
选择 Interfacing Options -> I2C ->yes 启动 i2C 内核驱动

RPI open i2c.png
然后重启树莓派：

sudo reboot

安装库

如果使用bookworm系统，只能使用lgpio库，bcm2835跟wiringPi无法安装与使用,python库可以不安装，直接运行程序即可

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版本，如果没有出现说明安装出错

lgpio

wget https://github.com/joan2937/lg/archive/master.zip
unzip master.zip
cd lg-master
sudo make install 
# 更多的可以参考官网：https://github.com/gpiozero/lg

python

sudo apt-get update
sudo apt-get install python3-pip 
sudo apt-get install python3-smbus
sudo pip3 install spidev

下载例程

在树莓派终端运行：

sudo apt-get install p7zip-full
wget http://www.waveshare.net/w/upload/5/53/1.3inch-OLED-HAT-Code.7z
7zr x 1.3inch-OLED-HAT-Code.7z -r -o.
sudo chmod 777 -R  1.3inch-OLED-HAT-Code
cd 1.3inch-OLED-HAT-Code/RaspberryPi/

运行测试程序

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

I2C控制

  • 默认使用的4线SPI，如果硬件上修改成I2C的，需要修改程序

C语言

打开C\obj\DEV_Config.h，把如下：

#define USE_SPI 1
#define USE_IIC 0

改成

#define USE_SPI 0
#define USE_IIC 1

然后重新执行：

make clean
make
sudo ./main

python

打开python2/config.py，把如下：

Device_SPI = 1
Device_I2C = 0

改成

Device_SPI = 0
Device_I2C = 1

然后重新执行：

sudo python main.py

python3同理

Jetson nano

安装库

安装函数库

  • 打开终端界面，输入以下指令安装相应的函数库
sudo apt-get update
sudo apt-get install python3-pip
sudo pip3 install Jetson.GPIO
sudo groupadd -f -r gpio
sudo usermod -a -G gpio your_user_name
sudo cp /opt/nvidia/jetson-gpio/etc/99-gpio.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

【注意】your_user_name 是你使用的用户名，比如说 waveshare

  • 安装I2C
sudo apt-get install python-smbus
  • 安装图像处理库：
sudo apt-get install python3-pil
sudo apt-get install python3-numpy

下载程序

sudo apt-get install p7zip
wget http://www.waveshare.net/w/upload/5/53/1.3inch-OLED-HAT-Code.7z
7zr x 1.3inch-OLED-HAT-Code.7z -r -o.
sudo chmod 777 -R  1.3inch-OLED-HAT-Code
cd 1.3inch-OLED-HAT-Code/JetsonNano/

运行测试程序

由于JetsonNano的GPIO驱动能力弱，只能使用SPI进行控制

  • C语言
cd C
make clean
make
sudo ./main
  • python
#python2
cd python2
sudo python main.py
sudo python key_demo.py
#python3
cd python3
sudo python3 main.py
sudo python3 key_demo.py

FAQ

问题：OLED模块可以在多少伏的系统中使用？

OLED模块默认是在3.3V的系统中使用的。


问题：OLED模块使用寿命有多少个小时？

在正常的工作条件下，一般有50000个小时


问题：OLED模块的工作电流是多少？

在3.3V工作电压下:

0.95inch RGB OLED的工作电流：全白显示约为38mA，全黑显示约为4mA。

0.96inch OLED的工作电流：全亮约为25mA，全灭约为1.5mA。

1.3inch OLED的工作电流：全亮约为29mA，全灭约为1.0mA。

1.51inch OLED的工作电流：全亮约为171mA，全灭约为6.9mA。

2.42inch OLED的工作电流：全亮约为196mA，全灭约为7.3mA。


问题：OLED模块接上电源为什么不亮？

OLED是没有背光的，显示属于自发光方式。只接VCC和GND，OLED是不会亮的。

必须用程序控制才能亮点OLED。


问题：使用该OLED模块，有什么需要注意的？

1.注意电源不要接反。

2.不能长时间显示同一画面，否则将产生残影，导致OLED损坏。


技术支持

联系人：黄工
QQ：2850151199
EMAIL：2850151199@qq.com
电话：0755-83040712
微信：扫下方二维码添加
Service20-Weichat.png

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证
取自“https://www.waveshare.net/w/index.php?title=1.3inch_OLED_HAT&oldid=107820”