LiquidCrystal_PCF8574 Arduino库指南
项目地址:https://gitcode.com/gh_mirrors/li/LiquidCrystal_PCF8574
本指南旨在帮助您了解并开始使用mathertel/LiquidCrystal_PCF8574这一开源项目,该库专为通过I2C总线控制LiquidCrystal LCD显示器而设计,利用PCF8574 I2C适配器。
1. 目录结构及介绍
LiquidCrystal_PCF8574库遵循典型的Arduino库结构:
LiquidCrystal_PCF8574/
├── examples # 示例代码示例应用程序
│ ├── ...
├── src # 源码目录,包含主要库文件
│ ├── LiquidCrystal_PCF8574.cpp # 主要实现文件
│ └── LiquidCrystal_PCF8574.h # 头文件,声明接口和类
├── keywords.txt # 用于IDE的关键词列表,方便自动完成
├── library.properties # 库属性文件,包含了库的元数据
└── README.md # 项目的快速入门说明和概述
- examples: 包含了多个示例程序,演示如何在不同场景下使用该库。
- src: 存放核心源代码,其中
.cpp
文件实现了库函数,.h
文件定义了库接口。 - keywords.txt: 提供了代码补全支持,便于开发者在编辑器中编写时使用。
- library.properties: 库的配置文件,记录了库的名称、版本、作者等重要信息。
- README.md: 这份文档的原始位置,提供了快速安装指引和基本使用信息。
2. 项目的启动文件介绍
在实际应用中,项目通常不直接从库的源代码开始编写。但是,理解和分析示例代码中的启动流程对于新手来说是很有帮助的。以examples
目录下的一个简单示例为例,如Hello_World
,它通常会包括以下几个关键步骤:
- 引入头文件:
#include <LiquidCrystal_PCF8574.h>
是开始使用的必备步骤。 - 初始化对象:
LiquidCrystal_PCF8574 lcd(PCF8574_ADDRESS);
其中PCF8574_ADDRESS
是I2C地址。 - 在
setup()
函数中初始化LCD:调用lcd.begin-columns,rows;
设置LCD尺寸。 - 在
loop()
函数内添加显示逻辑:例如,lcd.print("Hello World!");
将文本打印到LCD上。
3. 项目的配置文件介绍
- library.properties 可视为此项目的“配置中心”。它包含以下重要字段:
name
: 库的名字,这里是LiquidCrystal_PCF8574
。version
: 当前库的版本号。author
: 库的作者,Matthias Hertel。maintainer
: 库的维护者信息,同样为Matthias Hertel。sentence
: 简短描述库的功能。category
: 库属于哪个类别,在这里是“Display”。url
: 库的主页或更多信息的链接。architecture
: 表明该库对所有架构兼容,适用于任意Arduino板。
通过编辑这个文件,开发人员可以更新库的元数据,进而影响到库在Arduino IDE中的行为和展示。
为了开始使用此库,建议直接在Arduino IDE的库管理器中搜索LiquidCrystal_PCF8574
并安装,然后参考提供的示例进行实践。这样做简化了配置过程,并确保了与库的最新版本同步。