ch347-py

English

简介

ch347-py是一个用于驱动CH347芯片的Python绑定库。它提供了一种简单的方式来与CH347芯片进行交互，可以基于此开发I2C、SPI等通信接口应用。

安装

使用pip安装

你可以通过pip来安装这个库：

pip install ch347-py

从源码安装

使用uv进行开发（推荐）：

git clone https://github.com/pengwon/ch347-py.git
cd ch347-py

# 安装uv（如果尚未安装）
pip install uv

# 创建虚拟环境并安装依赖
uv sync

# 激活虚拟环境
source .venv/bin/activate  # Linux/macOS
# 或
.venv\Scripts\activate  # Windows

使用传统方式：

git clone https://github.com/pengwon/ch347-py.git
cd ch347-py
pip install -e .

开发环境设置

如果你想参与开发或运行测试，需要安装开发依赖：

# 使用uv（推荐）
uv sync

# 或使用pip
pip install -e ".[dev]"

使用方法

首先，你需要从ch347模块中导入CH347类：

from ch347 import CH347

然后，你可以创建一个CH347类的实例，并使用它的方法来与CH347芯片进行交互。例如：

driver = CH347()
driver.spi_write(0x00, [0xFF] * 10)

测试

本项目包含了一些测试脚本，你可以运行这些脚本来测试和演示如何使用这个库。

参考文档

1. 读取MPU6050传感器数据和显示
2. 读写SPI Flash
3. 连接MPU6050
4. INA226电流计的使用
5. 详解I2C
6. python封装动态库
7. 详解SPI

许可证

本项目使用的许可证在 LICENSE 文件中给出。

贡献

欢迎对本项目做出贡献。在提交Pull Request之前，请确保您的代码通过了所有的测试。

联系

如果您在使用这个库的过程中遇到任何问题，或者有任何建议和反馈，欢迎通过GitHub Issues与我们联系。