GDK101 support (esphome#2853)

Co-authored-by: Jesse Hills <[email protected]>

components/sensor/gdk101.rst

@@ -0,0 +1,125 @@
+FTLab GDK101 Gamma Radiation Sensor Module
+==========================================
+
+.. seo::
+    :description: Instructions for setting up GDK101 Gamma Radiation Sensor Module
+    :image: gdk101.jpg
+    :keywords: gdk101
+
+The **GDK101** sensor platform allows you to use your GDK101 sensor to monitor radiation levels at your place.
+
+The GDK101 can measure average dose rate per 1 and 10 minutes, it also detect vibrations that can disturb the measurement.
+
+The GDK101 requires setting up :ref:`I²C <i2c>` for data communication.
+
+Module Pins
+-----------
+
+============  ===============================================================
+ Module Pin   Description
+============  ===============================================================
+TX            UART TX pin
+RX            UART RX pin
++5VIN         Positive supply voltage
+GND1          Ground
+SDA           I²C data bus
+SCL           I²C clock bus
+
+A0            Adress Jumper 1
+A1            Adress Jumper 2
+============  ===============================================================
+
+============  ===============================================================
+I2C Address   Jumpers State
+============  ===============================================================
+0x18          A0 Short, A1 Short
+0x19          A0 Open,  A1 Short
+0x1A          A0 Short, A1 Open
+0x1B          A0 Open,  A1 Open
+============  ===============================================================
+
+.. figure:: images/gdk101.jpg
+    :align: center
+    :width: 50.0%
+
+    GDK101 Gamma Radiation Sensor Module.
+
+Component/Hub
+-------------
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    gdk101:
+      i2c_id: bus_a
+      address: 0x18
+      update_interval: 10s
+
+- **address** (*Optional*, int): Manually specify the I²C address of
+  the sensor. Defaults to ``0x18`` (``A0`` and ``A1`` shorted).
+  The address is made up using the state of ``A0`` as bit 1 and the state of ``A1`` as bit 2, so a total of four addresses is possible.
+- **update_interval** (*Optional*, int): Manually defined update iterval of sensor. Default to 60s.
+- **i2c_id** (*Optional*, string): Optional name of the bus.
+
+Sensor
+------
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    sensor:
+      - platform: gdk101
+        radiation_dose_per_1m:
+          name: "GDK101 Radiation Dose @ 1 min"
+        radiation_dose_per_10m:
+          name: "GDK101 Radiation Dose @ 10 min"
+        status:
+          name: "GDK101 Status"
+        version:
+          name: "GDK101 FW Version"
+        measurement_duration:
+          name: "GDK101 Measuring Time"
+
+A sensor platform to radiation data
+
+Configuration variables:
+
+- **radiation_dose_per_1m** (**Required**): Radiation average dose per 1 minute.
+  All options from :ref:`Sensor <config-sensor>`.
+- **radiation_dose_per_10m** (**Required**): Radiation average dose per 10 minutes.
+  All options from :ref:`Sensor <config-sensor>`.
+- **version** (**Required**): Fimware version of the module.
+  All options from :ref:`Sensor <config-sensor>`.
+- **status** (*Optional*): Sensor status.
+  All options from :ref:`Sensor <config-sensor>`.
+- **measurement_duration** (*Optional*): Total time of measurement.
+  All options from :ref:`Sensor <config-sensor>`.
+
+Binary Sensor
+-------------
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    binary_sensor:
+      - platform: gdk101
+        vibrations:
+          name: "GDK101 Vibrations"
+
+Binary sensor that indicates if measurement was disturbed by vibrations.
+
+Configuration variables:
+
+- **vibrations** (**Required**): Vibration status.
+  All options from :ref:`Binary Sensor <config-binary_sensor>`.
+
+
+See Also
+--------
+
+- :ref:`sensor-filters`
+- :apiref:`gdk101/gdk101.h`
+- `Data Sheet <http://allsmartlab.com/eng/wp-content/uploads/sites/2/2017/01/GDK101datasheet_v1.6.pdf>`__
+- `Application Notes <https://merona.blob.core.windows.net/radonftlab-web/GDK101.zip>`__
+- `Arduino Sensors for Everyone blog post <https://arduino.steamedu123.com/entry/GDK101-Radiation-Sensor>`__
+- :ghedit:`Edit`

index.rst

@@ -488,6 +488,7 @@ Miscellaneous
     uFire EC sensor, components/sensor/ufire_ec, ufire_ec.png, EC & Temperature
     uFire ISE sensor, components/sensor/ufire_ise, ufire_ise.png, pH & Temperature
     WireGuard, components/wireguard, wireguard_custom_logo.svg
+    GDK101, components/sensor/gdk101, gdk101.jpg, Radiation
 
 Motion
 ******