Debug Component

The debug component can be used to debug problems with ESPHome. At startup, it prints a bunch of useful information like reset reason, free heap size, ESPHome version and so on. It also allows you to get the same information as a text sensor, and to monitor the state of the ESP heap memory (free space, maximum free block size and fragmentation level) and the main-loop timing.

../_images/debug.png

Example debug component output.

# Example configuration entry
debug:
  update_interval: 5s

text_sensor:
  - platform: debug
    device:
      name: "Device Info"
    reset_reason:
      name: "Reset Reason"

sensor:
  - platform: debug
    free:
      name: "Heap Free"
    fragmentation:
      name: "Heap Fragmentation"
    block:
      name: "Heap Max Block"
    loop_time:
      name: "Loop Time"
    psram:
      name: "Free PSRAM"

# Logger must be at least debug (default)
logger:
  level: debug

Text Sensor

Configuration variables:

  • device (Optional): Reports the following device information:

    • ESPHome Version

    • Free heap size at startup

    • Flash chip size, speed and mode

    • ESP32:

      • Chip model, cores, revision

      • Chip features (BLE / BT / WiFi_BGN / EMB_FLASH / EMB_PSRAM / …)

      • ESP-IDF version

      • EFuse MAC

      • Reset reason

      • Wakeup reason

    • ESP8266:

      • Chip id, frequency

      • Flash id

      • SDK, Core & Boot versions

      • Reset reason & information

    Accepts all options from Text Sensor.

  • reset_reason (Optional): Reports the last reboot reason in a human-readable form. Accepts all options from Text Sensor.

Sensor

Configuration variables:

  • free (Optional): Reports the free heap size in bytes. All options from Sensor.

  • fragmentation (Optional): Reports the fragmentation metric of the heap (0% is clean, more than ~50% is not harmless). Only available on ESP8266 with Arduino 2.5.2+. All options from Sensor.

  • block (Optional): Reports the largest contiguous free RAM block on the heap in bytes. All options from Sensor.

  • loop_time (Optional): Reports the longest time between successive iterations of the main loop. All options from Sensor.

  • psram (Optional): Reports the free PSRAM in bytes. Only available on ESP32. All options from Sensor.

See Also