No description
- Python 97.7%
- Makefile 2%
- Shell 0.3%
| .forgejo | ||
| archive | ||
| data | ||
| docs | ||
| software | ||
| systems | ||
| vehicle | ||
| .editorconfig | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| README.md | ||
EV-GT
Electric conversion of an Alfa Romeo GT (donor), using a Fiat 500e 42 kWh 96S pack, an Orion BMS 2, and a Tesla Model X SDU front drive unit running OpenInverter stm32-sine.
Private repository. It holds vendor manuals and software installers that may not be redistributed. Never make it public.
Safety: workshop safety is governed by the EV-GT workshop procedures, which live outside this repo and always take precedence. Anything in here about safety is a secondary check only. See docs/safety/secondary-checks.md.
Where do I find…
| I want to… | Go to |
|---|---|
| See the whole car at a glance | vehicle/architecture/system-overview.md |
| Open the electrical schematics | vehicle/electrical/ (PDF set) |
| See what's done and what's open | docs/project/status.md · open questions |
| Find a manual or datasheet | docs/manuals/README.md |
| Look at or add a drawing | docs/standards/drawing-style.md → drawings live in each system's drawings/ folder |
| Work on a subsystem | systems/README.md |
| Run or build the software tools | software/README.md |
| Find CAN frames, IDs and the generated DBC | vehicle/can/README.md (protocol.yaml) |
| Change limits / margins and generate configs and tool limits | vehicle/config/README.md (evgt config build) |
| FIO-1 / RIO hardware (CAN-IO-Stack, RP2040) | systems/can-io-stack/IMPORT.md |
| Store a log or measurement | data/README.md |
| Find an old installer or legacy repo | archive/README.md |
| Understand how revisions work | docs/standards/revision-control.md |
| Understand how testing works | docs/standards/testing.md |
| Brief an AI agent | AGENTS.md |
Subsystems
| System | Folder | Status |
|---|---|---|
| Traction battery (Fiat 500e pack) | systems/battery | Pack in hand, spec drafted, cooling TBD |
| Orion BMS 2 | systems/battery/orion-bms | Profile needs configuring for this pack |
| Drive unit + OpenInverter | systems/drive-unit | Bench running, params are test values |
| HV distribution (fuse, contactors, precharge) | systems/hv-distribution | Parts specified, not built |
| AC charging | systems/charging-ac | TBD (likely OpenInverter project) |
| DC fast charging (CCS) | systems/charging-dc | TBD (likely Foccci / OpenInverter) |
| Thermal (battery, drive unit, cabin AC, heat) | systems/thermal | To be engineered |
| 12 V system / DC-DC | systems/lv-12v | Not started |
| VCU / vehicle logic | systems/vcu | Not started |
| Power steering | systems/power-steering | Not started |
| Brakes / vacuum | systems/brakes | Not started |
| Instruments / driver display | systems/instrumentation | Not started |
| Mechanical (mounts, boxes, driveline) | systems/mechanical | Not started |
Repository map
EV-GT/
├── README.md ← you are here
├── AGENTS.md ← rules for AI agents working in this repo (CLAUDE.md points here)
├── CHANGELOG.md ← vehicle-level change log
├── docs/ ← project docs, standards, manuals, decisions (ADRs), safety notes
├── vehicle/ ← whole-car things: architecture, CAN network, wiring harness, donor car
├── systems/ ← one folder per subsystem: config, drawings, datasheets, tests
├── software/ ← all code: shared Python library, apps, firmware, tests
├── data/ ← logs, CAN recordings, measurements, photos
└── archive/ ← frozen copies: legacy repos, installers, firmware binaries
Quick start (software)
cd software
uv sync # or: python -m venv .venv && pip install -e ".[dev]"
uv run pytest # level-0 tests, no hardware needed
uv run evgt config status # what to update on which device (deployed CFG vs generated)