esphome-docs/esphomeyaml/components/sensor/esp32_hall.rst

51 lines
1.8 KiB
ReStructuredText
Raw Normal View History

2018-06-02 23:36:38 +02:00
ESP32 Hall Sensor
=================
The ``esp32_hall`` sensor platform allows you to use the integrated
`hall effect sensor <https://en.wikipedia.org/wiki/Hall_effect_sensor>`__ of the
ESP32 chip to measure the magnitude and direction of magnetic field around the
chip (with quite poor accuracy).
Please make sure that nothing is connected to pins ``GPIO36`` and ``GPIO39`` if this
component is enabled, as those pins are used for the internal low-noise amplifier used
by the hall sensor.
.. figure:: images/esp32_hall-ui.png
:align: center
:width: 80.0%
.. code:: yaml
# Example configuration entry
sensor:
- platform: esp32_hall
name: "ESP32 Hall Sensor"
update_interval: 15s
Configuration variables:
2018-08-24 22:44:01 +02:00
------------------------
2018-06-02 23:36:38 +02:00
- **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::
The values this sensor outputs were only calibrated with a few magnets and no real "truth" sensor.
Therefore the values could very well be off by orders of magnitude. Besides, this sensor should
only be used to detect sudden high changes in the magnetic field.
If you have a real magnetic field calibration setup and want to contribute your values to esphomelib,
please feel free to do so 😺.
See Also
2018-08-24 22:44:01 +02:00
--------
2018-06-02 23:36:38 +02:00
- :ref:`sensor-filters`
- :doc:`adc`
- :doc:`/esphomeyaml/devices/esp32`
- :doc:`API Reference </api/sensor/esp32_hall>`
2018-06-04 08:17:22 +02:00
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/sensor/esp32_hall.rst>`__