Archives/VictronMPPT-ESPHOME
2
0
Fork 0
mirror of https://github.com/KinDR007/VictronMPPT-ESPHOME.git synced 2024-10-21 07:09:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
Victron Mppt charger ve.direct to esphome node
46 Commits 3 Branches 1 Tag 786 KiB
C++ 66.3%
Python 33.4%
Shell 0.3%
4dd381d4a3
Go to file
Jiří Bětuňák 4dd381d4a3
Merge pull request #28 from syssi/add-esphome-2021.10-compat
2021-10-22 16:11:24 +02:00
.github/workflows Add esphome 2021.10.0 compatility 2021-10-22 16:05:41 +02:00
components/victron Add esphome 2021.10.0 compatility 2021-10-22 16:05:41 +02:00
.clang-format Apply clang-format 2021-08-29 09:01:00 +02:00
.gitattributes Initial commit 2021-05-30 12:26:43 +02:00
.gitignore Add gitignore and flip some permissions 2021-08-29 08:55:27 +02:00
.yamllint Fix yaml lint issues 2021-08-29 09:44:10 +02:00
esp8266-example-advanced.yaml Refactor sensors and text sensors 2021-09-01 11:56:00 +02:00
esp8266-example-multiple-uarts.yaml Fix CI build 2021-10-04 20:16:01 +02:00
esp8266-example.yaml Refactor sensors and text sensors 2021-09-01 11:56:00 +02:00
LICENSE Initial commit 2021-05-30 12:26:43 +02:00
README.md Add support for inverters 2021-09-21 22:42:27 +02:00

README.md

VictronMPPT-ESPHOME

ESPHome component to monitor a Victron MPPT Charger via ve.direct / UART TTL

Supported devices

All Victron MPPT Chargers providing a ve.direct port.

Tested devices

  • Victron SmartSolar MPPT 75/15
  • Victron SmartSolar MPPT 100/20
  • Victron SmartSolar MPPT 150/35
  • Victron SmartSolar MPPT 250/70
  • Victron Phoenix Inverter 12/500

Requirements

Schematics

                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

Pin Purpose ESP pin
1 GND GND
2 RX
3 TX D7 (RX)
4 5V

Installation

You can install this component with ESPHome external components feature like this:

external_components:
  - source: github://KinDR007/VictronMPPT-ESPHOME@main

uart:
  id: uart0
  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: uart0

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 <<EOF
mqtt_host: MY_MQTT_HOST
mqtt_username: MY_MQTT_USERNAME
mqtt_password: MY_MQTT_PASSWORD

wifi_ssid: MY_WIFI_SSID
wifi_password: MY_WIFI_PASSWORD
EOF

# Validate the configuration, create a binary, upload it, and start logs
esphome run esp8266-example.yaml

The uart_id and victron_id is optional if you use a single UART / victron device. All sensors are optional.

The available numeric sensors are:

  • max_power_yesterday
  • max_power_today
  • yield_total
  • yield_yesterday
  • yield_today
  • panel_voltage
  • panel_power
  • battery_current
  • day_number
  • charging_mode_id
  • error_code
  • tracking_mode_id
  • load_current

The available text sensors are:

  • charging_mode
  • error
  • tracking_mode
  • firmware_version
  • device_type

Big thanks for help to ssieb for the support!