Skip to content

Commit dbc4239

Browse files
committed
rename project
1 parent 6f91066 commit dbc4239

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+296
-100
lines changed

.github/FUNDING.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,6 @@
33

44
# github: [username]
55
# patreon: username
6-
# open_collective: active-wing
6+
# open_collective: blackbox
77
# ko_fi: username
88
# custom: ["https://www.buymeacoffee.com/username", "https://paypal.me/username"]

.github/workflows/ci.yml

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ jobs:
2727
- name: Cache cargo (using Swatinem/rust-cache)
2828
uses: Swatinem/rust-cache@v2
2929
with:
30-
workspaces: sensors/active-wing
30+
workspaces: sensors/blackbox
3131
cache-on-failure: true
3232

3333
- name: Cache cargo tools
@@ -84,7 +84,7 @@ jobs:
8484
- name: Check compilation
8585
run: |
8686
. $HOME/export-esp.sh
87-
cd sensors/active-wing
87+
cd sensors/blackbox
8888
cargo check
8989
9090
fmt:
@@ -115,12 +115,12 @@ jobs:
115115
- name: Cache cargo (using Swatinem/rust-cache)
116116
uses: Swatinem/rust-cache@v2
117117
with:
118-
workspaces: sensors/active-wing
118+
workspaces: sensors/blackbox
119119
cache-on-failure: true
120120

121121
- name: Run clippy
122122
run: |
123-
cd sensors/active-wing
123+
cd sensors/blackbox
124124
cargo clippy -- -D warnings
125125
126126
build:
@@ -139,7 +139,7 @@ jobs:
139139
- name: Cache cargo (using Swatinem/rust-cache)
140140
uses: Swatinem/rust-cache@v2
141141
with:
142-
workspaces: sensors/active-wing
142+
workspaces: sensors/blackbox
143143
cache-on-failure: true
144144
shared-key: partition-fix-v2
145145

@@ -206,18 +206,18 @@ jobs:
206206
207207
- name: Clean build to force partition table update
208208
run: |
209-
cd sensors/active-wing
209+
cd sensors/blackbox
210210
rm -rf ../../target/riscv32imc-esp-espidf
211211
rm -rf ../../.embuild
212212
echo "✓ Cleaned ESP-IDF build cache (.embuild and target)"
213213
214214
- name: Build firmware
215215
run: |
216216
. $HOME/export-esp.sh
217-
cd sensors/active-wing
217+
cd sensors/blackbox
218218
cargo build --release
219219
echo "Built binary size:"
220-
ls -lh ../../target/riscv32imc-esp-espidf/release/active-wing
220+
ls -lh ../../target/riscv32imc-esp-espidf/release/blackbox
221221
echo "Checking generated partition configuration:"
222222
grep "CONFIG_PARTITION_TABLE" ../../target/riscv32imc-esp-espidf/release/build/esp-idf-sys-*/out/sdkconfig | head -10
223223
echo "Partition table binary:"
@@ -226,26 +226,26 @@ jobs:
226226
227227
- name: Create merged binary for web flasher
228228
run: |
229-
cd sensors/active-wing
229+
cd sensors/blackbox
230230
cargo espflash save-image \
231231
--chip esp32c3 \
232232
--merge \
233233
--release \
234-
../../target/active-wing.bin
235-
ls -lh ../../target/active-wing.bin
234+
../../target/blackbox.bin
235+
ls -lh ../../target/blackbox.bin
236236
237237
- name: Upload merged firmware
238238
uses: actions/upload-artifact@v4
239239
with:
240240
name: firmware-esp32c3
241-
path: target/active-wing.bin
241+
path: target/blackbox.bin
242242

243243
- name: Upload individual components (debug)
244244
uses: actions/upload-artifact@v4
245245
with:
246246
name: firmware-components
247247
path: |
248-
target/riscv32imc-esp-espidf/release/active-wing
248+
target/riscv32imc-esp-espidf/release/blackbox
249249
target/riscv32imc-esp-espidf/release/bootloader.bin
250250
target/riscv32imc-esp-espidf/release/partition-table.bin
251251

CHANGELOG.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Changelog
22

3-
All notable changes to Active Wing will be documented in this file.
3+
All notable changes to Blackbox will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -15,7 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1515
## [0.1.0] - 2025-01-XX
1616

1717
### Added
18-
- Initial release of Active Wing
18+
- Initial release of Blackbox
1919
- ESP32-C3 firmware for vehicle telemetry
2020
- WT901 IMU driver with UART parsing
2121
- NEO-6M GPS driver with NMEA parsing

CLAUDE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
44

55
## Project Overview
66

7-
Active Wing is an ESP32-C3 vehicle telemetry system that performs real-time sensor fusion of IMU and GPS data using an Extended Kalman Filter (EKF). It streams binary telemetry at 20 Hz over TCP for live data acquisition during track days, autocross, rally, and vehicle dynamics research.
7+
Blackbox is an ESP32-C3 vehicle telemetry system that performs real-time sensor fusion of IMU and GPS data using an Extended Kalman Filter (EKF). It streams binary telemetry at 20 Hz over TCP for live data acquisition during track days, autocross, rally, and vehicle dynamics research.
88

99
**Target Hardware:** ESP32-C3 microcontroller
1010
**Sensors:** WT901 9-axis IMU (UART), NEO-6M GPS (UART)
@@ -57,7 +57,7 @@ python3 -m py_compile tools/python/*.py
5757

5858
### Project Structure
5959
```
60-
active_wing/
60+
blackbox/
6161
├── src/ # Rust firmware
6262
├── tools/python/ # Telemetry receivers
6363
├── docs/ # Additional documentation

CONTRIBUTING.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
1-
# Contributing to Active Wing
1+
# Contributing to Blackbox
22

33
First off, thanks for taking the time to contribute! 🎉
44

5-
Active Wing is a community-driven project, and we welcome contributions from everyone—whether you're a seasoned embedded developer, a car enthusiast learning to code, or somewhere in between.
5+
Blackbox is a community-driven project, and we welcome contributions from everyone—whether you're a seasoned embedded developer, a car enthusiast learning to code, or somewhere in between.
66

77
---
88

99
## Code of Conduct
1010

1111
### Our Pledge
1212

13-
We pledge to make participation in the Active Wing community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
13+
We pledge to make participation in the Blackbox community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
1414

1515
### Our Standards
1616

@@ -85,12 +85,12 @@ If you experience or witness unacceptable behavior, please report it by opening
8585
1. **Fork the repository** on GitHub
8686
2. **Clone your fork** locally:
8787
```bash
88-
git clone https://github.com/YOUR_USERNAME/active_wing.git
89-
cd active_wing
88+
git clone https://github.com/YOUR_USERNAME/blackbox.git
89+
cd blackbox
9090
```
9191
3. **Add upstream remote**:
9292
```bash
93-
git remote add upstream https://github.com/jctoledo/active_wing.git
93+
git remote add upstream https://github.com/jctoledo/blackbox.git
9494
```
9595
4. **Create a branch** for your work:
9696
```bash
@@ -102,7 +102,7 @@ If you experience or witness unacceptable behavior, please report it by opening
102102
### Reporting Bugs
103103

104104
Before submitting a bug report:
105-
- Check the [existing issues](https://github.com/jctoledo/active_wing/issues) to avoid duplicates
105+
- Check the [existing issues](https://github.com/jctoledo/blackbox/issues) to avoid duplicates
106106
- Try the latest version from `main` branch
107107
- Collect information about your setup
108108

@@ -124,7 +124,7 @@ Before submitting a bug report:
124124

125125
We love new ideas! Before suggesting a feature:
126126

127-
- Check if it's already been proposed in [issues](https://github.com/jctoledo/active_wing/issues)
127+
- Check if it's already been proposed in [issues](https://github.com/jctoledo/blackbox/issues)
128128
- Consider if it fits the project's scope (vehicle telemetry/data acquisition)
129129
- Think about how it benefits the community
130130

@@ -195,7 +195,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
195195
cargo install cargo-espflash espflash ldproxy
196196

197197
# Install Python dependencies (for telemetry receivers)
198-
pip3 install -r sensors/active-wing/tools/python/requirements.txt
198+
pip3 install -r sensors/blackbox/tools/python/requirements.txt
199199
```
200200

201201
### Building the Project
@@ -206,16 +206,16 @@ This is a Cargo workspace. Build commands from the repository root:
206206
# Check all workspace members compile
207207
cargo check
208208

209-
# Build entire workspace (framework + drivers + active-wing)
209+
# Build entire workspace (framework + drivers + blackbox)
210210
cargo build
211211

212212
# Build specific package
213-
cargo build -p active-wing
213+
cargo build -p blackbox
214214
cargo build -p wt901
215215
cargo build -p neo6m
216216

217217
# Build release binary for ESP32
218-
cd sensors/active-wing
218+
cd sensors/blackbox
219219
cargo build --release
220220

221221
# Flash to ESP32 (will auto-detect port)
@@ -235,10 +235,10 @@ cargo fmt
235235
cargo clippy -- -D warnings
236236

237237
# Test Python syntax
238-
python3 -m py_compile sensors/active-wing/tools/python/*.py
238+
python3 -m py_compile sensors/blackbox/tools/python/*.py
239239

240240
# Test telemetry receiver
241-
python3 sensors/active-wing/tools/python/tcp_telemetry_receiver.py
241+
python3 sensors/blackbox/tools/python/tcp_telemetry_receiver.py
242242
```
243243

244244
## Pull Request Process
@@ -406,4 +406,4 @@ Stuck on something? Here are resources:
406406

407407
---
408408

409-
**Thank you for contributing to Active Wing!** Every contribution, no matter how small, makes this project better for everyone. 🏁
409+
**Thank you for contributing to Blackbox!** Every contribution, no matter how small, makes this project better for everyone. 🏁

Cargo.lock

Lines changed: 19 additions & 19 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ members = [
33
"framework", # motorsport-telemetry crate
44
"drivers/wt901", # WT901 IMU driver
55
"drivers/neo6m", # NEO-6M GPS driver
6-
"sensors/active-wing", # Active Wing ESP32 telemetry application
6+
"sensors/blackbox", # Active Wing ESP32 telemetry application
77
]
88
resolver = "2"
99

README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Active Wing - ESP32 Vehicle Telemetry System
1+
# Blackbox - ESP32 Vehicle Telemetry System
22

33
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
44
[![Rust](https://img.shields.io/badge/rust-1.75%2B-orange.svg)](https://www.rust-lang.org/)
@@ -100,8 +100,8 @@ rustup component add rust-src --toolchain esp
100100
### 2. Clone and Configure
101101

102102
```bash
103-
git clone https://github.com/jctoledo/active_wing.git
104-
cd active_wing/sensors/active-wing
103+
git clone https://github.com/jctoledo/blackbox.git
104+
cd blackbox/sensors/blackbox
105105

106106
# Edit WiFi credentials
107107
nano src/main.rs
@@ -118,7 +118,7 @@ The project includes a `.cargo/config.toml` that configures everything automatic
118118

119119
```bash
120120
# Navigate to the sensor project
121-
cd sensors/active-wing
121+
cd sensors/blackbox
122122

123123
# Load ESP environment first (in every new terminal!)
124124
source $HOME/export-esp.sh
@@ -229,7 +229,7 @@ The `.cargo/config.toml` file in the sensor project configures the target and bu
229229

230230
```bash
231231
# Navigate to the sensor project first
232-
cd sensors/active-wing
232+
cd sensors/blackbox
233233

234234
# ALWAYS load ESP environment first!
235235
source $HOME/export-esp.sh
@@ -266,7 +266,7 @@ This means the ESP toolchain isn't loaded or rust-src is missing:
266266

267267
```bash
268268
# Solution 1: Make sure you're in the sensor directory
269-
cd sensors/active-wing
269+
cd sensors/blackbox
270270

271271
# Solution 2: Load ESP environment
272272
source $HOME/export-esp.sh
@@ -373,9 +373,9 @@ GPS (5Hz) IMU (50Hz)
373373
### File Structure
374374

375375
```
376-
active_wing/
376+
blackbox/
377377
├── sensors/
378-
│ └── active-wing/
378+
│ └── blackbox/
379379
│ ├── .cargo/
380380
│ │ └── config.toml # ESP32-C3 build configuration
381381
│ ├── src/
@@ -461,7 +461,7 @@ struct TelemetryPacket {
461461

462462
### WiFi and Network
463463

464-
Edit `sensors/active-wing/src/main.rs`:
464+
Edit `sensors/blackbox/src/main.rs`:
465465
```rust
466466
const WIFI_SSID: &str = "YourNetwork";
467467
const WIFI_PASSWORD: &str = "YourPassword";
@@ -471,7 +471,7 @@ const TCP_SERVER: &str = "192.168.1.100:9000";
471471

472472
### EKF Tuning
473473

474-
Edit `sensors/active-wing/src/ekf.rs`:
474+
Edit `sensors/blackbox/src/ekf.rs`:
475475
```rust
476476
const Q_ACC: f32 = 0.40; // Process noise: acceleration (m/s²)²
477477
const Q_GYRO: f32 = 0.005; // Process noise: gyro (rad/s)²
@@ -484,7 +484,7 @@ const R_YAW: f32 = 0.10; // Measurement noise: magnetometer (rad)²
484484

485485
### Mode Detection Thresholds
486486

487-
Edit `sensors/active-wing/src/mode.rs`:
487+
Edit `sensors/blackbox/src/mode.rs`:
488488
```rust
489489
pub min_speed: f32 = 2.0; // Minimum speed for maneuvers (m/s)
490490
pub acc_thr: f32 = 0.21; // Acceleration threshold (g)
@@ -562,6 +562,6 @@ Inspired by open-source motorsport and robotics projects that prove pro-grade sy
562562

563563
---
564564

565-
**Questions?** Open an [issue](https://github.com/jctoledo/active_wing/issues).
565+
**Questions?** Open an [issue](https://github.com/jctoledo/blackbox/issues).
566566

567567
**Ready to track?** [Start with Quick Start ↑](#quick-start)

0 commit comments

Comments
 (0)