AbfallNavi (regio IT)

Symcon Modul für die Visualisierung von Entsorgungsterminen.

1. Funktionsumfang

Das Modul nutzt die von Regio IT (www.regioit.de ) bereitgestellten Daten zur Berechnung der bevorstehenden Entsorgungstermine (Abfallentsorgung).

Derzeit unterstützt das Modul rund 25 verschiedene Regionen. Wenn jemand noch weitere kennt, bitte einfach bei mir melden!

2. Voraussetzungen

• 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

• Unter “Instanz hinzufügen” ist das ‘AbfallNavi’-Modul (Alias: ‘Abfallwirtschaft (AbfallNavi)’ oder ‘Entsorgungskalender (AbfallNavi)’) 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 …

♻️ Abfallwirtschaft …

✨ Visualisierung …

⚙️ Erweiterte Einstellungen …

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 …

5. Statusvariablen und Darstellungen

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

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):

7. PHP-Befehlsreferenz

void REGIO_LookAhead(int $InstanzID);

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

Beispiel: REGIO_LookAhead(12345);

void REGIO_Update(int $InstanzID);

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

Beispiel: REGIO_Update(12345);

8. Versionshistorie

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 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

v2.3.20250107

• NEU: Internationalisierte Anbieterauswahl
• FIX: Dokumentation verbessert

v2.2.20240702

• NEU: Fallback wenn Service fehlschlägt (keine Subdomain)
• NEU: Vorrausschauende Anzeige
• FIX: URL Prüfung verbessert

v2.1.20240304

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

v2.0.20231119

• NEU: Kompatibilität auf IPS 6.4 hoch gesetzt
• NEU: Support für v7 Visualisierung
• FIX: Sortierreihenfolge der Daten korrigiert

v1.0.20221020

• NEU: Initialversion

Danksagung

Ich möchte mich für die Unterstützung bei der Entwicklung dieses Moduls bedanken bei …

• dixi00 : für den Hinweis auf die API und das Testen :-)

Vielen Dank!

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

Spenden

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

Lizenz

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