python-openevse-http
A Python library for communicating with OpenEVSE chargers via the HTTP API on ESP8266 and ESP32-based WiFi modules.
Features
- Asynchronous: Built on
aiohttpfor non-blocking I/O. - WebSocket Support: Real-time updates for charger status.
- Firmware Support: Compatible with ESP8266 (2.x) and ESP32 (4.x+) WiFi firmware.
- Comprehensive API:
- Query status and configuration.
- Manage manual overrides.
- Control charging claims and limits.
- Handle schedules.
- Shaper Toggle: Enable or disable the grid shaper feature (requires firmware 4.0.0+).
Installation
pip install python_openevse_http
Quick Start
import asyncio
import aiohttp
from openevsehttp import OpenEVSE
async def main():
async with aiohttp.ClientSession() as session:
charger = OpenEVSE("192.168.1.30", session=session)
await charger.update()
print(f"Charger State: {charger.status}")
print(f"Current Charge: {charger.charge_current}A")
if charger.shaper_active:
print("Shaper is active, disabling...")
else:
print("Shaper is inactive, enabling...")
await charger.toggle_shaper()
await charger.ws_disconnect()
if __name__ == "__main__":
asyncio.run(main())
HTTPS and SSL Verification Options
If your OpenEVSE WiFi/ethernet module uses HTTPS, you can configure the client to connect securely using the ssl=True parameter:
# Connect securely using HTTPS (validating SSL/TLS certificates)
charger = OpenEVSE(
"192.168.1.30",
session=session,
ssl=True,
)
Bypassing SSL Verification (Self-Signed Certificates)
To bypass certificate verification:
# Connect using HTTPS, and disable certificate verification
charger = OpenEVSE(
"192.168.1.30",
session=session,
ssl=True,
ssl_verify=False,
)
API Support Matrix
| Endpoint | Methods | Supported | Description |
|---|---|---|---|
/status |
GET, POST | ✅ | Real-time status, sensors, and Vehicle SoC pushing |
/config |
GET, POST | ✅ | System and WiFi configuration |
/override |
GET, POST, PATCH, DELETE | ✅ | Manual charging overrides & current limits |
/claims |
GET, POST, DELETE | ✅ | Client-based charging claims |
/schedule |
GET, POST | ⚠️ | Charging schedule management (Retrieval only) |
/limit |
GET, POST, DELETE | ✅ | Charge limits (Time, Energy, SoC) |
/shaper |
POST | ✅ | Grid shaper control (v4.0.0+) |
/restart |
POST | ✅ | Reboot WiFi gateway or EVSE module |
/divertmode |
POST | ✅ | Solar divert mode control |
/r (RAPI) |
POST | ✅ | Direct RAPI command interface |
/ws |
GET | ✅ | WebSocket real-time updates |
/time |
GET, POST | ❌ | RTC and NTP time settings |
/logs |
GET | ❌ | System and debug event logs |
/emeter |
DELETE | ❌ | Energy meter reset |
/wifi |
GET, POST | ❌ | Network scanning and AP configuration |
/tesla |
GET | ❌ | Tesla vehicle integration |
/certificates |
GET, POST, DELETE | ❌ | SSL/TLS certificate management |
/schedule/plan |
GET | ❌ | Schedule planning and optimization |
/update |
POST | ✅ | Firmware update interface |
/rfid/add |
POST | ❌ | RFID tag management |
✅ = Fully Supported | ⚠️ = Partial Support | ❌ = Not yet implemented
License
This project is licensed under the Apache-2.0 License.
1 maintainer
Metadata
1 maintainer
Release files for python-openevse-http 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| python_openevse_http-1.6.0.tar.gz | 81.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_openevse_http-1.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 113.0 kB
Release files / python_openevse_http-1.6.0.tar.gz
| Download URL | python_openevse_http-1.6.0.tar.gz |
|---|---|
| Size | 81.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
685970390a1bcf43427dad18961c2dec68079c5d3c4ad54e4ce773bfee967441
|
|
BLAKE2b-256 checksum How to use checksums |
eba8e06063a8b7145d8a032f4924c49b1ce67092a65db05214f0f9fdbcb30c5f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / python_openevse_http-1.6.0-py3-none-any.whl
| Download URL | python_openevse_http-1.6.0-py3-none-any.whl |
|---|---|
| Size | 31.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b29e4f06b3b971070ac6ca5719789fc37325eb812eeddbb6fec8662451ee9b3
|
|
BLAKE2b-256 checksum How to use checksums |
3849787740cebfc81488a4d7716b32c5951445ba478997ae96861a25ea253111
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency log
