Ball-Balancing-PID-System 开源项目安装和使用文档

Ball-Balancing-PID-System 开源项目安装和使用文档

Ball-Balancing-PID-System 项目地址: https://gitcode.com/gh_mirrors/ba/Ball-Balancing-PID-System

1. 项目的目录结构及介绍

项目的主要目录结构如下：

Ball-Balancing-PID-System/
├── ArduinoCodes/
│   └── arduino3servoTest/
│       └── additional_codes/
├── images/
├── pythonCodes/
├── License.txt
├── README.md
└── TM_SJF_version.pdf

目录详细介绍：

• ArduinoCodes/: 包含用于控制伺服电机的Arduino代码。
  • arduino3servoTest/: 具体的Arduino测试代码目录。
    • additional_codes/: 额外的代码文件，可能包含一些辅助功能。
• images/: 存放项目相关的图片文件，可能用于文档或演示。
• pythonCodes/: 包含用于数据处理或控制的Python代码。
• License.txt: 项目许可证文件，描述了项目的开源协议。
• README.md: 项目说明文件，包含项目的基本介绍和使用指南。
• TM_SJF_version.pdf: 可能是项目的相关文档或论文。

2. 项目的启动文件介绍

项目的启动文件主要是Arduino代码和Python代码，具体如下：

Arduino启动文件

位于 ArduinoCodes/arduino3servoTest/ 目录下的 .ino 文件，例如 arduino3servoTest.ino。这个文件是Arduino的主程序，负责控制伺服电机以实现球的平衡。

Python启动文件

位于 pythonCodes/ 目录下的 .py 文件，例如 main.py。这个文件可能是用于数据处理、PID控制算法的实现或其他辅助功能。

3. 项目的配置文件介绍

项目中并没有明确的配置文件，但可以通过以下文件进行相关配置：

Arduino代码配置

在 ArduinoCodes/arduino3servoTest/ 目录下的 .ino 文件中，可以通过修改以下部分进行配置：

// 伺服电机引脚配置
const int servo1Pin = 9;
const int servo2Pin = 10;
const int servo3Pin = 11;

// PID参数配置
double Kp = 1.0;
double Ki = 0.1;
double Kd = 0.05;

Python代码配置

在 pythonCodes/ 目录下的 .py 文件中，可以通过修改以下部分进行配置：

# PID参数配置
Kp = 1.0
Ki = 0.1
Kd = 0.05

# 串口配置
serial_port = '/dev/ttyUSB0'
baud_rate = 9600

通过以上配置，可以调整PID参数和硬件连接设置，以适应不同的硬件环境和控制需求。

---

以上是Ball-Balancing-PID-System开源项目的安装和使用文档，希望对您有所帮助。如果有更多问题，请参考项目的README文件或联系项目作者。

Ball-Balancing-PID-System 项目地址: https://gitcode.com/gh_mirrors/ba/Ball-Balancing-PID-System