Adafruit CircuitPython SSD1306 项目教程

Adafruit CircuitPython SSD1306 项目教程

Adafruit_CircuitPython_SSD1306Adafruit CircuitPython framebuf driver for SSD1306 or SSD1305 OLED displays. Not for use with displayio. See README.项目地址:https://gitcode.com/gh_mirrors/ad/Adafruit_CircuitPython_SSD1306

项目介绍

Adafruit CircuitPython SSD1306 是一个用于 SSD1306 或 SSD1305 OLED 显示器的 CircuitPython 框架缓冲驱动程序。该项目实现了 adafruit_framebuf 接口，并且不适用于 displayio。对于 displayio 支持，请参阅 Adafruit CircuitPython DisplayIO SSD1306 驱动程序。

主要特点

• 支持 SSD1306 和 SSD1305 OLED 显示器
• 实现 adafruit_framebuf 接口
• 不适用于 displayio

依赖项

• Adafruit CircuitPython Bus Device
• Adafruit framebuf

项目快速启动

安装

系统级安装

sudo pip3 install adafruit-circuitpython-ssd1306

虚拟环境安装

mkdir project-name && cd project-name
python3 -m venv venv
source venv/bin/activate
pip3 install adafruit-circuitpython-ssd1306

基本使用示例

# 导入必要的模块
from board import SCL, SDA
import busio
import adafruit_ssd1306

# 创建 I2C 接口
i2c = busio.I2C(SCL, SDA)

# 创建 SSD1306 OLED 类
oled = adafruit_ssd1306.SSD1306_I2C(128, 64, i2c)

# 清除显示
oled.fill(0)
oled.show()

# 在屏幕上绘制像素
oled.pixel(64, 32, 1)
oled.show()

应用案例和最佳实践

显示系统统计信息

一个常见的应用案例是使用 SSD1306 OLED 显示器来显示系统统计信息，如 CPU 使用率、内存使用情况等。以下是一个简单的示例：

import time
import subprocess
import adafruit_ssd1306
from board import SCL, SDA
import busio

# 创建 I2C 接口和 OLED 对象
i2c = busio.I2C(SCL, SDA)
oled = adafruit_ssd1306.SSD1306_I2C(128, 64, i2c)

def get_cpu_usage():
    return subprocess.check_output("top -bn1 | grep 'Cpu(s)' | sed 's/.*, *\([0-9.]*\)%* id.*/\1/' | awk '{print 100 - $1}'", shell=True).decode('utf-8').strip()

while True:
    oled.fill(0)
    oled.text("CPU Usage:", 0, 0, 1)
    oled.text(get_cpu_usage() + "%", 0, 10, 1)
    oled.show()
    time.sleep(1)

显示传感器数据

另一个常见的应用案例是显示传感器数据，如温度、湿度等。以下是一个简单的示例：

import time
import adafruit_ssd1306
from board import SCL, SDA
import busio

# 创建 I2C 接口和 OLED 对象
i2c = busio.I2C(SCL, SDA)
oled = adafruit_ssd1306.SSD1306_I2C(128, 64, i2c)

def get_sensor_data():
    # 模拟传感器数据
    return 25.5, 60.0

while True:
    oled.fill(0)
    temp, humidity = get_sensor_data()
    oled.text("Temp: " + str(temp) + "C", 0, 0, 1)
    oled.text("Humidity: " + str(humidity) + "%", 0, 10, 1)
    oled.show()
    time.sleep(1)

典型生态项目

Adafruit

Adafruit_CircuitPython_SSD1306Adafruit CircuitPython framebuf driver for SSD1306 or SSD1305 OLED displays. Not for use with displayio. See README.项目地址:https://gitcode.com/gh_mirrors/ad/Adafruit_CircuitPython_SSD1306