Thanks to visit codestin.com
Credit goes to GitHub.com

Skip to content

ESPHOME based Home Assistant Interface for Voltronic solar inverters and clones with single MPPT input

License

Notifications You must be signed in to change notification settings

mchiriciuc/mppha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MPPHA - Inverter Interface for Home Assistant

ESPHome-based WiFi interface for Voltronic-style solar inverters, PIP inverters, EASUN, etc. , providing seamless integration with Home Assistant.

Made for ESPHome License: MIT

WhatsApp Image 2025-11-09 at 17 47 06_3e8085ea

Just connect the board to the inverter's serial port with a standard RJ45 ethernet cable, provision the board and you are ready to go. Simple as that!

WhatsApp Image 2025-08-29 at 18 02 07_ed289043

Features

  • Comprehensive Monitoring

    • Grid voltage, frequency, and power metrics
    • Solar (PV) voltage, current, and charging power
    • Battery voltage, charging/discharging current, and state
    • Inverter heat sink temperature and bus voltage
    • Output power, voltage, and load percentage
    • Complete fault and warning indicators
    • Single AND Dual MPPT compatible
  • Remote Configuration

    • Battery charging parameters (bulk, float, recharge voltages)
    • Charging source priority (Utility/Solar/Both)
    • Output source priority
    • Maximum charging currents (AC and DC)
    • Dynamic log level control
  • Easy Setup

    • ESP32 Improv WiFi provisioning via Bluetooth
    • Dashboard import for quick adoption
    • No hardcoded credentials required
    • Automatic AP fallback mode

Hardware Requirements

  • MCU: ESP32-S3
  • Interface Board: MPPHA (custom PCB)
  • Inverter: Voltronic-style solar inverters (PIP series, etc.)
  • Connection: UART (GPIO6/GPIO7) at 2400 baud

WhatsApp Image 2025-11-09 at 17 47 06_116c4d56 If you want to purchase the electronics board contact me directly at [email protected]

Installation

  1. Connect the MPPHA device to the serial port of the inverter with the supplied RJ45 cable
  2. The inverter should power the board trough the RJ45 cable and a orange led should light up on the board
  3. The second led should pulse slowly (aprox. once per second)

Initial Setup

  1. Power up the device - The ESP32 will create a WiFi access point named mppha-XXXXXX - Setup (password: setup1234) - Default IP 192.168.4.1
  2. Connect via Bluetooth using ESP Improv in the Home Assistant ESPHome dashboard
  3. Configure WiFi credentials through the provisioning interface
  4. Device auto-discovers in Home Assistant

Configuration

All configuration is done through Home Assistant after initial setup:

  • Battery Settings: Configure voltage thresholds and charging parameters
  • Priority Settings: Set charging and output source priorities
  • Current Limits: Adjust maximum charging currents
  • Log Level: Change logging verbosity for debugging

Troubleshooting

Device not connecting to WiFi

  • Try the fallback AP mode (mppha_single-XXXXXX - Setup)
  • Check WiFi credentials
  • Ensure 2.4GHz WiFi is available (5GHz not supported)

Entities not appearing in Home Assistant

  • Wait 30 seconds for auto-discovery
  • Restart Home Assistant
  • Check ESPHome logs for connection errors

Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Test your changes thoroughly
  4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Credits

  • ESPHome Community for the excellent framework
  • Pipsolar component developers
  • Home Assistant community

Support

Changelog

See CHANGELOG.md for version history and updates.


Made with ❤️ for the ESPHome community

If you want to purchase the electronics board contact me directly at [email protected]

About

ESPHOME based Home Assistant Interface for Voltronic solar inverters and clones with single MPPT input

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published