Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Battery-Emulator

This software enables EV battery packs to be used for stationary storage in combination with solar inverters.
https://github.com/dalathegreat/battery-emulator

Category: Energy Storage
Sub Category: Battery

Keywords from Contributors

transforms observability archiving profiles measurements optimizers mesh general projections mock

Last synced: 42 minutes ago
JSON representation

Repository metadata

This revolutionary software enables EV battery packs to be easily reused for stationary storage in combination with solar inverters

README.md

Battery-Emulator ⚡🔋

GitHub release (with filter)
GitHub Repo stars
GitHub forks
GitHub actions
Static Badge

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.

Fronius

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 compatibility list on which are supported.

Finally, you will need a compatible hybrid solar inverter, 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.
Wiring

Here's how to connect the high voltage lines
HighVoltageWiring

For more examples showing wiring, see each battery types own Wiki page. For instance the Nissan LEAF page

How to compile the software 💻

Start by watching this quickstart guide

IMAGE ALT TEXT HERE

  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 ESP32 version depends on which release of Battery-Emulator you are running! See the Release Notes for more info on which version to use with the current version (Suggested ESP32 version X.Y.Z)

bild

  1. The Arduino board should be set to ESP32 Dev Module and Partition Scheme to Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS) (under Tools -> Board -> ESP32 Arduino) with the following settings:

ArduinoSettings

  1. Select which battery type you will use, along with other optional settings. This is done in the USER_SETTINGS.h file.
  2. Copy the USER_SECRETS.TEMPLATE.h file to USER_SECRETS.h and update connectivity settings inside this file.
  3. 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 firmware upload.
    NOTE: On Mac, the following USB driver may need to be installed: https://github.com/WCHSoftGroup/ch34xser_macos

NOTE: If you see garbled messages on the serial console, change the serial console to match the baud rate to the code, currently 115200.

NOTE: If you see the error Sketch too big then check you set the Partition Scheme above correctly.

This video explains all the above mentioned steps:
https://youtu.be/_mH2AjnAjDk

Linux Development Environment Setup

In addition to the steps above, ESP32 requires a dependency for a Python module, pyserial install using the cli.
python3 -m pip install pyserial

If you're using Ubuntu , use apt to manage the dependencies of arduino:
pyserial install: sudo apt install python3-serial

Arduino AppImage must be set as executable after downloading to run correctly
example: chmod 775 arduino-ide_2.3.3_Linux_64bit.AppImage

Also you might need to install FUSE to run appimages
sudo apt install libfuse2

Dependencies 📖

This code uses the following excellent libraries:

It is also based on the information found in the following excellent repositories/websites:

Like this project? 💖

Leave a ⭐ If you think this project is useful. Consider hopping onto my Patreon to encourage more open-source projects!

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 12 days ago

Total Commits: 2,260
Total Committers: 52
Avg Commits per committer: 43.462
Development Distribution Score (DDS): 0.395

Commits in past year: 1,400
Committers in past year: 41
Avg Commits per committer in past year: 34.146
Development Distribution Score (DDS) in past year: 0.452

Name Email Commits
Daniel Öster d****t@g****m 1367
Cabooman 8****n 101
amarofarinha 1****a 89
lenvm l****m 88
mvgalen m****n@g****m 74
Jaakko Haakana j****o@h****t 70
josiahhiggs 7****s 55
rha r****o@o****g 48
wjcloudy 5****y 34
Brett Christensen b****n@r****m 33
Jakob Löw j****b@m****e 30
laughingguffly e****m@g****m 27
No-Signal m****t@h****d 26
Steven Maresca s****a@g****m 23
LevinSwe l****m@h****m 21
nmainil 1****l 20
Ole o****d@l****k 18
Christopher Obbard o****c@g****m 15
Bernhard Urban-Forster l****m@g****m 13
rjsc r****t@g****m 13
itpr-gwis2 b****2@i****e 9
pre-commit-ci[bot] 6****] 9
Paul Brand p****d@g****m 8
József Nagy 1****o 7
James Brookes jb@j****m 5
Jamie Jones j****e@j****k 5
mathl79 m****l@g****t 4
JorgenSeemann 8****n 4
Brian McKenna b****n@b****g 3
Bryant Eadon b****n@g****m 3
and 22 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 464
Total pull requests: 778
Average time to close issues: about 2 months
Average time to close pull requests: 4 days
Total issue authors: 195
Total pull request authors: 46
Average comments per issue: 3.87
Average comments per pull request: 0.8
Merged pull request: 684
Bot issues: 0
Bot pull requests: 3

Past year issues: 372
Past year pull requests: 558
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 5 days
Past year issue authors: 162
Past year pull request authors: 41
Past year average comments per issue: 2.95
Past year average comments per pull request: 0.94
Past year merged pull request: 474
Past year bot issues: 0
Past year bot pull requests: 3

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/dalathegreat/battery-emulator

Top Issue Authors

  • dalathegreat (39)
  • havrla (12)
  • GoSmartEV (11)
  • malcolmputer (9)
  • StarkJohan (9)
  • pazdzierzz (9)
  • Jaywatts (8)
  • lenvm (7)
  • dvbhannes (6)
  • EnergibatteriMax (6)
  • pmajor021 (6)
  • jakub8109 (6)
  • obbardc (6)
  • DeadmaroZ-TLOTL (6)
  • bubble07 (5)

Top Pull Request Authors

  • dalathegreat (433)
  • lenvm (70)
  • amarofarinha (41)
  • mvgalen (28)
  • kyberias (25)
  • StarkJohan (21)
  • No-Signal (16)
  • wjcloudy (13)
  • LevinSwe (11)
  • kukumagi (10)
  • rjsc (10)
  • obbardc (10)
  • M4GNV5 (7)
  • josiahhiggs (7)
  • beadon (6)

Top Issue Labels

  • Feature request (114)
  • bug (105)
  • question (49)
  • Troubleshooting install (47)
  • enhancement (37)
  • help wanted (16)
  • Connectivity (13)
  • crash (11)
  • hardware (8)
  • Triage (8)
  • wontfix (6)
  • invalid (3)
  • good first issue (2)
  • dependencies (2)
  • documentation (1)

Top Pull Request Labels

  • enhancement (6)
  • help wanted (2)
  • hardware (2)
  • bug (2)

Package metadata

proxy.golang.org: github.com/dalathegreat/Battery-Emulator

proxy.golang.org: github.com/dalathegreat/battery-emulator

Dependencies

.github/workflows/compile-arduino-sketch.yml actions
  • actions/checkout v4 composite
  • arduino/compile-sketches v1 composite

Score: -Infinity