2018-08-22 22:05:28 +02:00
|
|
|
Uptime Sensor
|
|
|
|
|
=============
|
|
|
|
|
|
2018-11-14 22:12:27 +01:00
|
|
|
.. seo::
|
|
|
|
|
:description: Instructions for setting up a sensor that tracks the uptime of the ESP.
|
2021-11-16 03:19:33 +01:00
|
|
|
:image: timer.svg
|
2018-11-14 22:12:27 +01:00
|
|
|
|
2018-08-22 22:05:28 +02:00
|
|
|
The ``uptime`` sensor allows you to track the time the ESP has stayed up for in seconds.
|
|
|
|
|
Time rollovers are automatically handled.
|
|
|
|
|
|
2018-11-19 18:32:16 +01:00
|
|
|
.. code-block:: yaml
|
2018-08-22 22:05:28 +02:00
|
|
|
|
|
|
|
|
# Example configuration entry
|
|
|
|
|
sensor:
|
|
|
|
|
- platform: uptime
|
2024-07-02 04:29:55 +02:00
|
|
|
type: seconds
|
2018-08-22 22:05:28 +02:00
|
|
|
name: Uptime Sensor
|
|
|
|
|
|
|
|
|
|
Configuration variables:
|
|
|
|
|
------------------------
|
|
|
|
|
|
2024-07-02 04:29:55 +02:00
|
|
|
- **type** (*Optional*): Either:
|
2019-01-06 18:56:14 +01:00
|
|
|
|
2024-07-02 04:29:55 +02:00
|
|
|
- ``seconds`` (*default*): A simple counter.
|
|
|
|
|
- ``timestamp``: presents the time ESPHome last booted up. Requires a :doc:`/components/time/index`.
|
2018-08-24 22:44:01 +02:00
|
|
|
|
2024-07-02 04:29:55 +02:00
|
|
|
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``.
|
|
|
|
|
Valid only with ``type: seconds``.
|
|
|
|
|
- All other options from :ref:`Sensor <config-sensor>`.
|
2021-01-11 15:50:29 +01:00
|
|
|
|
2018-08-24 22:44:01 +02:00
|
|
|
See Also
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
- :ref:`sensor-filters`
|
2019-05-12 22:44:59 +02:00
|
|
|
- :apiref:`uptime/uptime_sensor.h`
|
2019-02-07 13:54:45 +01:00
|
|
|
- :ghedit:`Edit`
|
