milo/E-Fit-Samson
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

😄 emojis are fun

Browse source
This commit is contained in:
milo 2025-12-05 14:39:30 -05:00
parent 6ebbe40cf4
commit b3e549fa68
1 changed files with 12 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
README.md
View file

@ -1,12 +1,12 @@
# Samson eFit Module – Internal README (MVP Implementation) # ⚙️ Samson eFit Module – Internal README (MVP Implementation)
## Purpose ## 🎯 Purpose
Build a compact, motor-controlled resistance unit with basic wireless control and encoder-based feedback. Build a compact, motor-controlled resistance unit with basic wireless control and encoder-based feedback.
Stay within MVP scope and avoid feature creep until core functionality works. Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## MVP Core Goals ## 🧭 MVP Core Goals
- Smooth electronic resistance using BLDC + driver - Smooth electronic resistance using BLDC + driver
- Wireless control of load (ESP32 → PWM) - Wireless control of load (ESP32 → PWM)
- Encoder-based feedback to maintain commanded resistance - Encoder-based feedback to maintain commanded resistance
@ -15,7 +15,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## Current Components (Received) ## 📦 Current Components (Received)
| # | Component | Purpose | Notes | | # | Component | Purpose | Notes |
|---|-----------|---------|------| |---|-----------|---------|------|
@ -26,7 +26,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## High-Level Architecture (MVP) ## 🧩 High-Level Architecture (MVP)
- **ESP32**: PWM output + encoder reading + wireless interface - **ESP32**: PWM output + encoder reading + wireless interface
- **BLDC Driver**: Drives motor phases based on PWM - **BLDC Driver**: Drives motor phases based on PWM
- **AS5600 Encoder**: Shaft position/velocity feedback over I²C - **AS5600 Encoder**: Shaft position/velocity feedback over I²C
@ -35,7 +35,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## Implementation Order (Milestones) ## 🛠️ Implementation Order (Milestones)
1) Bench-test BLDC controller + motor (no load) 1) Bench-test BLDC controller + motor (no load)
2) Read encoder position/velocity reliably 2) Read encoder position/velocity reliably
3) Close feedback loop (PWM adjusted from encoder) 3) Close feedback loop (PWM adjusted from encoder)
@ -45,7 +45,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## Firmware Tasks (ESP32) ## 💻 Firmware Tasks (ESP32)
- PWM generation + tuning - PWM generation + tuning
- Encoder I²C driver (AS5600) - Encoder I²C driver (AS5600)
- Resistance control loop (angle/speed → PWM adjust) - Resistance control loop (angle/speed → PWM adjust)
@ -54,7 +54,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## Hardware Tasks ## 🔩 Hardware Tasks
- Encoder magnet mounting on pulley/shaft - Encoder magnet mounting on pulley/shaft
- Secure motor + driver on bench fixture - Secure motor + driver on bench fixture
- Power routing + regulation - Power routing + regulation
@ -62,7 +62,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## Power Notes ## 🔋 Power Notes
- M18 battery: 18V nominal - M18 battery: 18V nominal
- Driver acceptable: 6–60V - Driver acceptable: 6–60V
- ESP32 requires regulated 5V/3.3V - ESP32 requires regulated 5V/3.3V
@ -70,7 +70,7 @@ Stay within MVP scope and avoid feature creep until core functionality works.
--- ---
## Scope Limiters (Avoid Feature Creep) ## 🚫 Scope Limiters (Avoid Feature Creep)
Not MVP: Not MVP:
- Full AI workout planning - Full AI workout planning
- Cloud accounts or server database - Cloud accounts or server database
@ -81,7 +81,7 @@ MVP success = controllable electronic resistance + encoder feedback loop.
--- ---
## Testing Targets ## 🧪 Testing Targets
- Commanded resistance holds within stable margin - Commanded resistance holds within stable margin
- Encoder data noise acceptable - Encoder data noise acceptable
- No uncontrolled torque spikes - No uncontrolled torque spikes
@ -89,6 +89,6 @@ MVP success = controllable electronic resistance + encoder feedback loop.
--- ---
## Notes to Ourselves ## 📝 Notes to Ourselves
If it does not directly help us **control and stabilize resistance**, it waits until after MVP. If it does not directly help us **control and stabilize resistance**, it waits until after MVP.