initial tem3200 pressure sensor documentation

components/sensor/tem3200.rst

@@ -0,0 +1,115 @@
+TE-M3200 Pressure Sensor
+===========================================
+
+.. seo::
+    :description: Instructions for setting up TE-M3200 pressure sensors with ESPHome
+    :image: tem3200.jpg
+    :keywords: TEM3200 TE-M3200
+
+The ``tem3200`` sensor platform allows you to use your TE-M3200 (`datasheet <https://www.te.com/commerce/DocumentDelivery/DDEController?Action=showdoc&DocId=Data+Sheet%7FM3200%7FA20%7Fpdf%7FEnglish%7FENG_DS_M3200_A20.pdf>`__,
+`product page <https://www.te.com/en/product-CAT-PTT0068.html>`__) pressure sensors with ESPHome.
+
+.. figure:: images/tem3200.jpg
+    :align: center
+    :width: 50.0%
+
+    TE-M3200 Pressure Sensor.
+
+
+Configuration
+-------------
+:ref:`I²C <i2c>` bus is required to be set up in your configuration for this sensor to work.
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    i2c:
+
+    sensor:
+      - platform: tem3200
+        raw_pressure:
+          name: "Raw Pressure"
+          id: raw_pressure
+
+        temperature:
+          name: Temperature
+
+      - platform: copy
+        source_id: raw_pressure
+        name: Pressure
+        state_class: measurement
+        device_class: pressure
+        unit_of_measurement: psi
+
+        filters:
+          - calibrate_linear:
+            - 1000 -> 0.0
+            - 15000 -> 100.0
+
+
+Configuration variables
+-----------------------
+
+- **raw_pressure** (*Optional*): The information for the pressure sensor. See :ref:`tem3200-converting`.
+
+ - All other options from :ref:`Sensor <config-sensor>`.
+
+- **temperature** (*Optional*): The information for the temperature sensor. Readings in degrees celsius (°C).
+
+ - All other options from :ref:`Sensor <config-sensor>`.
+
+- **i2c_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :ref:`I²C Component <i2c>`. Defaults to the default I²C bus.
+
+- **address** (*Optional*, int): Manually specify the I²C address of the sensor. Defaults to ``0x28``. See `datasheet
+  <https://www.te.com/commerce/DocumentDelivery/DDEController?Action=showdoc&DocId=Data+Sheet%7FM3200%7FA20%7Fpdf%7FEnglish%7FENG_DS_M3200_A20.pdf>`__
+  (page 10).
+
+
+.. _tem3200-converting:
+Converting units
+-----------------
+
+The TE-M3200 pressure sensor is not calibrated to units, you have to convert the measurement to units yourself.
+
+Estimated
+*********
+
+On page 6 of the `datasheet <https://www.te.com/commerce/DocumentDelivery/DDEController?Action=showdoc&DocId=Data+Sheet%7FM3200%7FA20%7Fpdf%7FEnglish%7FENG_DS_M3200_A20.pdf>`__
+the value ``1000`` maps to approximately ``0%`` of the maximum value of the sensor (e.g. ``0``  psi for a ``100`` psi sensor);
+the value ``8000`` maps to approximately ``50%`` of the maximum value of the sensor (e.g. ``50`` psi for a ``100`` psi sensor);
+the value ``15000`` maps to approximately ``100%`` of the maximum value of the sensor (e.g. ``100``  psi for the ``100`` psi sensor).
+Use ``calibrate_linear`` filter to map these sensor values:
+
+.. code-block:: yaml
+
+    # Extract of configuration
+    filters:
+      - calibrate_linear:
+        - 1000 -> 0.0
+        - 8000 -> 50.0
+        - 15000 -> 100.0
+
+Calibrated
+**********
+1. Expose the sensor to a low known pressure, for example ``5`` psi.
+2. Observe the value of the raw pressure sensor, for example ``990``.
+3. Expose the sensor to a high pressure, for example ``90`` psi.
+4. Observe the value of the raw pressure sensor, for example ``13550``.
+5. Use ``calibrate_linear`` filter to map the incoming value to the calibrated one:
+
+.. code-block:: yaml
+
+    # Extract of configuration
+    filters:
+      - calibrate_linear:
+        - 990 -> 5.0
+        - 13550 -> 90.0
+
+
+See Also
+--------
+
+- :ref:`sensor-filters`
+- `TE-M3200 Product Page <https://www.te.com/en/product-CAT-PTT0068.html>`__
+- `TE-M3200 Datasheet <https://www.te.com/commerce/DocumentDelivery/DDEController?Action=showdoc&DocId=Data+Sheet%7FM3200%7FA20%7Fpdf%7FEnglish%7FENG_DS_M3200_A20.pdf>`__
+- :ghedit:`Edit`

index.rst

@@ -432,6 +432,7 @@ Environmental
     SMT100, components/sensor/smt100, smt100.jpg, Moisture & Temperature
     STS3X, components/sensor/sts3x, sts3x.jpg, Temperature
     TEE501, components/sensor/tee501, TEE501.png, Temperature
+    TE-M3200, components/sensor/tem3200, tem3200.jpg, Temperature & Pressure
     TMP102, components/sensor/tmp102, tmp102.jpg, Temperature
     TMP1075, components/sensor/tmp1075, tmp1075.jpg, Temperature
     TMP117, components/sensor/tmp117, tmp117.jpg, Temperature