VLEN - 用户贡献 [zh-cn]

0.96inch OLED A

2025-10-02T09:01:06Z

Nichen：

__NOTOC__ __NOEDITSECTION__

= 0.96inch OLED (A) =

<div style="text-align:center;">
https://www.waveshare.com/w/upload/5/5d/0.96inch-OLED-A_l.jpg
</div>

; 型号：0.96inch OLED (A)（横/弯脚排针）
; 对应版本：[https://www.waveshare.com/wiki/0.96inch_OLED_(B) 0.96inch OLED (B)]（竖/直脚排针）
; 驱动芯片：SSD1306
; 分辨率：128×64
; 接口：3-wire SPI / 4-wire SPI / I²C
; 默认模式：4-wire SPI（出厂默认）

----

== 产品简介 ==
0.96 英寸 OLED 显示模块，内置 SSD1306 驱动，分辨率 128×64。支持 **3 线 SPI、4 线 SPI 与 I²C** 多种通信方式，适配 Raspberry Pi、Arduino、STM32、ESP32、Pico 等主控平台。
A 版为**横/弯脚排针**，B 版为**竖/直脚排针**；电气功能一致，仅排针方向不同。

== 产品参数 ==
* 供电电压：3.3V / 5V
* 通信接口：3-wire SPI / 4-wire SPI / I²C
* 分辨率：128×64
* 显示尺寸：0.96inch
* 显示颜色：上黄下蓝（1/4 黄 + 3/4 蓝）
* 适配平台：Raspberry Pi / Arduino / STM32 / ESP32 / Pico

== 硬件配置与拨阻 ==
<div style="text-align:center;">
https://www.waveshare.com/w/upload/9/93/0.96inch_OLED_Hardware.png
</div>

{| class="wikitable"
! 模式 !! BS1/BS0
|-
| 3-wire SPI || 0 / 1
|-
| 4-wire SPI（默认） || 0 / 0
|-
| I²C || 1 / 0
|}

== 管脚定义（A 版：横/弯脚排针） ==
{| class="wikitable"
! 引脚 !! 名称 !! SPI 功能 !! I²C 功能
|-
| 1 || VCC || 电源正（3.3V/5V） || 电源正（3.3V/5V）
|-
| 2 || GND || 电源地 || 电源地
|-
| 3 || DIN/SDA || SPI MOSI || I²C 数据
|-
| 4 || CLK/SCL || SPI 时钟 || I²C 时钟
|-
| 5 || CS || 片选 || —
|-
| 6 || DC || 数据/命令选择 || （I²C 时可作地址位，接 GND=0x3C）
|-
| 7 || RST || 复位 || 复位
|}

== 接线示例（Raspberry Pi，4-wire SPI） ==
<div style="text-align:center;">
https://www.waveshare.com/w/upload/f/fe/0.96inch_OLED_rpi.png
</div>

; SPI
: MOSI→DIN、SCLK→CLK、CE0→CS、GPIO25→DC、GPIO13→RES、VCC→3.3V、GND→GND
; I²C
: SDA→SDA、SCL→SCL、VCC→3.3V、GND→GND（DC 脚接地则地址 0x3C）

== 示例代码 ==
=== Arduino/ESP32（U8g2） ===
<pre>
#include <U8g2lib.h>
U8G2_SSD1306_128X64_NONAME_F_4W_SW_SPI u8g2(U8G2_R0, SCK, MOSI, CS, DC, RST);
void setup(){ u8g2.begin(); }
void loop(){
u8g2.clearBuffer();
u8g2.setFont(u8g2_font_ncenB08_tr);
u8g2.drawStr(0,12,"Hello OLED!");
u8g2.sendBuffer();
}
</pre>

=== Raspberry Pi（Python：luma.oled，I²C） ===
<pre>
from luma.core.interface.serial import i2c
from luma.oled.device import ssd1306
from PIL import Image, ImageDraw

device = ssd1306(i2c(port=1, address=0x3C))
image = Image.new("1", device.size)
draw = ImageDraw.Draw(image)
draw.text((0,0), "Hello OLED!", fill=255)
device.display(image)
</pre>

== 资料下载 ==
* [https://files.waveshare.com/upload/7/71/0.96inch-OLED-UserManual.pdf 用户手册（PDF）]
* [https://files.waveshare.com/upload/d/dc/0.96inch-OLED-Schematic.pdf 原理图（PDF）]
* [https://files.waveshare.com/upload/e/ec/SDD1306-30pin.pdf SSD1306 数据手册（PDF）]

== 选型 ==
* '''0.96inch OLED (A)'''：横/弯脚排针
* '''0.96inch OLED (B)'''：竖/直脚排针

== 常见问题 ==
; 上电不亮？
: OLED 无背光，需要初始化并刷屏后才会有显示。
:
; 有残影/烧屏风险吗？
: 长时间显示静态画面会产生残影，建议定期刷新或做屏保。

== 修订记录 ==
* 2025-10-02：初版整理

首页

2025-10-02T08:02:03Z

Nichen：/* 首页 */

<strong>已安装MediaWiki。</strong>

请查阅[https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents 用户指导]以获取使用本wiki软件的信息。


<div style="background:#0b67ff; color:#fff; padding:28px 20px; border-radius:12px; box-shadow:0 6px 18px rgba(0,0,0,.12); text-align:center; margin:0 0 18px 0;">
<div style="font-size:34px; font-weight:700; letter-spacing:.5px;">欢迎来到我的知识库</div>
<div style="font-size:16px; margin-top:6px; opacity:.95;">项目文档 · 研发笔记 · 运维手册 · 经验沉淀</div>
</div>


== 🚀 快速入口 ==
<table style="width:100%; border-spacing:12px; border-collapse:separate;">
<tr>
<td style="width:33%; background:#f8fafc; border:1px solid #e6ecf5; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:18px; margin-bottom:6px;">[[项目总览|📂 项目总览]]</div>
<div style="color:#5b6472; font-size:13px;">里程碑 / 设计方案 / 进展追踪 / 归档</div>
</td>
<td style="width:33%; background:#f8fafc; border:1px solid #e6ecf5; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:18px; margin-bottom:6px;">[[开发文档|🛠️ 开发文档]]</div>
<div style="color:#5b6472; font-size:13px;">嵌入式 / 后端 / 前端 / 联调与调试</div>
</td>
<td style="width:33%; background:#f8fafc; border:1px solid #e6ecf5; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:18px; margin-bottom:6px;">[[使用说明|📖 使用说明]]</div>
<div style="color:#5b6472; font-size:13px;">产品手册 / SOP / 安装配置 / 故障排查</div>
</td>
</tr>
<tr>
<td style="background:#f8fafc; border:1px solid #e6ecf5; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:18px; margin-bottom:6px;">[[硬件资料|💡 硬件资料]]</div>
<div style="color:#5b6472; font-size:13px;">原理图 / PCB / 器件选型 / 调参笔记</div>
</td>
<td style="background:#f8fafc; border:1px solid #e6ecf5; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:18px; margin-bottom:6px;">[[软件工具|🧰 软件工具]]</div>
<div style="color:#5b6472; font-size:13px;">SDK / CLI / 调试脚本 / 常用下载</div>
</td>
<td style="background:#f8fafc; border:1px solid #e6ecf5; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:18px; margin-bottom:6px;">[[常见问题|❓ 常见问题（FAQ）]]</div>
<div style="color:#5b6472; font-size:13px;">高频问题 / 解决方案 / 最佳实践</div>
</td>
</tr>
</table>


== ✨ 精选专题 ==
<table style="width:100%; border-spacing:12px; border-collapse:separate;">
<tr>
<td style="width:33%; background:#fff; border:1px solid #e9eef8; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:16px;">[[ESP32-C3 开发笔记|ESP32-C3 开发笔记]]</div>
<div style="color:#5b6472; font-size:13px; margin:6px 0 8px;">FreeRTOS 任务、外设驱动、Mesh 与低功耗实践</div>
<div style="font-size:12px; color:#6a778b;">⭐ 持续更新 · 代码片段可复用</div>
</td>
<td style="width:33%; background:#fff; border:1px solid #e9eef8; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:16px;">[[STM32 学习文档|STM32 实战手册]]</div>
<div style="color:#5b6472; font-size:13px; margin:6px 0 8px;">HAL/DMA/中断调度、外设合集、CubeMX 配置范式</div>
<div style="font-size:12px; color:#6a778b;">📎 附示意图与调参表格</div>
</td>
<td style="width:33%; background:#fff; border:1px solid #e9eef8; border-radius:12px; padding:14px; vertical-align:top;">
<div style="font-weight:700; font-size:16px;">[[水族智能设备方案|水族智能设备方案]]</div>
<div style="color:#5b6472; font-size:13px; margin:6px 0 8px;">传感器链路、灯泵控制、告警策略、App 交互规范</div>
<div style="font-size:12px; color:#6a778b;">🔗 关联硬件/前端/运维文档</div>
</td>
</tr>
</table>


== 📰 最近更新 ==
<div style="background:#ffffff; border:1px solid #e9eef8; border-left:4px solid #0b67ff; border-radius:8px; padding:8px 12px; margin:8px 0 14px 0;">
<recentchanges limit="12" />
</div>


== 📦 资源与工具 ==
* [[下载专区|软件下载与驱动]] — 固件、USB 驱动、脚本与工具合集
* [[模板示例|模板与语法示例]] — 页面骨架、信息框、代码块规范
* [https://www.mediawiki.org/wiki/Help:Contents MediaWiki 官方帮助] — 语法/模板/分类/文件上传


== 📊 站点统计 ==
<div style="background:#f8fafc; border:1px dashed #dbe3ef; padding:10px 12px; border-radius:10px;">
<span style="display:inline-block; margin:4px 10px;">📄 词条数：<b>{{NUMBEROFARTICLES}}</b></span>
<span style="display:inline-block; margin:4px 10px;">✍️ 编辑数：<b>{{NUMBEROFEDITS}}</b></span>
<span style="display:inline-block; margin:4px 10px;">👥 用户数：<b>{{NUMBEROFUSERS}}</b></span>
<span style="display:inline-block; margin:4px 10px;">🕒 今日：<b>{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}</b></span>
</div>


<div style="text-align:center; margin-top:18px; padding:18px; background:#f1f4f9; border:1px solid #e6ecf5; border-radius:12px;">
<div style="font-weight:700;">记录 · 复用 · 传承</div>
<div style="color:#5b6472; font-size:12px; margin-top:4px;">本Wiki基于 <b>MediaWiki</b> 构建，专注打造高质量工程知识库。</div>
</div>

0.96inch OLED A

2025-10-02T07:55:04Z

Nichen：

__NOTOC__ __NOEDITSECTION__

= 0.96inch OLED (A) =

<div style="text-align:center;">
https://www.waveshare.com/w/upload/5/5d/0.96inch-OLED-A_l.jpg
</div>

; 型号
: 0.96inch OLED (A)（横/弯脚排针）
; 对应版本
: [https://www.waveshare.com/wiki/0.96inch_OLED_(B) 0.96inch OLED (B)]（竖/直脚排针）
; 驱动芯片
: SSD1306
; 分辨率
: 128×64
; 接口
: 3-wire SPI / 4-wire SPI / I²C
; 默认模式
: 4-wire SPI（出厂默认）

----

== 产品简介 ==
0.96 英寸 OLED 显示模块，内置 SSD1306 驱动，分辨率 128×64。支持 **3 线 SPI、4 线 SPI 与 I²C** 多种通信方式，适配 Raspberry Pi、Arduino、STM32、ESP32、Pico 等主控平台。
A 版为**横/弯脚排针**，B 版为**竖/直脚排针**；电气功能一致，仅排针方向不同。

== 产品参数 ==
* 供电电压：3.3V / 5V
* 通信接口：3-wire SPI / 4-wire SPI / I²C
* 分辨率：128×64
* 显示尺寸：0.96inch
* 显示颜色：上黄下蓝（1/4 黄 + 3/4 蓝）
* 适配平台：Raspberry Pi / Arduino / STM32 / ESP32 / Pico

== 硬件配置与拨阻 ==
<div style="text-align:center;">
https://www.waveshare.com/w/upload/9/93/0.96inch_OLED_Hardware.png
</div>

{| class="wikitable"
! 模式 !! BS1/BS0
|-
| 3-wire SPI || 0 / 1
|-
| 4-wire SPI（默认） || 0 / 0
|-
| I²C || 1 / 0
|}

== 管脚定义（A 版：横/弯脚排针） ==
{| class="wikitable"
! 引脚 !! 名称 !! SPI 功能 !! I²C 功能
|-
| 1 || VCC || 电源正（3.3V/5V） || 电源正（3.3V/5V）
|-
| 2 || GND || 电源地 || 电源地
|-
| 3 || DIN/SDA || SPI MOSI || I²C 数据
|-
| 4 || CLK/SCL || SPI 时钟 || I²C 时钟
|-
| 5 || CS || 片选 || —
|-
| 6 || DC || 数据/命令选择 || （I²C 时可作地址位，接 GND=0x3C）
|-
| 7 || RST || 复位 || 复位
|}

== 接线示例（Raspberry Pi，4-wire SPI） ==
<div style="text-align:center;">
https://www.waveshare.com/w/upload/f/fe/0.96inch_OLED_rpi.png
</div>

; SPI
: MOSI→DIN、SCLK→CLK、CE0→CS、GPIO25→DC、GPIO13→RES、VCC→3.3V、GND→GND
; I²C
: SDA→SDA、SCL→SCL、VCC→3.3V、GND→GND（DC 脚接地则地址 0x3C）

== 示例代码 ==
=== Arduino/ESP32（U8g2） ===
<pre>
#include <U8g2lib.h>
U8G2_SSD1306_128X64_NONAME_F_4W_SW_SPI u8g2(U8G2_R0, SCK, MOSI, CS, DC, RST);
void setup(){ u8g2.begin(); }
void loop(){
u8g2.clearBuffer();
u8g2.setFont(u8g2_font_ncenB08_tr);
u8g2.drawStr(0,12,"Hello OLED!");
u8g2.sendBuffer();
}
</pre>

=== Raspberry Pi（Python：luma.oled，I²C） ===
<pre>
from luma.core.interface.serial import i2c
from luma.oled.device import ssd1306
from PIL import Image, ImageDraw

device = ssd1306(i2c(port=1, address=0x3C))
image = Image.new("1", device.size)
draw = ImageDraw.Draw(image)
draw.text((0,0), "Hello OLED!", fill=255)
device.display(image)
</pre>

== 资料下载 ==
* [https://files.waveshare.com/upload/7/71/0.96inch-OLED-UserManual.pdf 用户手册（PDF）]
* [https://files.waveshare.com/upload/d/dc/0.96inch-OLED-Schematic.pdf 原理图（PDF）]
* [https://files.waveshare.com/upload/e/ec/SDD1306-30pin.pdf SSD1306 数据手册（PDF）]

== 选型 ==
* '''0.96inch OLED (A)'''：横/弯脚排针
* '''0.96inch OLED (B)'''：竖/直脚排针

== 常见问题 ==
; 上电不亮？
: OLED 无背光，需要初始化并刷屏后才会有显示。
; 有残影/烧屏风险吗？
: 长时间显示静态画面会产生残影，建议定期刷新或做屏保。

== 修订记录 ==
* 2025-10-02：初版整理

0.96inch OLED A

2025-10-02T06:38:42Z

Nichen：

__NOTOC__ __NOEDITSECTION__

= 0.96inch OLED (A) =

<div style="text-align:center;">
<img src="https://www.waveshare.com/w/upload/5/5d/0.96inch-OLED-A_l.jpg" alt="0.96inch OLED (A)" width="420" />
</div>

; 型号
: 0.96inch OLED (A)（横/弯脚排针）
; 对应版本
: [https://www.waveshare.com/wiki/0.96inch_OLED_(B) 0.96inch OLED (B)]（竖/直脚排针）
; 驱动芯片
: SSD1306
; 分辨率
: 128×64
; 接口
: 3-wire SPI / 4-wire SPI / I²C
; 默认模式
: 4-wire SPI（出厂默认）

----

== 产品简介 ==
0.96 英寸 OLED 显示模块，内置 SSD1306 驱动，分辨率 128×64。支持 **3 线 SPI、4 线 SPI 与 I²C** 多种通信方式，适配 Raspberry Pi、Arduino、STM32、ESP32、Pico 等主控平台。
A 版为**横/弯脚排针**，B 版为**竖/直脚排针**；电气功能一致，仅排针方向不同。

== 产品参数 ==
* 供电电压：3.3V / 5V
* 通信接口：3-wire SPI / 4-wire SPI / I²C
* 分辨率：128×64
* 显示尺寸：0.96inch
* 显示颜色：上黄下蓝（1/4 黄 + 3/4 蓝）
* 适配平台：Raspberry Pi / Arduino / STM32 / ESP32 / Pico

== 硬件配置与拨阻 ==
<div style="text-align:center;">
<img src="https://www.waveshare.com/w/upload/9/93/0.96inch_OLED_Hardware.png" alt="硬件丝印与拨阻说明" width="520" />
</div>

{| class="wikitable"
! 模式 !! BS1/BS0
|-
| 3-wire SPI || 0 / 1
|-
| 4-wire SPI（默认） || 0 / 0
|-
| I²C || 1 / 0
|}

== 管脚定义（A 版：横/弯脚排针） ==
{| class="wikitable"
! 引脚 !! 名称 !! SPI 功能 !! I²C 功能
|-
| 1 || VCC || 电源正（3.3V/5V） || 电源正（3.3V/5V）
|-
| 2 || GND || 电源地 || 电源地
|-
| 3 || DIN/SDA || SPI MOSI || I²C 数据
|-
| 4 || CLK/SCL || SPI 时钟 || I²C 时钟
|-
| 5 || CS || 片选 || —
|-
| 6 || DC || 数据/命令选择 || （I²C 时可作地址位，接 GND=0x3C）
|-
| 7 || RST || 复位 || 复位
|}

== 接线示例（Raspberry Pi，4-wire SPI） ==
<div style="text-align:center;">
<img src="https://www.waveshare.com/w/upload/f/fe/0.96inch_OLED_rpi.png" alt="树莓派接线示意" width="600" />
</div>

; SPI
: MOSI→DIN、SCLK→CLK、CE0→CS、GPIO25→DC、GPIO13→RES、VCC→3.3V、GND→GND
; I²C
: SDA→SDA、SCL→SCL、VCC→3.3V、GND→GND（DC 脚接地则地址 0x3C）

== 示例代码 ==
=== Arduino/ESP32（U8g2） ===
<pre>
#include <U8g2lib.h>
U8G2_SSD1306_128X64_NONAME_F_4W_SW_SPI u8g2(U8G2_R0, SCK, MOSI, CS, DC, RST);
void setup(){ u8g2.begin(); }
void loop(){
u8g2.clearBuffer();
u8g2.setFont(u8g2_font_ncenB08_tr);
u8g2.drawStr(0,12,"Hello OLED!");
u8g2.sendBuffer();
}
</pre>

=== Raspberry Pi（Python：luma.oled，I²C） ===
<pre>
from luma.core.interface.serial import i2c
from luma.oled.device import ssd1306
from PIL import Image, ImageDraw

device = ssd1306(i2c(port=1, address=0x3C))
image = Image.new("1", device.size)
draw = ImageDraw.Draw(image)
draw.text((0,0), "Hello OLED!", fill=255)
device.display(image)
</pre>

== 资料下载 ==
* [https://files.waveshare.com/upload/7/71/0.96inch-OLED-UserManual.pdf 用户手册（PDF）]
* [https://files.waveshare.com/upload/d/dc/0.96inch-OLED-Schematic.pdf 原理图（PDF）]
* [https://files.waveshare.com/upload/e/ec/SDD1306-30pin.pdf SSD1306 数据手册（PDF）]

== 选型 ==
* '''0.96inch OLED (A)'''：横/弯脚排针
* '''0.96inch OLED (B)'''：竖/直脚排针

== 常见问题 ==
; 上电不亮？
: OLED 无背光，需要初始化并刷屏后才会有显示。
; 有残影/烧屏风险吗？
: 长时间显示静态画面会产生残影，建议定期刷新或做屏保。

== 修订记录 ==
* 2025-10-02：初版整理

0.96inch OLED A

2025-10-02T06:32:58Z

Nichen：

__NOTOC__ __NOEDITSECTION__

= 0.96inch OLED (A) =

[[File:https://www.waveshare.net/w/upload/7/79/0.96inch_OLED_A.jpg|center|420px|thumb|0.96inch OLED (A) 模块示意图]]

; 型号
: 0.96inch OLED (A)（横/弯脚排针）
; 对应版本
: [[https://www.waveshare.net/wiki/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 显示模块，内置 SSD1306/SSD1315 驱动，分辨率 128×64。支持 **3 线 SPI、4 线 SPI 与 I²C** 多种通信方式，适配 Raspberry Pi、Arduino、STM32、ESP32、Pico 等主控平台。
A 版为**横/弯脚排针**，B 版为**竖/直脚排针**；电气功能一致，仅排针方向不同。

== 产品参数 ==
* 供电电压：3.3V / 5V
* 功耗：全亮约 20~30mA
* 显示区域：21.7 mm × 11.2 mm
* 颜色：单色（白/蓝/黄，上黄下蓝）
* 接口模式：SPI/I²C
* 兼容平台：Raspberry Pi / Arduino / STM32 / ESP32 / Pico

== 通信模式与电阻配置 ==
{| class="wikitable"
! 模式 !! 配置示例
|-
| 3-wire SPI || BS1=0 / BS0=1
|-
| 4-wire SPI（默认） || BS1=0 / BS0=0
|-
| I²C || BS1=1 / BS0=0
|}

== 管脚定义（A 版：横/弯脚排针） ==
{| class="wikitable"
! 引脚 !! 名称 !! SPI 功能 !! I²C 功能
|-
| 1 || VCC || 电源正（3.3V/5V） || 电源正（3.3V/5V）
|-
| 2 || GND || 电源地 || 电源地
|-
| 3 || DIN/SDA || SPI MOSI || I²C 数据
|-
| 4 || CLK/SCL || SPI 时钟 || I²C 时钟
|-
| 5 || CS || 片选 || —
|-
| 6 || DC || 数据/命令选择 || —
|-
| 7 || RST || 复位 || 复位
|}

== 接线示例 ==
; SPI
: MOSI→DIN、SCK→CLK、CS→CS、DC→DC、RST→RST、VCC→3.3V/5V、GND→GND
; I²C
: SDA→SDA、SCL→SCL、VCC→3.3V/5V、GND→GND

== 示例代码 ==
=== Arduino/ESP32 (U8g2) ===
<pre>
#include <U8g2lib.h>
U8G2_SSD1306_128X64_NONAME_F_4W_SW_SPI u8g2(U8G2_R0, SCK, MOSI, CS, DC, RST);

void setup() {
u8g2.begin();
}
void loop() {
u8g2.clearBuffer();
u8g2.setFont(u8g2_font_ncenB08_tr);
u8g2.drawStr(0,12,"Hello OLED!");
u8g2.sendBuffer();
}
</pre>

=== Raspberry Pi (Python luma.oled) ===
<pre>
from luma.core.interface.serial import i2c
from luma.oled.device import ssd1306
from PIL import Image, ImageDraw

serial = i2c(port=1, address=0x3C)
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>

== 尺寸图 ==
[[File:https://www.waveshare.net/w/upload/2/23/0.96inch_OLED_Dimension.png|center|520px|thumb|尺寸图]]

== 常见问题 ==
; 上电不亮？
: OLED 无背光，需要初始化才会显示。
; 会不会烧屏？
: 长时间静态画面会产生残影，建议定期刷新。

== 资料下载 ==
* [https://www.waveshare.net/w/upload/f/f9/0.96inch-OLED-UserManual.pdf 用户手册（PDF）]
* [https://www.waveshare.net/w/upload/b/b8/0.96inch-OLED-Schematic.pdf 原理图（PDF）]
* [https://www.waveshare.net/w/upload/9/9f/0.96inch-OLED-Arduino.zip Arduino 例程]
* [https://www.waveshare.net/w/upload/8/86/0.96inch-OLED-RaspberryPi.zip Raspberry Pi 例程]
* [https://www.waveshare.net/w/upload/3/3d/0.96inch-OLED-STM32.zip STM32 例程]
* [https://www.waveshare.net/w/upload/7/7e/0.96inch-OLED-Pico.zip Pico 例程]

== 选型 ==
* '''0.96inch OLED (A)'''：横/弯脚排针
* '''0.96inch OLED (B)'''：竖/直脚排针

== 修订记录 ==
* 2025-10-02：初版整理

0.96inch OLED A

2025-10-02T06:26:35Z

Nichen：创建页面，内容为“ __NOTOC__ __NOEDITSECTION__ = 0.96inch OLED (A) = File:0.96inch_OLED_A.jpg|center|420px|thumb|0…”

__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：补充通信模式电阻、尺寸图与示例代码链接

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

Vlen socket v600

2025-10-02T05:36:53Z

Nichen：创建页面，内容为“= VLen六路水族排插 - 机智云WiFi类设备接入协议文档（MCU方案） = ; 产品名称 : VLen六路水族排插 ; 产品类型 : 电工/排插/自定义多路排插 ; 生成日期 : 2023-06-20 本页为 MCU 与 WiFi 通讯模组的串口通讯协议（机智云标准接入协议 v4.3.1）的 **单页 MediaWiki** 版。完整覆盖 1~4 章，字段逐条展开，并在各命令下以表格列出“字段名 / 字节长度 / 说明”。 == 1. 设…”

= VLen六路水族排插 - 机智云WiFi类设备接入协议文档（MCU方案） =
; 产品名称 : VLen六路水族排插
; 产品类型 : 电工/排插/自定义多路排插
; 生成日期 : 2023-06-20

本页为 MCU 与 WiFi 通讯模组的串口通讯协议（机智云标准接入协议 v4.3.1）的 **单页 MediaWiki** 版。完整覆盖 1~4 章，字段逐条展开，并在各命令下以表格列出“字段名 / 字节长度 / 说明”。

== 1. 设备通讯信息 ==
* 通讯方式：UART
* 波特率：9600
* 数据位：8
* 奇偶校验：无
* 停止位：1
* 数据流控：无
* 供电：3.3V，电流（Max）150 mA

== 2. 约定 ==
=== 2.1 传输字节序 ===
默认采用 **大端** 编码（高字节在前，低字节在后）。

=== 2.2 通信交互形式 ===
* 采用 **一问一答**；每条命令需要接收方给出 ACK 确认；
* 超时时间 **200 ms**，超时后重发；最多 **重发 3 次**；其后丢弃该包。

=== 2.3 协议格式 ===
==== 指令总体结构 ====
* 包头（2B）= `0xFFFF`。注意：**非包头部分**如出现 `0xFF`，发送方需在其后**插入** `0x55`；接收方检测到非包头的 `0xFF 55` 需要**移除**该 `0x55`。该填充字节**不计入**包长度及校验和。
* 包长度（2B）：**从命令开始**至**校验和**的字节数（含命令与校验和）。
* 命令（1B）。
* 包序号 SN（1B）：由发起方给出，自 0 递增，超过 255 后回绕；ACK 回复需回填收到的 SN。
* Flags（2B）：高字节为**通用标记**（跨命令），低字节为**命令内私有标记**（仅本命令意义）。
* 有效负载：由产品数据点/业务定义。
* 校验和（1B）：对 **[包长度…有效负载]** 做逐字节求和，再取 **mod 256**。

== 3. 基本通讯协议（必须） ==

=== 3.1 获取设备信息 ===
WiFi 模组上电后向 MCU 查询设备信息，成功后方可正常工作。

==== WiFi → MCU（请求） ====
{| class="wikitable"
! 序号 !! 字段名称 !! 长度（B） !! 内容说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x01
|-
| 4 || 包序号 || 1 || 0x##
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || 校验和 || 1 || 0x##
|}

==== MCU → WiFi（应答） ====
{| class="wikitable"
! # !! 字段名称 !! 长度（B） !! 说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x02
|-
| 4 || 包序号 || 1 || 回填请求 SN
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || 通用串口协议版本号 || 8 || 字符串，如 “00000004”
|-
| 7 || 业务协议版本号 || 8 || 字符串，如 “00000002”
|-
| 8 || 硬件版本号 || 8 || 字符串
|-
| 9 || 软件版本号 || 8 || 字符串
|-
| 10 || 产品标识码 ProductKey || 32 || 字符串
|-
| 11 || 可绑定状态失效时间 || 2 || 秒（大端）。0=随时可绑定；>0 为进入可绑定后的失效秒数
|-
| 12 || 设备属性 attributes || 8 || bit0…bit63 定义（见下）
|-
| 13 || 产品秘钥 ProductSecret || 32 || Hex 字符串
|-
| 14 || DataLen || 2 || 环境参数长度；0=无 Data
|-
| 15 || Data || DataLen || 环境参数字符串（键值对，见下）
|-
| 16 || 校验和 || 1 || 0x##
|}

; 设备属性 attributes（bit0→bit63，自右向左）
* bit0=1：设备是**中控**；
* bit1=1：**自动化生成代码**；
* bit2~bit5（当 bit0=1 生效）：中控重置范围：
** 0000：中控重置
** 0001：中控重置 + **所有子设备**重置
** 0010：中控重置 + **所有子设备与用户绑定关系**
** 0011：中控重置 + **部分子设备**重置（与该中控有关联的子设备）
** 0100：**所有子设备**重置
** 0101：**所有子设备与用户绑定关系**
** 0110：**部分子设备**重置
** 0111：**部分子设备与用户绑定关系**
* bit6=1：UDP **加密**；
* bit7=1：**变长数据点**；
* bit8=1：设备是**网关**；
* bit9~bit12（当 bit8=1 生效）：网关重置范围：
** 0000：网关重置
** 0001：网关重置 + 所有子设备重置
** 0010：所有子设备重置
* bit13=1：**低功耗**产品；
* bit14~bit63：**预留**（保持 0 以免影响云端连接）。

; 环境参数 Data（key=value，用‘&’连接；示例：
"wechatId=...&server=...&port=...&apName=...&apPwd=...&m2mKeepAL=...&m2mHT=...&tz=...&LocalHT=...&LocalAckT=...&nwcName=...&cfgMode=...&tScanNum=...&tCon=...&runMode=..."）
# wechatId：设备微信设备公众号 ID
# server：默认服务器域名
# port：默认服务器端口
# apName：SoftAP 热点名，**后缀追加 4 位 MAC**
# apName0：SoftAP 热点名，**不追加 MAC**
# apPwd：SoftAP 热点密码；为空=Open
# m2mKeepAL：M2M keepalive 秒
# m2mHT：M2M 心跳秒
# tz：默认时区
# LocalHT：串口心跳秒
# LocalAckT：串口等待 ACK 基础时间（毫秒）
# nwcName：网卡名，例 "eth0"
# cfgMode：初始化运行模式（1=SoftAP，2=AirLink）
# tScanNum：初始化扫描热点次数（默认 2）
# tCon：产测是否连路由（0=否，1=是（默认））
# runMode：运行模式（1=单通道（默认）；2=双通道，如 Wi‑Fi+BLE/4G+BLE）

----

=== 3.2 WiFi 模组控制设备 ===
WiFi → MCU，命令 `0x03`，`action=0x11`；MCU 回复 `0x04`（ACK）。

==== 帧格式 ====
{| class="wikitable"
! # !! 字段 !! 长度（B） !! 说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x03
|-
| 4 || 包序号 || 1 || 0x##
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || action || 1 || 0x11
|-
| 7 || attr_flags || 6 || **是否设置标志位位图**（见下）
|-
| 8 || attr_vals || Max 249 || **按位顺序紧凑排列**的数据值（见下）
|-
| 9 || 校验和 || 1 || 0x##
|}

; 规则
* `attr_flags` 中**某位=1**，表示 `attr_vals` 中**对应字段**的**数值存在且有效**；为 0 表示该字段**忽略**。
* `attr_vals` 的字段顺序与 `attr_flags` 的位定义一一对应，按**从低位到高位**、从**bool → 标量 → binary** 的**固定顺序**连续排列。

==== attr_flags 位定义（共 48 位，bit0→bit47） ====
{| class="wikitable"
! 位 !! 字段 !! 类型 / 说明
|-
| bit0 || switch_1 || bool（开关 1）
|-
| bit1 || switch_2 || bool（开关 2）
|-
| bit2 || switch_3 || bool（开关 3）
|-
| bit3 || switch_4 || bool（开关 4）
|-
| bit4 || switch_5 || bool（开关 5）
|-
| bit5 || switch_6 || bool（开关 6）
|-
| bit6 || power || bool（总电源）
|-
| bit7 || High_temperature_alarm || bool
|-
| bit8 || Low_temperature_alarm || bool
|-
| bit9 || High_Humidity_alarm || bool
|-
| bit10 || Low_Humidity_alarm || bool
|-
| bit11 || High_tds_alarm || bool
|-
| bit12 || Low_tds_alarm || bool
|-
| bit13 || High_ph_alarm || bool
|-
| bit14 || Low_ph_alarm || bool
|-
| bit15 || humidity || uint8（0..100，y=1*x+0）
|-
| bit16 || ph_value || uint8（0..140，**y=0.1*x**）
|-
| bit17 || switch_mode_1 || uint8（0..10）
|-
| bit18 || switch_mode_2 || uint8（0..10）
|-
| bit19 || switch_mode_3 || uint8（0..10）
|-
| bit20 || switch_mode_4 || uint8（0..10）
|-
| bit21 || switch_mode_5 || uint8（0..10）
|-
| bit22 || switch_mode_6 || uint8（0..10）
|-
| bit23 || Temperature_alarm_max || uint8（0..100）
|-
| bit24 || Temperature_alarm_min || uint8（0..100）
|-
| bit25 || Humidity_alarm_max || uint8（0..100）
|-
| bit26 || Humidity_alarm_min || uint8（0..100）
|-
| bit27 || ph_alarm_max || uint8（0..140，y=0.1*x）
|-
| bit28 || ph_alarm_min || uint8（0..140，y=0.1*x）
|-
| bit29 || temp_current_1 || uint16（0..1200，**y=1*x-200**）
|-
| bit30 || temp_current_2 || uint16（0..1200，**y=1*x-200**）
|-
| bit31 || Total_dissolved_solids || uint16（0..5000）
|-
| bit32 || current_voltage || uint16（0..5000）
|-
| bit33 || Current_power || uint16（0..10000）
|-
| bit34 || tds_alarm_max || uint16（0..5000）
|-
| bit35 || tds_alarm_min || uint16（0..5000）
|-
| bit36 || urt_value || uint32（0..600000）
|-
| bit37 || Current_current || uint32（0..100000）
|-
| bit38 || cur_timestamp || uint32（Unix 秒）
|-
| bit39 || cycle_mode_set || binary（24B，数组 [1,2,3…]）
|-
| bit40 || temperature_mode_set || binary（12B）
|-
| bit41 || humidity_mode_set || binary（12B）
|-
| bit42 || time_mode_set_1 || binary（30B）
|-
| bit43 || time_mode_set_2 || binary（30B）
|-
| bit44 || time_mode_set_3 || binary（30B）
|-
| bit45 || time_mode_set_4 || binary（30B）
|-
| bit46 || time_mode_set_5 || binary（30B）
|-
| bit47 || time_mode_set_6 || binary（30B）
|}

; attr_vals 编码顺序与示例（节选）
* bool 组合位（byte0）：`switch_1…switch_6` + `power` + 各报警位，**bit0→bit7**；
* 接着是 `switch_mode_1…6`（6×uint8）→ `Temperature_alarm_max/min`（2×uint8）→ `Humidity_alarm_max/min`（2×uint8）→ `ph_alarm_max/min`（2×uint8，y=0.1x）→ `tds_alarm_max/min`（2×uint16）→ `cur_timestamp`（uint32）→ `cycle/temperature/humidity_mode_set`（binary）→ `time_mode_set_1…6`（各 30B）。

==== MCU → WiFi（ACK） ====
{| class="wikitable"
! # !! 字段 !! 长度（B） !! 说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x04
|-
| 4 || 包序号 || 1 || 回填请求 SN
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || 校验和 || 1 || 0x##
|}

; 实施建议
* 无论状态是否改变，**执行控制后建议立即上报一次**最新设备状态（参见 3.4 上报）。

----

=== 3.3 WiFi 模组读取设备的当前状态 ===
WiFi → MCU：命令 `0x03`，`action=0x12`；MCU → WiFi：命令 `0x04`，`action=0x13`。

==== 请求 ====
{| class="wikitable"
! # !! 字段 !! 长度（B） !! 说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x03
|-
| 4 || 包序号 || 1 || 0x##
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || action || 1 || 0x12
|-
| 7 || attr_flags || 6 || 与控制命令一致（筛选需要返回的状态）
|-
| 8 || 校验和 || 1 || 0x##
|}

==== 应答（含 dev_status） ====
{| class="wikitable"
! # !! 字段 !! 长度（B） !! 说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x04
|-
| 4 || 包序号 || 1 || 0x##
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || action || 1 || 0x13
|-
| 7 || attr_flags || 6 || 与控制命令一致
|-
| 8 || dev_status || Max 270 || **设备状态**（字段顺序/类型与 3.2 对应）
|-
| 9 || 校验和 || 1 || 0x##
|}

; dev_status 字段说明
* 位/字段定义与 3.2 `attr_flags` 一致，**编码顺序**与 3.2 的 `attr_vals` 相同；
* 定标公式：同 3.2 中各字段（例如 `ph_value`、`ph_alarm_*` 为 0.1x；温度 current_* 为 1*x-200）。

----

=== 3.4 设备 MCU 主动上报当前状态 ===
MCU → WiFi：命令 `0x05`，`action=0x14`，负载为 `dev_status`。

{| class="wikitable"
! # !! 字段 !! 长度（B） !! 说明
|-
| 1 || 固定包头 || 2 || 0xFFFF
|-
| 2 || 包长度 || 2 || len(命令…校验和)
|-
| 3 || 命令 || 1 || 0x05
|-
| 4 || 包序号 || 1 || 0x##
|-
| 5 || flags || 2 || 0x0000
|-
| 6 || action || 1 || 0x14
|-
| 7 || attr_flags || 6 || 按需设置（哪些状态有效即置位）
|-
| 8 || dev_status || Max 270 || 状态体（字段/顺序同 3.2/3.3）
|-
| 9 || 校验和 || 1 || 0x##
|}

; 上报策略（建议）
* 接收到“控制设备”命令后，**立即上报**被控制后的数据点组合；
* 因用户手动或环境变化导致设备状态改变时，仅上报**发生变化**的数据点组合；
* 可设置**定期上报**（例如每 10 分钟一次）。

----

=== 3.5 心跳 ===
* WiFi → MCU：`0x07`；MCU → WiFi：`0x08`。

=== 3.6 通知 WiFi 模组进入配置模式 ===
* 命令：`0x09`（请求）/ `0x0A`（应答）；支持 SoftAP / AirLink / BLE 等。

=== 3.7 重置 WiFi 模组 ===
* 命令：`0x0B`（请求）/ `0x0C`（应答）；清除 SSID/密码/DID/Passcode，恢复出厂。

=== 3.8 推送 WiFi 模组工作状态 ===
* 命令：`0x0D`（WiFi 状态上报）/ `0x0E`（ACK）；状态包含 SoftAP/Station/Onboarding/绑定状态/RSSI/蓝牙模式等。

=== 3.9 非法数据包通知 ===
* 命令：`0x11`（WiFi→MCU）/ `0x12`（MCU→WiFi）；
* 错误码：1=校验和错误；2=命令不可识别；3=其他错误；4=文件类型不匹配。

=== 3.10 MCU 通知 WiFi 模组进入可绑定模式 ===
* 命令：`0x15`（请求）/ `0x16`（应答）；倒计时（可绑定失效秒）见 3.1 字段。

=== 3.11 MCU 重启通讯模组 ===
* 命令：`0x29`（请求）/ `0x2A`（应答）；ACK 成功后模组再重启。

== 4. 扩展通讯协议（可选） ==

=== 4.1 重启 MCU ===
* WiFi → MCU：`0x0F`（请求）；MCU → WiFi：`0x10`（应答）。
* 注意：MCU **在回复 ACK 后等待 ~600 ms** 再重启，避免 WiFi 端未收到 ACK 而重复请求。

=== 4.2 MCU 请求 WiFi 模组进入产测模式 ===
* MCU → WiFi：`0x13`；WiFi → MCU：`0x14`。

=== 4.3 MCU 请求获取网络时间 ===
* MCU → WiFi：`0x17`；WiFi → MCU：`0x18`（返回本地时区时间 + NTP 秒）。
{| class="wikitable"
! 字段 !! 长度（B） !! 说明
|-
| year || 2 || 年（大端），如 2015
|-
| month || 1 || 月
|-
| day || 1 || 日
|-
| hour || 1 || 时
|-
| minute || 1 || 分
|-
| second || 1 || 秒
|-
| ntp || 4 || NTP 秒计数
|}

=== 4.4 大数据下发：发起者请求 ===
* WiFi → MCU：`0x19`；MCU → WiFi：`0x1A`。
负载含：**数据大小**、**文件类型**、**MD5**。

=== 4.5 大数据下发：接收者确认 ===
* MCU → WiFi：`0x1B`；WiFi → MCU：`0x1C`。
负载含：**分片大小**（建议 128B）。

=== 4.6 大数据下发：分片传输 ===
* WiFi → MCU：`0x1D`；MCU → WiFi：`0x1E`。
{| class="wikitable"
! 字段 !! 长度（B） !! 说明
|-
| total_packets || 2 || 总分片数
|-
| packet_index || 2 || 当前分片号（0 起）
|-
| data || N || 分片数据
|}
* Flags.bit1 = 1 表示**最后一包**。

=== 4.7 大数据下发：发起者取消 ===
* WiFi → MCU：`0x1F`；MCU → WiFi：`0x20`。

=== 4.8 大数据下发：接收者取消 ===
* MCU → WiFi：`0x27`；WiFi → MCU：`0x28`。

=== 4.9 MCU 获取通讯模组信息 ===
* MCU → WiFi：`0x21`；WiFi → MCU：`0x22`。
{| class="wikitable"
! # !! 字段 !! 长度（B） !! 说明
|-
| 1 || module_type || 8 || 模组类型（字符串）
|-
| 2 || protocol_version || 8 || 协议版本（字符串）
|-
| 3 || hardware_version || 8 || 硬件版本（字符串）
|-
| 4 || software_version || 8 || 软件版本（字符串）
|-
| 5 || mac || max 13 || 以 '\\0' 结尾的字符串，例如 "5CF9388AE8F0\\0"
|-
| 6 || ip || max 16 || 以 '\\0' 结尾的字符串，例如 "192.168.100.254\\0"
|-
| 7 || attributes || 8 || 模组属性（预留）
|-
| 8 || 校验和 || 1 || 0x##
|}

== A. 附录：数据点/字段的缩放与边界 ==
* `ph_value`、`ph_alarm_*`：**y=0.1*x**；
* `temp_current_1/2`：**y=1*x-200**（原始 0..1200）；
* `humidity`、`Temperature/Humidity_alarm_*`：**y=1*x+0**；
* `Total_dissolved_solids`、`tds_alarm_*`：uint16（0..5000）；
* `current_voltage`：uint16（0..5000）；`Current_power`：uint16（0..10000）；
* `urt_value`：uint32（0..600000）；`Current_current`：uint32（0..100000）；
* `cur_timestamp`：uint32（Unix 秒）。

== B. 附录：布尔组合位（byte0）编码 ==
* bit0…bit5 = `switch_1…switch_6`；bit6=`power`；bit7..bit14=各报警位（高温/低温/高湿/低湿/高 TDS/低 TDS/高 pH/低 pH）。

[[Category:协议文档]]
[[Category:水族智能设备]]

ESP32-S3-Touch-LCD-4.3

2025-10-02T04:53:39Z

Nichen：创建页面，内容为“= ESP32-S3-Touch-LCD-4.3 = __TOC__ 本页为 ESP32-S3-Touch-LCD-4.3 的本地维护文档，按照官方 Wiki 的信息结构梳理：功能概览、示例运行、固件烧录与擦除、资料下载、FAQ 等，便于在本地持续更新与二次开发。页面结构参考官方条目。 == 产品概览 == * MCU：ESP32-S3 双核 LX7，支持 2.4GHz Wi-Fi 与 BLE 5 * 存储：常见 16MB Flash / 8MB PSRAM（以实物丝印为准） * 显示：4.3" RGB LC…”

= ESP32-S3-Touch-LCD-4.3 =

__TOC__

本页为 ESP32-S3-Touch-LCD-4.3 的本地维护文档，按照官方 Wiki 的信息结构梳理：功能概览、示例运行、固件烧录与擦除、资料下载、FAQ 等，便于在本地持续更新与二次开发。页面结构参考官方条目。

== 产品概览 ==
* MCU：ESP32-S3 双核 LX7，支持 2.4GHz Wi-Fi 与 BLE 5
* 存储：常见 16MB Flash / 8MB PSRAM（以实物丝印为准）
* 显示：4.3" RGB LCD，800×480 分辨率；电容触摸（常见 GT911，I²C）
* 接口：CAN、I²C、RS485、UART 等
* 适配：Arduino / ESP-IDF，适合运行 LVGL 等 GUI
* 应用：HMI、信息看板、控制面板、教学实验
（页面结构参照官方 Wiki 的“概述/特性/演示/资料/FAQ”布局。） :contentReference[oaicite:1]{index=1}

== 示例演示（结果展示） ==
* 提供示例工程用于验证 LCD/触摸/存储等功能；烧录后复位即可看到界面演示。
* 示例包含对 TF 卡（MicroSD）的识别与基本文件操作（创建/删除/读写/查询）等演示。
* 若需进一步提升帧率，可按官方建议优化显示时序、刷新方式与 DMA/双缓冲等参数。 :contentReference[oaicite:2]{index=2}

== 快速上手 ==
=== Arduino 路线 ===
* 安装 ESP32 开发板支持包；选择 S3 系列目标板。
* 依示例需要安装 LVGL 与显示/触摸相关库（如 Arduino_GFX/TFT_eSPI、GT911 等）。
* 在 Tools 菜单正确设置 Flash（如 16MB）与 PSRAM（如 8MB OPI），否则可能编译通过但黑屏。 :contentReference[oaicite:3]{index=3}

<pre>
/* Arduino + LVGL 最小化示例（需先完成屏与触摸初始化） */
#include <lvgl.h>
void setup(){
lv_init();
lv_obj_t* label = lv_label_create(lv_scr_act());
lv_label_set_text(label, "Hello ESP32-S3 4.3\"");
lv_obj_center(label);
}
void loop(){ lv_timer_handler(); delay(5); }
</pre>

=== ESP-IDF 路线 ===
* 获取示例工程，设置目标为 esp32s3，按需在 menuconfig 中选择屏幕/触摸/LVGL/PSRAM 等配置。 :contentReference[oaicite:4]{index=4}
<pre>
git clone https://github.com/waveshare/esp32-s3-touch-lcd-4.3.git
cd esp32-s3-touch-lcd-4.3
idf.py set-target esp32s3
idf.py menuconfig
idf.py build
idf.py -p /dev/ttyUSB0 flash monitor
</pre>

* 触摸控制可通过工程中的宏/配置开关启用或关闭（示例名以实际工程为准）。 :contentReference[oaicite:5]{index=5}
<pre>
/* 示例宏（以工程实际为准） */
#define CONFIG_EXAMPLE_LCD_TOUCH_CONTROLLER_GT911 1 /* 1 开启触摸，0 关闭触摸 */
</pre>

== 固件烧录与擦除 ==
* 官方示例通常附带测试固件（BIN），用于快速验证板载功能是否正常。
* BIN 文件一般位于示例工程的 Firmware 目录；也可使用 idf.py 或 esptool.py 手动烧录。
* 进入下载模式：断电后按住 BOOT 并插入 USB，上电后松开。 :contentReference[oaicite:6]{index=6}

<pre>
idf.py -p /dev/ttyUSB0 erase-flash
idf.py -p /dev/ttyUSB0 flash
</pre>

== 资料 ==
=== 原理图 / 工程图纸 ===
* 原理图（按具体版本选择，例如 4.3B）：（在此添加你上传的本地文件或官方链接）
- 例：[[File:ESP32-S3-Touch-LCD-4.3B-Sch.pdf]]（或使用官方下载链接）
=== 示例程序 ===
* 官方示例工程（ESP-IDF / LVGL 等，详见官方资料区）
=== 数据手册（ESP32-S3 系列） ===
* 数据手册、技术参考手册、模组手册（按需要列出中/英版本）
=== 其他资料链接 ===
* Arduino 官方文档、ESP-IDF 官方资料、LVGL 文档等（按需补充）
（以上分节与标题对应官方页面的“资料/原理图/示例程序/数据手册/其他资料链接”。） :contentReference[oaicite:7]{index=7}

== 常见问题（FAQ） ==
; 电脑接入后未识别到串口
: 按住 BOOT 重新上电进入下载模式；检查 USB 线是否为数据线。 :contentReference[oaicite:8]{index=8}

; CAN 接收异常
: 重启上位机串口工具并多次复位板卡；部分串口工具需取消 “DTR” 勾选。 :contentReference[oaicite:9]{index=9}

; 烧录 Arduino RGB 屏程序后黑屏
: 检查是否在 Arduino IDE 的 Tools 中正确设置了 Flash/PSRAM，并确认依赖库已完整安装。 :contentReference[oaicite:10]{index=10}

; Arduino 编译报缺少 LVGL 头文件
: 可能是库安装路径含中文导致检索失败，建议使用无空格/英文路径。 :contentReference[oaicite:11]{index=11}

; 成功烧录但仍无显示
: 参考官方给出的显示/触摸驱动与帧率优化建议，校准显示时序与极性，必要时启用双缓冲/DMA。 :contentReference[oaicite:12]{index=12}

== 版本记录 ==
* 2025-10-02：按官方页面结构创建本地可编辑条目骨架并完成内容重述。