Move WiFi signal to next

This commit is contained in:
Otto Winter 2018-06-09 10:43:48 +02:00
parent de8e891b3f
commit 41f60b3b9d
No known key found for this signature in database
GPG Key ID: DB66C0BE6013F97E
2 changed files with 65 additions and 0 deletions

View File

@ -0,0 +1,23 @@
WiFi Signal Sensor
==================
Example Usage
-------------
.. code-block:: cpp
App.make_wifi_signal_sensor("WiFi Signal Sensor");
.. cpp:namespace:: nullptr
See :cpp:func:`Application::make_wifi_signal_sensor`.
API Reference
-------------
.. cpp:namespace:: nullptr
.. doxygenclass:: sensor::WiFiSignalSensor
:members:
:protected-members:
:undoc-members:

View File

@ -0,0 +1,42 @@
WiFi Signal Sensor
==================
The ``wifi_signal`` sensor platform allows you to read the signal
strength of the currently connected :doc:`WiFi Access Point </esphomeyaml/components/wifi>`.
The sensor value is the `"Received signal strength indication" <https://en.wikipedia.org/wiki/Received_signal_strength_indication>`__
measured in decibels. These values are always negative and the closer they are to zero, the better the signal is.
.. figure:: images/wifi_signal-ui.png
:align: center
:width: 80.0%
.. code:: yaml
# Example configuration entry
sensor:
- platform: wifi_signal
name: "WiFi Signal Sensor"
update_interval: 15s
Configuration variables:
------------------------
- **name** (**Required**, string): The name of the hall effect sensor.
- **update_interval** (*Optional*, :ref:`config-time`): The interval
to check the sensor. Defaults to ``15s``. See :ref:`sensor-default_filter`.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- All other options from :ref:`Sensor <config-sensor>` and :ref:`MQTT Component <config-mqtt-component>`.
.. warning::
Signal strength readings are only available when WiFi in in station mode. Readings are not valid
if the device is acting as an access point without any station mode connection.
See Also
--------
- :ref:`sensor-filters`
- :doc:`/esphomeyaml/components/wifi`
- :doc:`API Reference </api/sensor/wifi_signal>`
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/sensor/wifi_signal.rst>`__