RpiMotorLib 项目启动与配置教程

1. 项目目录结构及介绍

RpiMotorLib 是一个用于控制树莓派上的电机的库。以下是项目的目录结构及各部分的作用：

RpiMotorLib/
├── examples/           # 示例代码目录，包含不同的电机控制示例
├── hardware/           # 硬件接口代码，用于不同硬件的驱动
├── library/            # 核心库文件目录
│   └── RpiMotorLib.py  # RpiMotorLib 库的主要 Python 文件
├── tests/              # 测试代码目录，用于验证库的功能
└── README.md           # 项目说明文件，包含项目信息和基本使用说明

• examples/: 包含使用 RpiMotorLib 控制电机的示例代码，可以帮助用户快速了解如何使用该库。
• hardware/: 包含适用于不同硬件驱动的代码，使得 RpiMotorLib 可以支持多种电机驱动板。
• library/: 包含库的核心文件，RpiMotorLib.py 是主要文件，实现了电机控制的核心功能。
• tests/: 包含测试代码，用于确保库的稳定性和功能正确性。
• README.md: 包含了项目的基本信息和如何使用该项目的说明。

2. 项目的启动文件介绍

RpiMotorLib 的启动主要是通过在 Python 环境中导入 RpiMotorLib.py 文件来完成的。在 examples/ 目录下的示例代码可以用来启动和控制电机。

以下是一个简单的启动示例：

from RpiMotorLib import RpiMotorLib

# 初始化电机控制对象
motor = RpiMotorLib.Adafruit_MotorHAT()

# 设置电机参数
myMotor = motor.getMotor(1)

# 启动电机
myMotor.run(1)  # 1: 正转，-1: 反转，0: 停止

在上述代码中，首先从 RpiMotorLib 中导入 RpiMotorLib 类，然后创建一个电机控制对象，并通过该对象控制电机。

3. 项目的配置文件介绍

RpiMotorLib 的配置主要通过在代码中设置参数来完成。由于库的设计考虑了不同硬件的兼容性，因此在 hardware/ 目录中可能包含了不同硬件的配置文件。

在 RpiMotorLib.py 文件中，可以通过修改以下参数来配置电机：

# 设置电机驱动板的类型
DRIVER = 'PCA9685'

# 设置 PCA9685 的 I2C 地址
I2C_ADDR = 0x40

# 设置 PWM 频率和电机控制引脚（如果使用不同的硬件驱动板，这些参数可能需要更改）
PWM_FREQ = 1600
MOTOR_A = {'1': {'pin': 8, 'EN': 4}, '2': {'pin': 9, 'EN': 5}}
MOTOR_B = {'1': {'pin': 10, 'EN': 6}, '2': {'pin': 11, 'EN': 7}}

在配置这些参数时，需要根据实际使用的硬件驱动板和连接的引脚来调整。确保这些参数与实际的硬件设置相匹配是非常重要的。