Afvalbeheer installeren en configureren in Home Assistant

Intro

Als je in Belgie of Nederland woont en jouw afval wordt opgehaald door een van volgende firma’s, kan je heel eenvoudig het ophaalschema integreren in Home Assistant:

Blink, Cure*, Suez, ACV, Twente Milieu, Hellendoorn, Cyclus, DAR, HVC Groep, Meerlanden, RMN (Reinigingsbedrijf Midden Nederland), Schouwen-Duiveland, Peel en Maas, Purmerend, Circulus-Berkel (Afvalvrij), Avalex, Venray, Den Haag, Berkelland, Alphen aan den Rijn, Waalre, ZRD, Spaarnelanden, SudwestFryslan, Montfoort, GAD, Cranendonck, ROVA, RD4, Limburg.NET, Afval Alert, RecycleApp, DeAfvalApp, Alkmaar, AreaReiniging, Almere, Waardlanden, Reinis, Avri, Omrin, BAR, RAD, Meppel, PreZero and Middelburg-Vlissingen.

Noot: De lijst hierboven bevat namen van afvalophaaldiensten/intercommunicales maar ook namen van apps die door een of meerdere van deze diensten worden gebruikt. Vind je dus de naam van jouw lokale intercommunale niet terug, zoek dan eens op of ze een app aanbieden.

Afvalbeheer installeren

Je kan de Afvalbeheer integratie manueel installeren of via HACS. Het voordeel aan het gebruik van HACS (Home Assistant Community Store) is dat je zeer eenvoudig updates kan installeren. Je hoeft ook geen bestanden te downloaden en dan weer op jouw Home Assistant machine te uploaden in de juiste mapjes enz.

HACS installeren

Mocht je dit nog niet gedaan hebben, zal je dus eerst de Home Assistant Community Store Store moeten installeren.

De handleiding bevat alle info die je nodig hebt. Ik raad je dan ook aan deze te volgen, zodat je steeds de laatste versie voor je hebt.

De installatie is vrij eenvoudig:

1. Identificeer welke versie van Home Assistant je gebruikt.
   Gebruik je Home Assistant OS, Home Assistant Container, Home Assistant Core, of Home Assistant Supervised?
   De installatiemethode is voor elke van deze versies gelijkaardig, enkel hoe je moet starten is een beetje anders.
2. Download en installeer het installatiescript.
   Het commando dat je moet uitvoeren haalt het script van deze URL https://install.hacs.xyz en voert het uit.
   Dit script gaat checken of je in de juiste map bezig bent en zal vervolgens de laatste versie van HACS downloaden en uitpakken.
3. Voeg de nieuwe HACS integratie toe aan Home Assistant.
   Tijdens dit proces zal je gevraagd worden om in te loggen met jouw GitHub account.
   Dit is omdat GitHub anders een beperking oplegt voor aanvragen tot hun servers, en alle HACS-integraties op GitHub staan.

Afvalbeheer installeren via HACS

De Afvalbeheer integratie is standaard inbegrepen in de repositories van HACS.

1. Open HACS via het knopje in de zijbalk
   
2. Klik op Integrations
3. Klik onderaan op Explore & Add Repositories
4. Zoek naar Afvalbeheer en klik erop
   Als je twijfels of je de juiste repository gevonden hebt, kijk dan of je bovenaan @pippyn ziet staan als auteur.
5. Klik vervolgens op Install this repository in HACS om Afvalbeheer toe te voegen aan Home Assistant

Na het installeren van de Afvalbeheer repository zal je gevraagd worden om Home Assistant te rebooten. Ga hiervoor naar Configuration > Server Controls en klik op Restart.
Het kan ook nooit kwaad om eerst eens Check Configuration te doen vooraleer je HA heropstart.

Afvalbeheer configureren

Nu moet je de Afvalbeheer integratie natuurlijk nog configureren zodat het weet welke afvalophaaldienst het voor jou moet volgen.

De exacte configuratie is afhankelijk van de afvalophaaldienst (waste collector), dus je kijkt best eens in de documentatie op GitHub.
Zo zal afhankelijk van de ophaaldienst jouw postcode, straatnaam en -nummer moeten ingeven.

Een voorbeeld van zo’n configuratie is als volgt:

afvalbeheer:
  wastecollector: RecycleApp
  resources:
    - restafval
    - papier
    - pmd
  postcode: 1234
  streetnumber: 1
  streetname: Sesamstraat
  upcomingsensor: 1
  dateformat: '%d-%m-%Y'
  dateonly: 0
  dayofweek: 0
  dateobject: 1
  name: ""
  nameprefix: 0
  builtinicons: 1
  builtiniconsnew: 1
  dutch: 1

Deze config kan je toevoegen aan jouw configuration.yaml.

Ga daarna opnieuw naar Configuration > Server Controls, doe een Check Configuration om zeker te zijn dat je bv. geen spaties bent vergeten, en klik vervolgens op Restart.

Eens Home Assistant terug is opgestart, zal je merken dat je extra sensors hebt gekregen die je nu kan weergeven in jouw Lovelace dashboard.
Zoals een aparte sensor voor elke ophaling, een sensor voor ophaling(en) vandaag, en een voor ophaling(en) morgen.

Speel wat met de configuratie van de Afvalbeheer integratie zodat het volledig voldoet aan jouw verwachtingen.
Zo kan je andere icoontjes gebruiken, het formaat van de datum aanpassen naar bv. “24 aug”, enzovoort. Je kan ook een automatisatie maken die jouw een notificatie stuurt met de ophalingen van de volgende dag, zodat je zeker jouw zak/doos/container niet vergeet klaar te zetten.

Update 2023-02-20

De configuratie van de integratie is gewijzigd. afvalbeheer is nu z’n eigen component.

In het verleden zag de config er zo uit:

sensor:
  - platform: afvalbeheer
    wastecollector: RecycleApp
    resources:
      - restafval
      - papier
      - pmd
    postcode: 1234
    streetname: Sesamstraat
    upcomingsensor: 1
    dutch: 1
    builtinicons: 1

Noot m.b.t. YAML config

Je kan ook jouw config opsplitsen, zoals ik eerder al eens heb besproken. Een andere optie hiervoor is het gebruik van packages.

In configuration.yaml zet je dan het volgende:

homeassistant:
  packages: !include_dir_named packages/

en de configuratie voor de Afvalbeheer integratie plaats je dan in config/packages/home/afvalbeheer.yaml als volgt:

afvalbeheer:
  wastecollector: RecycleApp
  resources:
    - restafval
    - papier
    - pmd
  postcode: 1234
  streetnumber: 1
  streetname: Sesamstraat
  upcomingsensor: 1
  dateformat: '%d-%m-%Y'
  dateonly: 0
  dayofweek: 0
  dateobject: 1
  name: ""
  nameprefix: 0
  builtinicons: 1
  builtiniconsnew: 1
  dutch: 1

Automations e.d. gelinkt aan de Afvalbeheer-integratie, kan je dan in deze file zetten onder een automation: component. Of je maakt nog een file reminders.yaml aan om alle reminders m.b.t. het huishouden in te beheren, en zet deze in dezelfde folder.