Openeo
Cloudless software install for EO Home Hub and Mini Pro 2 EV charger
Install / Use
/learn @minceheid/OpeneoREADME
Cloudless software for the EO Smart Home Hub/Mini and Mini Pro 2 EV charger
EO Charging announced in July 2025 that their EO Smart Home app is being discontinued on November 30th 2025. This disables the ability for owners to set automated timed schedules and to directly manage their device, which will then operate purely as a "plug & play" charger. This project aims to provide an alternate, open source software that can be directly installed on these devices to allow control from the local WiFi network without relying on the original manufacturer.
<p align="center"> <img src="https://github.com/user-attachments/assets/e8eb317d-e411-4b7b-83f1-c2d1a450f97c" style="width:25%; height:auto;"/> <img src="https://github.com/user-attachments/assets/d41a2b3e-8d2e-4806-81a4-dd613ddad66c" style="width:25%; height:auto;"/> <img src="https://github.com/user-attachments/assets/72bbf639-530b-4743-a0a7-431bfc92eaa2" /> </p>NEW: Solar Improvements
The solar charging integration has been improved! - previously the solar charging facility was always on when enabled. We have introduced the concept of solar timers, allowing OpenEO to selectively charge your car during specific hours of the day. This might be useful if you need to run multiple loads from your solar generation (e.g. hot water heater), and need to schedule/prioritise.
Additionally, we now show the status of your solar charging on the Status Panel of the homepage. If solar is active, a yellow icon will be shown.
See more in the <b>Solar Integration</b> section, below.
NEW: Donate to support the development
Several folks have asked about how they might be able to contribute, to thank and to support. The primary method that I'd encourage is for them to subscribe to the OpenEO cloud service. This will give those who wish to contribute an additional service. However - for those that would prefer not to subscribe to the cloud service, here is a payment link that should allow a similar donation. Any payment is entirely voluntary and very much appreciated.
<a href="https://donate.stripe.com/9B66oJ0Lb2AkbeZ9SF2oE00"> <img src="https://github.com/user-attachments/assets/4e257c47-0f61-4faa-8883-8594fb428ef7" style="width:25%; height:auto;"/> </a>NEW: Multiple Schedules
New for the current release - multiple timed schedules can be defined. In order to do this, we had to redesign the UI: in previous versions there was two distinct modes of operation: "Manual" and "Schedule" - the timed schedule would not run if the charger was in "Manual" mode, and vice versa. This has now changed - the new concept is that all defined timer schedules will operate, and they can be overriden by a manual control (either to disable all timers, or to manually switch the charger on). You can scroll through the defined timers on the home page, as well as create new timers and delete unwanted ones. Each timer appears as a separate clockface where you set the start, end and Amps.
NEW: OpenEO Cloud
It sounds a bit odd to have a cloud service for a cloudless EV Charger, doesn't it?. However -for those that might want to access their charger from anywhere, we have developed OpenEO Cloud. This provides a secure interface for connecting to your OpenEO charger over the internet. It works by running the latest version of OpenEO on your charger, which can securely connect to https://openeo.uk, where you can log in with your Google Account and access the familiar OpenEO interface. Importantly, OpenEO does not require your charger to be connected to the cloud service. If you don't enable it - your charger will continue to work as-is. More info, and configuration details below.
Compatibility
This project has been designed to be compatible with the EO Smart Home Hub/Mini and EO "Mini Pro 2" devices. It does not support "Mini Pro 3"
Smart Home Hub/Mini
<p align="center"> <img src="https://github.com/user-attachments/assets/1ad1ba51-ef88-4cb6-9a99-9f922e32f02c" style="width:25%; height:auto;" /> <img src="https://github.com/user-attachments/assets/62a2e6cc-128f-49bd-8265-9c09de2d08fe" style="width:25%; height:auto;" /> </p>Mini Pro 2
<p align="center"> <img src="https://github.com/user-attachments/assets/5488462c-a5c6-44c0-843b-16ec874e846a" style="width:25%; height:auto;" /> </p>Install Instructions NEW
The new and recommended method of install is to download a SD card image directly from GitHub, and boot your pi with it - here's how.
- Obtain a 8GB (or larger) micro SD card. It's worth ensuring that this is a known good card, and at least Class 10 for performance reasons. If the SD card in your hand has been sat at the back of your drawer for a decade, then it's probably worth disposing of it, and getting a new one. We recommend that you keep your original EO SD card safe and separate, so that you can revert easily, should things don't work out for you, however (I do wonder what possible use that crippled old software could be these days...)
- Download the SD card image from here:
-
Get and install a tool to write SD cards. I use the Raspberry Pi imager. Follow the instructions on the tool to write the image to the SD card.
-
IMPORTANT Once the new SD card has been created, remove power to your EO box by disconnecting it or by switching off the relevant breaker in your consumer unit. Please ensure that it is completely isolated from the mains electricity. If you are unsure that the electricity is fully disconnected, then do not proceed.
-
Open the Smart Hub or Mini Pro 2 box by loosening the four captive screws that are visible on the front of the case (you may need to remove the four rubber covers, if they are fitted), and you will see the Raspberry Pi inside (Smart Hub is a Raspberry Pi 3, and the Mini Pro 2 is a smaller Raspberry Pi Zero). You can now switch the SD cards, keeping the original safe. Whilst you are doing this, on the Mini Pro 2, take care to not accidentally dislodge the cables connecting the Raspberry Pi board with the main control board in the lid of the unit.
-
Close the EO enclosure, and apply power to it. The Raspberry Pi should boot, and if you got the configuration correct in step #3 above, it will then join your wireless network and you can log in with SSH (you should be able to find the RPi IP address from your broadband router). Note that the first time that you power up with a fresh SD card, it will take about five minutes to fully boot before it is seen on the network. Be patient - it's only a small pi and it takes some time to set itself up.
-
Once the pi fully boots, whilst standing close to your charger, you should have a wireless network called "OpenEO", use your phone or tablet to join this wireless network. Once joined, use your browser which will redirect to the wifi configuration interface, allowing you to set your charger to your home network. If you need command-line access to your charger, then here is also where you'd set a public SSH key. For security purposes, the OpenEO network is only available for 30 minutes after the charger starts, after which time it disables itself.
- Once the wifi network has been sucessfully configured, you should be able to disconenct from the OpenEO network, reconnect to your home network, and then browse to http://openeo.local/ or the IP address that was allocated by your network to see the full OpenEO interface.
Install Instructions - Manual Method
Of course - it remains possible to carry out a manual install. Here's how we do that:
This software can be installed onto a Raspberry OS Lite install.
- Obtain a 8GB (or larger) micro SD card
- Flash the SD card with the Raspberry PI imager (Device: Raspberry Pi 3 for Home Hub and Raspberry Pi Zero for Mini Pro 2, Operating System: Raspberry PI OS Lite (32 bit)). Note that as of OpenEO v0.7, all development and testing is done on Raspberry Pi OS (32 bit) Lite "Trixie", which was released in December 2025.
- In the Raspberry PI imager "Storage" settings, select your SD Card:
- In the Raspberry PI imager "Customisation" settings - set your Hostname to "openeo" and set the Localisation configuration as appropriate to your part of the world. In Username/Password you must use a username of "pi". Continue to fill in your Wireless LAN
