Skip to content

adrixair/PiPhocos

Repository files navigation

⚡ PiPhocos

High-performance, local-first dashboard & monitor for Phocos Any-Grid on Raspberry Pi.

Version Raspberry Pi PWA A11y License: MIT


PiPhocos dashboard overview

Live telemetry, battery status, energy history, and CSV export in one lightning-fast local web app. Designed as a Progressive Web App (PWA) compatible with both desktop and mobile devices.


✨ Features

  • 📊 Real-time Monitoring: Instant live telemetry for voltage, load, and battery metrics.
  • 🔋 Battery Management: Precise battery status tracking.
  • 📈 Historical Data: Comprehensive energy history over time.
  • ⬇️ CSV Exports: Easily export your data for external analysis.
  • 🏠 Local First: No reliance on cloud services. Your data stays entirely on your machine.
  • ♿ Fully Accessible: Built with accessibility (a11y) in mind, adhering to modern standards for an inclusive UI.

📸 Screenshots

PiPhocos live chart view
Live Chart telemetry
PiPhocos daily data view
Daily data breakdown

🚀 Quick Start

You need:

  • A Raspberry Pi with Docker and Docker Compose installed.
  • The Phocos USB / RS232 adapter connected to the Pi.
  • Terminal access to the Raspberry Pi.

1. Locate the adapter

Find the exact path of your connected adapter:

ls -l /dev/serial/by-id/

2. Download and configure

Clone the repository and prepare your config file:

git clone https://github.com/adrixair/PiPhocos.git
cd PiPhocos
mkdir -p data
cp templates/config.yml data/config.yml

Edit data/config.yml and explicitly update the core attributes:

  • phocos.serial_port
  • device.start_date
  • prices.price_per_grid_kwh
  • prices.revenue_per_fed_in_kwh

3. Deploy

Start the application using Docker Compose, passing the adapter path:

export PIPHOCOS_SERIAL_PORT=/dev/serial/by-id/your-adapter
docker compose up --build -d piphocos

4. Access the Dashboard

Open your favorite browser and head to:

  • http://localhost:5000
  • http://<your-raspberry-pi-ip>:5000

🎯 Use Cases & Search Tags

This project is specifically tailored for Off-Grid Solar architectures using the Phocos Any-Grid series. It empowers solar enthusiasts, DIY engineers, and homeowners to monitor their energy infrastructure intuitively and privately.

Keywords & Discoverability: Phocos Any-Grid PSW-H, Solar Inverter Dashboard, Off-Grid Solar Monitor, Raspberry Pi Solar Logger, MPPT Tracker Data, DIY Solar Telemetry, Battery Voltage Monitor, RS232 Inverter Communication, Local Solar Smart Home Framework.


📚 Included Resources


🙏 Credits & Acknowledgements

This project was originally a fork of the Sunalyzer project by Boris Brock (VanKurt). The initial codebase descends from his work, while this repository has been heavily narrowed, optimized, and standalone-refactored into a sleek Phocos Any-Grid monitoring path for Raspberry Pi. We thank Boris for the groundwork that made this project possible.


Maintained by Adrien Lejeune · Released under the MIT License

About

High-performance, local-first dashboard and monitor for Phocos Any-Grid solar inverters on Raspberry Pi.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors