Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/KinDR007/VictronSmartShunt-ESPHOME
SmartShunt ve.direct to ESPHOME node
https://github.com/KinDR007/VictronSmartShunt-ESPHOME
esphome esphome-component hacktoberfest smartshunt vedirect victron
Last synced: 2 months ago
JSON representation
SmartShunt ve.direct to ESPHOME node
- Host: GitHub
- URL: https://github.com/KinDR007/VictronSmartShunt-ESPHOME
- Owner: KinDR007
- License: mit
- Created: 2021-06-03T09:10:54.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-14T15:58:19.000Z (over 1 year ago)
- Last Synced: 2024-08-02T09:22:18.472Z (5 months ago)
- Topics: esphome, esphome-component, hacktoberfest, smartshunt, vedirect, victron
- Language: C++
- Homepage:
- Size: 72.3 KB
- Stars: 70
- Watchers: 13
- Forks: 27
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: license
Awesome Lists containing this project
README
# Deprecated, please use the [Victron MPPT library](https://github.com/KinDR007/VictronMPPT-ESPHOME) which includes support for MPPT and Smartshunt or BMV.
# VictronSmartShunt-ESPHOME
ESPHome component to monitor a Victron BMV and SmartShunt via ve.direct / UART TTL
## Supported devices
All BMV and SmartShunt providing a ve.direct port.
## Tested devices
* Victron SmartShunt 500A/50mV
## Requirements
* [ESPHome 2021.10 or higher](https://github.com/esphome/esphome/releases).
* Generic ESP32 or ESP8266 board
## Schematics
```
UART-TTL
┌────────────────┐ ┌──────────────────┐
│ GND o│<-------------->│o GND │
│ BMV or RX o│ │ ESP32/ │
│ SmartShunt TX o│--------------->│o D7 ESP8266 │<-- GND
│ 5V/3.3V o│ │ │<-- 3.3V
└────────────────┘ └──────────────────┘
# UART-TTL jack (JST-PH 2.0mm pinch)
┌────────────────┐
│ │
│ O O O O │
│VCC TX RX GND │
└─── ─────── ────┘
```
If you are unsure about to pin order please measure the voltage between GND and VCC (5V/3.3V). 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](https://esphome.io/components/external_components.html) like this:
Example:
```yaml
external_components:
- source: github://KinDR007/VictronSmartShunt-ESPHOME@main
uart:
id: the_uart
rx_pin: D7
baud_rate: 19200
stop_bits: 1
data_bits: 8
parity: NONE
rx_buffer_size: 256
victron_smart_shunt:
uart_id: the_uart
sensor:
- platform: victron_smart_shunt
battery_voltage:
id: bv
battery_current:
id: bc
```
The `uart_id` is optional.
All sensors are optional.
```yaml
- platform: victron_smart_shunt
battery_voltage:
name: "Battery Voltage"
id: bv
battery_current:
name: "Battery Current"
id: bc
fw_version:
name: "fw"
id: fw
pid:
name: "pid"
id: pid
instantaneous_power:
name: "instantaneous power"
id: instantaneous_power
time_to_go:
name: "time to go"
id: time_to_go
consumed_amp_hours:
name: "consumed amp hours"
id: consumed_amp_hours
unit_of_measurement: Ah
min_battery_voltage:
name: "Min battery voltage"
id: min_battery_voltage
max_battery_voltage:
name: "Max battery voltage"
id: max_battery_voltage
amount_of_charged:
name: "Amount of charged"
id: amount_of_charged
filters:
- multiply: 0.001
unit_of_measurement: kWh
bmv_alarm:
name: "BMV alarm"
id: bmv_alarm
bmv_pid:
name: "bmv - pid"
id: bmv_pid
last_full_charge:
name: "Time since last full charge"
id: last_full_charge
deepest_discharge:
name: "Depth of the deepest discharge"
id: deepest_discharge
unit_of_measurement: Ah
last_discharge:
name: "Depth of the last discharge"
id: last_discharge
unit_of_measurement: Ah
discharged_energy:
name: "Amount of discharged energy"
id: discharged_energy
filters:
- multiply: 0.001
unit_of_measurement: kWh
state_of_charge:
id: state_of_charge
name: "SoC"
```
The available numeric sensors are:
- `instantaneous_power`
- `time_to_go`
- `state_of_charge`
- `consumed_amp_hours`
- `min_battery_voltage`
- `max_battery_voltage`
- `amount_of_charged`
- `last_full_charge`
- `deepest_discharge`
- `last_discharge`
- `discharged_energy`
- `number_of_full_dis`
- `number_of_charge_cycles`
- `discharged_energy`
The available text sensors are:
- `bmv_alarm_text`
- `bmv_text`
- `charger_text`
- `error_text`
- `alarm_reason_text`
- `tracker_text`
- `fw_version`
- `pid`
Full example in `smartshunt.yaml`
`Big thanks for help to ssieb`
```
#victron #esphome #smartshunt #bmv #ve.direct