Adafruit CircuitPython RGB Display 项目教程
1. 项目的目录结构及介绍
Adafruit_CircuitPython_RGB_Display/
├── .github/
│ └── workflows/
├── examples/
│ ├── ili9341_pillow_simpletest.py
│ ├── ili9341_simpletest.py
│ ├── ...
├── docs/
│ ├── examples.rst
│ ├── ...
├── adafruit_rgb_display/
│ ├── __init__.py
│ ├── hx8353.py
│ ├── ili9341.py
│ ├── ...
├── .gitignore
├── .pre-commit-config.yaml
├── CODE_OF_CONDUCT.md
├── LICENSE
├── README.md
├── requirements.txt
├── setup.py
目录结构介绍
- .github/workflows/: 包含GitHub Actions的工作流配置文件。
- examples/: 包含项目的示例代码,如
ili9341_simpletest.py
等。 - docs/: 包含项目的文档文件,如
examples.rst
等。 - adafruit_rgb_display/: 包含项目的主要代码文件,如
__init__.py
,hx8353.py
,ili9341.py
等。 - .gitignore: Git忽略文件配置。
- .pre-commit-config.yaml: 预提交钩子配置文件。
- CODE_OF_CONDUCT.md: 行为准则文件。
- LICENSE: 许可证文件。
- README.md: 项目说明文件。
- requirements.txt: 项目依赖文件。
- setup.py: 项目安装脚本。
2. 项目的启动文件介绍
项目的启动文件通常位于examples/
目录下,例如ili9341_simpletest.py
。以下是一个示例启动文件的内容:
import busio
import digitalio
import board
import adafruit_rgb_display.ili9341 as ili9341
# 配置SPI接口
spi = busio.SPI(clock=board.SCK, MOSI=board.MOSI, MISO=board.MISO)
# 配置CS和DC引脚
cs = digitalio.DigitalInOut(board.CE0)
dc = digitalio.DigitalInOut(board.D25)
# 初始化显示器
display = ili9341.ILI9341(spi, cs=cs, dc=dc)
# 清屏
display.fill(0xFFFFFF)
# 显示像素
display.pixel(64, 64, 0x000000)
启动文件介绍
- 导入必要的模块: 导入
busio
,digitalio
,board
和adafruit_rgb_display.ili9341
模块。 - 配置SPI接口: 使用
busio.SPI
配置SPI接口。 - 配置CS和DC引脚: 使用
digitalio.DigitalInOut
配置CS和DC引脚。 - 初始化显示器: 使用
ili9341.ILI9341
初始化显示器。 - 清屏和显示像素: 使用
display.fill
和display.pixel
方法进行屏幕操作。
3. 项目的配置文件介绍
项目中没有明确的配置文件,但可以通过修改示例代码中的参数来配置显示器。例如,可以在ili9341_simpletest.py
中修改SPI的波特率、CS和DC引脚等参数。
配置文件介绍
- SPI波特率: 可以在初始化显示器时设置SPI的波特率,例如
baudrate=16000000
。 - CS和DC引脚: 可以在初始化显示器时设置CS和DC引脚,例如
cs=digitalio.DigitalInOut(board.CE0)
和dc=digitalio.DigitalInOut(board.D25)
。
通过修改这些参数,可以适应不同的硬件环境和需求。