Suche

    AWIDO

    Dokumentation direkt aus GitHub Wilkware/WasteManagement ↗

    Version Product Version License Actions

    Symcon Modul für die Visualisierung von Entsorgungsterminen.

    1. Funktionsumfang

    Das Modul nutzt die von awido (www.awido-online.de ) bereitgestellten Daten zur Berechnung der bevorstehenden Entsorgungstermine (Abfallentsorgung).

    Derzeit unterstützt das Modul 42 verschiedene Landkreise und Großstädte. Wenn jemand noch weitere kennt, bitte einfach bei mir melden!

    2. Voraussetzungen

    • Symcon ab Version 8.1

    3. Installation

    • Über den Modul Store die Bibliothek Abfallwirtschaft installieren.
    • Alternativ über das Modul Control folgende URL hinzufügen.
      https://github.com/Wilkware/WasteManagement oder git://github.com/Wilkware/WasteManagement.git

    4. Einrichtung

    • Unter ‘Instanz hinzufügen’ ist das Awido-Modul (Alias: Abfallwirtschaft (Awido), Entsorgungskalender (Awido)) unter dem Hersteller ‘(Geräte)’ aufgeführt.

    Konfigurationsseite:

    Entsprechend der gewählten Auswahl verändert sich das Formular dynamisch. Eine komplette Neuauswahl erreicht man durch Auswahl “Bitte wählen …” an der gewünschten Stelle.

    VORSICHT: eine Änderung der Auswahl bedingt ein Update bzw. ein Neuanlegen der Statusvariablen!!! Alte Variablen, welche es im anderen Landkreis gab werden nicht gelöscht! Hat man diese in einem WF verlinkt muss man danach selber aufräumen. Ich denke aber mal das ein Umzug nicht so häufig vorkommt ;-)

    Einstellungsbereich:

    🔗 Online Dienst …

    NameBeschreibung
    Anbieter‘AWIDO (awido-online.de)’
    LandLandesauswahl (derzeit nur DE)

    ♻️ Abfallwirtschaft …

    NameBeschreibung
    EntsorgungsgebietListe der verfügbaren Gebiete (siehe oben)
    Stadt/GemeindeOrt im Entsorgungsgebiet (kann identisch zum Gebiet sein)
    Ortsteil/StrasseOrtsteil/Strasse im gewählten Ort
    HausnummerHausnummer von-bis, oder Alle = gesamte Strasse
    EntsorgungenEntsorgungsarten, d.h. was wird im Gebiet an Entsorgung angeboten

    ✨ Visualisierung …

    NameBeschreibung
    Unterstützung für Tile Visu aktivieren?Aktivierung der Darstellung für Kachel-Visualisierung
    AbfallgruppenFarbliche Zuordnung der Abfallarten
    Akzentfarbe (Heute)Highlighting (Kachel-Hintergrund) der heutigen Abholung
    Akzentfarbe (Morgen)Highlighting (Kachel-Hintergrund) der morgigen Abholung
    Farbtransparenz (Kleine Kachel)Transparenz (100% Vollfarbe) für Tonnen- bzw. Akzentfarbe(n)
    Die Farbe der Tonne als Hintergrund verwenden (Kleine Kachel)?Übersteuert gewählte Akzentfarbe für Abholung “HEUTE”!
    Größte Ansicht (größere Kacheln)Begrenzt die Darstellung bei größeren Kacheln: nur Symbole, kompakte Liste oder große Ansicht (Standard, automatisch nach Kachelgröße)
    Unterstützung für das alte Webfrontend (HTMLBox) aktivieren?Weiterhin die Visualisierung über HtmlBox unterstützen!
    Vorrausschauende Anzeige für Folgetage aktivieren?Aktivierung, ob zu einer bestimmten Zeit die Anzeige umschalten soll auf Folgetermine
    ZeitpunktUhrzeit, wo die Umschaltung erfolgen soll

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    Tägliche Aktualisierung aktivieren?Status, ob das tägliche Update aktiv oder inaktiv ist
    Variablen für nicht ausgewählte Entsorgungen erstellen?Status, ob für nicht genutzte Entsorgungen auch Variablen angelegt werden sollen, standardmäßig nein
    SkriptSkript, welches nach dem Update der Termine ausgeführt wird, z.B. für Sortierung usw.

    HINWEIS: Dem Skript werden die Variablen ‘TIMESTAMP’ und ‘DATA’ mitgegeben. DATA beinhaltet JSON kodiert das Array der ausgewählten Abfuhrtermine. Der Feldindex(key) ist der interne Verarbeitungsname der Müllart. Über den Ident kann der Variablenname klar zugeordnet werden.

    Beispiel:

    {
      "Blaue Tonne": {
        "ident": "BT",
        "date": "29.06.2026"
      },
      "Biotonne": {
        "ident": "BIO",
        "date": "24.06.2026"
      },
      "Restabfalltonne": {
        "ident": "RM",
        "date": "30.06.2026"
      }
    }
    

    Aktionsbereich:

    🚀 Aktion ausführen …

    AktionBeschreibung
    AKTUALISIERENWerte werden neu ermittelt und geschrieben
    VORAUSSCHAUSchaltet die Anzeige in der Kachel-Visualisierung auf die Folgetermine um (nur bei aktivierter Tile Visu)

    5. Statusvariablen

    Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

    IdentNameTypBeschreibung
    (dynamisch)Entsorgungsart(en)StringAbhängig vom Entsorgungsgebiet und dem angebotenen Service mehrere Variablen, z.B.: Restmüll, Biotonne usw. Der Ident entspricht der Kennung der Entsorgungsart beim Dienst.
    WidgetAbholungStringHTML-Darstellung der Entsorgungstermine für das alte Webfrontend (nur bei aktivierter Unterstützung für Tile Visu und HTMLBox)

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    Entsorgungsart(en)WertanzeigeDatum der nächsten Abholung (TT.MM.JJJJ), Icon Mülltonne
    AbholungWebinhaltHTML-Darstellung der Entsorgungstermine

    7. Visualisierung

    Man kann sowohl das gesamte Modul (HTML-SDK Support) als auch nur die Statusvariablen direkt in der Visualisierung verlinken.
    Aber wie bei der Konfiguration beschrieben, muss man aufpassen wenn die Konfiguration geändert wird. Dann müssen gegebenenfalls die Links neu eingerichtet werden.

    Hintergrundfarben-Logik (Kleine Kachel):

    Tonnenfarbe nutzenAkzentfarben definiertErgebnis
    JaNeinHeute und Morgen erhält die Tonnenfarbe, danach keine Hintergrundfarbe
    JaJaHeute und Morgen erhält die Tonnenfarbe, danach keine Hintergrundfarbe
    NeinNeinKeine individuellen Farben → transparent → Akzentfarbe des Themes für heute/morgen
    NeinJaIndividuelle Akzentfarben werden für heute/morgen verwenden

    Bedienung der Kachel:

    • Ansichten: Je nach Kachelgröße werden die Termine als Tonnen-Symbole (kleine Kachel), als kompakte Liste oder als große Ansicht mit Banner und Liste dargestellt. Über die Einstellung “Größte Ansicht (größere Kacheln)” kann man die Darstellung begrenzen, z.B. auch bei großen Kacheln nur die Tonnen-Symbole anzeigen.
    • “Heute” antippen: Ist heute eine Abholung, erscheint unter den Tonnen-Symbolen die Schaltfläche “Heute”. Antippen bzw. Anklicken schaltet die Anzeige sofort auf die nächste(n) Abholung(en) um, genau wie die automatische Vorausschau zur eingestellten Uhrzeit. Ein kurzes Aufhellen der Symbole bestätigt das Antippen. Nach der Umschaltung zeigt die Kachel wieder die Tage bis zur nächsten Abholung an.
    • Abfallarten anzeigen: Mit der Maus über den Tonnen-Symbolen (Desktop) bzw. durch Gedrückthalten (Touch) werden die Namen der Abfallarten eingeblendet. Das ist hilfreich, wenn mehrere Tonnen am gleichen Tag gestapelt dargestellt werden.

    8. Befehlsreferenz

    void AWIDO_LookAhead(int $InstanzID);
    

    Stellt in der Visualisierung den für Folgetage anstehenden Entsorgungstermine dar.
    Die Funktion liefert keinerlei Rückgabewert.

    Beispiel: AWIDO_LookAhead(12345);

    void AWIDO_Update(int $InstanzID);
    

    Holt die nächsten anstehenden Entsorgungstermine für die gewählten Entsorgungsarten.
    Die Funktion liefert keinerlei Rückgabewert.

    Beispiel: AWIDO_Update(12345);

    9. Versionshistorie

    v5.3.20261030

    • FIX: Fehlerbehandlung bei nicht erreichbarem Dienst
    • NEU: Einstellung “Größte Ansicht” für größere Kacheln (z.B. auch große Kacheln nur mit Tonnen-Symbolen)
    • NEU: Schaltfläche “Vorausschau” im Aktionsbereich
    • NEU: Bei einem Fehler im Datenabruf erneuter Versuch nach einer Stunde und Status “Abfrage beim Dienst fehlgeschlagen”
    • NEU: Timeouts für alle Abfragen beim Dienst
    • NEU: Darstellungen (Wertanzeige, Webinhalt) statt Profile für die Statusvariablen
    • FIX: Übersetzung der Wochentage und von “Heute”/“Morgen” in der Kachel
    • FIX: Fehlende Übersetzungen ergänzt
    • FIX: Interne Vereinheitlichungen (Formularzugriff, Aktionen ohne eval, Fehlerbehandlung)
    • FIX: Dokumentation überarbeitet und vereinheitlicht

    v5.2.20260902

    • FIX: Ampelfarben im HTML Widget gefixt
    • NEU: Neuer Visualisierungstyp für TileVisu eingeführt (Maximierung behält Darstellung)

    v5.1.20260831

    • NEU: Automatischer Cache Update für TileVisu (Restart Symcon)
    • FIX: Support neuer Top-Level-Doamins

    v5.0.20260710

    • NEU: Support für TileVisu (Kachel-Visualisierung)
    • NEU: Kompatibilität auf Symcon 8.1 vereinheitlicht
    • NEU: Umstellung auf Strict-Modus (IPSModuleStrict)
    • NEU: Modulversion wird in Quellcodesektion angezeigt
    • FIX: Modulkonfiguration überarbeitet und vereinheitlicht
    • FIX: Interne Bibliotheken und Konfiguration überarbeitet und vereinheitlicht

    v4.5.20260622

    • NEU: Datenübergabe an Skript
    • NEU: Letzte Version für Support ab Symcon v6.4

    v4.3.20250107

    • NEU: Internationalisierte Anbieterauswahl
    • FIX: Dokumentation verbessert

    v4.2.20240702

    • NEU: Vorrausschauende Anzeige
    • FIX: URL Prüfung verbessert

    v4.1.20240304

    • FIX: Support für v7 Visualisierung verbessert
    • FIX: Update für nicht aktivierte Abfallarten korrigiert
    • FIX: Einige interne Vereinheitlichungen und Anpassungen
    • FIX: Dokumentation korrigiert

    v4.0.20231119

    • NEU: Kompatibilität auf Symcon 6.4 hoch gesetzt
    • NEU: Support für v7 Visualisierung

    v3.4.20230124

    • FIX: Skripte in den erweiterten Einstellungen werden wieder gespeichert

    v3.3.20220309

    • NEU: Konfigurationsformular angepasst

    v3.2.20211212

    • NEU: Kompatibilität auf Symcon 6.0 hoch gesetzt
    • NEU: Konfigurationsformular an die neuen Möglichkeiten der 6.0 angepasst

    v3.1.20210620

    • NEU: Umstellung auf maximal 30 vewrschiedene Abfallarten
    • FIX: IPS_SetProperty nicht mehr notwendig
    • FIX: HTML Entities in Namen der Abfallarten werden jetzt dekodiert

    v3.0.20210405

    • NEU: Eigener Webservice (JSON-API) für Bereitstellung der unterstützten Gebiete (aktuell 36 Gebiete)
    • NEU: Landkreis Augsburg (lose Zuordnung von verschiedenen Orten)
    • NEU: Landkreis Gießen
    • NEU: Landkreis Mühldorf am Inn
    • NEU: Zweckverband Isar-Inn
    • FIX: Modul Aliase auf ‘Abfallwirtschaft (Awido)’ und ‘Entsorgungskalender (Awido)’ geändert
    • FIX: Umbau und Vereinheitlichungen des Konfigurationsformulars
    • FIX: Vereinheitlichungen der Libs

    v2.0.20201010

    • NEU: Umstellung des Konfigurationsformulars auf dynamische Konfiguration
    • NEU: Gemeinde Unterhaching
    • NEU: Landkreis Gotha
    • NEU: Landkreis Schweinfurt
    • NEU: Stadt Kaufbeuren
    • NEU: Zweckverband Saale-Orla
    • FIX: Maximale Anzahl an Entsorgungsarten angepasst
    • FIX: Dokumentation überarbeitet
    • FIX: Debug Meldungen erweitert bzw. korrigiert
    • FIX: Englische Übersetzung korrigiert

    v1.4.20190814

    • NEU: Anpassungen für Module Store
    • NEU: Landkreis Fürstenfeldbruck

    v1.3.20190323

    • NEU: Vereinheitlichungen, Umstellung auf Libs
    • NEU: Variablenerstellung kann nun vom Benutzer beeinflusst werden
    • FIX: RegisterTimer Umstellung wieder verworfen (v1.2)

    v1.2.20190320

    • FIX: Umsetzung Store Richtlinie(6), RegisterTimer wieder verwendet

    v1.1.20190312

    • NEU: Vereinheitlichungen, StyleCI uvm.

    v1.0.20181021

    • FIX: Umstellung auf https

    v1.0.20180831

    • NEU: Landkreis Berchtesgadener Land
    • NEU: Pullach im Isartal

    v1.0.20180725

    • NEU: Stadt Unterschleissheim

    v1.0.20180628

    • NEU: Landkreis Tirschenreuth
    • NEU: Landkreis Rosenheim

    v1.0.20180405

    • NEU: Landkreis Kronach
    • NEU: Landkreis Tübingen

    v1.0.20170417

    • NEU: Zweckverband München-Südost

    Entwickler

    Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence