# SILCARP: Open-Source EV Electronics, VCU, Inverter & BMS Architecture
**Dokumentace otevřené elektroniky pro SILCARP L7e-CP**

---

### Schéma architektury pohonné a řídicí elektroniky

```
                       +-------------------------------------------------------+
                       |              12V Low Voltage & Safety Bus             |
                       +-------------------+---------------+-------------------+
                                           |               |
                                           v               v
+-----------------------+          +---------------+  +---------------------+
| Driver Controls       |          | RealDash      |  | Round Aux Display   |
| - Dual Hall Throttle  |          | Digital Dash  |  | (ESP32-S3 + LVGL)   |
| - 0.5-4.5V Brake Pres |          | (Android/RPi) |  | 52mm Gauge Pod      |
| - D/N/R Shift Switch  |          +-------+-------+  +----------+----------+
| - E-Stop & Key Switch |                  |                     |
+-----------+-----------+                  | USB / CANable       | CAN
            | Analog/Discrete              | (SLCAN / SocketCAN) | (TWAI)
            v                              v                     v
+-------------------------------------------------------------------------------+
|                       500 kbps CAN 2.0B Powertrain Bus                        |
+-------+----------------------------------+-----------------------------+------+
        | CAN1                             | CAN2                        |
        v                                  v                             v
+--------------------+            +--------------------+        +---------------+
| ZombieVerter VCU   |            | Trampa VESC 100/250|        | LilyGO        |
| (STM32F105 + ESP)  |            | Motor Controller   |        | T-CAN485      |
+---+----+-----+-----+            +---------+----------+        | ESP32 Bridge  |
    |    |     |                            |                   +-------+-------+
    |    |     | Low-Side Relays            | 3-Phase AC                | RS485 / UART
    |    |     +--> Precharge Contactor     v                           v
    |    +--------> Main Positive Cont.   [ PMSM Motor ]        +---------------+
    +-------------> Negative Contactor    [ 15kW / 8k RPM ]     | JK-BMS 24S    |
                                                                | 200A-300A     |
                                                                | 2A Active Bal |
                                                                +-------+-------+
                                                                        |
                                                                        v
                                                                [ 24S LiFePO4 ]
                                                                [ 76.8V / 105Ah ]
```

---

## 1. ZombieVerter VCU (OpenInverter Community)

**ZombieVerter VCU** je de-facto standard pro stavbu open-source a DIY elektromobilů (Damien Maguire / EVBMW a Johannes Huebner).

* **Mikrokontrolér:** STM32F105RCT6 (ARM Cortex-M3, 72 MHz, dual CAN).
* **Konektor a krytí:** Standardní automobilový 56-pinový konektor Delphi/Aptiv ve vodotěsném hliníkovém těle (IP67).
* **Integrovaná Wi-Fi:** Integrované ESP pro webové rozhraní OpenInverter — konfigurace, diagnostika, kalibrace pedálu a live data z libovolného telefonu přes prohlížeč.
* **Rozhraní a I/O:**
  * **3× nezávislé izolované CAN 2.0B sběrnice** (CAN1 Inverter, CAN2 BMS, CAN3 Dashboard/CCS).
  * **1× LIN Bus** (volič jízdy, posilovač řízení, vodní čerpadlo).
  * **Výstupy pro stykače:** Chráněné spínače pro Main +, Main -, Precharge stykač, ventilátory, pumpu.
  * **Bezpečnostní logika pedálu:** Čtení dvou nezávislých signálů (pot1, pot2) s křížovou validací. Při odchylce >10 % se točivý moment okamžitě odpojí.
  * **Automatický precharge:** Monitoruje napětí meziobvodu. Jakmile dosáhne 90–95 % napětí baterie, sepne hlavní stykač a rozepne precharge. Při překročení 2000 ms bez nabití okamžitě odpojí okruh a hlásí chybu.
  * **Plynulá rekuperace:** Možnost zapojení snímače tlaku v brzdovém okruhu (0.5–4.5V) pro proporcionální brzdnou rekuperaci. Automatické spínání brzdových světel při rekuperačním zpomalení >0.7 m/s² (dle ECE).
* **Kde koupit / stáhnout:**
  * GitHub: [damienmaguire/Stm32-vcu](https://github.com/damienmaguire/Stm32-vcu)
  * E-shop (hotová deska): [EVBMW Shop](https://evbmw.com/) / [OpenInverter Shop](https://openinverter.org/shop/) (~€280–€350).

---

## 2. Invertor VESC (72V / 15kW–25kW)

### Zásadní pravidlo dimenzování napětí:
* **24S LiFePO4 pack má nominální napětí 76.8V a plné nabití 87.6V** (24 × 3.65V). Při prudkém brzdění vznikají napěťové špičky až **90V–92V**.
* Běžné 75V VESC kontroléry (Flipsky 75200, Makerbase 75200) **nelze** na 24S použít (dojde k proražení MOSFETů).
* Pro 72V/24S je nutné použít **100V VESC hardware**.

### Doporučený hardware:
1. **Trampa VESC 100/250 (Water-Cooled MkIII):**
   * Max napětí: **100V DC** (až 24S LiFePO4).
   * Proud: 250A trvale (vodní chlazení), 350A špičkově.
   * Špičkový výkon: **26.8 kW** při 76.8V.
   * Cena / dostupnost: [Trampa Boards UK](https://trampaboards.com/) (~€580–€680).
2. **Spintend UBox 100V 250A:**
   * Max napětí: 100V DC. Proud: 150A trvale, 250A špička.
   * Cena: ~$320 (AliExpress / Spintend.com).

### Komunikace s VCU po CAN 2.0B:
* Řídicí příkaz `CAN_PACKET_SET_CURRENT` (ID = 1): posílá požadovaný proud motoru v miliampérech s frekvencí 50 Hz.
* Bezpečnostní watchdog: pokud VESC neobdrží CAN paket do 500 ms, automaticky rampuje výkon na 0.
* Zpětná telemetrie: VESC vrací otáčky (RPM), proud, napětí meziobvodu a teploty měniče i motoru.

---

## 3. BMS: JK-BMS + Otevřený ESP32 CAN Bridge

Místo stavby vlastního BMS hardware z nuly (např. extrémně složitý a drahý akademický foxBMS 2):
* **Hardware:** **JK-BMS 24S 200A–300A s 2.0A aktivním balancérem** (~€140 na AliExpressu).
  * 2A aktivní balancér je zásadní pro srovnání velkých 105Ah–230Ah prismatických článků.
* **Open-Source Bridge:** Deska **LilyGO T-CAN485** (~$15, ESP32 + CAN + RS485).
  * Firmware: [`SirIcy/esphome-jk-bms-can`](https://github.com/SirIcy/esphome-jk-bms-can)
  * Čte telemetrii článků z JK-BMS přes RS485 a posílá standardní automobilové CAN rámce (napětí, proud, SOC %, teploty, alarmy).
  * V případě podpětí článku nebo přehřátí pošle VCU příkaz k bezpečnému otevření hlavních stykačů.

---

## 4. Digitální palubní deska (Dashboard)

1. **RealDash (Android Tablet / Raspberry Pi):**
   * Běží na levném 8"–10" Android tabletu nebo RPi přes USB adaptér **CANable 2.0** (firmware Candlelight).
   * Zobrazuje rychlost (km/h z otáček motoru), SOC %, výkon (kW), teploty, kontrolky D/N/R a světel.
   * Automatické uspání/probuzení podle zapnutí 12V klíčku.
2. **Kruhový pomocný displej (52 mm budík):**
   * **Waveshare ESP32-S3 1.28" / 2.1" Round Touch Display** (~$22).
   * Firmware: Open-source LVGL EV Gauge. Zapadne do standardního 52mm otvoru pro budíky.

---

## 5. Kompletní kusovník otevřené elektroniky (Off-The-Shelf)

| Komponenta | Model | Otevřený projekt / Zdroj | Přibližná cena |
| :--- | :--- | :--- | :--- |
| **VCU (Mozek vozu)** | ZombieVerter VCU (IP67 box) | [damienmaguire/Stm32-vcu](https://github.com/damienmaguire/Stm32-vcu) | €320 |
| **Invertor** | Trampa VESC 100/250 | [vedderb/bldc](https://github.com/vedderb/bldc) | €620 |
| **BMS** | JK-BMS 24S 200A (2A Active Bal) | Sériový hardware (AliExpress) | €150 |
| **BMS CAN Bridge** | LilyGO T-CAN485 (ESP32) | [SirIcy/esphome-jk-bms-can](https://github.com/SirIcy/esphome-jk-bms-can) | €20 |
| **HV Stykače** | 2× Gigavac GX14 + Precharge | Průmyslový standard (Mouser) | €220 |
| **Palubní tablet** | 8" Android IPS Tablet | Běží RealDash | €100 |
| **USB-CAN převodník** | CANable 2.0 (Candlelight) | Otevřený hardware (Tindie) | €30 |
| **Pomocný 52mm budík** | Waveshare ESP32-S3 Round LCD | Otevřený LVGL projekt | €25 |
| **CELKEM** | **Kompletní elektronický stack** | **100 % off-the-shelf, bez vývoje PCB** | **~€1,485** |
