Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add README.md and rename Ruff CI action #12

Merged
merged 3 commits into from
Sep 22, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 80 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# AirbrakesV2


## Overview
This project controls the extension of airbrakes using a servo motor. It includes modules for logging data and managing the servo motor.

### Installation
Clone the repository:

```
git clone https://github.com/yourusername/AirbrakesV2.git
cd AirbrakesV2
```

#### Set up a virtual environment:

```
python3 -m venv venv
source venv/bin/activate
```

#### Install the required dependencies:

```pip install -r requirements.txt```
harshil21 marked this conversation as resolved.
Show resolved Hide resolved

#### Install and start the pigpio daemon on the Raspberry Pi:

```bash
sudo pigpiod
```

#### Install the mscl library to communicate with the IMU:

https://github.com/LORD-MicroStrain/MSCL

(scroll down and click on the Python 3 link for armhf (raspbian))

### Project Structure


```
AirbrakesV2/
├── airbrakes/
| ├── imu/
│ │ ├── [files related to the imu]
│ ├── [files related to airbrakes ...]
├── tests/ [used for testing all the code]
│ ├── ...
├── logs/ [log files made by the logger]
│ ├── log_1.csv
├── scripts/ [small files to test individual components like the servo]
│ ├── ...
├── main.py [main file used to run on the rocket]
├── requirements.txt
├── README.md
```

### Running Tests
To run the tests, use pytest:
```pytest```

### Running the Linter
This project uses ruff for linting. To run the linter, use:
```ruff check . --fix```
```ruff format .```

### Usage
```python3 main.py```

Initialize the Servo:

Set the Servo Extension:

Logging Data:

Contributing
Feel free to submit issues or pull requests. For major changes, please open an issue first to discuss what you would like to change.

License
This project is licensed under the MIT License. See the LICENSE file for details.