广泛使用的日立HD44780控制器的树莓PI LCD库。
RPLCD的Python项目详细描述
日立HD44780的Python3/2覆盆子PI字符LCD库 控制器。它既支持GPIO(并行)模式,也支持I?C板 端口扩展器(例如PCF8574或MCP23008)。
这个图书馆的灵感来源于Adafruit Industries的CharLCD图书馆以及 Arduino的LiquidCrystal库。
对于gpio模式,没有外部依赖项(除了RPi.GPIO库 需要预先安装在raspbian上才能使用此库。如果你想的话 通过i~c控制lcd,那么您还需要python-smbus或smbus2库。如果你 要使用pigpio控制LCD,必须安装pigpio库。
如果你想开始使用rplcd,你应该read the docs:)
设置
可以使用pip从PyPI直接安装rplcd:
$ sudo pip install RPLCD
如果您想使用iC,还需要smbus或smbus2库:
$ sudo apt install python-smbus or $ sudo pip install smbus2
rplcd将首先尝试使用smbus(如果可用),如果不可用,则返回smbus2。
也可以在不使用pip的情况下手动安装库。要么直接复制 脚本到工作目录并导入它们,或者下载存储库 运行python setup.py install将其安装到python包中 目录。
功能
实施
- 简单易用的API
- 支持4位和8位模式
- 支持并行(GPIO)和I?C连接
- 支持自定义字符
- 支持背光控制电路
- 内置支持a00和a02字符表
- python 2/3兼容
- 缓存:仅当字符更改时才写入字符
- 没有外部依赖关系(除了rpi.gpio和python smbus或smbus2之外,如果需要的话 空调支架)
愿望列表
这些事情可能会在未来实现,这取决于我的空闲时间和 动机:
- micropython端口
支持的I?C端口扩展器
- PCF8574(供Ali Express上的许多I?C LCD适配器使用)
- MCP23008(用于Adafruit i?c LCD背包)
- MCP23017
文档
- 稳定(在pypi上释放):http://rplcd.readthedocs.io/en/stable/
- 最新(当前主控):http://rplcd.readthedocs.io/en/latest/
测试
交互式测试脚本
要测试LCD,请使用^{tt7}运行rplcd-tests脚本$ 目标。
单元测试
也有单元测试。首先,安装依赖项:
pip install -U -r requirements-dev.txt
然后运行测试:
py.test -v
编码指南
PEP8通过flake8并将max-line-width设置为99和 E126-E128,C901忽略:
flake8 --max-line-length=99 --ignore=E126,E127,E128,C901 RPLCD/lcd.py
资源
- TC2004A-01产品介绍:http://www.adafruit.com/datasheets/TC2004A-01.pdf
- HD44780U产品介绍:http://www.adafruit.com/datasheets/HD44780.pdf
许可证
此代码是在mit许可下授权的,有关详细信息,请参见LICENSE file或tldrlegal。