在智能硬件项目中，显示屏通常承担“设备表达能力”的角色。传感器采集到的数据、系统运行状态、任务执行进度、异常提示信息，如果只能停留在串口日志里，调试和展示都会受到限制。OLED 屏幕的价值就在于把程序内部状态直接显示到硬件界面上，让代码运行过程变成可观察、可交互、可演示的结果。
本实验使用 CanMV K210 开发板通过 I2C 总线驱动 SSD1306 OLED 屏幕，实现 128x64 分辨率下的综合显示效果。程序完成了 OLED 初始化、文本显示、居中文本、进度条绘制、状态面板展示、模拟传感器数据显示和滚动提示信息等功能。代码中的温度、湿度和光照数据为程序模拟生成，不是来自真实传感器，但整体结构已经接近智能硬件状态面板的基础形态。
| 学习目标 | 说明 |
|---|---|
| 理解 OLED 显示链路 | 掌握程序、显存缓冲区、I2C 总线和 OLED 屏幕之间的关系 |
| 掌握 SSD1306 基础驱动 | 学会通过初始化命令、显示数据和刷新函数控制 OLED |
| 理解 FrameBuffer 绘图 | 使用framebuf绘制文本、线条、矩形、填充区域和进度条 |
| 完成状态面板显示 | 将模拟温度、湿度、光照和系统状态显示到 OLED 屏幕 |
| 建立界面封装思路 | 把底层驱动、基础绘图和页面显示分层组织，便于后续扩展 |
文章目录
- 理论基础
- 硬件设施
- 软件代码
- 扩展应用
- 总结
理论基础
OLED 显示屏和 LED、蜂鸣器这类简单输出模块不同。LED 通常只需要一个高低电平就能表现亮灭状态，而 OLED 需要接收显示命令和显存数据，才能在指定位置显示文字或图形。本实验使用的 SSD1306 OLED 屏幕分辨率为 128x64，程序需要先在内存中准备一块显示缓冲区，再通过 I2C 总线把缓冲区内容发送到屏幕。
I2C 通信可以理解成 CanMV K210 和 OLED 之间的一条数据通道。SCL 负责通信节拍，SDA 负责传输数据内容，设备地址用于区分总线上的不同设备。当前代码中 OLED 地址设置为0x3C，SCL 使用 IO6，SDA 使用 IO7。程序通过这个地址向 SSD1306 发送初始化命令、地址范围命令和显示数据。
OLED 的显示过程并不是“调用text()后立刻出现在屏幕上”。代码中的文字、线条和矩形会先被绘制到buffer缓冲区里，framebuf负责在这块内存区域中完成图形操作，最后由show()把整块缓冲区发送到 OLED。这个过程类似先在内存中准备一张画面，再统一刷新到屏幕。
