Inicio › Guía LD2420 › Ajustar gates y sensibilidad

LD2420 y ESPHome: reduce falsos positivos ajustando gates y sensibilidad

Publicado: 21/09/2026 · Última revisión: 21/09/2026

El LD2420 no decide "aquí hay una persona". Compara energía contra un umbral. Si tienes falsos positivos, casi nunca es el sensor: es que algún gate está cubriendo un objeto que no debería ver, o un umbral está tan bajo que el ruido también lo supera.

El problema que describe la documentación

La propia documentación de ESPHome lo avisa, y es la frase que da la clave:

Solid objects and noise outside the detection_gate_max and detection_gate_min may cause false detections or result in abnormal gate thresholds.

Traducido sin eufemismos: una pared, una nevera o un armario metálico que quede dentro del rango que le has dado al radar puede devolver detecciones fantasma. No es defecto del sensor, es el rango de trabajo que le has definido.

Configuración base de ejemplo

Parto de esta base y después ajusto los valores según el falso positivo que esté viendo en el registro de Home Assistant.

ld2420:
  id: radar_presencia
  number:
    - platform: ld2420
      presence_timeout:
        name: Tiempo de presencia
      min_gate_distance:
        name: Distancia mínima
      max_gate_distance:
        name: Distancia máxima
      gate_select:
        name: Gate a ajustar
      still_threshold:
        name: Umbral reposo
      move_threshold:
        name: Umbral movimiento
      gate_move_sensitivity:
        name: Sensibilidad calibración movimiento
      gate_still_sensitivity:
        name: Sensibilidad calibración reposo
  binary_sensor:
    - platform: ld2420
      has_target:
        name: Presencia radar
  button:
    - platform: ld2420
      apply_config:
        name: Aplicar configuración

Los dos mandos que más cambian la conducta

No hace falta tocar los 16 gates a ciegas. Casi todos los falsos positivos se corrigen con dos parámetros:

• min_gate_distance y max_gate_distance: definen la ventana de distancia que el radar va a mirar. Si la detección fantasma viene de un mueble a 4 metros y la persona está a 1 metro, baja el máximo hasta dejarlo por debajo del mueble.
• presence_timeout: cuántos segundos espera ESPHome antes de dar la presencia por terminada. Un valor corto disimula ruido que llega en ráfagas; un valor largo mantiene la habitación ocupada tras una detección real, pero también deja pasar más ruido como presencia.

Tabla de parámetros

Los nombres son exactamente los del componente. Los rangos que no conseguí confirmar con fuente primaria van marcados como estimación o sin confirmar; no los uses como especificación oficial.

Procedimiento para no tocar a ciegas

1. Sube presence_timeout a 10-15 segundos al empezar; así separas el ruido en ráfagas de la presencia real limpia.
2. Mira en el registro qué gate está disparando. Para calibrarlo, pon gate_select en ese número y sube el umbral correspondiente de 5 en 5.
3. Si no aparece ningún gate concreto y el fantasma es de fondo, estrecha la ventana: sube min_gate_distance para ignorar lo que esté pegado al sensor o baja max_gate_distance para ignorar lo que esté al fondo.
4. Tras cada cambio, pulsa apply_config y espera al menos 30 minutos antes de tocar nada más; si cambias dos parámetros a la vez, no sabrás cuál de los dos calmó el sensor.
5. Si el falso positivo vuelve solo con la calefacción, con el aire acondicionado o con la lavadora, no subas más umbrales: replantea la ubicación física del radar porque estás intentando calibrar ruido estructural, no detección.

Qué no he podido verificar

Los rangos numéricos exactos de still_threshold, move_threshold, min_gate_distance y max_gate_distance no están explícitos en la página oficial que consulté, y no voy a rellenarlos de memoria porque un YAML con un número inventado es justo lo que no debe ser esta web. La estructura del YAML y la existencia de los 16 gates sí quedaron confirmadas por la documentación oficial y por la guía de Esp32.co.uk del 19/08/2026.