Skip to the content
2 layers60.3 × 44 mmLocal zappi power, the printed circuit board in 3D

Local zappi power

donoghdb/local-zappi12

A dedicated hardware implant for Myenergi Zappi V2.x EV Chargers. This project interfaces directly with the Zappi's internal control bus to provide Local MQTT, Home Assistant, and Web Control without relying on the…

Size
60.3 × 44 mm
Copper layers
2
Thickness
1.6 mm
Parts
40
Nets
65
Pads
197
Tracks, vias
243, 112
Pours
4
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
16 Dec 2025
Updated
3 Jun 2026

Overview

Local zappi power is an open-source printed circuit board by donoghdb, from the donoghdb/local-zappi repository on GitHub, published under the MIT licence. It is a 2-layer board of 60.3 × 44 mm with 40 parts on 65 nets, routed with 243 tracks and 112 vias.

It is built around the ESP32-S3-WROOM-1-N8 and TCMT4100. Its parts include 12 capacitors, 12 resistors, 5 connectors, 3 ICs and 2 switches. It belongs with the ESP32 boards of this library.

Main components

2

README

README.md

Myenergi Zappi V2.x Local Controller (ESP32-S3)

A dedicated hardware implant for Myenergi Zappi V2.x EV Chargers. This project interfaces directly with the Zappi's internal control bus to provide Local MQTT, Home Assistant, and Web Control without relying on the Myenergi Cloud or Hub. It is intended to action on the 4 external buttons while monitoring the EVSE CP line conversation between the Zappi and the car. It does not affect the software of the Zappi nor does it affect anything else. So it can be removed without affecting anything else.

⚠️ DANGER: HIGH VOLTAGE

This device is installed INSIDE a 240V/400V EV Charger.

  • Isolate power completely at the consumer unit/breaker before opening the Zappi.
  • High voltage components are centimeters away from the installation area.
  • Use at your own risk. Improper installation can damage your charger, vehicle, or cause injury.

🔌 How It Works

This PCB intercepts the connection between the Zappi Main Control Board and the Front Panel (Display & Buttons).

  1. Power (5V): Draws power directly from the Zappi's internal 5V rail (no external USB power needed).
  2. Button Interface:
    • Read Mode: Monitors the 4 physical buttons (Enter, Up, Down, Select) so you can still use the Zappi manually.
    • Write Mode: Simulates button presses using Optocouplers/Relays, allowing you to control the menu remotely via WiFi.
  3. J1772 Pilot Reading:
    • Taps into the CP (Control Pilot) line to detect accurate Status (A-F) and PWM Duty Cycle (Amps).

🛠️ Hardware Interface

The design utilizes an ESP32-S3-WROOM-1 and integrates via the internal 20-pin Ribbon Header.

SignalFunctionConnection
5V / GNDPower SupplyTaken from Zappi internal header.
ButtonsEnter, Up, Down, SelectBi-directional: Reads physical presses & triggers simulated presses via Optocouplers (TCMT4100).
CP SignalJ1772 State DetectionRead ±12V Pilot Signal.
Boost Relaye-Sense Port triggerEnable via relay.

Pinout Configuration (ESP32-S3)

Based on PCB Revision 1.1

  • Button Inputs: GPIO 4, 5, 6, 7
  • Button Triggers: GPIO 12, 13, 14, 15
  • CP Signal (ADC): GPIO 8
  • CP Interrupt: GPIO 3
  • Relay: GPIO 17

💻 Software / Firmware

This project supports two firmware paths depending on your needs:

Option A: ESPHome (Not complete yet)

Best for Home Assistant users. Provides native integration with zero coding.

  • Exposes Buttons as simple HA Switches.
  • Exposes Charging Amps and State as Sensors.
  • Config: Copy esphome/zappi.yaml and esphome/zappi_logic.h to your ESPHome directory.
  • Limitations: Does not monitor or track the menu position. The monitoring of the Zappi buttons is not tested yet.

Option B: Custom C++ Firmware (Best Option)

Best for standalone use or custom MQTT setups.

🌟 Features

  • Full Local Control: No cloud dependency. Works with Home Assistant via MQTT.
  • Offline Scheduler: Set Start/End times directly on the device via text input (e.g., "07:30"). It handles the mode switching (Stopped ↔ Fast) automatically.
  • Robust Time Sync:
    • Primary: NTP via Google/NIST (Direct IP to bypass DNS issues).
    • Backup: "Push" time via MQTT from Home Assistant (works during internet outages).
    • Safety: Scheduler only activates once the system year is verified > 2020.
  • Live Monitoring: View Charging State, Pilot Amps, Duty Cycle, and RSSI.
  • Menu Navigation: Remotely navigate the Zappi menu using the Web UI or HA.
  • Reliability: Includes "Last Will & Testament" (LWT) so Home Assistant immediately knows if the device loses power.
  • Others: Web Interface, WebSocket Live Data, WebSerial, OTA Updates.
  • Tech Stack: PlatformIO, AsyncWebServer.

🔐 Configuration (Custom Firmware)

To keep your WiFi and MQTT passwords safe, this project uses a separate credentials file that is ignored by Git.

1. Create src/credentials.cpp

Create a new file in the src/ folder named credentials.cpp and copy the code below. Update the values with your actual network details.

cpp
#include "credentials.h"
#include <Arduino.h> // for IPAddress

// WiFi Credentials
const char* ssid = "YOUR_WIFI_SSID";
const char* password = "YOUR_WIFI_PASSWORD";

// MQTT Broker Details
const char* mqttServer = "192.168.1.50";
const int mqttPort = 1883;
const char* mqttUser = "homeassistant";
const char* mqttPassword = "mqtt_password";
const char* mqttClientId = "Zappi_Controller";

// Static IP Configuration (Optional)
// Set to 0.0.0.0 if you want to use DHCP
IPAddress staticIP(192, 168, 1, 200);
IPAddress gateway(192, 168, 1, 1);
IPAddress subnet(255, 255, 255, 0);

2. MQTT Topics

The device uses the base topic zappi/ (configurable).

  • Controls: zappi/button/...
  • Sensors: zappi/sensor/...
  • Status: zappi/status (online/offline)
  • Scheduler:
    • Enable: zappi/switch/zap_sch_en/command (ON/OFF)
    • Start Time: zappi/text/zap_sch_start/set (HH:MM)
    • End Time: zappi/text/zap_sch_end/set (HH:MM)
    • Force Time Sync: zappi/time/set_epoch (Epoch Timestamp)

⚡ Installation (Custom Firmware / PlatformIO)

This method allows you to use the full Web Interface and custom C++ logic.

1. Initial Setup (USB)

  1. Clone this repository and open the firmware_custom folder in VS Code with the PlatformIO extension installed.
  2. Connect your ESP32-S3 to your computer via USB.
  3. Open platformio.ini and ensure the OTA lines are commented out (so it uses USB upload by default):
    ini
    ; upload_protocol = espota
    ; upload_port = 192.168.1.X
  4. Click the Upload arrow (→) in the bottom toolbar to flash the firmware.

2. Upload the Web Interface (Filesystem)

The HTML files live in a separate partition called LittleFS. You must upload this once, or the web page will be blank.

  1. Click the PlatformIO Alien Icon on the left sidebar.
  2. Navigate to: Project Tasks → Platform.
  3. Click Upload Filesystem Image.
  4. Wait for the success message. Your ESP32 will reboot.
  5. The HTML can be updated directly from the webserver later via an Upload page.

3. Connect & Use

  1. Search for the WiFi Network: Zappi-AP (Password: password123 or as configured).
  2. Navigate to http://192.168.4.1 (or the IP assigned by your router).
  3. You should see the Zappi Control Dashboard.

4. Future Updates via OTA (Wireless)

Once the device is installed inside the Zappi case, you can update it wirelessly:

  1. Find the IP address of your Zappi Controller (e.g., 192.168.1.50).
  2. Edit platformio.ini and uncomment the OTA lines:
    ini
    upload_protocol = espota
    upload_port = 192.168.1.50  ; Replace with your actual IP
  3. Click Upload in PlatformIO. It will now flash over WiFi.

🔧 Hardware Installation Guide

  1. Power Off: Turn off the Zappi at the breaker.
  2. Open Case: Remove the front fascia and unscrew the main cover.
  3. Locate Header: Find the 20-pin pin header connecting the main PCB to the screen module.
  4. Seperate boards: Use a needle nose pliers to compress each corner connecting pin and carfully seperate the boards. 20 pin in Blue, connecting pins in Red
  5. Extend Header: Extend the header using this component Samtec EW-10-12-G-D-250 or this one EW-10-13-G-D-200.
  6. Connect: With the extended header connect the boards back together and then attach the ESP32 board. Local ESP32 in place, with Molex connector for Wifi
  7. Connect CP: Attach the single sensing wire to the CP terminal block. Attach or Extend the CP line to the ESP32
  8. e-Sence: Attached the 24V output of the zappi power board to the Common Relay connector and the Normally Closed to the e-Sence input on the zappi power board. eSence connection 24V to Input via Relay
  9. Wifi: Attach the Zappi existing antenna to the new board or install a new on. Or else create it with this varient ESP32-S3-WROOM-1-N8R2
  10. Close & Power Up: Reassemble and restore power.

🔌 Schematic

Schematic Preview Download Full PDF Schematic

🧩 Bill of Materials (BOM)

This project requires a custom PCB or a perfboard setup designed to fit inside the Zappi case. There is more Decoupling capacitators than required. Sometimes the power rails dip when the Zappi triggers its own relays.

Active Components

RefComponentDescriptionNotes
U2ESP32-S3-WROOM-1MCU ModuleSchematic specifies WROOM-1 (PCB Antenna). If using the 1U version, connect an external IPEX antenna.
U3ADP33383.3V LDO RegulatorSteps down the Zappi 5V rail to 3.3V for the ESP32.
U1TCMT4100Quad OptocouplerU1: Simulates button presses.

Passive Components

RefValueQuantityDescription
R110kΩ1Pull up to 3.3V for ESP32 Enable Pin.
R2-R539.2Ω4Current limiting for Optocoupler LEDs.
R6-R9100Ω4Pull/Protection for button return lines.
R1082kΩ1Pull up to 3.3V Pilot Signal divider (CP to ADC), 1% Tolerance required.
R11300kΩ1High-side Pilot Signal divider (CP to ADC), 1% Tolerance required.
R12100kΩ1Low-side Pilot Signal divider (ADC to GND), 1% Tolerance required.
C6, C7, C10, C1, C310µF4Bulk capacitance for LDO & 3.3V Rails.
C2, C4, C8, C11, C121µF4Stability capacitance for LDO.
C5, C90.1µF2Decoupling for ESP32 and Power rails.

Connectors

ComponentQuantityPurpose
20-Pin Header12x10 Samtec (HLE-110-02-L-DV-BE-K-TR) to interface with Zappi mainboard.
2-Pin Terminal1Screw terminal for CP (Pilot) wire connection.
3-Pin Header/Terminal1Optional Relay/GPIO breakout (JP5).
Buttons2Reset and GPIO 0 button.
Mini Relay1Optional: Adafruit STEMMA Non-Latching Mini Relay.

🕒 Scheduler & Time Sync

The device includes a System Time Sensor (sensor.system_time) to show you exactly what time the internal clock thinks it is.

How it works:

  1. On Boot: The device attempts to sync time via NTP using Google & NIST IPs (bypassing local DNS issues).
  2. Safety Check: The scheduler will not run until the year is > 2020. This prevents the charger from triggering at the wrong time (e.g., 1970).
  3. Offline Backup: If your internet is down, Home Assistant can "push" the time to the Zappi via MQTT automation using the topic zappi/time/set_epoch.

🧪 Testing the CP (Pilot) Signal (Optional Extra if you want to verify the device before installing it)

The Control Pilot (CP) line communicates the state of the EVSE to the car using specific voltage levels (+12V, +9V, +6V) and a 1kHz PWM signal.

Since we are using a Passive Resistor Divider (300kΩ / 100kΩ), it is critical to verify the voltage levels before relying on the automation.

1. Bench Testing

Before installing the unit into the Zappi, you can verify the voltage divider logic using a DC Power Supply or a simple 9V battery.

  1. Disconnect the ESP32 (if possible) or ensure it is unpowered.
  2. Apply Voltage to the CP Terminal on your custom board:
    • Input 12V: Measure the voltage at the ESP32 GPIO 8 pin. It should be ~3.0V.
    • Input 9V: Measure the voltage at GPIO 8. It should be ~2.25V.
  3. Verify: If you see >3.3V at the GPIO pin, STOP. Your resistor values are incorrect, and you risk frying the ESP32.

2. Live Signal Verification

Once installed in the Zappi, use the WebSerial (Custom Firmware) or Home Assistant Logs (ESPHome) to view the raw ADC readings.

Expected ADC Values (12-bit Resolution)

The code looks for the Peak Voltage of the signal. Here is what you should see in the logs:

StateJ1772 VoltageDivider OutputTarget ADC Raw
A (Unplugged)+12V~3.0V3600 - 4095
B (Connected)+9V~2.25V3100 - 3600
C (Charging)+6V (PWM)~1.5V2500 - 3100
D (Ventilation)+3V (PWM)~0.75V1900 - 2500
F (Error/Fault)-12V-3.0V*< 1500

> Note: The passive divider will pass negative voltages to the GPIO. Ensure your protection diode is in place, or that the ESP32 inputs are clamped effectively to prevent damage during State F.

3. Verifying Amperage (PWM)

When the car enters State C (Charging), the Zappi generates a 1kHz Square Wave.

  1. Check the "Zappi Duty Cycle" sensor.
  2. Compare it to the Zappi Screen.
    • Formula: Amps = Duty Cycle x 0.6
    • Example: A 50% Duty Cycle should display as 30A.

Parts

40
QtyValueFootprintReferences
510uFCapacitor_SMD:C_1206_3216Metric_Pad1.33x1.80mm_HandSolderC1, C3, C6, C7, C10
51uFCapacitor_SMD:C_1206_3216Metric_Pad1.33x1.80mm_HandSolderC2, C4, C8, C11, C12
4100Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR6, R7, R8, R9
439.2Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR2, R3, R4, R5
20.1uFCapacitor_SMD:C_1206_3216Metric_Pad1.33x1.80mm_HandSolderC5, C9
1100kResistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR12
110kResistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR1
13.3VJumper:SolderJumper-2_P1.3mm_Open_TrianglePad1.0x1.5mmJP5
1300kResistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR11
182kResistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolderR10
1A0TerminalBlock_Phoenix:TerminalBlock_Phoenix_PT-1,5-2-5.0-H_1x02_P5.00mm_HorizontalJ3
1ADP3338Package_TO_SOT_SMD:SOT-223-3_TabPin2U3
1Conn_02x10_Top_BottomConnector_Samtec_HLE_SMD:Samtec_HLE-110-02-xxx-DV-BE_2x10_P2.54mm_HorizontalJ4
1DownJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP3
1ESP32-S3-WROOM-1Espressif:ESP32-S3-WROOM-1U2
1EnterJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP1
1GNDConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ5
1GPIO0Button_Switch_THT:SW_PUSH_6mm_H4.3mmSW2
1MountingHoleMountingHole:MountingHole_2.5mm_Pad_ViaH1
1RSTButton_Switch_THT:SW_PUSH_6mm_H4.3mmSW1
1RXTXConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ1
1SelectJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP4
1TCMT4100Package_SO:SOP-16_4.4x10.4mm_P1.27mmU1
1USBConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ2
1UpJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP2

Similar boards

  • 2 layers48.3 × 123.8 mmAltimeter v2, the printed circuit board in 3D

    Altimeter v2

    pimbongaerts/altimeter

    Underwater sonar/USBL interface for photogrammetry surveys. PCB design files and Arduino code.

    74 parts4
  • 2 layers79.7 × 54 mmLapX, the printed circuit board in 3D

    LapX

    alexnaet/LapX

    PCB fürn Igel

    113 parts1
  • 4 layers200 × 150 mmCabShield, the printed circuit board in 3D

    CabShield

    Avery-Jutkowitz/CabShield

    158 parts
  • 4 layers80 × 150 mmCAN Power Control, the printed circuit board in 3D

    CAN Power Control

    risingtideresearch/CAN-Power-Control

    CAN device for switching high-current DC loads and reading sensors and switch closures

    131 parts
  • 2 layers100 × 85 mmCurrent, the printed circuit board in 3D

    Current

    wojtek-00/HomeAutomation

    A modular home automation system built around ESPHome, custom PCB design (KiCad), and 3D-printed enclosures.

    102 parts
  • 2 layers85 × 115 mmOSO BOOK B1, the printed circuit board in 3D

    OSO BOOK B1

    joeycastillo/The-Open-Book

    For details on how to build, test and use Open Book, I've made documentation available here.

    76 parts8.1kCC-BY-SA-4.0
  • 2 layers299 × 82.5 mmPixelWave, the printed circuit board in 3D

    PixelWave

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    663 parts915
  • 4 layers56.5 × 99.8 mmBitaxeGamma, the printed circuit board in 3D

    BitaxeGamma

    bitaxeorg/bitaxeGamma

    Bitaxe based on the BM1370 from the S21 Pro

    147 parts432CERN-OHL-S-2.0

Questions

How big is the Local zappi power PCB?

It measures 60.3 × 44 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Local zappi power use?

40 parts, built around the ESP32-S3-WROOM-1-N8 and TCMT4100. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Local zappi power KiCad files?

From the donoghdb/local-zappi repository on GitHub, at the commit this page was made from: the board is kicad/local-zappi-power/local-zappi-power.kicad_pcb and its schematic kicad/local-zappi-power/local-zappi-power.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Local zappi power design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).