/victron-hacs

Home Assistant plug-in for Victron Instant Readout compatible devices

Primary LanguagePython

hacs_badge

Victron Instant Readout Integration

This integration allows exposing data from Victron devices with Instant Readout enabled in Home Assistant.

Supported Devices & Entities:

  • SmartShunt 500A/500mv and BMV-712/702 provide the following data:
    • Voltage
    • Alarm status
    • Current
    • Remaining time (mins)
    • State of charge (%)
    • Consumed amp hours
    • Auxilary input mode and value (temperature, midpoint voltage, or starter battery voltage)
  • Smart Battery Sense
    • Voltage
    • Temperature (°C)
  • MPPT/Solar Charger
    • Charger State (Off, Bulk, Absorption, Float)
    • Battery Voltage (V)
    • Battery Charging Current (A)
    • Solar Power (W)
    • Yield Today (Wh)
    • External Device Load (A)
  • Inverter
    • Device State (Off, Inverting)
    • Battery Voltage (V)
    • AC Voltage (V)
    • AC Current (A)
    • AC Apparent Power (VA)
  • VE.Bus Adapter (works with Multiplus Inverters)
    • Device State (Off, Inverting)
    • Battery Voltage (V)
    • Battery Current (A)
    • Battery Temperature (°C)
    • Battery State of Charge (%)
    • AC Input State (AC_IN_1, AC_IN_2, NOT_CONNECTED)
    • AC Input Power (W)
    • AC Output Power (W)
  • Orion Tr DC/DC Converter
    • Operation Mode
    • Input Voltage (V)
    • Output Voltage (V)
    • Off Reason
    • Charger Error
  • Orion XS DC/DC Converter
    • Operation Mode
    • Input Voltage (V)
    • Input Current (A)
    • Output Voltage (V)
    • Output Current (A)
    • Off Reason
    • Charger Error

Installation

Manual

  1. Clone the repository to your machine and copy the contents of custom_components/ to your config directory
  2. Restart Home Assistant
  3. Setup integration via the integration page.

HACS

  1. Add the integration through this link: Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.
  2. Restart Home Assistant
  3. Setup integration via the integration page.