https://github.com/jarauvi/beny_wifi
This repository contains Home Assistant custom integration communicating with ZJ Beny chargers over Wifi
https://github.com/jarauvi/beny_wifi
actions beny charger ev hass remote sensors wifi zj
Last synced: about 2 months ago
JSON representation
This repository contains Home Assistant custom integration communicating with ZJ Beny chargers over Wifi
- Host: GitHub
- URL: https://github.com/jarauvi/beny_wifi
- Owner: Jarauvi
- License: gpl-3.0
- Created: 2024-12-21T16:55:50.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-11T20:29:43.000Z (4 months ago)
- Last Synced: 2025-08-24T15:59:47.119Z (about 2 months ago)
- Topics: actions, beny, charger, ev, hass, remote, sensors, wifi, zj
- Language: Python
- Homepage:
- Size: 1.13 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚡ Beny Wifi ⚡
*PRs accepted! My progress with this integration is veeery slow right now and I definitely appreciate help!*
⚠️*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 communicating with ZJ Beny EV chargers over 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 with ZBox app should work with integration.
### Supported chargers
Integration should support 1-phase and 3-phase "smart" chargers with or without DLB. Also OCPP equipped devices may work, but I've had 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 | ✅ |
| BCP-A2-L | 1.26 | WIP |
### Installation
**Using HACS**
You can now find this plugin from HACS Store!
Or alternatively add repository to HACS:
- Click three dots in the upper right corner of HACS.
- From the menu, select Custom Repositories
- Paste link of this repository to Repository field
- Select "integration" to Type field
- Find and install 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 serial number and pin. Also scan interval of the sensors can be configured
### Sensors
Currently, integration creates charger device 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 |
| temperature | [C / F] | Charger temperature
| maximum_session_consumption | [kWh] | Session based maximum consumption |
| timer_start | [timestamp] | Currently set timer start time |
| timer_end | [timestamp] | Currently set timer end time |
| grid_import** | [kW] | Imported power from grid |
| grid_export** | [kW] | Exported power from grid |
| solar_power** | [kW] | Solar power |
| ev_power** | [kW] | Power for charging EV |
| house_power** | [kW] | Power for house |
* 3-phase charger only
* dlb equipped charger only
### 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:
- add possibility to set maximum current
### Troubleshooting guide
1. Get [PCAPdroid](https://github.com/emanuele-f/PCAPdroid)
2. Open that up and select traffic dump to PCAP file and from target apps select Z-Box. Do not start capture yet (on my phone Z-Box did not want to connect to charger while capturing)
3. Open Z-Box and enter the main page of device where the values and data are shown and updated
4. Now go back to PCAPdroid and press circle with "Ready". Record a couple kb of data and stop capturing
5. Under three dots in upper right corner, select Open PCAP file. By default, it is saved to Downloads > PCAPdroid
6. The interesting part is UDP to port 3333
7. From there you can check Payload tab with both request and response
For privacy, just keep in mind that characters 13-18 are your pin code, obfuscate it before sharing if you wish to keep it private
Tools folder has some scripts that may help:
- simple udp server that can be used for simulating charger responses
- tool for converting pcap-file to json that simulator can read
- script for translating messages