Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jarauvi/beny_wifi
This repository contains Home Assistant custom integration for controlling and retrieving information from ZJ Beny chargers
https://github.com/jarauvi/beny_wifi
actions beny charger ev hass remote sensors wifi zj
Last synced: 18 days ago
JSON representation
This repository contains Home Assistant custom integration for controlling and retrieving information from ZJ Beny chargers
- Host: GitHub
- URL: https://github.com/jarauvi/beny_wifi
- Owner: Jarauvi
- License: gpl-3.0
- Created: 2024-12-21T16:55:50.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-01-13T13:58:54.000Z (25 days ago)
- Last Synced: 2025-01-13T14:49:20.669Z (25 days ago)
- Topics: actions, beny, charger, ev, hass, remote, sensors, wifi, zj
- Language: Python
- Homepage:
- Size: 1.08 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚡ Beny Wifi ⚡
⚠️*DISCLAIMER: I DO NOT TAKE ANY RESPONSIBILITY OF DAMAGED OR DESTROYED PROPERTY, INJURIES OR HUMAN CASUALTIES. USE AT YOUR OWN RISK*
This repository contains Home Assistant custom component for controlling and retrieving information from ZJ Beny EV chargers via Wifi.
Integration mimics ZBox phone app's communication with charger. All parameters and commands are not mapped yet, but assumption is that any charger communicating using ZBox app should work with integration.
### Supported chargers
I have tested integration with 3-phase, non-OCPP model. 1-phase chargers and OCPP equipped devices may work, but I have no possibility to confirm that. If you have one and you're willing to test the compatibility, please share your results and I will add the model to supported devices 🙏
### Confirmed to work with models
| Model | Firmware version | Status |
| ------------------ | ---------------- | ----------------- |
| BCP-AT1N-L | 1.26 | ✅ |
### Installation
**Using HACS**
- Click three dots in the upper right corner of HACS.
- From the menu, select Custom Repositories
- Paste link to this repository to Repository field
- Select "integration" to Type field
- Find Beny Wifi from the list of integrations
- Restart Home Assistant
**Manually**
- Copy contents of custom_components/beny_wifi folder of this repository to config/custom_components/beny_wifi folder in Home Assistant
**Configuration**
- Find Beny Wifi integration under Settings > Devices & services
- Insert charger IP address. Related on model, port may have to be changed. Also scan interval of the sensors can be configured
### Sensors
Currently, integration contains creates charger devices with following sensors:
| Sensor | Unit | Description |
| ------------------ | --------------- | ----------------------------------------------------------------------------- |
| state | [charger state] | Charger state *(abnormal unplugged standby starting unknown waiting charging)*|
| current1 | [A] | Current L1 |
| current2 | [A] | Current L2 |
| current3 | [A] | Current L3 |
| voltage1 | [V] | Voltage L1 |
| voltage2 | [V] | Voltage L2 |
| voltage3 | [V] | Voltage L3 |
| power | [kW] | Current power consumption |
| total_energy | [kWh] | Session based charged capacity |
| maximum_session_consumption | [kWh] | Session based maximum consumption |
| timer_start | [timestamp] | Currently set timer start time |
| timer_end | [timestamp] | Currently set timer end time |
### Actions
Currently integration supports following actions:
*Only when EV is plugged to charger:*
- beny_wifi.start_charging (*device_id*)
- beny_wifi.stop_charging (*device_id*)
- beny_wifi.set_timer (*device_id | start time | end time*)
- beny_wifi.reset_timer (*device_id*)
- beny_wifi.set_maximum_session_consumption (*device_id | maximum_consumption*)
*Any state:*
- beny_wifi.request_weekly_schedule (*device_id*)
- beny_wifi.set_weekly_schedule (*device_id | sunday | monday | tuesday | wednesday | thursday | friday | saturday | start time | end time)
- beny_wifi.set_maximum_monthly_consumption (*device_id | maximum_consumption*)
### Roadmap
I am pretty busy with the most adorable baby boy right now, but I'll be adding some bells and whistles when I have a moment:
- map missing parameters as sensors (like outdoor temperature)