mirror of
https://github.com/dalathegreat/Battery-Emulator.git
synced 2025-10-03 09:49:32 +02:00
99 lines
6.8 KiB
Markdown
99 lines
6.8 KiB
Markdown
# Battery-Emulator ⚡🔋
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This software enables EV battery packs to be used for stationary storage. It achieves this by converting the EV battery CAN data into a brand battery format that solar inverters can understand. This makes it extremely cheap and easy to use large EV batteries in a true plug'n'play fashion!
|
|
|
|
> [!CAUTION]
|
|
> Working with high voltage is dangerous. Always follow local laws and regulations regarding high voltage work. If you are unsure about the rules in your country, consult a licensed electrician for more information.
|
|
|
|
|
|
|
|
|
|
## Hardware requirements 📜
|
|
This code fits on the LilyGo ESP32 T-CAN485 devboard , see https://github.com/Xinyuan-LilyGO/T-CAN485
|
|
|
|
You will also need a complete EV battery. [See the battery compability list on which are supported.](https://github.com/dalathegreat/BYD-Battery-Emulator-For-Gen24/wiki#supported-batteries-list)
|
|
|
|
Finally, you will need a [compatible hybrid solar inverter](https://github.com/dalathegreat/BYD-Battery-Emulator-For-Gen24/wiki#supported-inverters-list), for example the "Fronius Gen24" or "GoodWe ET"
|
|
|
|
## Installation basics 🪛
|
|
1. Connect one end of the LilyGo RS485 to the Gen24 Modbus
|
|
2. Connect the other end of the LilyGo to the CAN side of the battery
|
|
3. Wire up high voltage cable between the Gen24 and the battery
|
|
4. Add a 5-12V power source to power the LilyGo and 12V to the battery (uninterruptible PSU or 12V lead acid recommended in parallel)
|
|
5. Some batteries need manual pre-charge circuit and positive/negative contactor control. Others are automatic. See the wiki for more info.
|
|
6. Enjoy a big cheap grid connected battery!
|
|
|
|
## Wiring example, LEAF battery 💡
|
|
Here's how to wire up the communication between the components.
|
|
|
|
|
|
|
|
Here's how to connect the high voltage lines
|
|
|
|
|
|
For more examples showing wiring, see each battery types own Wiki page. For instance the [Nissan LEAF page](https://github.com/dalathegreat/BYD-Battery-Emulator-For-Gen24/wiki/Nissan-LEAF-battery#wiring-diagram)
|
|
|
|
## How to compile the software 💻
|
|
1. Download the Arduino IDE: https://www.arduino.cc/en/software
|
|
2. Open the Arduino IDE.
|
|
3. Click `File` menu -> `Preferences` -> `Additional Development` -> `Additional Board Manager URLs` -> Enter the URL in the input box: `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json` and click OK.
|
|
4. Click `Tools` menu -> `Board: "...."` -> `Boards Manager...`, install the `esp32` package by `Espressif Systems` (not `Arduino ESP32 Boards`), then press `Close`.
|
|
|
|
**NOTE: The version depends on which release of Battery-Emulator you are running!**
|
|
|
|
- ⚠️ Make sure to use a 2.x.x version if you are on a release **older** than 6.0.0 (For instance ESP32 v2.0.11 when using Battery-Emulator v5.4.0)
|
|
- ⚠️ Make sure to use a 3.x.x version if you are on a release **newer** than 6.0.0 (For instance ESP32 v3.0.0 when using Battery-Emulator v6.0.0)
|
|
|
|
|
|
|
|
5. The Arduino board should be set to `ESP32 Dev Module` (under `Tools` -> `Board` -> `ESP32 Arduino`) with the following settings:
|
|
|
|
6. Select which battery type you will use, along with other optional settings. This is done in the `USER_SETTINGS.h` file.
|
|
7. Press `Verify` and `Upload` to send the sketch to the board.
|
|
NOTE: In some cases, the LilyGo must be powered through the main power connector instead of USB-C
|
|
when performing the initial firsmware upload.
|
|
NOTE: On Mac, the following USB driver may need to be installed: https://github.com/WCHSoftGroup/ch34xser_macos
|
|
|
|
This video explains all the above mentioned steps:
|
|
https://youtu.be/_mH2AjnAjDk
|
|
|
|
## Dependencies 📖
|
|
This code uses the following excellent libraries:
|
|
- [adafruit/Adafruit_NeoPixel](https://github.com/adafruit/Adafruit_NeoPixel) LGPL-3.0 license
|
|
- [ayushsharma82/ElegantOTA](https://github.com/ayushsharma82/ElegantOTA) AGPL-3.0 license
|
|
- [bblanchon/ArduinoJson](https://github.com/bblanchon/ArduinoJson) MIT-License
|
|
- [eModbus/eModbus](https://github.com/eModbus/eModbus) MIT-License
|
|
- [knolleary/pubsubclient](https://github.com/knolleary/pubsubclient) MIT-License
|
|
- [mackelec/SerialDataLink](https://github.com/mackelec/SerialDataLink)
|
|
- [me-no-dev/AsyncTCP](https://github.com/me-no-dev/AsyncTCP) LGPL-3.0 license
|
|
- [me-no-dev/ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer)
|
|
- [miwagner/ESP32-Arduino-CAN](https://github.com/miwagner/ESP32-Arduino-CAN/) MIT-License
|
|
- [pierremolinaro/acan2515](https://github.com/pierremolinaro/acan2515) MIT-License
|
|
- [pierremolinaro/acan2517FD](https://github.com/pierremolinaro/acan2517FD) MIT-License
|
|
- [YiannisBourkelis/Uptime-Library](https://github.com/YiannisBourkelis/Uptime-Library) GPL-3.0 license
|
|
|
|
It is also based on the information found in the following excellent repositories/websites:
|
|
- https://gitlab.com/pelle8/inverter_resources //new url
|
|
- https://github.com/burra/byd_battery
|
|
- https://github.com/flodorn/TeslaBMSV2
|
|
- https://github.com/SunshadeCorp/can-service
|
|
- https://github.com/openvehicles/Open-Vehicle-Monitoring-System-3
|
|
- https://github.com/dalathegreat/leaf_can_bus_messages
|
|
- https://github.com/rand12345/solax_can_bus
|
|
- https://github.com/Tom-evnut/BMWI3BMS/ SMA-CAN
|
|
- https://github.com/maciek16c/hyundai-santa-fe-phev-battery
|
|
- https://github.com/ljames28/Renault-Zoe-PH2-ZE50-Canbus-LBC-Information
|
|
- Renault Zoe CAN Matrix https://docs.google.com/spreadsheets/u/0/d/1Qnk-yzzcPiMArO-QDzO4a8ptAS2Sa4HhVu441zBzlpM/edit?pli=1#gid=0
|
|
- Pylon hacking https://www.eevblog.com/forum/programming/pylontech-sc0500-protocol-hacking/
|
|
|
|
## Like this project? 💖
|
|
Leave a ⭐ If you think this project is useful. Consider hopping onto my Patreon to encourage more open-source projects!
|
|
|
|
<a href="https://www.patreon.com/dala">
|
|
<img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" width="160">
|
|
</a>
|