From caf969865f3757cb96aee75a1b055ccc28d012e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Stenberg?= <bjorn@haxx.se>
Date: Sun, 24 Nov 2024 16:58:43 +0100
Subject: [PATCH] Add docs for MCP3201

---
 components/sensor/images/mcp3201.jpg | Bin 0 -> 7215 bytes
 components/sensor/mcp3201.rst        |  74 +++++++++++++++++++++++++++
 images/mcp3201.jpg                   | Bin 0 -> 7215 bytes
 3 files changed, 74 insertions(+)
 create mode 100644 components/sensor/images/mcp3201.jpg
 create mode 100644 components/sensor/mcp3201.rst
 create mode 100644 images/mcp3201.jpg

diff --git a/components/sensor/images/mcp3201.jpg b/components/sensor/images/mcp3201.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..bb9d74559d86b66e4e7c7c2223c98bd834be6aba
GIT binary patch
literal 7215
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
bL7R^_#vA|$_%f7J_y1~N{kvY_&+NYe<C;wq

literal 0
HcmV?d00001

diff --git a/components/sensor/mcp3201.rst b/components/sensor/mcp3201.rst
new file mode 100644
index 0000000000..3584b8285c
--- /dev/null
+++ b/components/sensor/mcp3201.rst
@@ -0,0 +1,74 @@
+MCP3201 12-Bit A/D Converter
+=======================================
+
+.. seo::
+    :description: Instructions for setting up the MCP3201 12-Bit Analog to Digital Converter in ESPHome.
+    :keywords: MCP3201
+    :image: mcp3201.jpg
+
+The Microchip Technology Inc. MCP3201 is a single-channel successive
+approximation 12-bit Analog-to-Digital (A/D) converter with on-board sample
+and hold circuitry.
+
+.. figure:: images/mcp3201.jpg
+    :align: center
+    :width: 50.0%
+
+.. _mcp3201-component:
+
+Component/Hub
+-------------
+
+The MCP3201 component allows you to use MCP3201 12-Bit A/D Converter
+(`datasheet <https://ww1.microchip.com/downloads/aemDocuments/documents/APID/ProductDocuments/DataSheets/21290F.pdf>`__) in ESPHome.
+The MCP3201 uses the :ref:`SPI Bus <spi>` for communication.
+
+It reports voltage in relation to the ``reference_voltage`` (default is 3.3V).
+It calculates the voltage by multiplying the ``reference_voltage * value`` on the pin (basically the percentage of VREF)
+
+Most configurations will set the ``reference_voltage`` = VREF pin
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    mcp3201:
+      cs_pin: GPIOXX
+      reference_voltage: 3.3V
+
+Configuration variables:
+************************
+
+- **cs_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The SPI cable select pin to use.
+- **reference_voltage** (*Optional*, float): The reference voltage. Defaults to ``3.3V``.
+
+
+Sensor
+------
+
+The ``mcp3201`` sensor allows you to use your MCP3201 12-Bit A/D Converter
+sensor with ESPHome.  First, configure the `mcp3210` component and then
+create a `sensor` using the `mcp3201` platform to report the voltage to
+Home Assistant.
+
+.. code-block:: yaml
+
+    # Example config
+    # This is a small 1.5v solar panel power rail attached to the MCP3201
+    sensor:
+      - platform: mcp3201
+        id: solar_voltage
+        update_interval: 30s
+
+
+Configuration variables:
+************************
+
+- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``.
+- All other options from :ref:`Sensor <config-sensor>`.
+
+See Also
+--------
+
+- :ref:`spi`
+- :apiref:`mcp3201/mcp3201.h`
+- :ghedit:`Edit`
diff --git a/images/mcp3201.jpg b/images/mcp3201.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..bb9d74559d86b66e4e7c7c2223c98bd834be6aba
GIT binary patch
literal 7215
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
bL7R^_#vA|$_%f7J_y1~N{kvY_&+NYe<C;wq

literal 0
HcmV?d00001