Compatible Emulator Hardware~
There are many hardware kits that can run the Battery-Emulator software. Amount of stars ⭐ signal how easy to use the hardware is for a newcomer:
| Product | Notes | CAN interfaces | Newcomer friendly | All features |
|---|---|---|---|---|
| Stark CMR Module | Professional HW, CE certified, Massive I/O, DIN rail mount | 2 (+ 1 add-on) | ⭐⭐⭐ | ✅ |
| BECom | Open source triple-CAN and RS485 (fully isolated), DIN rail mount | 3 | ⭐⭐⭐ | ✅ |
| LilyGo T-2CAN | Dual isolated CAN | 2 (+ 1 add-on) | ⭐⭐⭐ | ✅ |
| LilyGo T-2CANFD | Isolated CAN & Isolated CAN-FD | 2 (+ 1 add-on) | ⭐⭐⭐ | ✅ |
| Waveshare ESP32-S3-RS485-CAN | CAN & Modbus, DIN rail mount | 1 (+ 1 add-on) | ⭐⭐ | ✅ |
| DFRobot Edge101 | CAN & Modbus, metal enclosure, Massive I/O, DIN rail mount | 1 | ⭐⭐ | ✅ |
| 3LB | Open source triple-CAN (fully isolated) | 3 (+ ? add-on) | ⚠️ | ❔ |
| LilyGo T-CAN485 | CAN & Modbus! | 1 (+ 1 add-on) | ⭐ | Reduced |
| ESP32 Devkit V1 | Build your own! For expert tinkerers | ⭐ | Reduced |
NOTE
There is no way to purchase a pre-programmed device. This is a hobbyist open source project. You will be responsible for loading the software and setting it up correctly for your components. There is however a support Discord group available.
Small flash boards~
The LilyGo T-CAN485 and the ESP32 DevKit have only 4 MB of flash, so their firmware is built without some features to make room for the rest.
Reduced features
| Feature | On a small flash board |
|---|---|
| MG 5 battery | Not offered in the battery list |
| Degradation reset for Nissan LEAF | No reset button, the LEAF battery itself works |
| QNHCK2-16 DC current clamp | Not offered in the measurement devices list |
| "Custom Clamp" shunt | Not offered in the measurement devices list |
| CHAdeMO V2X battery, with its CT clamp and IVT shunt support | Not offered in the battery list |
| Chargebyte CCS V2X battery | Not offered in the battery list |
| Chevrolet Volt Gen1 charger | No Charger option in the settings |
| Nissan LEAF PDM charger | No Charger option in the settings |
<hostname>.local address (mDNS) |
Reach the board by its IP address instead |
| I2C display (SSD1306) | Not offered for the configurable port |
| Built-in help texts of the Settings page | Shown only when the browser has Internet access |
| Built-in DTC descriptions on the battery pages | Shown only when the browser has Internet access |
| RS485 driver-enable (DE) pin control | Not driven (matters only for an RS485 transceiver that needs it) |
Status LED 🟢~
Some boards have a built-in LED that is used to signal current status. Most boards expose a GPIO pin where you can attach your own WS2812-compatible pixel you can cut off a LED strip. With this feature, it is easy to at a glance catch what info the board is getting. It will show the current colors:
- 🟢 Pulses green if all is well and BMS is active
- 🟡 Pulses yellow if battery has entered a warning state
- 🔴 Solid red if battery goes into a fault state
- 🔵 Solid blue when upgrading firmware via OTA or before rebooting
- ⚪ Pulses white at various speeds when the BOOT/User button has been long pressed for various tasks at runtime
The Status LED pulse pattern can be Classic (the default), it breathes evenly over a 3 s cycle, just showing the emulator is alive. Energy Flow follows power: a slow rise with a quick drop while charging, a slow fade with a snap back while discharging, and Classic's even breathing when idle. Heartbeat pulses a double "lub-dub" over a dim glow, at 35 BPM when OK and 70 BPM on a warning.
By visiting the Events page in the Webserver UI, you can see which specific warnings/faults are active.
Connectivity 🛜~
The board has wifi, and supports running a Webserver that you can connect to for real time values, Over The Air updates (OTA), cellmonitoring, changing settings and more. See the Webserver page for more info on how to use the system.
For those into home automation, the code is also supports MQTT.
Optional screen via ESPNow 🖥️~
No Battery-Emulator hardware comes with displays by default. If you want to add a local display to your system, the best option is to add a ESPNow compatible microcontroller, which will wirelessly connect to the Battery-Emulator board and display statistics.
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.