用于标准字符LCD的CircuitPython库。
adafruit-circuitpython-charlcd的Python项目详细描述
简介
此库与标准字符LCD兼容，例如： *Adafruit Standard LCD 16x2 *Adafruit RGB backlight negative LCD 16x2 *Adafruit RGB backlight negative LCD 20x4
从pypi安装
在支持的gnu/linux系统（如raspberry pi）上，可以在本地安装驱动程序from PyPI。为当前用户安装：
pip3 install adafruit-circuitpython-charlcd
要在系统范围内安装（在某些情况下可能需要安装）：
sudo pip3 install adafruit-circuitpython-charlcd
在当前项目的虚拟环境中安装：
mkdir project-name &&cd project-name python3 -m venv .env source .env/bin/activate pip3 install adafruit-circuitpython-charlcd
依赖关系
此驱动程序取决于：
- Adafruit CircuitPython
- Adafruit CircuitPython BusDevice
- Adafruit CircuitPython MCP230xx
- Adafruit CircuitPython 74HC595
i2c&spi显示还取决于：
请确保circuitpython文件系统上的所有依赖项都可用。 这很容易通过下载来实现 the Adafruit library and driver bundle。
用法示例
Character_LCD类使用circuitpython接口预定义的字符lcd显示。
importboardimportdigitalioimportadafruit_character_lcd.character_lcdascharacter_lcd
在使用Character_LCD类之前，必须在代码中定义数据管脚（RS，EN，D4，D5，D6，D7）。 如果您想拥有开/关backlight功能，也可以将背光定义为lcd_backlight。否则，背光 会一直开着。下面是一个示例设置。
lcd_rs=digitalio.DigitalInOut(board.D7)lcd_en=digitalio.DigitalInOut(board.D8)lcd_d7=digitalio.DigitalInOut(board.D12)lcd_d6=digitalio.DigitalInOut(board.D11)lcd_d5=digitalio.DigitalInOut(board.D10)lcd_d4=digitalio.DigitalInOut(board.D9)lcd_backlight=digitalio.DigitalInOut(board.D13)
您还必须通过指定charlcd的lcd_columns和lcd_rows：
lcd_columns=16lcd_rows=2
设置好液晶显示器后，我们可以通过调用它来制作设备
lcd=character_lcd.Character_LCD_Mono(lcd_rs,lcd_en,lcd_d4,lcd_d5,lcd_d6,lcd_d7,lcd_columns,lcd_rows,lcd_backlight)
要验证您的PIN是否正确，请向charlcd打印一条问候消息：
lcd.message="Hello\nCircuitPython"
/examples/
中提供了带有create_char()的自定义字符示例贡献
欢迎投稿！请阅读我们的Code of Conduct在贡献帮助这个项目保持欢迎。
本地建筑
要在本地构建此库，您需要安装 circuitpython-build-tools包。
python3 -m venv .env
source .env/bin/activate
pip install circuitpython-build-tools
安装后，请确保您处于虚拟环境中：
source .env/bin/activate
然后运行生成：
circuitpython-build-bundles --filename_prefix adafruit-circuitpython-charlcd --library_location .
斯芬克斯文件
sphinx用于根据代码中的rst文件和注释构建文档。第一， 安装依赖项（请随意重用上面的虚拟环境）：
python3 -m venv .env
source .env/bin/activate
pip install Sphinx sphinx-rtd-theme
现在，激活虚拟环境后：
cd docs
sphinx-build -E -W -b html . _build/html
这将把文档输出到docs/_build/html。在浏览器中打开index.html以 查看它们。它还将（由于-w）错误的任何警告，像特拉维斯将。这是个很好的方法 本地验证它将通过。
欢迎加入QQ群-->： 979659372
