HC-SR04 Ultraschall Distanzsensor

Kategorie:: esphome
Unterkategorie:: snippets
Pfad:: templates/esphome/snippets/sensors/ultrasonic-hc-sr04

Tags:

#sensors

Beschreibung & Dokumentation

HC-SR04 Ultraschall Distanzsensor Zweck Berührungslose Entfernungsmessung für Füllstandsanzeigen, Parksensoren oder Anwesenheitserkennung. Nutzung Messbereich: 2cm bis 400cm Genauigkeit: ±3mm Stromverbrauch: ~15mA (nur während Messung) Betriebsspannung: 5V (funktioniert meist auch mit 3.3V) Anschlus...

Code-Vorschau

Haupt-Konfiguration

Tipp: Markieren & ⌘/Ctrl + C zum Kopieren

configuration.yaml

# HC-SR04 Ultraschall Distanzsensor
# Misst Entfernung mit Ultraschallwellen (2cm - 400cm)
sensor:
  - platform: ultrasonic
    trigger_pin: GPIO5
    echo_pin: GPIO18
    name: "${friendly_name} Distance"
    id: ultrasonic_sensor
    unit_of_measurement: "cm"
    accuracy_decimals: 1
    device_class: distance
    state_class: measurement
    update_interval: 5s
    timeout: 3m  # Maximale Messzeit
    filters:
      - filter_out: nan  # Ungültige Messwerte entfernen
      - median:  # Rauschen reduzieren
          window_size: 5
          send_every: 3
      - lambda: |-
          // Auf Sensor-Bereich begrenzen (2-400cm)
          if (x < 2.0 || x > 400.0) {
            return {};  // Leerwert zurückgeben (gefiltert)
          }
          return x;

# Optional: Binärsensor für Näherungserkennung
binary_sensor:
  - platform: template
    name: "${friendly_name} Close Proximity"
    id: proximity_alert
    device_class: proximity
    lambda: |-
      if (id(ultrasonic_sensor).state < 10.0) {
        return true;
      } else {
        return false;
      }

GitHub anzeigen