AWIDO – Alle wichtigen Daten online.

Awido

Version Product Version License Actions

IP-Symcon Modul für die Visualisierung von Entsorgungsterminen.

Inhaltverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Darstellungen
  6. Visualisierung
  7. PHP-Befehlsreferenz
  8. Versionshistorie

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

  • IP-Symcon ab Version 8.1

3. Installation

  • Über den Modul Store das Modul Abfallwirtschaft (ehem. Awido) installieren.
  • Alternativ Über das Modul-Control folgende URL hinzufügen.
    https://github.com/Wilkware/WasteManagement oder git://github.com/Wilkware/WasteManagement.git

4. Einrichten der Instanzen in IP-Symcon

  • Unter "Instanz hinzufügen" ist das 'Awido'-Modul (Alias: 'Abfallwirtschaft (Awido)' oder '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.

VORSTICHT: 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 Dienste ...

Name Beschreibung
Anbieter 'AWIDO (awido-online.de)'
Land Landesauswahl (derzeit nur DE)

♻️ Abfallwirtschaft ...

Name Beschreibung
Entsorgungsgebiet Liste der verfügbaren Gebiete (siehe oben)
Stadt/Gemeinde Ort im Entsorgungsgebiet (kann identisch zum Gebiet sein)
Ortsteil/Strasse Ortsteil/Strasse im gewählten Ort
Hausnummer Hausnummer von-bis, oder Alle = gesamte Strasse
Entsorgungen Entsorgungsarten, d.h. was wird im Gebiet an Entsorgung angeboten

✨ Visualisierung ...

Name Beschreibung
Unterstützung für Tile Visu aktivieren? Aktivierung der Darstellung für Kachel-Visualisierung
Abfallgruppen Farbliche 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"!
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
Zeitpunkt Uhrzeit, wo die Umschaltung erfolgen soll

⚙️ Erweiterte Einstellungen ...

Name Beschreibung
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
Skript Skript, 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 ...

Aktion Beschreibung
AKTUALISEREN Werte werden neu ermittelt und geschrieben

5. Statusvariablen und Darstellungen

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

Name Typ Beschreibung
Entsorgungsart(en) String Abhängig vom Entsorgungsgebiet und den angebotenem Service mehrere Variablen, z.B.: Restmüll, Biotonne usw.

Es werden keine zusätzlichen Darstellungrn/Profile benötigt.

6. 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 nutzen Akzentfarben definiert Ergebnis
Ja Nein Heute und Morgen erhält die Tonnenfarbe, danach keine Hintergrundfarbe
Ja Ja Heute und Morgen erhält die Tonnenfarbe, danach keine Hintergrundfarbe
Nein Nein Keine individuellen Farben → transparent → Akzentfarbe des Themes für heute/morgen
Nein Ja Individuelle Akzentfarben werden für heute/morgen verwenden

7. PHP-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);

8. Versionshistorie

v5.0.20260710

  • NEU: Support für TileVisu (Kachel-Visualisierung)
  • NEU: Kompatibilität auf IPS 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 IPS 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 IPS 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 IP-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