Arduino_keypads 项目技术文档

1. 安装指南

下载与解压

首先，从GitHub上下载本项目压缩包（.zip文件）。下载完成后，将其解压到临时文件夹中。

安装库文件

将解压后的库文件移动到Arduino的库文件夹中。Arduino库文件夹通常位于您的计算机上的以下路径：

• Windows: Documents\Arduino\libraries
• Mac: Documents/Arduino/libraries
• Linux: ~/Arduino/libraries

确保将正确类型的库文件放入库文件夹中，例如Keypad_I2C、Keypad_I2Ca、Keypad_MC16等。

使用库管理器

请注意，库管理器无法处理整个存储库，因此需要手动安装库。

2. 项目的使用说明

本项目包含了多个Arduino格式的库，每个库都支持通过I2C（或Wire()）端口与Arduino微处理器的外部扩展端口进行通信。每个库都处理不同扩展端口芯片的I/O需求。

以下为各个库所支持的芯片类型：

• Keypad_I2C: 支持PCF8574、PCF8574A和PCF8575
• Keypad_I2Ca: 支持PCA9554、PCA9555、PCA9534、PCA9535、PCA9539、PCA6408和PCA6416
• Keypad_MC16: 支持MCP23016
• Keypad_MCP: 支持MCP23008
• Keypad_MC17: 支持MCP23017
• Keypad_tw: 支持使用TinyWire库的atTiny处理器上的PCF8574和PCF8575

3. 项目API使用文档

本项目API的使用方法请参考各库的官方文档和示例代码。以下是一些基本的使用步骤：

初始化库

在Arduino代码中包含相应的库，并创建库的实例。

#include <Keypad_I2C.h>

Keypad_I2C kpd;

配置I2C端口

对于具有多个I2C总线的Arduino，可以指定一个I2C端口。

#include <Wire.h>
#include <Keypad_I2C.h>

Keypad_I2C kpd(0x20, &Wire1); // 使用第二个I2C端口（Wire1）

读取按键状态

使用库的函数读取按键状态。

char key = kpd.getKey();

处理按键事件

根据按键状态，执行相应的操作。

if (key) {
    // 处理按键事件
}

4. 项目安装方式

除了手动安装库文件外，本项目还支持以下安装方式：

• 使用Arduino IDE的库管理器搜索并安装库。
• 在Arduino IDE中通过添加库的URL进行安装。

请确保选择正确的库和版本，以确保兼容性。