Youless Desktop Gadget voor Windows
===================================
Copyright 2012-2024 Postfossil B.V.
Alle rechten op deze software zijn voorbehouden


Beschrijving
------------
De Youless Gadget is een applicatie voor op het Windows bureaublad, 
waarbij het actuele en historische door de Youless gemeten elektrisch 
vermogen in een oogopslag op het bureaublad te zien is. De Gadget 
communiceert direct met een Youless energy monitor via het netwerk.


Vereisten
---------
- Youless energy monitor model LS110 of LS120.
- Een PC met het Microsoft Windows 7/8/10/11 als besturingssysteem.
- De PC moet direct netwerk toegang tot de Youless hebben.
- Voor Windows 8 en hoger is de 8gadgetpack software van Helmut Buhler benodigd 
  als extra pakket om Desktop Gadgets op de desktop te kunnen gebruiken. 
  8gadgetpack is gratis te downloaden van https://8gadgetpack.net. 


Installatie
-----------
- Voor Windows 8 en hoger, download en installeer Helmut Buhler's 8gadgetpack 
  software van https://8gadgetpack.net.
- Indien een voorgaande versie van de Youless gadget reeds geinstalleerd
  was, sluit dan eerst alle draaiende Youless Gadgets.
- Open het bestand 'youless.gadget' uit het download zip 
  bestand. Een nieuwe instantie van de Gadget verschijnt nu meteen op het
  bureaublad.

Noot: In zeldzame situaties kan het gebeuren dat de installatie
      van een nieuwere versie van dezelfde desktop Gadget niet succesvol
      afgerond wordt. Dit is te merken doordat de Gadget niet op het 
      bureaublad verschijnt na het openen van het nieuwe .gadget bestand, 
      en dat de Gadget niet meer in de Gadget galerij te zien is.
      In zulke gevallen zal de installatie alsnog lukken na eerst 
      een systeem herstart uit te voeren.


Openen van nieuwe Gadget instanties
-----------------------------------
- Klik met de rechtermuisknop op een lege plek van de desktop en kies 'Gadgets'.
- Selecteer de Youless Gadget uit de galerij van beschikbare Gadgets. De
  Youless Gadget verschijnt op het bureaublad.
- Sleep desgewenst de gadget op de gewenste plaats door gebruik te maken van
  de 'sleep nopjes' die onder het 'steeksleutel' icoon verschijnen wanneer 
  de gadget wordt aangewezen met de muis.
- Meerdere instanties van de Youless gadget kunnen gelijktijdig op de destkop
  actief zijn.


Configuratie
------------
- Wijs de Youless Gadget aan met de muis.
- Klik op het steeksleutelsymbool dat na het aanwijzen van de gadget verschijnt.
  Het configuratiescherm zal vervolgens verschijnen.
- Voer de nodige instellingen in. Minimaal moet het Youless IP adres ingesteld
  worden.
- Voor model LS120 kan gekozen worden uit het hoofdmeter kanaal of het S0 input
  kanaal.
- Klik op OK om de instellingen op te slaan.

Indien er communicatie met de Youless is zal de kleur van het gadget veranderen. 
Indien er vermogen geregistreerd wordt door de Youless zal de de naald uitslaan 
en het live verbruik worden getoond.

Voor uitleg over de overige instellingens wordt verwezen naar de help tekst die
getoond wordt wanneer het betreffende configuratie item met de muist aangewezen 
wordt.

NB: Er kan ook een 'demo modus' worden gekozen voor test of evaluatie 
    doeleinden. Hierbij worden de meetwaarden van een Youless random 
    gegenereerd.


Gebruik
-------
De Youless Gadget toont het live verbruik op een meter. De schaal van de meter 
past zich automatisch aan aan het verbruik, waarbij de meter verkleurt bij een
overgang naar een hogere schaal.

Wanneer stroom wordt teruggeleverd/gegenereerd, wordt de Gadget groen en toont
het het vermogen als percentage van de Wp maximale capaciteit van de (solar) 
installatie. De Wp waarde kan in de instellingen worden geconfigureerd.

Wanneer op de gadget geklikt wordt, dan verschijnt een "flyout" venster met een
grafiek van het verbruik over de laatste 10 minuten. De grafiek wordt continu
ververst en "scrolt" daardoor geleidelijk van rechts naar links. De schaal van
de grafiek past zich net als de meter automatisch aan. Met de pijltjes knoppen
omhoog en omlaag (of door met de muis of touchscreen over de grafiek te 
slepen/swipen) kan de schaal echter desgewenst vastgezet worden op een 
bepaalde schaal. Door op het ronde pictogram te klikken wordt de automatische
schaalaanpassing weer actief.

Het tijdvenster waarover de grafiek getekend wordt kan met de pijltjes knoppen
links en rechts respectievelijk vergroot of verkleind worden, of door met de 
muis of touchscreen over de grafiek te slepen/swipen.

De "flyout" wordt gesloten door op de [X] knop rechtsboven te klikken, of met
de escape toets, of door op de desktop te klikken.


Tips
----
Voor een gereserveerd vast sidebar gebied voor gadgets aan de zijkant van het 
bureaublad, kan de 7 sidebar van Helmut Buhler worden gebruikt. De gadgets 
in de "Vista style" sidebar zijn dan altijd zichtbaar. De 7 sidebar komt 
gebundeld met de 8gadgetpack software.

Een vaste sidebar gaat echter wel ten koste van scherm ruimte. Als alternatief
kan het Gadget ook op "altijd op voorgrond" gezet worden, zodat het ook bij 
volledig gebruik van de desktop altijd zichtbaar is. Deze modus kan gekozen
worden vanuit het context menu door met de rechter muisknop op het Gadget
te klikken. Vanuit hetzelfde menu kan ook een semi-transparantie ingesteld 
worden zodat onderliggende vensters ook zichtbaar zijn door het Gadget heen.

Wanneer de S0 input voor model LS120 ook in gebruik is, dan in het aanbevolen
om 2 instanties van het gadgets tegelijk te draaien. Een voor de hoofd meter, 
en de andere voor de S0 input. Beide kanelen kunnen dan tegelijk gemonitord 
worden. Gebruik de 'opschrift' instelling van de gadget om de 2 gadgets 
makkelijk van elkaar te onderscheiden.


Vrijgaven
---------
19-03-2024 v1.3.0:
- Gadget bereik vergroot van 18 kW  naar 60 kW
- Toevoeging van zoom niveau stappen bij het veranderen van het bereik van 
  de grafiek.

23-09-2020 v1.2.0:
- De kleur groen is exclusief gereseveerd voor teruglevering/opwekking, zowel
  op het wijzerblad als in de flyout grafiek. The laagste consumptie schaal is
  nu blauw gekleurd.
- De grafiek maakt nu duidelijk onderscheid in de kleuring van consumptie en 
  opwekking/teruglevering van vermogen.
- De Gadget kan nu geconfigureerd worden om het hoofdkanaal of het S0 input 
  kanaal voor model LS120 te tonen.
- Verbeterde grafiek resolutie voor model LS120.
- De grafiek flyout is nu altijd groot.

23-11-2015 v1.1.0:
- Toegevoegd: optionele label instelling om eenheid (Watt) te vervangen 
  met eigen label.
- Toegevoegd: optionele grote flyout for more grafiek details.
- Toegevoegd: grafiek zoomen met mouse/touch control door draging/swiping over 
  de grafiek.
- Toegevoegd: bruto productie mode instelling for zonnepaneel gebruikers.
- Toegevoegd: check op laatste versie in het settings venster.
- Gefixed: grafiek rendering artifacten wanneer tijd tussen PC and Youless 
  verschilt.
- Gefixed: rendering issue in het settings venster, welke elementen niet 
  correct toonde bij Windows scherm tekst grootte instellingen hoger dan 100%.
- Gefixed: issue waarin gadget herhaaldelijk bleef proberen in te loggen 
  met een verkeerd ingesteld wachtwoord. De herhaalde pogingen zorgden voor een 
  Youless brute force attack penalty time welke tot gevolg hadden dat andere
  gebruikers met moeite in konden loggen.
- Gefixed: kleine bug waarin knipperende steeksleutel zichtbaar kon blijven 
  (maar niet meer knipperend) wanneer deze niet meer getoond hoefde te worden.
- Gefixed: kleine bug waarin highlighting van pijltjes knoppen niet correct was.
- Verbeterd: inertia emulatie in de beweging van de wijzer zo dat deze 
  minder 'springerig' is bij grote bewegingen.
- Verbeterd: settings venster layout, met de bedoeling dat deze een verbeterde
  gebruiksvriendelijkheid heeft.
- Verbeterde historische data sync and re-sync na tijdelijk communicatie 
  verlies.
- Verbeterd gedrag bij instellingen in het geval van meerdere actieve 
  instanties van de Gadget.

21-07-2014 V1.0.2:
- Multilanguage release met NL, EN en DE vertaling.

01-07-2012 V1.0.1:
- Bij meter constantes groter dan 1000 werden wijzigingen niet altijd zichtbaar
  omdat de kWh waarde (met 3 decimalen) in deze gevallen niet altijd een ophoging
  krijgt bij een data update. De ophoging werd gebruikt als indicatie voor een 
  refresh. In deze versie wordt een refresh ook getoond bij een Watt waarde 
  wijziging.

15-06-2012 v1.0.0:
- Initiele stabiele release


