PVdiary

Uit Pv en zonneboiler wiki
Ga naar: navigatie, zoeken
PVdiary.gif

Inleiding[bewerken]

WiKi van PVdiary V2

PVdiary is een gratis loggingprogramma voor pv installaties. Een voorbeeld van PVdiary vinden jullie hier.

PVdiary gebruikt php code (ontwikkelaar Leslie) om je omvormer uit te lezen, allerhande berekeningen te doen op deze data, en deze in het vervolg in een webvriendelijk formaat naar je webruimte up te loaden, of in je Dropbox te plaatsen.
Daar zorgt javascript (ontwikkelaar Thomas) voor een mooie display van deze data.

Waarom PVdiary?[bewerken]

Naast de gebruikelijke dag-, maand-, en jaaropbrengsten toont PVdiary twee verdere curves:

  1. "7-dagen-max": het maximumvermogen van je pv installatie op hetzelfde moment 7 dagen voor en na de gekozen datum over de verschillende jaren heen. Zo kun je gemakkelijk inschatten of het werkelijk vermogen op de gekozen datum inline is met wat het zou kunnen zijn (bv kun je eventueel degradatie opsporen).
  2. "clear-sky-vermogen": deze curve toont het theoretisch berekende maximumvermogen op elk tijdsstip van de dag. Zo kun je op zonnige momenten nagaan of je werkelijk vermogen overeenkomt met wat het theoretisch had kunnen zijn (in een wolkenvrije periode natuurlijk). Verder krijg je via een popup heel wat nuttige informatie over de stand van de zon, de instralingshoek op je panelen, het gedeelde direct en indirect licht, de geschatte paneeltemperatuur etc).

Ondersteunde omvormers[bewerken]

Oorspronkelijk werden enkel de (SMA) omvormers ondersteund die met SunnyExplorer konden uitgelezen worden. SunnyExplorer kan enkel op een Windows pc.
Het Linux alternatief is SBFspot.

Een aantal plugins/loggers zijn beschikbaar om ook andere omvormers uit te lezen.

  • Enphase
  • Kostal
  • SunnyBeam
  • Yasdi met 485solar
  • Mastervolt
  • ... ( plaats je vraag op het forum )

Noteer dat dat de meeste plugins gebruikt worden op linux. Hiervoor is een Raspberry Pi uitstekend geschikt.

Wat heb ik nodig?[bewerken]

PVdiary kan op een aantal manieren worden gebruikt.

  • Als applicatie op een PC (Windows of Linux)
  • Als applicatie op een RaspberryPi (handmatig instellen)
  • Als applicatie op een RaspberryPi (Via een bestaand Image file)

De laatste optie is vooral bedoeld voor gebruikers met een gebrekkige Unix kennis


PVdiary op een Windows PC[bewerken]

  • SMA omvormer met bluetooth
  • PC met bluetooth (ingebouwd of dongle), windows XP en hoger.
  • SunnyExplorer (gratis download bij SMA: http://www.sma.de/en/products/software/sunny-explorer.html). Pas op: de laatste versie van SunnyExplorer (1.04) heeft blijkbaar een bug waardoor de import van csv files via de CLI niet werkt. We raden dus aan de laatste werkende versie van SunnyExplorer (1.03) te gebruiken, downloaden kun je die hier: https://dl.dropbox.com/u/2790571/SunnyExplorerSetup103.exe
  • PHP (minimum versie 5.4.x) , PVdiary is geschreven in PHP en is volledig "web-based".
  • PVdiary-installer.
  • een webruimte met ftp access, of een Dropbox

PVdiary op een Raspberry pi[bewerken]

PVdiary op een Rpi heeft het grote voordeel dat het stroomverbruik van een Rpi extreem laag is, minder dan 16kWh op jaarbasis. Om deze reden kan de Rpi permanent on-line zijn en is in principe ook 7*24 vanaf internet te benaderen.

  • Indien je de raspberry volledig zelf wil installeren en configureren kun je hier terecht. Ook voor installatie onder andere smaken linux bevat deze pagina wellicht interessante informatie.
  • Vanaf november 2014 is een image beschikbaar waarmee je direct aan de slag kunt. Deze optie is vooral interessant voor mensen met geen of weinig Linux kennis. Uitgangspunt is dat de volledige installatie, configuratie en werking van Pvdiary webbased via een browser kan verlopen, in principe is zelfs geen monitor of keyboard op de Rpi nodig omdat de Rpi zuiver als server gebruikt wordt. Meer informatie in de Handleiding.

Hoe PHP installeren[bewerken]

Opgelet installatie van PHP op windows 8.1 schijnt niet altijd vlekkeloos te lopen

  • Een eventueel reeds bestaande PHP folder van naam veranderen, bv van C:\PHP naar C:\PHP_opzij
  • Het PHP_setup.hta script begeleid je bij de installatie en configuratie van PHP.
  • Open http://users.telenet.be/aps11tl/downloads/PHP_setup.zip en klik op het PHP_setup.hta script
  • Waarschijnlijk zal het script pas na bevestiging van de windows "security manager" of waakhond kunnen gestart worden?
  • Volg de 5 stappen (PHP.INI en snelkoppelingen worden aangemaakt)
  • Als alles OK is, ga je verder op http://localhost:8081/PHP_setup.php
  • Belangrijk ! Je moet uitloggen of de PC herstarten om de de aanpassing van de Path variabele in de registry aktief te maken. Wil je dit vermijden dan moet je dit handmatig aanpassen VOOR het opstarten van de PHP webserver. Dit gaat via Configuratie-scherm -> Systeem -> Geavanceerd -> Omgevingsvariablen

De Systeemvariabele Path opzoeken in de lijst en bewerken om er ";C:\PHP" aan toe te voegen ...

  • PHP_setup zal 3 snelkoppelingen aanmaken:

start->programs->PHP->HTTPD dit start de webserver
start->programs->PHP->PHP_setup stuurt je browser naar http://localhost:8081/PHP_setup.php
Een PHP_setup icoon op het bureaublad die de webserver start indien nodig en vervolgens je browser naar bovenvermelde url stuurt.

  • PHP_setup.php heb je enkel nodig om PVdiary de eerste maal te installeren en kan je ook helpen voor ondersteuning via het forum.

Hoe PVdiary versie 2 installeren[bewerken]

  • Niet vergeten! Je moet beschikken over een perfect werkende PHP webserver. Bij een "default" installatie volg je http://localhost:8081/PHP_setup.php
  • Klik op de PVdiary installer knop en volg de instructies
  • Velden enkel wijzigen indien nodig, bv wanneer je reeds een webserver draait op poort 8082.
  • Indien geen config file aanwezig is (bv. bij de eerste installatie) wordt een demo config voorzien.
  • Start het dashbord via de voorziene knop of via het icoon op het bureaublad.
  • Bij de eerste installatie best de demo even uittesten vooraleer de configuratie aan te passen.


Via de tab "Config & DB" -> "Initial Load" -> "Demo CSV" kun je de demo CSV-files in de juiste mappen plaatsen.
Vervolgens "Database initializeren"
De demo CSV-files inlezen in de database met "Alle DATA laden"
"Refresh" van het dashbord in de welkom tab.

  • Controleer of de database OK is via tab "Grafieken" -> "Go" . Met de + en - knoppen ga je een dag verder of terug
  • Maak de JSON files aan via tab "Welkom" -> Aanvinken all-data, info en expected -> "Export JSON"
  • Controleer de webpages via tab "Welkom" -> Webpages "Lokaal"

Hoe PVdiary configureren[bewerken]

  • Spijtig, maar de webconfigurator is nog niet af en de knop hiervoor is voorlopig gedisabled.
  • Ga via tab "Config & db" -> "Manueel aanpassen"
  • Verander plant_id. De plant_id wordt enkel gebruikt om de naam van de database te bepalen. Gebruik dus een korte naam zonder spaties of speciale letters. Voorbeeld "Myplant"
  • Volgende parameters zeker aanpassen om de import met sunnyexplorer te kunnen doen
* [cl_SB5000TL] veranderen naar [cl_xxxx] met xxxx de naam die je de omvormer wenst te geven. Liefst kort en geen spaties!
* import_params aanpassen door demo1.sx2 te vervangen door de .sx2 file van sunny explorer, bijvoorbeeld plant0001.sx2
* day1 aanpassen  
* in rubriek [pv_string_1] cl_name en pv_watt aanpassen
* in rubriek [win_env] sunsxpdir aanpassen
* Volg de instructies in de config-file wanneer het gaat over meerdere omvormers
  • Nu komt het grote moment ... De database laden met jouw gegevens
*  "Refresh" van het dashbord in de welkom tab om wijziging van config te activeren.
* Tab "Config & db" -> "Initial load" -> "Import CSV" 
* Eventueel Start-datum aanpassen indien nodig
* Vervolgens "Database initializeren"
* De CSV-files inlezen in de database met "Alle DATA laden"
* "Refresh" van het dashbord in de welkom tab.
  • Controleer of de database OK is via tab "Grafieken" -> "Go" . Met de + en - knoppen ga je een dag verder of terug
  • Maak de JSON files aan via tab "Welkom" -> Aanvinken all-data, info en expected -> "Export JSON"
  • Controleer de webpages via tab "Welkom" -> Webpages "Lokaal"

Automatizeren van de import[bewerken]

Werking van autorun

  • Autorun is een eenvoudige scheduler om pvdiary te automatizeren (import, backup, opkuizen logfiles...) en kan zowel voor windows als linux ingezet worden.
  • Per dag houdt autorun een logfile. Dit is handig om eventuele fouten terug te vinden.
  • Autorun wordt gestart met het commando "pvdiary --autorun" . Zorg ervoor dat dit commando uitgevoerd wordt bij het opstarten van de pc, bv met een script in de startup folder.
  • Autorun wordt configureerd in de rubriek [autorun] .

Voorbeeld config:

[autorun]
exit_at = "@sunset+2hours"
; exit_at = "tomorrow 00:10"
;
exec[] = "Import;@sunrise,@sunset+1hour,3 hours;pvdiary --import --export --sync"
exec[] = "Cleanup;00:00,23:59,1 day;pvdiary --cleanup"
exec[] = "Backup;@sunrise -5 minutes,@sunset+1hour,1day;pvdiary --db --backup"
;
  • De exec[] variabelen bepalen het commando, wanneer en met welke frequentie het commando mag gebeuren.
  • Het is mogelijk om de tijdstippen sunrise en sunset te gebruiken voor het schedulen van het commando.
  • exit_at is optioneel en laat toe om autorun automatisch te stoppen. Als je pc niet wordt herstart is het best om dit in commentaar te zetten met een ";" in het begin van de lijn.
  • In de Help tab van het PVdiary dashboard staan alle details en nog meer variabelen beschreven

Heb je als Windows-gebruiker last van het openstaande DOS-venster van de autorun? Doe het volgende (maar doe dit pas als alles andere, ook de autorun, perfect werkt):

  • download dit javascript file en plaats het in de pvdiary-directory. In Vista en hogere versies van Windows moet je dit file nog "unblocken". Je doet dit door met een rechter-muisklik op pvdiary_startup.js te klikken, en dan "properties". Je ziet een "unblock" knop die je moet klikken (in het NL noemt dit wellicht "vrijgeven"?).
  • maak een shortcut aan naar dit file (pvdiary_startup.js), bv vanuit je windows startup folder. Elke keer dat je je computer opstart wordt automatisch PVdiary mee opgestart. Je ziet dan bijna niets meer van PVdiary (alleen in de taskmanager zie je onder processes dat er "cmd.exe" en "php.exe" actief zijn). De update verloopt volledig in de achtergrond.

Commando's[bewerken]

Indien pvdiary en PHP juist geinstalleerd is kan je het "pvdiary" CLI-commando gebruiken.

pvdiary --dashboard ... start de PVdiary webserver indien nodig en stuurt je browser naar het dashboard.
pvdiary --httpd .... start de PVdiary webserver.
pvdiary --import --export --sync


Om manueel commando's uit te voeren gebruik je best het PVdiary dashbord


Natuurlijk kun je alle commando's ook uitvoeren vanuit de CLI, of in Task Scheduler. Voor de CLI beginnen alle commando's met PVdiary, en dan volgen de parameters. Hier een beschrijving van de parameters (copy-paste van de CLI help, daarom in het engels):

  • nog aan te passen

Support[bewerken]

Voor vragen, opmerkingen en support kun je hier terecht. We (Leslie en ik) zullen ons best doen om alle vragen zo snel mogelijk te beantwoorden.

Gebruikersovereenkomst[bewerken]

Deze software is gratis en wordt ter beschikking gesteld 'as is'. Wij zijn dan ook niet verantwoordelijk voor de goede werking of de correctheid van de gegevens verkregen door het gebruik van deze software.

Nieuwe Beta-versies en oudere versies[bewerken]

Hier een tijdelijke pagina om nieuwe releases van PVdiary voor te bereiden:

Wiki van oudere versies: