Skip to content

barrysolomon/solar_monitor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Solar Monitor v1.1.0.97 - SunPower Monitoring System πŸ†

🌞 Complete Local Solar Monitoring Solution - PRODUCTION READY!

Author: Barry Solomon
Email: barry@testingalchemy.com
License: MIT License

A professional, feature-complete solar monitoring system for SunPower installations. Replace expensive cloud services with your own local dashboard. Features real-time charts, comprehensive analytics, system management, and modern web interface. No monthly fees, complete data ownership, works offline.

πŸ“Έ Live Dashboard Preview

Solar Monitor Dashboard Real-time solar monitoring dashboard with new system dropdown menu, showing 2.71 kW production, 0.35 kW home usage, and 2.37 kW grid export with all 21 devices online

What you're seeing:

  • 🌞 Solar Production: 2.71 kW currently being generated by your panels
  • 🏠 Home Usage: 0.35 kW being consumed by your home right now
  • ⚑ Grid Power: 2.37 kW being exported back to the grid (earning you money!)
  • πŸ“Š Device Status: All 21 devices online (18 inverters + 3 monitoring devices)
  • πŸ“ˆ Performance Data: Peak production of 6.28 kW, daily averages, and comprehensive analytics

This is your system working perfectly - generating clean energy, powering your home, and selling excess back to the utility company!

πŸ“Š Advanced Analytics Dashboard

Analytics Dashboard Interactive power flow analysis with customizable time periods and chart types

Advanced Analytics Features:

  • πŸ“ˆ Interactive Charts: Real-time power flow visualization with production (green), consumption (red), and grid export/import (blue)
  • ⏱️ Flexible Time Periods: Last hour, 4 hours, 24 hours, 7 days, or 30 days
  • πŸ“Š Multiple Chart Types: Line charts, area charts, and bar charts
  • πŸ” Detailed Analysis: Minute-by-minute data resolution for precise monitoring
  • πŸ“± Responsive Design: Full-screen mode and adjustable chart heights

πŸ”Œ Professional API Documentation

API Documentation Interactive API explorer with live testing capabilities

Developer-Friendly API:

  • πŸ› οΈ Interactive Testing: Test all endpoints directly in the browser
  • πŸ“š Complete Documentation: Detailed parameter descriptions and example responses
  • 🌐 RESTful Design: Standard HTTP methods with JSON responses
  • πŸ”— Direct PVS6 Access: Connect directly to your SunPower gateway
  • ⚑ Real-Time Data: Live system status, device information, and historical data

✨ Features (v1.1.0.97 - Production Release)

🎨 Modern Web Interface

  • Card-Based Layout: Clean, organized design throughout all pages
  • Responsive Design: Works on desktop, tablet, and mobile devices
  • Real-Time Status Indicators: PVS6, Collector, and Database status in menu bar
  • Smooth Transitions: Enhanced user experience with modern animations
  • Clean Navigation: Intuitive 6-page structure with System dropdown menu (Overview, Inverters, Analytics, Data, System β–Ό, Help)
  • Comprehensive Help System: Built-in documentation for all features and troubleshooting

πŸ“Š Comprehensive Performance Analytics

  • Interactive Charts: Chart.js integration with multiple time periods (1h, 4h, 24h, 7d, 30d)
  • Performance Summary: Total production, consumption, net export with time period selector
  • Peak Performance Tracking: Production, consumption, and export peaks with timestamps
  • Daily Averages: Comprehensive statistics for any time period
  • Import/Export Analysis: Charts show negative values for grid import

⚑ Professional Inverter Monitoring

  • 18 Inverter Dashboard: Individual status cards for all inverters
  • Summary Statistics: Total power, online count, average efficiency
  • Auto-Loading Data: Inverters load automatically on page access
  • Real-Time Updates: Live power output and efficiency monitoring
  • Quick Actions: Export data, run diagnostics, toggle auto-refresh

πŸ—ƒοΈ Data Management (Data Mgmt Page)

  • Complete SQL Query Interface: Full SQL editor with AG-Grid results display and chart visualization
  • Table Browser: Filter by time range and device type with sortable columns
  • Template Queries: Pre-built queries for common analyses (Recent Production, Device Summary, etc.)
  • Export Capabilities: CSV and JSON downloads for all query results
  • Chart Integration: Visualize SQL query results as interactive charts

βš™οΈ Enhanced System Management (System Page)

  • System Dropdown Menu: Organized navigation with System, Database, and API options
  • System Information: Version, uptime, temperature, disk usage, and service status
  • Database Statistics: Real-time metrics, record counts, and health monitoring (moved from Data page)
  • Database Maintenance: Cleanup, optimization, and backup tools (moved from Data page)
  • PVS6 Diagnostics: Enhanced WiFi signal strength detection with multi-platform support
  • System Management: Service control, WiFi management, and recovery wizard
  • Organized Layout: Card-based design with structured sections

πŸ” Secure Configuration Management

  • Environment Variables: Secure .env file for sensitive data (serial numbers, passwords)
  • Automatic Setup: Secure file permissions and configuration management
  • Credential Protection: No hardcoded passwords or serial numbers in code
  • Reboot Persistence: Configuration survives system restarts

πŸ›’ Hardware Requirements

Recommended Setup - $85

Network Configuration

  • PVS6 WiFi Connection: SunPower12345 hotspot (172.27.152.1)
  • Home Network Access: Ethernet connection for remote monitoring
  • Dual Network Setup: WiFi to PVS6, Ethernet to home network

πŸ’° Cost Comparison vs SunPower

Feature SunPower Your System Annual Savings
Basic Monitoring $10/month ($100/year) FREE $100-120/year
Data Ownership ❌ No βœ… Complete Priceless
Offline Access ❌ No βœ… Yes Reliability
Custom Features ❌ Limited βœ… Unlimited Flexibility

Total Savings: $100-120+ per year plus complete data control!

πŸš€ Quick Start - One Command Installation

Step 1: Prepare Raspberry Pi (10 minutes)

  1. Flash SD Card: Use Raspberry Pi Imager with Raspberry Pi OS Lite
  2. Enable SSH: Set username barry and password during imaging
  3. Boot & Connect: Connect Pi to your network via Ethernet
  4. Find IP: Check your router or use nmap -sn 192.168.1.0/24

Step 2: Install Solar Monitor (5 minutes)

SSH to your Pi and run:

# Download and install
wget -O install.sh https://raw.githubusercontent.com/your-repo/solar-monitor/main/install.sh
chmod +x install.sh
./install.sh

This automatically:

  • βœ… Installs all dependencies (Python, Flask, Chart.js)
  • βœ… Configures PVS6 connection and environment variables
  • βœ… Sets up professional dashboard with all 5 pages
  • βœ… Starts monitoring services with auto-restart
  • βœ… Begins data collection every 60 seconds

Step 3: Configure Credentials (2 minutes)

# Edit configuration file with your PVS6 details
sudo nano /opt/solar_monitor/.env

# Update these values:
PVS6_SERIAL_NUMBER=YOUR_PVS6_SERIAL_HERE
PVS6_WIFI_PASSWORD=YOUR_WIFI_PASSWORD_HERE

Step 4: Access Your Dashboard (1 minute)

Open browser: http://YOUR_PI_IP:5000/

πŸŽ‰ What You Get

πŸ“Š Overview Page

  • Real-Time Tiles: Production, consumption, grid status, device count
  • Performance Summary: Total production, consumption, net export with time period selector
  • Peak Performance: Production, consumption, and export peaks with timestamps
  • Daily Averages: Comprehensive statistics for selected time period

⚑ Inverters & Panels Page

  • Summary Dashboard: Total inverters, online count, total power, average efficiency
  • Individual Inverter Cards: Status, power output, efficiency, temperature for all 18 inverters
  • Auto-Loading: Inverters load automatically on page access
  • Quick Actions: Export data, diagnostics, auto-refresh toggle

πŸ“ˆ Analytics Page

  • Interactive Charts: Line, area, and bar charts with Chart.js
  • Time Periods: Last hour, 4 hours, 24 hours, 7 days, 30 days
  • Import/Export Analysis: Charts show negative values for grid import
  • Summary Statistics: Production, consumption, and grid interaction metrics

πŸ’Ύ Data Page

  • SQL Query Interface: Full SQL editor with syntax highlighting
  • Database Statistics: Real-time metrics and health monitoring
  • Table Browser: Browse all tables with filtering and sorting
  • Data Export: One-click CSV and JSON downloads
  • Pre-Built Templates: Common queries for analysis

βš™οΈ System Page

  • PVS6 Diagnostics: Signal strength, connection status, recovery tools
  • System Information: Temperature, disk usage, uptime, service status
  • Database Maintenance: Cleanup, optimization, and backup tools
  • Professional Layout: Card-based design with real-time updates

πŸ› οΈ Troubleshooting

Service Issues

# Check service status
sudo systemctl status solar-monitor.service solar-data-collector.service

# View logs
sudo journalctl -u solar-monitor.service -f

# Restart services
sudo systemctl restart solar-monitor.service solar-data-collector.service

PVS6 Connection Issues

# Check WiFi connection
iwconfig
ping 172.27.152.1

# Test PVS6 API
curl "http://172.27.152.1/cgi-bin/dl_cgi?Command=DeviceList"

# Reset WiFi connection
sudo nmcli connection down PVS6-WiFi
sudo nmcli connection up PVS6-WiFi

Dashboard Issues

# Test local connection
curl http://localhost:5000/api/current_status

# Check database
ls -la /opt/solar_monitor/solar_data.db

# Verify configuration
cat /opt/solar_monitor/.env

πŸ“š Complete Documentation

πŸš€ Getting Started

πŸ”§ Hardware & Network

πŸ”— Integrations

🎯 Expected Results

πŸ“Š System Performance

  • Device Detection: 21 devices (1 PVS6 + 2 meters + 18 inverters)
  • Real-Time Data: 4.5-7.7 kW production during peak sunlight
  • Auto-Updates: Dashboard refreshes every 30 seconds
  • Response Time: <200ms for all pages
  • Offline Operation: Works 24/7 without internet

⚑ Inverter Monitoring

  • All 18 Inverters Online: Individual power output 250-430W each
  • Real-Time Efficiency: 92-96% typical efficiency per inverter
  • Temperature Monitoring: Individual inverter temperature tracking
  • Status Indicators: Online/offline status for each inverter

πŸ“ˆ Data Collection

  • Collection Interval: Every 60 seconds
  • Database Growth: ~60 records per hour
  • Historical Storage: SQLite with automatic optimization
  • Data Export: CSV/JSON for external analysis

🀝 Community & Credits

This project builds upon excellent work by:

⚠️ Important Disclaimer

What This Is

  • Community-developed solution based on proven methods
  • Production-ready monitoring system with professional features
  • Cost-effective alternative to paid cloud services
  • Complete data ownership with offline operation

What This Isn't

  • Official SunPower software (this is independent)
  • Warranty-voiding modification (read-only monitoring only)
  • Internet-dependent service (works completely offline)

Use Responsibly

  • Test thoroughly before relying on it for critical monitoring
  • Follow safety guidelines when working with electrical equipment
  • Backup your data regularly using built-in tools
  • Share your experience to help the community improve

πŸ† System Specifications

Software Stack

  • Backend: Python 3.7+ with Flask framework
  • Frontend: HTML5/CSS3 with Chart.js for analytics
  • Database: SQLite with automatic optimization
  • Services: Systemd for reliable operation

Network Requirements

  • PVS6 Connection: WiFi to SunPower12345 hotspot
  • Home Network: Ethernet for remote access
  • API Access: Direct connection to PVS6 at 172.27.152.1

Performance Metrics

  • Memory Usage: <100MB typical
  • CPU Usage: <5% during normal operation
  • Disk Space: <1GB including database
  • Network Traffic: Minimal (local connections only)

πŸ‘¨β€πŸ’» Author & Credits

Barry Solomon
Email: barry@testingalchemy.com

Acknowledgments

  • Brett Durrett for SunPower PVS6 WiFi credential research
  • SunPower Corporation for creating the PVS6 gateway (trademark of SunPower Corp)
  • Open Source Community for the excellent libraries and tools used

License

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

Disclaimer

This software is not affiliated with or endorsed by SunPower Corporation. SunPower is a trademark of SunPower Corporation. This is an independent monitoring solution for educational and personal use only.


Ready to take control of your solar data? Get started with the one-command installation above.

Current Version: v1.1.0.97 Production Release
Last Updated: September 29, 2025
System Status: 🟒 Production Ready

About

No description, website, or topics provided.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages