查看“︁0.96inch OLED A”︁的源代码

<!-- =========================
     0.96inch OLED (A) — 页面源码（可直接粘贴）
     说明：
     1) 将占位图片/文件名替换为你站点已上传的文件；
     2) 若不想隐藏目录，删掉 __NOTOC__；
     3) 如使用 I²C/不同驱动芯片，请据实改动“通信模式/初始化”相关内容。
========================= -->

__NOTOC__ __NOEDITSECTION__

= 0.96inch OLED (A) =

[[File:0.96inch_OLED_A.jpg|center|420px|thumb|0.96inch OLED (A) 模块示意图（请替换为你的图片文件名）]]

; 型号
: 0.96inch OLED (A)（横/弯脚排针）
; 对应版本
: [[0.96inch OLED (B)|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 为准。

{| class="wikitable"
! 通信模式 !! 选择位示例（按你的丝印改） !! 备注
|-
| 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）。以实物丝印为准。

{| class="wikitable"
! 引脚序号 !! 丝印名称 !! 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） ===
<pre>
// 以 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();
}
</pre>

=== Raspberry Pi（Python）===
<pre>
# 示例：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)
</pre>

=== STM32（HAL，伪代码）===
<pre>
// 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
}
</pre>

== 尺寸与外形 ==
* 外形尺寸：33.0 mm × 33.5 mm（示例，按资料更正）
* 显示区域：21.7 mm × 11.2 mm（约）
* 排针形式：A=横/弯脚；B=竖/直脚（功能一致）

[[File:0.96inch_OLED_A_Dimension.png|center|520px|thumb|尺寸图（请替换为你的尺寸图文件名）]]

== 常见问题（FAQ） ==
; 上电不亮，是坏了吗？
: OLED 无背光；仅接 VCC/GND 不会发光，需主控初始化后显示。
; 屏幕有残影怎么办？
: 建议定时刷新或屏保动画；降低固定高亮图案的停留时间。
; SPI 与 I²C 如何选择？
: SPI 刷新更快、更流畅；I²C 接线更简洁、占用 IO 更少。

== 资料下载 ==
* [[File:0.96inch-OLED-UserManual.pdf|用户手册（PDF）]]
* [[File:0.96inch-OLED-Schematic.pdf|原理图（PDF）]]
* 示例代码：
** [[File:Arduino_SSD1306_Example.zip|Arduino 示例]] / [[File:ESP32_U8g2_Example.zip|ESP32 示例]]
** [[File:RaspberryPi_Python_OLED_Example.zip|Raspberry Pi Python 示例]]
** [[File:STM32_HAL_OLED_Driver.zip|STM32 HAL 驱动示例]]

> 若未启用文件上传，可将以上链接改为外部下载页（Git/网盘）。

== 选型信息 ==
* '''0.96inch OLED (A)'''：横/弯脚排针
* '''0.96inch OLED (B)'''：竖/直脚排针（另页）

== 修订记录 ==
* 2025-10-02：首次发布此页面
* 2025-MM-DD：补充通信模式电阻、尺寸图与示例代码链接

== 技术支持 ==
使用中如遇问题，请附：
# 模块正反面清晰照片（含焊盘/丝印）
# 接线图与所用主控型号
# 初始化/显示相关代码片段（或完整示例）
# 串口/日志关键信息
以便快速定位与协助。