ssd1106 micropython

### 使用 MicroPython 驱动 SSD1306 OLED 显示屏

对于使用 MicroPython 驱动 SSD1306 OLED 显示屏，通常会采用 `micropython-ssd1306` 库来实现基本功能。此库支持通过 I2C 或 SPI 接口连接到微控制器，并提供了多种方法用于绘制图形和文本。

#### 安装 ssd1306 库
为了能够正常使用该库，在 Thonny IDE 中可以通过以下命令安装来自 PyPI 的最新版本：

import upip
upip.install('micropython-ssd1306')

这将自动下载并安装所需的依赖项[^1]。

#### 初始化 OLED 屏幕
初始化 OLED 屏幕涉及设置通信接口参数以及创建相应的对象实例。下面是一个简单的例子展示如何配置一个基于 I2C 协议的 128x64 分辨率显示器：

from machine import Pin, I2C
from ssd1306 import SSD1306_I2C

# 设置I2C总线上的SCL和SDA引脚编号
i2c = I2C(scl=Pin(22), sda=Pin(21))
oled = SSD1306_I2C(128, 64, i2c)

# 清除屏幕内容
oled.fill(0)
oled.show()

这段代码首先定义了一个新的 I2C 对象，指定了 SCL 和 SDA 引脚的位置；接着利用这些信息构建了 `SSD1306_I2C` 类的一个新实例，代表实际硬件设备；最后调用了两个方法清除现有画面并将更改同步至物理屏幕上[^4]。

#### 绘制简单图案与文字
一旦成功建立了与显示屏之间的联系，则可以进一步探索更多有趣的功能，比如打印字符串或者绘画几何形状等操作。这里给出一段示范性的程序片段用来说明怎样完成上述任务：

def draw_text_and_shapes():
    oled.text('Hello World!', 0, 0)       # 在坐标 (0, 0) 处写入 "Hello World!"
    
    # 创建framebuffer缓冲区以便更高效地渲染复杂图像
    from framebuf import FrameBuffer, GS4_HMSB
    
    buffer_width = 128                    # 缓冲区宽度等于屏幕分辨率宽
    buffer_height = 64                   # 缓冲区高度等于屏幕分辨率高
    buf = bytearray(buffer_width * buffer_height // 8)     # 计算所需字节数组大小
    fb = FrameBuffer(buf, buffer_width, buffer_height, GS4_HMSB)   # 构建FrameBuffer对象
    
    # 向帧缓存中添加一些额外的内容...
    fb.line(0, 0, 127, 63, 1)            # 连接左上角到右下角的一条直线
    fb.rect(5, 5, 20, 20, 1)             # 边框矩形位于靠近顶部左侧位置
    fb.fill_rect(30, 30, 20, 20, 1)      # 实心矩形放置于中间偏下方区域
    
    # 将所有修改应用回原始显示表面
    oled.blit(fb, 0, 0)
    oled.show()

draw_text_and_shapes()

以上代码不仅展示了基础的文字输出方式，还引入了 `framebuf` 模块中的类来进行更加复杂的绘图工作。值得注意的是，当涉及到大量数据更新时，先在一个独立的工作空间内预处理好最终要呈现的画面再一次性提交给目标器件往往能带来更好的性能表现[^2]。