Add: Seeed Studio MR60FDA2 mmWave Sensor document (#4330)

Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
Citric Lee 2024-11-26 08:54:02 +08:00 committed by GitHub
parent f464770315
commit 14cf1c478c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 119 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

View File

@ -0,0 +1,112 @@
Seeed Studio MR60FDA2 60GHz mmWave Fall Detection Sensor Kit
============================================================
.. seo::
:description: Instructions for setting up Seeed Studio MR60FDA2 60GHz mmWave Fall Detection Sensor Kit.
:image: seeed_mr60fda2.jpg
Component/Hub
-------------
The ``seeed_mr60fda2`` platform allows you to use Seeed Studio's MR60FDA2 60GHz mmWave Fall Detection Sensor Kit with XIAO ESP32C6 (`Product Page <https://www.seeedstudio.com/MR60FDA2-60GHz-mmWave-Sensor-Fall-Detection-Module-p-5946.html>`__) with ESPHome.
The :ref:`UART <uart>` is required to be set up in your configuration for this sensor to work, ``parity`` and ``stop_bits`` **must be** respectively ``NONE`` and ``1``.
You can use the ESP32 software or hardware (recommended) serial to use the MR60FDA2; its default baud rate is 115200.
.. figure:: images/seeed_mr60fda2.jpg
:align: center
:width: 50.0%
Seeed Studio MR60FDA2 60GHz mmWave Fall Detection Sensor Kit with XIAO ESP32C6
.. code-block:: yaml
# Example configuration entry
seeed_mr60fda2:
Configuration variables:
************************
- **uart_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :ref:`UART Component <uart>` if you want
to use multiple UART buses.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID for this :doc:`seeed_mr60fda2` component if you need multiple components.
Binary Sensor
-------------
The ``seeed_mr60fda2`` binary sensor allows you to determine the presence of a human.
.. code-block:: yaml
binary_sensor:
- platform: seeed_mr60fda2
people_exist:
name: "Person Information"
fall_detected:
name: "Falling Detected"
Configuration variables:
************************
- **people_exist** (*Optional*): If true when target (person) is detected.
All options from :ref:`Binary Sensor <config-binary_sensor>`.
- **fall_detected** (*Optional*): An indication of whether the radar has detected a fall.
All options from :ref:`Text Sensor <config-text_sensor>`.
Button
------
The ``seeed_mr60fda2`` button allows you to perform actions.
.. code-block:: yaml
button:
- platform: seeed_mr60fda2
get_radar_parameters:
name: "Get Radar Parameters"
factory_reset:
name: "Reset"
Configuration variables:
************************
- **factory_reset**: Restore all radar settings to factory parameters. All options from :ref:`Button <config-button>`.
- **get_radar_parameters**: Get all the current setup parameters of the radar.
All options from :ref:`Button <config-button>`.
Select
------
The ``seeed_mr60fda2`` select allows you to control the configuration.
.. code-block:: yaml
select:
- platform: seeed_mr60fda2
install_height:
name: "Set Install Height"
height_threshold:
name: "Set Height Threshold"
sensitivity:
name: "Set Sensitivity"
Configuration variables:
************************
- **install_height**: Before using the MR60FDA2, please select the installation height of the radar according to the actual situation in order to obtain accurate identification results. The default is 3m.
All options from :ref:`Select <config-select>`.
- **height_threshold**: To accurately distinguish between a person falling and sitting still in this area, you need to set the trigger height that triggers fall detection. This height refers to the distance between the person and the ground at the time of the fall. The default is 0.6m.
All options from :ref:`Select <config-select>`.
- **sensitivity**: Fall sensitivity factor. Defaults to 1 with a range of 1-3, 3 = high and 1 = low.
All options from :ref:`Select <config-select>`.
See Also
--------
- `Official Using Documents for Seeed Studio MR60FDA2 60GHz mmWave Fall Detection Sensor Kit with XIAO ESP32C6 <https://wiki.seeedstudio.com/getting_started_with_mr60fda2_mmwave_kit/>`_
- `Product Detail Page for Seeed Studio MR60FDA2 60GHz mmWave Fall Detection Sensor Kit with XIAO ESP32C6 <https://www.seeedstudio.com/MR60FDA2-60GHz-mmWave-Sensor-Fall-Detection-Module-p-5946.html>`_
- `Source of inspiration for implementation <https://github.com/limengdu/MR60FDA2_ESPHome_external_components>`_
- :apiref:`seeed_mr60fda2/seeed_mr60fda2.h`
- :ghedit:`Edit`

BIN
images/seeed_mr60fda2.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

View File

@ -508,6 +508,13 @@ Environmental
TMP117, components/sensor/tmp117, tmp117.jpg, Temperature
XGZP68xx Series, components/sensor/xgzp68xx, 6897d.jpg, Differential Pressure
Health/Safety
*************
.. imgtable::
Seeed Studio MR60FDA2 mmWave, components/seeed_mr60fda2, seeed_mr60fda2.jpg, Presence & Fall detection
Light
*****