1.3inch OLED HAT(B)
I 产品概述
1.3英寸OLED显示屏 128 x 64像素 黑白 支持SPI/I2C通信
该产品是一款多功能的 1.3 英寸 OLED 显示扩展模块,由 SH1106 控制器提供支持,分辨率为 128x64。它专为实现极高灵活性而设计,集成了一个独特的滑动开关,可实现 SPI 和 I²C 通信模式之间的无缝转换,并通过单个电阻器进行 I²C 地址配置。它与各种流行的开发板兼容,包括 Raspberry Pi 系列、Arduino、STM32 和 ESP32,可轻松集成到您的项目中。
我们为 Raspberry Pi (C/Python)、Arduino 和 STM32 平台提供全面的示例代码。这些库使您能够绘制点、线、矩形和圆形,并完全支持显示字母数字字符和图像。体验真正自适应显示解决方案的便利性,简化原型设计和开发。
II 产品特点
- 1.3英寸OLED显示屏,分辨率为128×64像素
- 支持SPI/I²C协议,带选择开关,实现无缝模式切换
- 板载电平转换器兼容 3.3V/5V MCU
- Raspberry Pi、Arduino Mega、STM32 和 ESP32 的开源示例代码
III 产品参数
|
大小 |
38mm(长) x 37mm(宽) |
|
像素 |
128 x 64 |
|
显示颜色 |
黑、白 |
|
电压转换器 |
TXS0108EPWR |
|
信号接口 |
SPI / I2C |
|
电源电压 |
3.3V/5V |
|
OLED 显示区域 |
29.42×14.70 |
|
驱动芯片 |
SH1106 |
IV 产品使用
本产品的所有示例代码都是针对SPI模式编写的,因此开发板背面的开关预设为“SPI”位置。要使用 I2C 模式,请按照以下步骤作:
将开发板背面的选择开关拨至“I2C”位置 将 oled.h 文件中的 use_mode 1 修改为 use_mode 0。
该产品提供两个可选的 I2C 地址。在I2C模式下,地址选择由I²C地址选择电阻的焊接位置控制。要修改 I²C 地址:
选择所需的I²C地址,并将电阻器重新定位到相应的焊盘
同时调整 oled.h 和 oled.c 文件中的 ADDR 参数值
4.1模块资源配置文件
模块资源配置文件如下图所示:


图4-1 1.3英寸OLED显示屏资源简介图
①SPI/I2C 控制接口(2.54mm 间距排针)②IIC 地址选择电阻
③SPI/I2C 控制接口(1.25mm 间距连接器)④SPI/I2C 选择开关
4.2 树莓派接线定义
由于bookworm系统不再支持wiringpi库,因此该系统的示例程序使用lgpio库,靶心系统可以使用示例程序的wiringpi库版本。
Raspberry Pi 的靶心系统示例程序使用 wiringPi 中的引脚定义编号,而 bookworm 系统使用 BCM 编号的引脚定义。树莓派主板接线定义如下表所示:
|
OLED 显示 |
WiringPi 编号 |
BCM 编号 |
|
VCC |
3.3V |
|
|
GND |
GND |
|
|
DIN |
SPI:P12 / I2C:P8 |
SPI:D10 / I2C:D2 |
|
CLK |
SPI:P14 / I2C:P9 |
SPI:D11 / I2C:D3 |
|
CS |
P10 |
D8 |
|
D/C |
P6 |
D25 |
|
RST |
P0 |
D17 |
表 4-1 OLED 显示屏和 Raspberry Pi 引脚的定义
4.3 Arduino接线定义
表 4-2 是 Arduino Mega 和 OLED 显示器之间的接线定义:
|
OLED 显示 |
Arduino Mega |
|
VCC |
5V |
|
GND |
GND |
|
DIN |
SPI:D51 / I2C:SDA1 |
|
CLK |
SPI:D52 / I2C:SCL1 |
|
CS |
D10 |
|
D/C |
D9 |
|
RST |
D8 |
表 4-2 OLED 显示器和 Arduino Mega 的引脚定义
表 4-3 是 Arduino Uno 和 OLED 显示器之间的接线定义:
|
OLED 显示 |
Arduino Uno |
|
VCC |
5V |
|
GND |
GND |
|
DIN |
SPI:D11 / I2C:SDA |
|
CLK |
SPI:D13 / I2C:SCL |
|
CS |
D10 |
|
D/C |
D9 |
|
RST |
D8 |
表 4-3 OLED 显示器和 Arduino Uno 的引脚定义
4.4 STM32接线定义
本示例程序中使用的 STM32 模块STM32F103C8T6。产品接线定义如下表4-4所示:
|
OLED 显示 |
STM32 |
|
VCC |
3.3V |
|
GND |
GND |
|
DIN |
SPI / I2C:PA7 |
|
CLK |
SPI / I2C:PA5 |
|
CS |
PB4 |
|
D/C |
PA3 |
|
RST |
PA2 |
表4-4 OLED显示器和STM32的引脚定义
4.5 ESP32接线定义
本示例程序中使用的 ESP32 模块是 ESP32-WROOM-32E。产品接线定义如下表4-5所示:
|
OLED 显示 |
ESP32 |
|
VCC |
3.3V |
|
GND |
GND |
|
DIN |
SPI:IO23/ I2C:IO21 |
|
CLK |
SPI:IO18/ I2C:IO22 |
|
CS |
IO25 |
|
DC |
IO26 |
|
RST |
IO33 |
表4-5 OLED显示屏和ESP32的引脚定义
V 附录
5.1 预防措施
-
在通电状态下,不要插拔模块。
-
遵循产品上提供的所有警告和指南。
-
保持产品干燥。如不小心溅水或浸入液体,立即断开电源并彻底干燥产品。
-
确保操作环境有良好的通风和散热,以避免因高温导致组件损坏。
-
不要在多尘或肮脏的环境中使用或存放产品。
-
避免在温度频繁变化的环境中使用产品,以防止组件发生冷凝损坏。
-
轻拿轻放产品,避免跌落、撞击或剧烈震动,以免损坏电路和组件。
-
不要使用有机溶剂或腐蚀性液体清洁产品。
-
请勿自行尝试维修或拆解产品。如出现任何故障,请联系我们公司进行维修。未经授权的维修可能会损坏产品,造成的损坏将不在保修范围内。
5.2保养
地址:广西壮族自治区桂林市七星区漓江花园19栋
联系人:售后维修部
技术支持
技术支持时间(工作日):香港时间:上午9:30 - 上午11:30,
下午1:30 - 下午5:30电话:0773-7799838 传真:gxshengui@163.com
感谢您选择深桂科技的产品。如果您有创意产品或想法,请随时给我们发送电子邮件,也许我们可以进一步合作。我们的电子邮件地址是:gxshengui@163.com
- 2025-12-02
- 2025-12-02
- 2025-12-02
- 2025-12-01
