【亲测免费】 SH1106 OLED驱动项目使用教程

1. 项目的目录结构及介绍

SH1106/
├── LICENSE
├── README.md
├── sh1106.py

目录文件介绍

• LICENSE: 项目许可证文件，说明了项目的开源协议和使用权限。
• README.md: 项目说明文件，包含了项目的基本介绍、功能、使用方法等信息。
• sh1106.py: 主要的驱动代码文件，包含了SH1106 OLED控制器的MicroPython驱动实现。

2. 项目的启动文件介绍

项目的启动文件主要是sh1106.py，这个文件包含了驱动SH1106 OLED显示器的所有必要代码。以下是该文件的主要组成部分：

类定义

• SH1106: 基础类，提供通用的显示控制方法。
• SH1106_I2C: 继承自SH1106，用于通过I2C接口控制显示器。
• SH1106_SPI: 继承自SH1106，用于通过SPI接口控制显示器。

方法介绍

• init_display(): 初始化显示器，清屏并显示空白屏幕。
• power_on() 和 power_off(): 控制显示器的电源状态。
• sleep(state): 控制显示器的休眠状态。
• contrast(level): 设置显示器的对比度（亮度）。
• invert(flag): 反转显示内容。
• flip([flag=None[, update=True]]): 旋转显示内容180度。
• show(): 将帧缓冲区的内容显示在屏幕上。

3. 项目的配置文件介绍

该项目没有独立的配置文件，所有的配置参数都在sh1106.py文件中的类构造函数中进行设置。以下是主要配置参数：

I2C接口配置

display = sh1106.SH1106_I2C(width, height, i2c, reset, address, rotate=0, delay=0)

• width: 显示器的宽度。
• height: 显示器的高度。
• i2c: I2C对象，需事先创建，指定SDA和SCL端口。
• reset: 复位GPIO引脚对象，如果不需要可以设置为None。
• address: I2C地址，默认为0x3c。
• rotate: 显示内容旋转角度，默认为0。
• delay: 上电延迟时间（毫秒），默认为0。

SPI接口配置

display = sh1106.SH1106_SPI(width, height, spi, dc, res, cs, rotate=0, delay=0)

• width: 显示器的宽度。
• height: 显示器的高度。
• spi: SPI对象，需事先创建，指定SCLK和MOSI端口。
• dc: 数据/命令选择GPIO引脚对象。
• res: 复位GPIO引脚对象，如果不需要可以设置为None。
• cs: 片选GPIO引脚对象，如果不需要可以设置为None。
• rotate: 显示内容旋转角度，默认为0。
• delay: 上电延迟时间（毫秒），默认为0。

通过以上配置参数，用户可以根据自己的硬件连接情况进行相应的设置。

希望这份教程能帮助您顺利使用SH1106 OLED驱动项目。如有更多问题，请参考项目的官方GitHub仓库。