0.96inch OLED (A)
- 型号
- 0.96inch OLED (A)（横/弯脚排针）
- 对应版本
- 0.96inch OLED (B)（竖/直脚排针）
- 驱动芯片
- SSD1306 / SSD1315（按实物填写）
- 分辨率
- 128×64
- 接口
- 3-wire SPI / 4-wire SPI / I²C
- 默认模式
- 4-wire SPI（出厂默认，若不同请改）
产品简介
本产品为 0.96 英寸 OLED 显示模块，内置 模板:在此填写芯片型号 驱动，分辨率 128×64。支持 **3 线 SPI、4 线 SPI 与 I²C** 多种通信方式，适配 Raspberry Pi、Arduino、STM32、ESP32、Raspberry Pi Pico 等主控平台。 A 版为**横/弯脚排针**，B 版为**竖/直脚排针**；电气功能一致，仅排针方向不同。
产品参数
- 供电电压：3.3V / 5V（双电压兼容按你的板卡丝印填写）
- 典型电流：全亮约 XX mA，静态约 X mA（以官方/实测为准）
- 有效显示区：约 21.7 mm × 11.2 mm（0.96"）
- 显示颜色：单色（白/黄/蓝，或“上黄下蓝”等，请据实填写）
- 接口模式：3-wire SPI / 4-wire SPI / I²C
- 兼容平台：Raspberry Pi / Arduino / STM32 / ESP32 / Pico 等
- 工作温度：-20℃ ~ +70℃（如有）
> 提示：OLED 长时间固定画面可能产生轻微残影，建议周期性刷新或启用屏保。
通信模式与焊盘配置
模块背面通常通过两颗选择电阻（示例：BS1、BS0 或 R1、R2）切换通信方式（以及 I²C 地址）。出厂默认 **4-wire SPI**。实际丝印以 PCB 为准。
| 通信模式 | 选择位示例（按你的丝印改） | 备注 |
|---|---|---|
| 3-wire SPI | BS1=0 / BS0=1 | D/C 通过串行命令位区分 |
| 4-wire SPI（默认） | BS1=0 / BS0=0 | 常用，速率较高 |
| I²C | BS1=1 / BS0=0 | 接线简单；地址随焊盘/电阻改变 |
- I²C 地址：0x3C / 0x3D（示例，按实际焊接/丝印填写）
- 若你的板卡用 “R1/R2 0Ω 电阻是否焊接” 来表示，请将上表文字替换为相应描述。
管脚定义（A 版：横/弯脚排针）
不同批次可能丝印略有差异（如 RES/RESET、DIN/MOSI、CLK/SCK）。以实物丝印为准。
| 引脚序号 | 丝印名称 | SPI（4-wire）说明 | I²C 说明 |
|---|---|---|---|
| 1 | VCC | 3.3V/5V 电源正 | 3.3V/5V 电源正 |
| 2 | GND | 电源地 | 电源地 |
| 3 | DIN / SDA | SPI MOSI / 数据输入 | I²C 数据（SDA） |
| 4 | CLK / SCL | SPI 时钟（SCK） | I²C 时钟（SCL） |
| 5 | CS | 片选（低有效） | —（I²C 无） |
| 6 | DC | 数据/命令选择（1=数据/0=命令） | —（I²C 无） |
| 7 | RST / RES | 复位（低有效） | 复位（低有效） |
典型接线
- 4-wire SPI（默认）
- MCU → OLED：MOSI→DIN、SCK→CLK、CS→CS、D/C→DC、RST→RST、3V3/5V→VCC、GND→GND
- I²C
- MCU → OLED：SDA→SDA、SCL→SCL、3V3/5V→VCC、GND→GND（并按焊盘配置地址）
> SPI 速率可较高但占用更多 IO；I²C 接线简单但速率相对较低。
快速上手
以下示例仅为“壳子”，请替换为你自己的初始化/库链接/代码片段。
Arduino / ESP32（U8g2 或 Adafruit SSD1306）
// 以 U8g2 SPI 为例（请按你的引脚/芯片修改构造函数）
#include <U8g2lib.h>
U8G2_SSD1306_128X64_NONAME_F_4W_SW_SPI u8g2(
/* rotation */ U8G2_R0,
/* clock*/ SCK_PIN, /* data*/ MOSI_PIN, /* cs*/ CS_PIN,
/* dc*/ DC_PIN, /* reset*/ RST_PIN
);
void setup() {
u8g2.begin();
}
void loop() {
u8g2.clearBuffer();
u8g2.setFont(u8g2_font_ncenB08_tr);
u8g2.drawStr(0, 12, "Hello OLED!");
u8g2.drawFrame(0, 16, 128, 48);
u8g2.sendBuffer();
}
Raspberry Pi（Python）
# 示例：I2C + luma.oled（按需修改地址/引脚）
# pip install luma.oled pillow
from luma.core.interface.serial import i2c, spi
from luma.oled.device import ssd1306
from PIL import Image, ImageDraw, ImageFont
serial = i2c(port=1, address=0x3C) # 如为 0x3D 请改
device = ssd1306(serial)
image = Image.new("1", device.size)
draw = ImageDraw.Draw(image)
draw.text((0, 0), "Hello OLED!", fill=255)
device.display(image)
STM32（HAL，伪代码）
// 1) CubeMX 选好 SPI/I2C 与 GPIO；
// 2) 初始化序列请对应 SSD1306/SSD1315 官方推荐参数；
// 3) 典型流程：Reset -> InitCmds -> 清屏 -> 画点/线/字。
void OLED_Init(void){
OLED_Reset_Low(); HAL_Delay(10); OLED_Reset_High();
// 发送初始化命令序列（对比你所用芯片的推荐序列）
OLED_SendCmd(0xAE); // Display Off
/* ... 省略若干初始化命令 ... */
OLED_SendCmd(0xAF); // Display On
}
尺寸与外形
- 外形尺寸：33.0 mm × 33.5 mm（示例，按资料更正）
- 显示区域：21.7 mm × 11.2 mm（约）
- 排针形式：A=横/弯脚；B=竖/直脚（功能一致）
常见问题（FAQ）
- 上电不亮，是坏了吗？
- OLED 无背光；仅接 VCC/GND 不会发光，需主控初始化后显示。
- 屏幕有残影怎么办？
- 建议定时刷新或屏保动画；降低固定高亮图案的停留时间。
- SPI 与 I²C 如何选择？
- SPI 刷新更快、更流畅；I²C 接线更简洁、占用 IO 更少。
资料下载
> 若未启用文件上传，可将以上链接改为外部下载页（Git/网盘）。
选型信息
- 0.96inch OLED (A)：横/弯脚排针
- 0.96inch OLED (B)：竖/直脚排针（另页）
修订记录
- 2025-10-02：首次发布此页面
- 2025-MM-DD：补充通信模式电阻、尺寸图与示例代码链接
技术支持
使用中如遇问题，请附：
- 模块正反面清晰照片（含焊盘/丝印）
- 接线图与所用主控型号
- 初始化/显示相关代码片段（或完整示例）
- 串口/日志关键信息
以便快速定位与协助。