From d84787b337f5d51ccedd82c1d077ad5cbe60f70b Mon Sep 17 00:00:00 2001 From: Guillermo Ruffino Date: Mon, 26 Oct 2020 20:42:09 -0300 Subject: [PATCH] add rc522 docs (#810) --- .../binary_sensor/images/rc522-full.jpg | Bin 0 -> 84751 bytes components/binary_sensor/rc522.rst | 153 ++++++++++++++++++ images/rc522.jpg | Bin 0 -> 11246 bytes index.rst | 1 + 4 files changed, 154 insertions(+) create mode 100644 components/binary_sensor/images/rc522-full.jpg create mode 100644 components/binary_sensor/rc522.rst create mode 100644 images/rc522.jpg diff --git a/components/binary_sensor/images/rc522-full.jpg b/components/binary_sensor/images/rc522-full.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b1563499f7fe09e40d2653975c56c9cef00211c9 GIT binary patch literal 84751 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�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 literal 0 HcmV?d00001 diff --git a/components/binary_sensor/rc522.rst b/components/binary_sensor/rc522.rst new file mode 100644 index 000000000..0fb6438af --- /dev/null +++ b/components/binary_sensor/rc522.rst @@ -0,0 +1,153 @@ +RC522 RFID +========== + +.. seo:: + :description: Instructions for setting up RC522 RFID tag readers and tags in ESPHome + :image: rc522.jpg + :keywords: RC522, RFID + +.. _rc522-component: + +Component/Hub +------------- + +The ``rc522`` component allows you to use RC522 RFID controllers +(`datasheet `__, `Ali Express `__) +with ESPHome. This component is a global hub that establishes the connection to the RC522 via :ref:`SPI ` and +outputs its data. Using the :ref:`RC522 binary sensors ` you can then +create individual binary sensors that track if an RFID tag is currently detected by the RC522. + +.. figure:: images/rc522-full.jpg + :align: center + :width: 60.0% + +See :ref:`rc522-setting_up_tags` for information on how to setup individual binary sensors for this component. + +As the communication with the RC522 is done using SPI you need to have an :ref:`SPI bus ` in your configuration with both +the **miso_pin** and **mosi_pin** set. + +.. code-block:: yaml + + # Example configuration entry + spi: + clk_pin: D0 + miso_pin: D1 + mosi_pin: D2 + + rc522_spi: + cs_pin: D3 + update_interval: 1s + + binary_sensor: + - platform: rc522 + uid: 74-10-37-94 + name: "RC522 RFID Tag" + +Configuration variables: +************************ + +- **cs_pin** (**Required**, :ref:`Pin Schema `): The pin on the ESP that the chip select line + is connected to. +- **reset_pin** (*Optional*, :ref:`Pin Schema `): The pin connected to the RST line. Some tests + shows the RC522 working okay without this. +- **update_interval** (*Optional*, :ref:`config-time`): The duration of each scan on the RC522. This affects the + duration that the individual binary sensors stay active when they're found. + If a device is not found within this time window, it will be marked as not present. Defaults to 1s. +- **on_tag** (*Optional*, :ref:`Automation `): An automation to perform + when a tag is read. See :ref:`rc522-on_tag`. +- **spi_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :ref:`SPI Component ` if you want + to use multiple SPI buses. +- **id** (*Optional*, :ref:`config-id`): Manually specify the ID for this component. + +.. _rc522-on_tag: + +``on_tag`` +---------- + +This automation will be triggered when the RC522 module responds with a tag. Please note that this +can be called quite often (with an interval of ``update_interval``) as it's triggered repeatedly +if the tag is re-read many times. + +The parameter ``x`` this trigger provides is of type ``std::string`` and is the tag UID in the format +``74-10-37-94``. The configuration below will for example publish the tag ID on the MQTT topic ``rc522/tag``. + +.. code-block:: yaml + + rc522: + # ... + on_tag: + then: + - mqtt.publish: + topic: rc522/tag + payload: !lambda 'return x;' + +A tag scanned event can also be sent to the Home Assistant tag component +using :ref:`api-homeassistant_tag_scanned_action`. + +.. code-block:: yaml + + rc522: + # ... + on_tag: + then: + - homeassistant.tag_scanned: !lambda 'return x;' + +.. _rc522-tag: + +RFID Tag +-------- + +The ``rc522`` binary sensor platform lets you track if an RFID tag with a given +unique id (``uid``) is currently being detected by the RC522 or not. + +.. code-block:: yaml + + # Example configuration entry + spi: + clk_pin: D0 + miso_pin: D1 + mosi_pin: D2 + + rc522_spi: + cs_pin: D3 + update_interval: 1s + + binary_sensor: + - platform: rc522 + uid: 74-10-37-94 + name: "RC522 RFID Tag" + +Configuration variables: +************************ + +- **uid** (**Required**, string): The unique ID of the RFID tag. This is a hyphen-separated list + of hexadecimal values. For example ``74-10-37-94``. +- **name** (**Required**, string): The name of the binary sensor. +- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. +- All other options from :ref:`Binary Sensor `. + +.. _rc522-setting_up_tags: + +Setting Up Tags +--------------- + +To set up binary sensors for specific RFID tags you first have to know their unique IDs. To obtain this +id, first set up a simple RC522 configuration without any binary sensors like above. + +When your code is running and you approach the RC522 with an RFID Tag, you should see a message like this: + +.. code:: + + Found new tag '74-10-37-94' + +Then copy this id and create a ``binary_sensor`` entry as in the configuration example. Repeat this process for +each tag. + +See Also +-------- + +- :doc:`index` +- :doc:`rdm6300` +- :doc:`pn532` +- :apiref:`rc522_spi/rc522_spi.h` +- :ghedit:`Edit` diff --git a/images/rc522.jpg b/images/rc522.jpg new file mode 100644 index 0000000000000000000000000000000000000000..addd2ea51931b2aa49d2b211e40088aeff41f1b7 GIT binary patch literal 11246 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 literal 0 HcmV?d00001 diff --git a/index.rst b/index.rst index 51ff28995..c147be2fe 100644 --- a/index.rst +++ b/index.rst @@ -189,6 +189,7 @@ Binary Sensor Components Nextion Touch, components/binary_sensor/nextion, nextion.jpg Template Binary Sensor, components/binary_sensor/template, description.svg PN532, components/binary_sensor/pn532, pn532.jpg + RC522, components/binary_sensor/rc522, rc522.jpg RDM6300, components/binary_sensor/rdm6300, rdm6300.jpg TTP229, components/binary_sensor/ttp229, ttp229.jpg Tuya Binary Sensor, components/binary_sensor/tuya, tuya.png