# mcp23008

**Repository Path**: RT-Thread-Mirror/mcp23008

## Basic Information

- **Project Name**: mcp23008
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-11
- **Last Updated**: 2024-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mcp23008 软件包

中文页 | [English](README.md)

## 介绍

`mcp23008` 软件包是 RT-Thread 针对 I2C 并行口扩展电路 MCP23008 推出的一个软件包。使用这个软件包，可以在 RT-Thread 上非常方便的使用该器件，并且支持一个 I2C 总线上挂载多个 MCP23008。

本文主要介绍该软件包的使用方式、API，以及 `MSH` 测试命令。

### 目录结构

```
mcp23008
│   README.md                       // 软件包说明
│   mcp23008.c                       // 源文件
│   mcp23008.h                       // 头文件
│   mcp23008_sample.c                // 软件包使用示例代码
│   SConscript                      // RT-Thread 默认的构建脚本
│   LICENSE                         // 许可证文件
```

### 许可证

mcp23008 遵循 Apache-2.0 许可，详见 `LICENSE` 文件。

### 依赖

- RT_Thread 3.0+
- i2c 设备驱动

## 获取方式

使用 `mcp23008 package` 需要在 RT-Thread 的包管理中选中它，具体路径如下：

```
RT-Thread online packages
    peripheral libraries and drivers  --->
        mcp23008: Remote 8-bit I/O expander for I2C-bus  --->
```

进入 mcp23008 软件包的配置菜单按自己的需求进行具体的配置

```
    --- mcp23008: Remote 8-bit I/O expander for I2C-bus                           
        [*]   Enable mcp23008 sample
           Version (latest)  --->
```

**Enable mcp23008 sample** ：开启 mcp23008  使用示例

配置完成后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。

## 使用方法

mcp23008 软件包的使用流程一般如下：

1. 初始化 mcp23008 设备 `mcp23008_init`
2. 进行 IO 的操作
   - 使用 API `mcp23008_port_read/mcp23008_write` 同时操作 8 路 IO
   - 使用 API `mcp23008_pin_read/mcp23008_pin_write` 单独操作其中一 路 IO

详细的使用方法可以参考[mcp23008 示例程序](mcp23008_sample.c) 。

## MSH 测试命令

如果开启了 mcp23008 软件包的示例程序，就会导出 `mcp23008_sample` 命令到控制台。调用之后默认会在 `i2c1`总线上探测地址为 `0x20` 的 mcp23008 设备，并会操作扩展端口的第 0 口进行测试。运行结果如下：

```
msh >mcp23008_sample
[D/mcp23008] mcp23008 init done
The value of mcp23008.P0 is 0
The value of mcp23008.P0 is 1
msh >
```

## 注意事项

暂无。

## 联系方式

- 维护：[XiaojieFan](https://github.com/XiaojieFan)
- 主页：<https://github.com/XiaojieFan/mcp23008>