IoT og smarthus

Jordfuktighetssensor i Home Assistant: bygg den selv med ESP32

Fotorealistisk illustrasjon av en potteplante med sonde i jorda, et ESP32-kort på et koblingsbrett og en telefon som viser 47 prosent jordfuktighet

En jordfuktighetssensor i Home Assistant gir deg fukten i potta på telefonen, en kurve over hvor raskt jorda tørker, og et varsel når det er på tide å vanne. Her bygger du den selv med et ESP32-kort og ESPHome, helt uten skytjenester og uten å skrive kode. Du begynner med en nettside som kortet lager selv, kobler deretter sensoren til Home Assistant, og lar til slutt kortet styre en pumpe, med sperrer som hindrer for mye vann.

Tegning: sonden i potta er koblet til et ESP32-kort, kortet sender jordfuktigheten over WiFi, og telefonen viser 47 prosent.
Slik kan løsningen se ut. Dette er en tegning. Tallet 47 % er regnet ut med eksempelverdiene som står i konfigurasjonen før du har kalibrert.
Nivå
Nybegynner til avansert
Tid
Rundt 3 timer for alle tre nivåene
Lodding
Nei
Spenning
5 V fra USB, 12 V til pumpen på nivå 3
Du lærer
ESPHome, YAML, ADC på ESP32, varsling i Home Assistant og sikker styring av en pumpe
Kort forklartSonden står i jorda og er koblet mellom GPIO26 og GPIO32 på et ESP32-kort, med en motstand på 10 kΩ fra GPIO32 til GND. ESPHome er et verktøy som lager programmet til kortet ut fra en tekstfil. I filen står det hvilke pinner som brukes, og hvordan spenningen skal regnes om til prosent. Kortet kobler seg til WiFi hjemme, og Home Assistant finner det av seg selv. Alt skjer i ditt eget nett.

Dette trenger du på bordet

Nivå 1 og 2 bruker de fem første delene i listen. Resten kommer på nivå 3, når kortet skal styre en pumpe. Har du bygd den automatiske vanningen med Arduino, har du alle delene til pumpekretsen fra før.

Du trenger også en micro-USB-kabel som kan overføre data, en PC og WiFi på 2,4 GHz. Til nivå 2 og 3 trenger du Home Assistant i samme nett. Andre ESP32-kort finner du i ESP32-kategorien, og koblingsbrett og ledninger under koblingsplater og prototyping og koblingsledninger.

Slik henger ESP32, ESPHome og Home Assistant sammen

ESP32 er en mikrokontroller med innebygd WiFi. ESPHome er verktøyet som lager programmet til den. Du skriver ikke kode, men en konfigurasjon i YAML: en tekstfil der innrykkene bestemmer hva som hører sammen. ESPHome oversetter filen til et ferdig program og laster det opp. Home Assistant er smarthussentralen som samler alle enhetene dine. Har du ikke brukt ESP32 før, gir ESP32-guiden for nybegynnere en god start, og guiden om protokollene i Home Assistant forklarer hvordan WiFi-enheter som denne passer inn.

NivåDu fårTrenger Home Assistant?Nytt i konfigurasjonen
1Jordfuktighet på en nettside i ditt eget nettNeiadc, calibrate_linear, web_server
2Sensor, historikk og varsel på telefonenJaapi, number, binary_sensor
3Pumpe som vanner selv, også når nettet er nedeJa, til innstillinger og varselscript, globals, button

Slik måler ESP32 jordfukten

Fuktig jord leder strøm bedre enn tørr jord. Sonden har to bein, og sammen med en fast motstand på 10 kΩ danner jorda mellom dem en spenningsdeler. GPIO26 gir 3,3 V til det ene beinet. Det andre beinet går til GPIO32, og fra GPIO32 går motstanden til GND. Jo fuktigere jorda er, desto høyere blir spenningen på GPIO32. Den samme målemetoden, med lamper og skjerm i stedet for WiFi, er forklart trinn for trinn i guiden om fuktighetsmåler for planter.

Prinsipptegning: GPIO26 gir 3,3 volt, strømmen går gjennom jorda og motstanden på 10 kiloohm til GND, og GPIO32 måler spenningen i punktet mellom dem.
Forenklet tegning. Tallene 0,20 V og 1,60 V er eksempelverdiene i konfigurasjonen. Dine egne tall finner du når du kalibrerer.

Tre ting er verdt å vite om ESP32 før du kobler:

  • Kortet tåler bare 3,3 V på pinnene. Derfor får sonden strøm fra en pinne og ikke fra 5 V. Kortslutter du de to beina, går det høyst 0,33 mA.
  • Ikke alle analoge innganger virker sammen med WiFi. ESP32 har to analog-til-digital-omformere. Den ene, ADC2, er opptatt når WiFi er på. GPIO32 hører til ADC1 og virker alltid. Det gjør også GPIO33, 34, 35, 36 og 39.
  • Sonden får bare strøm mens den måler. Likestrøm gjennom fuktig jord tærer på metallet. Konfigurasjonen slår på GPIO26, venter 0,2 sekunder, måler og slår den av igjen.

På kortet er pinnene merket med D foran nummeret. GPIO26 heter D26, GPIO32 heter D32, og GPIO33 heter D33.

Test deg selv: hva måler GPIO32 hvis sonden ikke står i jord?

Nesten 0 V. Uten jord mellom beina går det ingen strøm fra GPIO26, og motstanden på 10 kΩ trekker GPIO32 ned mot GND. Kortet viser 0 %. En sonde som har falt ut, ser altså ut som en knusktørr plante.

Nivå 1: jordfuktighet på en egen nettside

Nivå 1: nybegynner. Tid: rundt 1 time. Du trenger ESP32-kortet, sonden fra jordfuktighetssensoren, koblingsbrett, én motstand på 10 kΩ og seks koblingsledninger. Du lærer å installere ESPHome, laste opp en konfigurasjon og lese en måling i nettleseren.

Et ESP32-kort med 30 pinner er bredt. På et koblingsbrett med 400 hull dekker det nesten alle radene, og det blir bare én ledig hullrad, på den ene siden av kortet. Alle pinnene du trenger, sitter heldigvis på samme side: raden som begynner med VIN og slutter med EN.

Fotorealistisk illustrasjon av et ESP32-kort på et koblingsbrett, der ledningene står i den ene ledige hullraden foran pinnene.
Illustrasjon. Kortet dekker nesten hele bredden, og ledningene står i den ledige hullraden. Følg koblingstegningen under når du kobler, ikke ledningene på bildet.
Koblingstegning for nivå 1 og 2: ESP32 i kolonne 1 til 15, sonden mellom D26 og kolonne 20, og 10 kiloohm fra kolonne 20 til GND.
ESP32-kortet sett ovenfra med USB-kontakten til venstre. Pinneraden fra VIN til EN står i rad i, så hullene i rad j, øverst på brettet, er ledige rett foran hver pinne. Bare denne raden er merket på tegningen.
  1. Sett ESP32-kortet i koblingsbrettet med USB-kontakten ut til venstre. Pinnen merket VIN skal stå i kolonne 1 og EN i kolonne 15, og denne pinneraden skal stå i rad i. Den andre pinneraden havner da i rad a eller b, avhengig av hvor bredt kortet er. Trykk kortet rett ned, jevnt på begge langsidene.
  2. Koble kolonne 2 i rad j, rett foran GND, til minusskinnen øverst.
  3. Koble minusskinnen øverst til minusskinnen nederst med en ledning rundt høyre ende av brettet.
  4. Sett de to ledningene fra pakken på pinnene til sonden. Stikk en hann-hann-ledning inn i den ledige enden av hver, så får du pinner som passer i koblingsbrettet.
  5. Sett den ene sondeledningen i kolonne 7 i rad j, rett foran D26.
  6. Sett den andre sondeledningen i kolonne 20, i nedre halvdel av brettet.
  7. Sett motstanden på 10 kΩ fra kolonne 20 til kolonne 25, i nedre halvdel, og koble kolonne 25 til minusskinnen nederst.
  8. Koble kolonne 10 i rad j, rett foran D32, til kolonne 20 i nedre halvdel.

Motstanden på 10 kΩ har fargene brun, svart og oransje hvis den har fire ringer, og brun, svart, svart og rød hvis den har fem.

Installer ESPHome og lag to filer

ESPHome kan kjøres på to måter. Har du Home Assistant OS, kan du installere tillegget ESPHome Device Builder og gjøre alt i nettleseren. Her bruker vi kommandolinjen, fordi den virker uten Home Assistant og er lik på Windows, macOS og Linux. Du trenger Python 3. Hvilken versjon som kreves, står i installasjonsveiledningen til ESPHome.

pip install esphome
esphome version

Lag en mappe som heter plantevakt, og lagre to filer i den. Den første heter secrets.yaml og inneholder passordene. Bytt ut alle verdiene med dine egne:

wifi_ssid: "Hjemmenett"
wifi_password: "bytt-meg-123"
reserve_passord: "bytt-meg-456"
api_nokkel: "MDEyMzQ1Njc4OWFiY2RlZjAxMjM0NTY3ODlhYmNkZWY="

Nøkkelen api_nokkel krypterer de trådløse oppdateringene allerede fra nivå 1, og fra nivå 2 også forbindelsen til Home Assistant. Den skal være 32 tilfeldige byte kodet som base64. Lag din egen med knappen på ESPHome-siden om API, og bruk aldri eksempelet over. Den andre filen heter plantevakt.yaml:

# Plantevakt, nivå 1: jordfuktighet på en egen nettside
# Kort: ESP32 DevKit med 30 pinner. Verktøy: ESPHome.

substitutions:
  volt_torr: "0.20"    # spenningen med sonden i tørr jord
  volt_vat: "1.60"     # spenningen med sonden i nyvannet jord
  malepause: 10s       # 10s mens du tester, 10min i daglig bruk

esphome:
  name: plantevakt
  friendly_name: Plantevakt

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  # Eget nett som reserve hvis kortet ikke finner ruteren
  ap:
    ssid: "Plantevakt reserve"
    password: !secret reserve_passord

captive_portal:

# Trådløse oppdateringer krypteres med nøkkelen som API-et bruker fra nivå 2
ota:
  - platform: esphome
    encryption:
      key: !secret api_nokkel

# Nettsiden du åpner på http://plantevakt.local
web_server:
  port: 80
  ota: false          # nettsiden skal ikke ta imot ny programvare

# Sonden får 3,3 V fra GPIO26 bare mens den måler
switch:
  - platform: gpio
    pin: GPIO26
    id: sonde_strom
    internal: true
    restore_mode: ALWAYS_OFF

sensor:
  # Spenningen i punktet mellom sonden og 10 kΩ
  - platform: adc
    pin: GPIO32
    id: sonde_volt
    name: "Sondespenning"
    attenuation: 12db
    samples: 8
    update_interval: never
    accuracy_decimals: 2

  # Samme måling regnet om til 0 til 100 prosent
  - platform: copy
    source_id: sonde_volt
    id: jordfukt
    name: "Jordfuktighet"
    unit_of_measurement: "%"
    device_class: moisture
    state_class: measurement
    accuracy_decimals: 0
    filters:
      - calibrate_linear:
          method: exact
          datapoints:
            - ${volt_torr} -> 0
            - ${volt_vat} -> 100
      - clamp:
          min_value: 0
          max_value: 100

interval:
  - interval: ${malepause}
    then:
      - switch.turn_on: sonde_strom
      - delay: 200ms
      - component.update: sonde_volt
      - switch.turn_off: sonde_strom

Koble kortet til PC-en med USB-kabelen, åpne en terminal i mappen, og kjør:

esphome run plantevakt.yaml

Første gang laster ESPHome ned byggeverktøyene, og det kan ta ti minutter eller mer. Senere går det mye raskere. Når programmet er bygd, spør ESPHome hvilken port det skal laste opp til. Velg USB-porten. Etter opplastingen ser du loggen fra kortet. Eksempel på logg (klokkeslett, tall og linjenumre blir andre hos deg):

[10:20:31][I][wifi:617]: WiFi Connected!
[10:20:41][D][sensor:094]: 'Sondespenning': Sending state 0.86000 V with 2 decimals of accuracy
[10:20:41][D][sensor:094]: 'Jordfuktighet': Sending state 47.14286 % with 0 decimals of accuracy

Åpne http://plantevakt.local i nettleseren på en PC eller telefon i samme nett. Virker ikke navnet, står IP-adressen til kortet i loggen.

Tegning av nettsiden kortet lager selv: en tabell med Jordfuktighet 47 prosent og Sondespenning 0,86 volt.
Slik kan nettsiden se ut. Dette er en tegning. Navnene Jordfuktighet og Sondespenning kommer fra konfigurasjonen, og utseendet avhenger av ESPHome-versjonen. Kortet skriver tallene med punktum.

Kalibrering: fra volt til prosent

Kortet måler en spenning, men du vil se prosent. Filteret calibrate_linear trekker en rett linje mellom to punkter du selv måler: spenningen i tørr jord skal bli 0 %, og spenningen i nyvannet jord skal bli 100 %.

Graf: 0,20 volt i tørr jord blir 0 prosent, 1,60 volt i nyvannet jord blir 100 prosent, og 0,86 volt havner på 47 prosent.
Beregning, ikke måling. Linjen er tegnet med eksempelverdiene 0,20 V og 1,60 V. Filteret clamp holder resultatet mellom 0 og 100 %.
  1. Sett sonden i potta når jorda er så tørr at det er på tide å vanne. Beina skal helt ned, og den svarte toppen skal stå over jorda.
  2. Les av Sondespenning på nettsiden, og skriv tallet inn i volt_torr øverst i filen. Bruk punktum som desimaltegn.
  3. Vann planten godt, vent ti minutter, og les av på nytt. Skriv tallet inn i volt_vat.
  4. Kjør esphome run --no-logs plantevakt.yaml, og velg trådløs opplasting. Nå trengs USB-kabelen bare til strøm. Uten --no-logs avslutter ESPHome med en feilmelding om logging, fordi nivå 1 ikke kan sende loggen over WiFi. Målingene ser du på nettsiden.
  5. Sett malepause til 10min når du er ferdig med å teste, og last opp på nytt.

Prosenten forteller hvor jorda ligger mellom dine to punkter, ikke hvor mange prosent vann den inneholder. Gjødsel og hardt vann gir høyere spenning, og en sonde som står løst, gir lavere. Kalibrer derfor i den potta sonden skal stå i.

Nivå 2: sensoren inn i Home Assistant, med varsel på telefonen

Nivå 2: viderekommen. Tid: rundt 45 minutter. Koblingen er den samme som på nivå 1. Du trenger Home Assistant i samme nett og Home Assistant-appen på telefonen. Du lærer å koble en ESPHome-enhet til Home Assistant, endre en grense uten ny opplasting og lage en automasjon som varsler.

Tre ting er nye i konfigurasjonen. api åpner en kryptert forbindelse til Home Assistant. number lager en grense du kan justere fra Home Assistant. binary_sensor lager sensoren Trenger vann, som er på når fukten er under grensen. Bytt ut innholdet i plantevakt.yaml med dette, og behold dine egne kalibreringstall:

# Plantevakt, nivå 2: sensoren inn i Home Assistant
# Kort: ESP32 DevKit med 30 pinner. Verktøy: ESPHome.

substitutions:
  volt_torr: "0.20"
  volt_vat: "1.60"
  malepause: 10min

esphome:
  name: plantevakt
  friendly_name: Plantevakt

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:

# Kryptert forbindelse til Home Assistant
api:
  encryption:
    key: !secret api_nokkel

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap:
    ssid: "Plantevakt reserve"
    password: !secret reserve_passord

captive_portal:

ota:
  - platform: esphome
    encryption:
      key: !secret api_nokkel

web_server:
  port: 80
  ota: false          # nettsiden skal ikke ta imot ny programvare

switch:
  - platform: gpio
    pin: GPIO26
    id: sonde_strom
    internal: true
    restore_mode: ALWAYS_OFF

# Grensen kan du endre fra Home Assistant uten å laste opp på nytt
number:
  - platform: template
    id: torstgrense
    name: "Tørstgrense"
    unit_of_measurement: "%"
    min_value: 10
    max_value: 60
    step: 1
    initial_value: 30
    optimistic: true
    restore_value: true
    entity_category: config

sensor:
  - platform: adc
    pin: GPIO32
    id: sonde_volt
    name: "Sondespenning"
    attenuation: 12db
    samples: 8
    update_interval: never
    accuracy_decimals: 2

  - platform: copy
    source_id: sonde_volt
    id: jordfukt
    name: "Jordfuktighet"
    unit_of_measurement: "%"
    device_class: moisture
    state_class: measurement
    accuracy_decimals: 0
    filters:
      - calibrate_linear:
          method: exact
          datapoints:
            - ${volt_torr} -> 0
            - ${volt_vat} -> 100
      - clamp:
          min_value: 0
          max_value: 100

  - platform: wifi_signal
    name: "WiFi-signal"
    update_interval: 60s

# På når fukten er under grensen. Denne bruker du i varslingen.
binary_sensor:
  - platform: template
    id: trenger_vann
    name: "Trenger vann"
    device_class: problem
    lambda: |-
      if (isnan(id(jordfukt).state)) {
        return {};
      }
      return id(jordfukt).state < id(torstgrense).state;

interval:
  - interval: ${malepause}
    then:
      - switch.turn_on: sonde_strom
      - delay: 200ms
      - component.update: sonde_volt
      - switch.turn_off: sonde_strom
  1. Kjør esphome run plantevakt.yaml, og velg trådløs opplasting.
  2. Åpne Home Assistant, og gå til Innstillinger og deretter Enheter og tjenester. Plantevakt dukker opp som oppdaget enhet.
  3. Velg Konfigurer, og lim inn nøkkelen fra api_nokkel i secrets.yaml.
  4. Enheten har nå sensorene Jordfuktighet, Sondespenning, WiFi-signal og Trenger vann, og innstillingen Tørstgrense.

Varselet lager du som en automasjon. Gå til Innstillinger, Automasjoner og scener, lag en ny automasjon, velg Rediger i YAML i menyen, og lim inn dette. Bytt ut telefonen_min med navnet telefonen din har i Home Assistant:

alias: Planten trenger vann
description: Varsler når jorda har vært tørr i en halv time
triggers:
  - trigger: state
    entity_id: binary_sensor.plantevakt_trenger_vann
    to: "on"
    for: "00:30:00"
actions:
  - action: notify.mobile_app_telefonen_min
    data:
      title: Plantevakt
      message: "Jorda er tørr: {{ states('sensor.plantevakt_jordfuktighet') | float(0) | round(0) | int }} %"
mode: single
Flyt: kortet måler under 30 prosent, Trenger vann slår seg på, Home Assistant venter i 30 minutter og sender et varsel til telefonen.
Forenklet tegning. Ventetiden på 30 minutter gjør at én lav måling ikke gir varsel. Grensen på 30 % er startverdien til Tørstgrense, og den kan du endre i Home Assistant.

Nivå 3: pumpe med sperrer i selve kortet

Nivå 3: avansert. Tid: rundt 1,5 timer. I tillegg trenger du relémodulen på 5 V, pumpen, strømadapteren på 12 V, DC-kontaktmodulen, én diode 1N4007, to krokodilleledninger, fem hann-hunn-ledninger, slange, vanntank og et fat under potta. Du lærer skript, tellere og sperrer i ESPHome.

En pumpe som styres over WiFi, må ikke være avhengig av WiFi for å stoppe. Derfor ligger hele logikken i kortet. Home Assistant kan endre innstillinger og be om en dose, men det er kortet som bestemmer om pumpen får gå, og hvor lenge.

To bokser: kortet måler, doserer, teller doser og har nødstopp selv, mens Home Assistant viser, varsler og endrer innstillinger.
Forenklet tegning. Tallene til venstre er startverdiene i konfigurasjonen: måling hvert tiende minutt, 30 minutters pause etter hver dose og etter oppstart, fire doser i døgnet og nødstopp etter 12 sekunder.

Pumpen går på 12 V og trekker rundt 0,3 A. Den får sin egen krets gjennom et relé, akkurat som i guiden om automatisk vanning av potteplanter, der relé, friløpsdiode, slange og plassering av tanken er forklart grundig. Les sikkerhetsreglene der før du kobler til 12 V. Her er pumpekretsen enda enklere: pluss fra adapteren går rett fra DC-kontaktmodulen til COM på reléet, uten å gå innom koblingsbrettet.

Koblingstegning for nivå 3: relémodulen får S fra D33, pumpen og dioden står i kolonne 22 og 28, og sonden er koblet som før.
ESP32-kortet sett ovenfra med USB-kontakten til venstre. Skinnene fører 5 V og GND fra ESP32-kortet. Pumpekretsen bruker bare kolonne 22 og 28 i rad f og g, langt fra plusskinnen øverst. Relémodulen er tegnet med skrueklemmene vendt bort fra deg.
  1. Trekk ut USB-kabelen. Adapteren på 12 V kobles til helt til slutt.
  2. Koble kolonne 1 i rad j, rett foran VIN, til plusskinnen øverst. VIN gir rundt 5 V fra USB-kabelen.
  3. Koble + på relémodulen til plusskinnen øverst og − til minusskinnen øverst, med hann-hunn-ledninger.
  4. Koble S på relémodulen til kolonne 9 i rad j, rett foran D33.
  5. DC-kontaktmodulen har fire pinner merket GND, GND, VCC og VCC. Sett en hann-hunn-ledning på en av VCC-pinnene, og skru den andre enden fast i COM på relémodulen (klemmen i midten).
  6. Skru en hann-hann-ledning fast i NO, og sett den andre enden i kolonne 22 i rad g.
  7. Koble en av GND-pinnene på DC-kontaktmodulen til kolonne 28 i rad g.
  8. Sett dioden i rad f, fra kolonne 22 til kolonne 28. Ringen skal være i enden ved kolonne 22.
  9. Fest en krokodilleledning på hver loddeflik på pumpen. Den andre enden av den ene fester du på beinet til dioden ved kolonne 22, den andre på beinet ved kolonne 28. Er en av flikene merket med pluss eller en rød prikk, skal den til kolonne 22.
  10. Sett slangene på pumpen, den ene ned i tanken og den andre opp til potta. Tanken skal stå lavere enn potta.

Bytt ut innholdet i plantevakt.yaml med konfigurasjonen for nivå 3, og behold kalibreringstallene dine. Mens du tester, setter du trekketid til 1min, ellers må du vente en halv time mellom hver test. Last deretter opp:

# Plantevakt, nivå 3: pumpe med sperrer i selve kortet
# Kort: ESP32 DevKit med 30 pinner. Verktøy: ESPHome.

substitutions:
  volt_torr: "0.20"
  volt_vat: "1.60"
  malepause: 10min
  trekketid: 30min     # pause etter hver dose, så vannet rekker å trekke inn
  nodstopp: 12s        # pumpen slås av etter denne tiden uansett

esphome:
  name: plantevakt
  friendly_name: Plantevakt

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:

# reboot_timeout 0s: kortet vanner videre selv om Home Assistant er nede
api:
  reboot_timeout: 0s
  encryption:
    key: !secret api_nokkel

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  reboot_timeout: 0s
  ap:
    ssid: "Plantevakt reserve"
    password: !secret reserve_passord

captive_portal:

ota:
  - platform: esphome
    encryption:
      key: !secret api_nokkel

web_server:
  port: 80
  ota: false          # nettsiden skal ikke ta imot ny programvare

# Endrede tall lagres i flash etter høyst 10 sekunder
preferences:
  flash_write_interval: 10s

# Dosene som er gitt i dette døgnet. Tallet beholdes etter en omstart.
globals:
  - id: doser_i_dag
    type: int
    restore_value: true
    initial_value: "0"

switch:
  - platform: gpio
    pin: GPIO26
    id: sonde_strom
    internal: true
    restore_mode: ALWAYS_OFF

  # Pumpen er skjult for Home Assistant og kan bare startes av skriptet gi_dose.
  - platform: gpio
    pin: GPIO33
    id: pumpe
    internal: true
    restore_mode: ALWAYS_OFF
    on_turn_on:
      - delay: ${nodstopp}
      - switch.turn_off: pumpe

  - platform: template
    id: automatikk
    name: "Automatisk vanning"
    optimistic: true
    restore_mode: RESTORE_DEFAULT_OFF

number:
  - platform: template
    id: torstgrense
    name: "Tørstgrense"
    unit_of_measurement: "%"
    min_value: 10
    max_value: 60
    step: 1
    initial_value: 30
    optimistic: true
    restore_value: true
    entity_category: config

  - platform: template
    id: dose_tid
    name: "Dose"
    unit_of_measurement: "s"
    min_value: 1
    max_value: 10
    step: 1
    initial_value: 3
    optimistic: true
    restore_value: true
    entity_category: config

  - platform: template
    id: maks_doser
    name: "Maks doser per døgn"
    min_value: 1
    max_value: 8
    step: 1
    initial_value: 4
    optimistic: true
    restore_value: true
    entity_category: config

# Én dose. mode single: en ny dose kan ikke starte før trekketiden er over.
script:
  - id: gi_dose
    mode: single
    then:
      - if:
          condition:
            lambda: "return id(doser_i_dag) < (int) id(maks_doser).state;"
          then:
            - lambda: "id(doser_i_dag) += 1;"
            - component.update: doser_sensor
            - switch.turn_on: pumpe
            - delay: !lambda "return (uint32_t) (id(dose_tid).state * 1000);"
            - switch.turn_off: pumpe
            - delay: ${trekketid}
          else:
            - logger.log: "Stopp: maks antall doser i dette døgnet."

button:
  - platform: template
    name: "Gi én dose"
    on_press:
      - script.execute: gi_dose

sensor:
  - platform: adc
    pin: GPIO32
    id: sonde_volt
    name: "Sondespenning"
    attenuation: 12db
    samples: 8
    update_interval: never
    accuracy_decimals: 2

  - platform: copy
    source_id: sonde_volt
    id: jordfukt
    name: "Jordfuktighet"
    unit_of_measurement: "%"
    device_class: moisture
    state_class: measurement
    accuracy_decimals: 0
    filters:
      - calibrate_linear:
          method: exact
          datapoints:
            - ${volt_torr} -> 0
            - ${volt_vat} -> 100
      - clamp:
          min_value: 0
          max_value: 100
    on_value:
      then:
        - if:
            condition:
              and:
                - switch.is_on: automatikk
                - not:
                    script.is_running: gi_dose
                - lambda: "return x < id(torstgrense).state;"
                # ingen automatisk dose de første 30 minuttene etter oppstart
                - lambda: "return millis() > 1800000UL;"
            then:
              - script.execute: gi_dose

  - platform: template
    id: doser_sensor
    name: "Doser i dette døgnet"
    accuracy_decimals: 0
    update_interval: 60s
    lambda: "return id(doser_i_dag);"

  - platform: wifi_signal
    name: "WiFi-signal"
    update_interval: 60s

binary_sensor:
  - platform: template
    id: trenger_vann
    name: "Trenger vann"
    device_class: problem
    lambda: |-
      if (isnan(id(jordfukt).state)) {
        return {};
      }
      return id(jordfukt).state < id(torstgrense).state;

interval:
  - interval: ${malepause}
    then:
      - switch.turn_on: sonde_strom
      - delay: 200ms
      - component.update: sonde_volt
      - switch.turn_off: sonde_strom

  # Nytt døgn: nullstill telleren, første gang 24 timer etter oppstart
  - interval: 24h
    startup_delay: 24h
    then:
      - lambda: "id(doser_i_dag) = 0;"
      - component.update: doser_sensor

Relémodulen får 5 V på +, men styresignalet fra ESP32 er 3,3 V. Ifølge produktsiden skifter reléet ved minst 3,3 V på S, så det er akkurat nok, uten margin. Test derfor først uten adapteren: trykk på Gi én dose i Home Assistant eller på nettsiden til kortet. Reléet skal klikke, og tre sekunder senere skal det klikke igjen. Klikker det ikke, viser guiden om relémodul med Arduino og ESP32 hvordan en transistor løfter signalet.

Tegning av plantevakten slik den vises i Home Assistant: jordfuktighet 41 prosent, bryteren Automatisk vanning, knappen Gi én dose og innstillingene.
Slik kan enheten se ut i Home Assistant. Dette er en tegning. Navnene kommer fra konfigurasjonen, og utseendet avhenger av hvilken versjon av Home Assistant du har.

Slik virker sperrene i konfigurasjonen:

SperreHvor i filenHva den hindrer
Pumpen er skjultinternal: true på bryteren pumpeAt noen slår pumpen på direkte og glemmer den
Én dose om gangenmode: single og trekketid i skriptetNy dose før vannet har trukket inn
Maks doser per døgndoser_i_dag og maks_doserAt en sonde som har falt ut, tømmer tanken
Nødstoppon_turn_on med nodstoppAt pumpen blir stående på hvis skriptet avbrytes
Av ved oppstartrestore_mode: ALWAYS_OFFAt pumpen starter etter strømbrudd
Pause etter oppstartmillis() i on_valueAt et kort som starter på nytt igjen og igjen, gir en ny dose hver gang
Uavhengig av nettetreboot_timeout: 0sAt kortet starter på nytt om og om igjen når WiFi er borte

Bryteren Automatisk vanning er av første gang kortet starter. Mål dosen med slangen i et målebeger, slik det er beskrevet i vanningsguiden, og juster Dose slik at mengden passer til potta. Hver test teller med i døgnets doser, så sett Maks doser per døgn høyere mens du måler. Når dosen er riktig, setter du trekketid tilbake til 30min, laster opp på nytt, setter Maks doser per døgn tilbake og slår på automatikken.

Telleren Doser i dette døgnet beholdes når kortet starter på nytt. Den nullstilles første gang 24 timer etter oppstart, og deretter hvert døgn. Etter en omstart venter kortet dessuten 30 minutter før det kan gi en automatisk dose. Knappen Gi én dose virker hele tiden.

Et kabinett til plantevakten

Når alt virker, kan hele nivå 3 flytte inn i et lukket kabinett: koblingsbrettet med ESP32-kortet, relémodulen og DC-kontaktmodulen. Kabinettet er tegnet etter målene på delene i denne guiden og måler 107 × 101 × 39 mm. Ingen av delene skal skrus fast. Koblingsbrettet ligger i en lomme i bunnplaten, og relémodulen og DC-kontaktmodulen ligger på lave lister. En bit dobbeltsidig tape på listene holder dem på plass.

  • USB-kabelen går inn gjennom et hull i venstre vegg, rett foran USB-kontakten når ESP32-kortet står som på koblingstegningen, med VIN i kolonne 1.
  • Pluggen fra adapteren på 12 V går gjennom et hull i bakveggen og rett inn i DC-kontaktmodulen.
  • Ledningene til sonden og pumpen går ut gjennom et spor nederst i høyre vegg. Sporet er åpent nedover, så lokket kan settes på over ferdig koblede ledninger. Fest ledningene til broen i bunnplaten med et buntebånd, så et rykk i slangen ikke drar i koblingsbrettet.

Lokket festes med fire M3-skruer med senkhode fra undersiden. Sett kabinettet høyere enn vanntanken og et stykke unna den, og la ledningene henge i en bue som går lavere enn sporet. Da drypper vann som renner langs en ledning, av i bunnen av buen i stedet for å renne inn i kabinettet. Kabinettet er ikke vanntett.

Vanlige feil og løsninger

Kortet kobler seg ikke til WiFi

ESP32 bruker bare 2,4 GHz. Sjekk navn og passord i secrets.yaml, og husk at store og små bokstaver teller. Finner ikke kortet nettet, lager det sitt eget nett, Plantevakt reserve. Koble telefonen til det, så kan du velge riktig nett og skrive inn passordet der.

plantevakt.local virker ikke

Noen rutere og telefoner støtter ikke slike navn. Bruk IP-adressen fra loggen i stedet, for eksempel http://192.168.1.50.

Jordfuktighet viser 0 % hele tiden

Det går ingen strøm gjennom sonden. Sjekk ledningen foran D26 og ledningen fra sonden til kolonne 20. Kortslutt de to beina med en skrutrekker: Sondespenning skal da vise rundt 3 V.

Jordfuktighet viser 100 % i tørr jord

volt_vat er satt for lavt, eller motstanden på 10 kΩ mangler mellom kolonne 20 og GND. Sjekk også ledningen mellom de to minusskinnene.

Home Assistant finner ikke enheten

Kortet og Home Assistant må være i samme nett. Legg enheten til for hånd under Enheter og tjenester, velg ESPHome, og skriv inn IP-adressen til kortet. Sjekk at api står i filen, og at den er lastet opp.

Reléet klikker, men pumpen går ikke

Feilen ligger i 12 V-kretsen. Lyser lampen på DC-kontaktmodulen? Sitter ledningene i COM og NO godt fast under skruene? Har krokodilleklemmene tak i metallet på loddeflikene og på beina til dioden?

Kortet starter på nytt når reléet trekker

USB-porten eller kabelen klarer ikke strømmen. Bruk en USB-lader på minst 1 A og en kort kabel. Hjelper ikke det, kan du gi relémodulen 5 V fra en egen lader. Ta da bort ledningen fra VIN til plusskinnen, så de to 5 V-kildene ikke kobles sammen, og koble GND på laderen til GND på kortet.

Vil du heller ha noe ferdig?

Ikke alt må bygges fra løse deler. Dette er noen alternativer i butikken:

Kapasitiv sensor

Den kapasitive sensoren fra Cytron har ikke bart metall i jorda og tåler å stå lenge. Den gir ut en analog spenning og kan kobles til en ADC1-inngang på ESP32. Sjekk at utgangen ikke går over 3,3 V.

kr 229,00
På lager
For M5Stack

Vanningsenheten med fuktsensor og minipumpe har sensor og pumpe i samme enhet og kobles til med én Grove-kabel.

kr 389,00
På lager
Uten mikrokontroller: ferdig fuktmodul

Jordfuktighetssensoren med 12 V-relé styrer en pumpe helt uten mikrokontroller. Den har ingen app og ingen varsling.

kr 229,00
På lager

Vanlige spørsmål

Trenger jeg Home Assistant for å bruke en jordfuktighetssensor med ESPHome?

Nei. Nivå 1 virker helt alene: kortet lager en nettside du åpner i nettleseren. Home Assistant gir deg historikk, varsler og automasjoner, og det er først på nivå 2 du trenger den.

Hva er forskjellen på ESPHome og Arduino-kode?

I Arduino skriver du selv programmet som leser pinner og sender data. I ESPHome beskriver du hva som er koblet til, og verktøyet lager programmet. WiFi, kryptering, trådløs oppdatering og koblingen til Home Assistant følger med. Guiden om Arduino, PlatformIO og ESP-IDF sammenligner verktøyene for ESP32.

Hvor mange planter kan ett ESP32-kort måle?

Seks. ADC1 har inngangene GPIO32, 33, 34, 35, 36 og 39. Hver sonde trenger sin egen inngang og sin egen motstand på 10 kΩ, mens alle kan dele GPIO26 som strømkilde. Bruker du GPIO33 til reléet, som på nivå 3, er det fem igjen. Med bare én ledig hullrad på koblingsbrettet lønner det seg da å bruke to koblingsbrett ved siden av hverandre.

Kan sensoren gå på batteri?

Ikke lenge med denne konfigurasjonen. Kortet har WiFi på hele tiden og trekker i snitt flere titalls milliampere. ESPHome har komponenten deep_sleep, som lar kortet sove mellom målingene, men et utviklingskort har USB-brikke og spenningsregulator som trekker strøm også i dvale. For en plante innendørs er en USB-lader det enkleste.

Virker vanningen hvis WiFi eller Home Assistant er nede?

Ja. Måling, grense, dosering og sperrer ligger i kortet. Med reboot_timeout: 0s fortsetter kortet som før uten nett. Du mister bare varsler og muligheten til å endre innstillinger, helt til forbindelsen er tilbake.

Er det trygt å la et hjemmebygd vanningsanlegg stå på i ferien?

Sperrene begrenser hvor mye vann som kan komme, men ingen hjemmebygd løsning er uten risiko. Bruk en liten tank, sett potta på et fat, la alt stå på et underlag som tåler vann, og kjør anlegget i minst en uke mens du er hjemme. Konfigurasjonene her er kontrollert med ESPHome, men ikke prøvd på fysisk maskinvare hos oss.

Veien videre

Nå har planten fått plass i smarthuset. Vil du forstå målingen bedre og se den på en skjerm i stedet, viser guiden om fuktighetsmåler for planter hvordan den samme sonden brukes med lysdioder og OLED-skjerm. Vil du ha tankvakt og symboler rett på kortet, viser guiden om automatisk vanning av potteplanter det med Arduino. Og vil du sammenligne resistive og kapasitive sensorer, er guiden om jordfuktighetssensorer en god fortsettelse.

Fakta her er hentet fra dokumentasjonen til ESPHome (ADC-sensoren, API-komponenten og web_server), fra Espressifs oversikt over GPIO på ESP32, fra Home Assistants side om ESPHome og fra produktsidene. Konfigurasjonene er kontrollert med ESPHome, men ikke kjørt på fysisk maskinvare. Produktsiden til relémodulen oppgir at den skifter ved minst 3,3 V på S. Det er akkurat det ESP32 gir, og derfor tester du reléet før pumpen kobles til.

Alle guider

Produkter omtalt i denne guiden

Produktene som brukes og sammenlignes i guiden, med pris og lagerstatus.