L'électron rare
f55093d6fe
ESP-IDF CI / Host Tests (Unity) (push) Successful in 1m8s
CI / firmware-native (push) Successful in 2m57s
Rust Protection Tests / Cargo test (host) (push) Failing after 3m21s
ESP-IDF CI / ESP-IDF Build (v5.4) (push) Failing after 6m55s
ESP-IDF CI / Memory Budget Gate (push) Has been skipped
qa-cicd-environments / qa-kxkm-s3-build (push) Successful in 8m53s
qa-cicd-environments / qa-sim-host (push) Successful in 2m2s
qa-cicd-environments / qa-kxkm-s3-memory-budget (push) Successful in 11m17s
Context: the project archive (KXKM_Batterie_Parallelator-main) had no git history locally; a fresh repository is needed to host it on git.saillant.cc (electron/KXKM_Batterie_Parallelator). Approach: initialize a new repo on branch main, stage the archive content, and harden .gitignore before the first commit. Changes: - Import the full project tree: firmware/, firmware-idf/, firmware-rs/, iosApp/, kxkm-bmu-app/, kxkm-api/, hardware/, docs/, specs/, scripts/, models/, tests/ - Keep project dotfiles tracked despite the trailing '.*' ignore rule: .github/, .claude/, .superpowers/, .gitattributes, .markdownlint.json - Extend .gitignore: firmware/src/credentials.h (local secrets, template kept), kxkm-bmu-app/**/build/ (66 MB compiled iOS framework), .remember/ (session data) Impact: the project can now be maintained on the self-hosted Gitea forge with a clean, secret-free initial history.
3.2 KiB
3.2 KiB
Architecture — KXKM Batterie Parallelator
Kill_LIFE gate: S0 → S1 Version: 1.0 (2026-03-25)
Vue d'ensemble
┌─────────────────────────────────────────────────────────┐
│ ESP32 (K32 board) │
│ │
│ setup() │
│ ├── Wire.begin(SDA=32, SCL=33) @ 50 kHz │
│ ├── I²C scan (0x08–0x78) │
│ ├── setup_tca() ← TCA9535 GPIO expander init │
│ └── setup_ina() ← INA237 courant/tension init │
│ │
│ loop() [500 ms] │
│ └── for each INA (0..Nb_INA-1) │
│ ├── read_volt / read_current / read_power │
│ ├── check_protection() [compute.h] │
│ │ ├── under-voltage → switch_off │
│ │ ├── over-voltage → switch_off │
│ │ ├── over-current → switch_off │
│ │ ├── voltage imbalance → switch_off │
│ │ ├── Nb_switch < max → switch_on │
│ │ ├── Nb_switch == max → timer reconnect │
│ │ └── Nb_switch > max → permanent lock │
│ └── serial log │
└─────────────────────────────────────────────────────────┘
I²C bus (50 kHz)
├── INA237 @ 0x40–0x4F (jusqu'à 16, adresse via A0/A1)
└── TCA9535 @ 0x20–0x27 (adresse via A0/A1/A2)
└── outputs: relais MOSFET + LED état
Modules source
| Fichier | Rôle |
|---|---|
firmware/src/main.cpp |
Setup/loop principal, orchestration |
firmware/src/INA_Func.h |
Init INA237, lecture V/I/P |
firmware/src/TCA_Func.h |
Init TCA9535, lecture/écriture GPIO |
firmware/src/compute.h |
Logique protection (switch_on/off, compteurs) |
firmware/src/pin_mappings.h |
Mapping GPIO → INA ALERT pins |
firmware/src/data_log.h |
Logging série |
firmware/lib/INA237/ |
Driver INA237 local (fork) |
firmware/data/ |
Interface web (HTML/JS/CSS) |
PCB
| Version | Fichier | État |
|---|---|---|
| BMU v1 | hardware/PCB/BMU v1/BMU v1.kicad_sch |
Fabriqué JLCPCB |
| BMU v2 | hardware/pcb-bmu-v2/BMU_switch_mosfet.kicad_sch |
En cours |
Adressage I²C
- INA237 : A0/A1 configurables → 4 adresses max par bus (extensible via TCA multiplexeur)
- TCA9535 : A0/A1/A2 → 8 adresses max
- Tableau de correspondance :
adresse TCA_INA.xlsx
Contraintes d'implémentation
- I²C à 50 kHz (lent) pour fiabilité sur câblage terrain long
delay(500)en fin de loop — acceptable pour application de protection batterie (pas temps-réel strict)- Pas de RTOS / pas de tâches concurrentes