diff --git a/docs/guides/adressage-cablage.md b/docs/guides/adressage-cablage.md new file mode 100644 index 0000000..b661d9e --- /dev/null +++ b/docs/guides/adressage-cablage.md @@ -0,0 +1,130 @@ +# Guide d'adressage (ponts de soudure) et de câblage des cartes BMU + +**Cartes concernées** : BMU v2 (24 V) et BMU-v2-48v — l'adressage et la +connectique sont identiques. Connectivité extraite de la netlist KiCad +(`hardware/BMU-v2-48v/`). Plan des ponts : `plan-ponts-soudure.svg` +(vue de dessous — **tous les ponts sont côté cuivre arrière**). + +## 1. Principe + +Jusqu'à **4 cartes mères** partagent le même bus I2C (chaîné en RJ45, +isolé par carte). Chaque carte porte **4 voies** (1 INA237 + 1 sous-carte +MOSFET par voie) et **1 TCA9535** (commande des FETs + LEDs). Toutes les +adresses doivent être uniques sur le bus : + +| Carte | TCA9535 | INA237 (voies 1→4) | +|---|---|---| +| 1 | 0x20 | 0x40 · 0x41 · 0x42 · 0x43 | +| 2 | 0x21 | 0x44 · 0x45 · 0x46 · 0x47 | +| 3 | 0x22 | 0x48 · 0x49 · 0x4A · 0x4B | +| 4 | 0x23 | 0x4C · 0x4D · 0x4E · 0x4F | + +Le firmware valide la topologie au boot : `Nb_TCA × 4 == Nb_INA` +(sinon fail-safe : toutes les voies restent ouvertes). + +## 2. Adressage INA237 — règle générale + +L'adresse INA237 = `0x40 + 4×val(A1) + val(A0)`, où chaque broche +d'adresse est raccordée à l'un des 4 nets : + +| Raccordement | Valeur | +|---|---| +| GND | 0 | +| +3,3 V | 1 | +| SDA | 2 | +| SCL | 3 | + +Sur la carte : **A1 code le numéro de carte, A0 code le numéro de voie.** +Chaque broche d'adresse dispose de **2 ponts à 3 pastilles** (pastilles +numérotées sur la sérigraphie, la centrale « 2 » = broche d'adresse) : + +- pont « bus » : `1 = SDA · 2 = broche · 3 = SCL` +- pont « alim » : `1 = +3,3 V · 2 = broche · 3 = GND` + +| Voie | A0 bus | A0 alim | A1 bus | A1 alim | +|---|---|---|---|---| +| 1 | JP2 | JP4 | JP3 | JP5 | +| 2 | JP6 | JP8 | JP7 | JP9 | +| 3 | JP10 | JP12 | JP11 | JP13 | +| 4 | JP17 | JP19 | JP18 | JP20 | + +> ⚠ **Règle d'or : exactement UN pont par broche d'adresse** (sur l'un +> OU l'autre des deux jumpers de la paire, jamais les deux). Deux ponts +> simultanés court-circuitent par ex. SDA sur +3,3 V → bus I2C mort. +> Vérifier à l'ohmmètre avant la première mise sous tension. + +## 3. Tableaux de soudure par carte + +**A0 — identique sur les 4 cartes** (code la voie) : + +| Voie | Net A0 | Pont à souder | +|---|---|---| +| 1 | GND | **JP4 : 2–3** | +| 2 | +3,3 V | **JP8 : 1–2** | +| 3 | SDA | **JP10 : 1–2** | +| 4 | SCL | **JP17 : 2–3** | + +**A1 — dépend du numéro de carte** (même pont sur les 4 voies) : + +| Carte | Net A1 | Ponts à souder (voies 1/2/3/4) | +|---|---|---| +| 1 | GND | **JP5, JP9, JP13, JP20 : 2–3** | +| 2 | +3,3 V | **JP5, JP9, JP13, JP20 : 1–2** | +| 3 | SDA | **JP3, JP7, JP11, JP18 : 1–2** | +| 4 | SCL | **JP3, JP7, JP11, JP18 : 2–3** | + +(Carte 1 et 2 : aucun pont sur JP3/7/11/18 ; carte 3 et 4 : aucun pont +sur JP5/9/13/20.) + +**TCA9535** — `0x20 + A2·4 + A1·2 + A0`, ponts `1 = +3,3 V · 3 = GND` : + +| Carte | JP14 (A0) | JP15 (A1) | JP16 (A2) | +|---|---|---|---| +| 1 (0x20) | 2–3 | 2–3 | 2–3 | +| 2 (0x21) | **1–2** | 2–3 | 2–3 | +| 3 (0x22) | 2–3 | **1–2** | 2–3 | +| 4 (0x23) | **1–2** | **1–2** | 2–3 | + +## 4. Vérification au premier boot + +1. Ohmmètre : aucune continuité SDA↔SCL, SDA↔3,3 V, SDA↔GND (idem SCL). +2. Alimenter la carte seule (sans packs) et lire le scan I2C au boot + (console série) : le firmware liste les INA et TCA détectés — + comparer aux adresses attendues du §1. +3. Si une adresse manque : pont froid ou absent ; si une adresse + inattendue apparaît : pont sur la mauvaise position. + +## 5. Câblage d'une carte + +Chemin de puissance d'une voie : `pack + → H5..H8 → shunt 2 mΩ → +IDC H15..H18 → sous-carte MOSFET (8 FET back-to-back) → IDC H19..H22 → +bus +BATT → bornier J11`. + +| Point | Repère | Rôle | +|---|---|---| +| Entrée pack + | **H5 / H6 / H7 / H8** (voies 1–4) | arrivée du + de chaque pack | +| Entrée pack − | **H1 / H2 / H3 / H4** | retour − de chaque pack (GND commun) | +| Bus + | **J11** (bornier) | départ vers barre bus + (onduleur/chargeurs) | +| Bus − | **J12** (bornier) | départ vers barre bus − | +| Alim logique | **J3** | entrée buck (+BATT → LM5164 en 48 V / MCP16331 en 24 V) | +| Sous-carte MOSFET | **H15+H19** (v1), **H16+H20** (v2), **H17+H21** (v3), **H18+H22** (v4) | 2 embases IDC 10 pts par voie (courant réparti sur 10 broches) | +| Commande sous-carte | **H23 / H24 / H25 / H26** | header 3 pts : +3,3 V · CMD · GND | +| RJ45 **J1** | amont | vers la tête de bus (I2C_repeater + ESP32) ou la carte précédente — bus tamponné TCA9517 | +| RJ45 **J2** | aval | vers la carte suivante (bus isolé ISO1540, alim VPS8505) | + +Chaînage système : `tête de bus → J1(carte 1) ; J2(carte 1) → J1(carte 2) ; +J2(carte 2) → J1(carte 3) ; J2(carte 3) → J1(carte 4)`. Câbles RJ45 droits +blindés ; chaque carte flotte au potentiel de son pack (isolation par carte). + +Ordre de mise en service : 1) ponts + vérif ohmmètre, 2) sous-cartes +enfichées, 3) RJ45 chaînés, 4) alim logique (packs débranchés) + scan I2C, +5) raccordement des packs un par un, voies ouvertes, 6) fermeture des +voies par le firmware (précharge sur la première voie si onduleur raccordé). + +## 6. Références croisées + +- Plan des ponts (vue de dessous) : [`plan-ponts-soudure.svg`](plan-ponts-soudure.svg) +- Schémas système : [`../branchement/`](../branchement/) +- Designs KiCad : [`../../hardware/`](../../hardware/) +- Firmware : classe de tension 24/48 V (`BMU_PACK_CLASS` ESP-IDF, + `-DBATTERY_PACK_CLASS_48V` PlatformIO) — repo KXKM_Batterie_Parallelator. diff --git a/docs/guides/plan-ponts-soudure.svg b/docs/guides/plan-ponts-soudure.svg new file mode 100644 index 0000000..852306c --- /dev/null +++ b/docs/guides/plan-ponts-soudure.svg @@ -0,0 +1,77 @@ + + + + Carte mère BMU v2 — plan des ponts de soudure + VUE DE DESSOUS (côté soudures — tous les ponts sont sur la face arrière) · pastilles numérotées sur la sérigraphie · guide : adressage-cablage.md + + + + + + + J1 RJ45 + amont + + J2 RJ45 + aval + + J3 + + J11 bus+ + + J12 bus− + + + + VOIE 1 + JP5A1 alim + JP3A1 bus + JP2A0 bus + JP4A0 alim + + + + VOIE 2 + JP9A1 alim + JP7A1 bus + JP6A0 bus + JP8A0 alim + + + + VOIE 3 + JP13A1 alim + JP11A1 bus + JP10A0 bus + JP12A0 alim + + + + VOIE 4 + JP20A1 alim + JP18A1 bus + JP17A0 bus + JP19A0 alim + + + + ADRESSE TCA9535 + JP14A0 + JP15A1 + JP16A2 + + + + Légende des ponts (pastille centrale « 2 » = broche d'adresse) + Ponts « bus » (JP2/3/6/7/10/11/17/18) : 1 = SDA · 3 = SCL — Ponts « alim » (JP4/5/8/9/12/13/19/20 et JP14–16) : 1 = +3,3 V · 3 = GND + ⚠ Un seul pont par broche d'adresse (jamais les deux jumpers d'une paire). Repères bleus = connecteurs face avant (traversants), pour orientation. +