VictronMPPT-ESPHOME
ESPHome component to monitor a Victron device (MPPT, SmarShunt, BMV, Phoenix Inverter … ) via ve.direct / UART TTL
Supported devices
All Victron devices providing a ve.direct port.
Tested devices
-
Victron SmartSolar MPPT 75/10 rev2 (0xA074)
-
Victron SmartSolar MPPT 75/15
-
Victron SmartSolar MPPT 100/15
-
Victron SmartSolar MPPT 100/20
-
Victron BlueSolar MPPT 100/30
-
Victron SmartSolar MPPT 150/35
-
Victron SmartSolar MPPT 150/45
-
Victron SmartSolar MPPT 150/60
-
Victron SmartSolar MPPT VE.Can 150/100 rev2 (Using VE.Direct port)
-
Victron SmartSolar MPPT 250/70
-
Victron Phoenix Inverter 12/500
-
Victron Blue Smart IP65 Charger 12|25
-
Victron Orion XS 12|12
-
Victron SmartShunt 500A/50mV
Requirements
Schematics
Attention: The TX voltage of the VE.Direct interface depends on the product: Some are 5V, others 3.3V!
Please measure the voltage between TX and GND. In case of a logic level of 5V you should add a voltage divider or logic level converter between the ESP and the Victron device.
UART-TTL
┌────────────────┐ ┌──────────────────┐
│ GND o│<-------------->│o GND │
│ Victron TX o│--------------->│o D7 ESP32/ │
│ Charger RX o│ │ ESP8266 │<-- GND
│ 5V o│ │ │<-- 3.3V
└────────────────┘ └──────────────────┘
# UART-TTL jack (JST-PH 2.0mm pinch)
┌─── ─────── ────┐
│ │
│ O O O O │
│GND RX TX VCC │
└────────────────┘
If you are unsure about to pin order please measure the voltage between GND and VCC (5V). If you measure a positive voltage you know the position of VCC and GND!
JST-PH jack (direct connection noninsulated)
| Pin |
Purpose |
ESP8266 pin |
ESP32 pin |
| 1 |
GND |
GND |
GND |
| 2 |
RX |
|
|
| 3 |
TX |
D7 (RX) |
GPIO16 (RX) |
| 4 |
5V |
|
|
note: JST-PH connector on this image has lock downwards

According to the VE.direct FAQ, the 5V/3.3 pin has a strict current limitation, allowing only 10mA on average with occasional 20mA bursts lasting up to 5 milliseconds. ESP devices like the ESP8266 and ESP32 draw significantly more current than this limit, typically several hundred milliamperes during startup and an additional 100-150mA when transmitting, which would immediately overload and permanently damage the Victron device’s power circuit. Therefore, powering an ESP directly from these pins is not possible.
note: Level shifter (5V<->3.3V)between esp32 and mppt is not necessary (tested on esp32 nodemcu v1 and MPPT 75/115 , MPPT 150/35 and smartshunt 500A)
Safe connection (insulated)
use ADUM 1201 for galvanic isolation between ESP and Victron Devices (or make an insulated cable for Ve.direct)
Ve.Direct downwards |
Ve.Direct upward |
Purpose (wire color) |
connect |
ADUM1201 #2 |
ADUM1201 #1 |
connect |
ESP8266 pin |
ESP32 pin |
USB TTL cable |
| 1 |
1 |
GND (black) |
<- -> |
GND2 |
GND1 |
<- -> |
GND |
GND |
GND |
| 2 |
2 |
RX (red) |
<- -> |
VOB |
VIB |
<- -> |
D8 (TX) |
GPIO17 (TX) |
TX |
| 3 |
3 |
TX (white) |
<- -> |
VIA |
VOA |
<- -> |
D7 (RX) |
GPIO16 (RX) |
RX |
| 4 |
4 |
5V or 3V3 (yellow) |
<- -> |
VDD2 |
VDD1 |
<- -> |
3V3 or 5V |
3V3 or 5V |
3V3 or 5V |
Note that if the VE.direct RX line is connected to VOB on the ADUM1201, the corresponding VIB needs to be connected to a valid signal, i.e. VDD1 or GND1. Depending on the RX pin configuration of the device, this might enable/disable the device. Check the device documentation for details. If unsure, best leave the RX line unconnected, in which case the VIB pin of the ADUM still should be tied to VDD1 or GND1 to not have it floating.

Buy on Ebay
Buy on Aliexpress
Installation
You can install this component with ESPHome external components feature like this:
external_components:
- source: github://KinDR007/VictronMPPT-ESPHOME@main
uart:
id: uart_0
tx_pin: D8 # Not used! The communication is read-only
rx_pin: D7
baud_rate: 19200
rx_buffer_size: 256
victron:
id: victron0
uart_id: uart_0
sensor:
- platform: victron
victron_id: victron0
panel_voltage:
name: "Panel voltage"
battery_voltage:
name: "Battery voltage"
battery_current:
name: "Battery current"
or just use the esp8266-example.yaml as proof of concept:
# Install esphome
pip3 install esphome
# Clone this external component
git clone https://github.com/KinDR007/VictronMPPT-ESPHOME.git
cd VictronMPPT-ESPHOME
# Create a secret.yaml containing some setup specific secrets
cat > secrets.yaml <
评论