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 observation archiving profiles measur optimize mock routes projection generic
Last synced: about 12 hours ago
JSON representation
Repository metadata
This revolutionary software enables EV battery packs to be easily reused for stationary storage in combination with solar inverters
- Host: GitHub
- URL: https://github.com/dalathegreat/battery-emulator
- Owner: dalathegreat
- License: gpl-3.0
- Created: 2023-02-19T19:21:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-21T09:58:22.000Z (10 days ago)
- Last Synced: 2025-06-25T07:07:37.997Z (6 days ago)
- Language: C++
- Homepage:
- Size: 29.9 MB
- Stars: 1,579
- Watchers: 84
- Forks: 224
- Open Issues: 106
- Releases: 70
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
README.md
Battery-Emulator β‘π
What is Battery Emulator?
Many manufacturers sell home battery systems to enable homeowners to store power collected from the grid, or renewable sources, to use at times when electricity demand is higher. However almost all of these home battery systems charge a high cost for every kilowatt hour (kWh) of capacity you buy.
At the same time, EV manufacturers have been putting high capacity battery packs into their cars, with no firm plan for what should happen to those batteries if the car is damaged in a crash, or reaches the end of its life as a vehicle.
Battery Emulator enables EV battery packs to be repurposed for stationary storage. It acts as a translation layer between the EV battery and the home inverter. 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.
Quickstart guide π
- Pick a supported inverter (solar panels optional) π
- Pick a supported battery π
- Order the Battery-Emulator compatible hardware π€
- Follow the installation guidelines section for how to install and commission your battery properly π
Installation basics πͺ
- Connect your Battery Emulator hardware to your EV battery
- Connect your Battery Emulator hardware to your inverter
- Wire up high voltage cable between the inverter and the battery
- Add a low voltage power supply to your Battery Emulator hardware
- Configure any additional requirements to allow Battery Emulator to switch on your EV battery (also referred to as 'closing contactors')
- Enjoy a big cheap grid connected battery!
For examples showing wiring, see each battery type's own Wiki page. For instance the Nissan LEAF page
How to compile the software π»
Start by watching this quickstart guide
- Download the Arduino IDE: https://www.arduino.cc/en/software
- Open the Arduino IDE.
- 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. - Click
Tools
menu ->Board: "...."
->Boards Manager...
, install theesp32
package byEspressif Systems
(notArduino ESP32 Boards
), then pressClose
.
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)
- The Arduino board should be set to
ESP32 Dev Module
andPartition Scheme
toMinimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)
(underTools
->Board
->ESP32 Arduino
) with the following settings:
- Select which battery type you will use, along with other optional settings. This is done in the
USER_SETTINGS.h
file. - Copy the
USER_SECRETS.TEMPLATE.h
file toUSER_SECRETS.h
and update connectivity settings inside this file. - Press
Verify
andUpload
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:
- adafruit/Adafruit_NeoPixel LGPL-3.0 license
- ayushsharma82/ElegantOTA AGPL-3.0 license
- bblanchon/ArduinoJson MIT-License
- eModbus/eModbus MIT-License
- ESP32Async/AsyncTCP LGPL-3.0 license
- ESP32Async/ESPAsyncWebServer LGPL-3.0 license
- miwagner/ESP32-Arduino-CAN MIT-License
- pierremolinaro/acan2515 MIT-License
- pierremolinaro/acan2517FD MIT-License
- 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/FozzieUK/FoxESS-Canbus-Protocol FoxESS-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!
Owner metadata
- Name: Daniel Γster
- Login: dalathegreat
- Email:
- Kind: user
- Description: π Automation Engineer (Bsc), π± Plant based βοΈ Reverse engineering specialist ππ Extending Electric vehicle lifecycles
- Website: dalasevrepair.fi
- Location: Vaasa, Finland
- Twitter:
- Company: Dala's EV Repair
- Icon url: https://avatars.githubusercontent.com/u/26695010?u=20d9d4c07ad56cdf0c89dd436a301bd997794d99&v=4
- Repositories: 10
- Last ynced at: 2023-03-03T15:41:38.871Z
- Profile URL: https://github.com/dalathegreat
GitHub Events
Total
- Fork event: 83
- Create event: 258
- Release event: 23
- Issues event: 431
- Watch event: 552
- Delete event: 224
- Member event: 6
- Issue comment event: 1124
- Push event: 1048
- Pull request review comment event: 289
- Pull request review event: 514
- Gollum event: 973
- Pull request event: 671
Last Year
- Fork event: 83
- Create event: 258
- Release event: 23
- Issues event: 431
- Watch event: 552
- Delete event: 224
- Member event: 6
- Issue comment event: 1124
- Push event: 1048
- Pull request review comment event: 289
- Pull request review event: 514
- Gollum event: 973
- Pull request event: 671
Committers metadata
Last synced: 5 days ago
Total Commits: 2,343
Total Committers: 56
Avg Commits per committer: 41.839
Development Distribution Score (DDS): 0.402
Commits in past year: 1,407
Committers in past year: 44
Avg Commits per committer in past year: 31.977
Development Distribution Score (DDS) in past year: 0.463
Name | Commits | |
---|---|---|
Daniel Γster | d****t@g****m | 1402 |
Cabooman | 8****n | 101 |
Jaakko Haakana | j****o@h****t | 97 |
amarofarinha | 1****a | 89 |
lenvm | l****m | 88 |
mvgalen | m****n@g****m | 76 |
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 | 31 |
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 |
pre-commit-ci[bot] | 6****] | 18 |
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 |
Paul Brand | p****d@g****m | 8 |
JΓ³zsef Nagy | 1****o | 7 |
Jamie Jones | j****e@j****k | 5 |
James Brookes | jb@j****m | 5 |
mathl79 | m****l@g****t | 4 |
freddanastrom | f****k@l****e | 4 |
JorgenSeemann | 8****n | 4 |
Brian McKenna | b****n@b****g | 3 |
and 26 more... |
Committer domains:
- ukr.net: 1
- jeito.nl: 1
- poczta.onet.pl: 1
- stamp.se: 1
- coinerella.com: 1
- svane.se: 1
- locatelli.be: 1
- river-soft.net: 1
- mail.bg: 1
- snutt.net: 1
- ging.nz: 1
- brianmckenna.org: 1
- lagun.se: 1
- gmx.net: 1
- jamesbrookespartnership.com: 1
- jamie-jones.co.uk: 1
- itprojekt.ee: 1
- lgaard.dk: 1
- holmes.world: 1
- m4gnus.de: 1
- rea-group.com: 1
- oh1gwk.org: 1
- haakana.net: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 482
Total pull requests: 805
Average time to close issues: about 2 months
Average time to close pull requests: 4 days
Total issue authors: 202
Total pull request authors: 46
Average comments per issue: 3.88
Average comments per pull request: 0.79
Merged pull request: 709
Bot issues: 0
Bot pull requests: 3
Past year issues: 384
Past year pull requests: 585
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 4 days
Past year issue authors: 168
Past year pull request authors: 41
Past year average comments per issue: 2.94
Past year average comments per pull request: 0.92
Past year merged pull request: 499
Past year bot issues: 0
Past year bot pull requests: 3
Top Issue Authors
- dalathegreat (40)
- havrla (13)
- GoSmartEV (11)
- malcolmputer (9)
- StarkJohan (9)
- pazdzierzz (9)
- pmajor021 (8)
- Jaywatts (8)
- jakub8109 (7)
- lenvm (7)
- dvbhannes (6)
- DeadmaroZ-TLOTL (6)
- EnergibatteriMax (6)
- obbardc (6)
- HansNetcom (5)
Top Pull Request Authors
- dalathegreat (450)
- lenvm (70)
- amarofarinha (41)
- kyberias (33)
- mvgalen (28)
- StarkJohan (21)
- No-Signal (16)
- wjcloudy (13)
- LevinSwe (11)
- kukumagi (10)
- rjsc (10)
- obbardc (10)
- M4GNV5 (7)
- josiahhiggs (7)
- matvey83 (6)
Top Issue Labels
- Feature request (118)
- bug (111)
- Troubleshooting install (50)
- question (49)
- enhancement (37)
- help wanted (16)
- Connectivity (15)
- crash (14)
- 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
- Total packages: 2
- Total downloads: unknown
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 140
proxy.golang.org: github.com/dalathegreat/battery-emulator
- Homepage:
- Documentation: https://pkg.go.dev/github.com/dalathegreat/battery-emulator#section-documentation
- Licenses: gpl-3.0
- Latest release: v8.14.1+incompatible (published 14 days ago)
- Last Synced: 2025-06-29T22:33:15.078Z (1 day ago)
- Versions: 70
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%
proxy.golang.org: github.com/dalathegreat/Battery-Emulator
- Homepage:
- Documentation: https://pkg.go.dev/github.com/dalathegreat/Battery-Emulator#section-documentation
- Licenses: gpl-3.0
- Latest release: v8.14.1+incompatible (published 14 days ago)
- Last Synced: 2025-06-29T22:33:15.100Z (1 day ago)
- Versions: 70
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%
Dependencies
- actions/checkout v4 composite
- arduino/compile-sketches v1 composite
Score: -Infinity