From 52e7be2e9765b28e63a434bb9e76456ade2516dd Mon Sep 17 00:00:00 2001
From: Valentin Ochs <Cat-Ion@users.noreply.github.com>
Date: Wed, 18 Jan 2023 01:42:36 +0100
Subject: [PATCH] Documentation for `sigma_delta_output` component (#2500)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: H. Árkosi Róbert <robreg@zsurob.hu>
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
---
 .../output/images/sigma-delta-example.png     | Bin 0 -> 15418 bytes
 components/output/sigma_delta.rst             |  81 ++++++++++++++++++
 components/output/slow_pwm.rst                |   9 ++
 images/sigma-delta.svg                        |  50 +++++++++++
 index.rst                                     |   1 +
 5 files changed, 141 insertions(+)
 create mode 100644 components/output/images/sigma-delta-example.png
 create mode 100644 components/output/sigma_delta.rst
 create mode 100644 images/sigma-delta.svg

diff --git a/components/output/images/sigma-delta-example.png b/components/output/images/sigma-delta-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..c4cebdc2808834f6179ac3523e797cdc89aa9831
GIT binary patch
literal 15418
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

literal 0
HcmV?d00001

diff --git a/components/output/sigma_delta.rst b/components/output/sigma_delta.rst
new file mode 100644
index 000000000..f8938c314
--- /dev/null
+++ b/components/output/sigma_delta.rst
@@ -0,0 +1,81 @@
+Sigma-Delta Output
+==================
+
+This integration uses `sigma-delta modulation <https://en.wikipedia.org/wiki/Delta-sigma_modulation>`__
+to output a floating-point value on a binary output. Unlike with :doc:`/components/output/slow_pwm`,
+it is possible to update the output value with each update cycle, not just at the end of a longer period.
+
+.. figure:: images/sigma-delta-example.png
+    :align: center
+    :width: 65.0%
+
+    Comparison between a *Slow PWM* with a period of 100s and a *sigma-delta output* with an update interval of 1s
+
+For example, if you choose to toggle the output at most once every 1 second and decide on a
+PWM period of 10 seconds, for reasonably frequent updates, with :doc:`/components/output/slow_pwm`
+there are only 10 possible levels, and for higher precision a longer update interval is needed,
+restricting the update rate. 
+
+A *sigma-delta* output is updated during each cycle, thus a higher precision can be achieved, without
+being constrained by a calculation timeframe (=period).
+
+So instead of having to define a ``period`` where the width of the pulse determines the output level, here you
+choose an ``update_interval`` which acts like a clock signal from where the pulse density determines the output level. 
+
+This component can be used as a drop-in replacement for :doc:`/components/output/slow_pwm` by changing the ``platform`` to
+``sigma_delta_output`` and changing ``period`` to ``update_interval`` (you usually want to set the *sigma-delta*'s
+``update_interval`` as a fraction of *Slow PWM*'s ``period`` for similar results)
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    output:
+      - platform: sigma_delta_output
+        update_interval: 10s
+        id: sd_heater_output
+
+        # Output to a pin
+        pin: 15
+
+        # Use the same output, but through automations
+        turn_on_action:
+          then:
+            - output.turn_on: heater_relay
+        turn_off_action:
+          then:
+            - output.turn_off: heater_relay
+    
+      - platform: gpio
+        pin: 15
+        id: heater_relay
+
+Configuration variables:
+
+- **update_interval** (**Required**, :ref:`Time <config-time>`): The cycle interval at which the output is recalculated.
+- **pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The pin to pulse.
+- **state_change_action** (*Optional*, :ref:`Automation <automation>`): An automation to perform when the load is switched. If a lambda is used the boolean ``state`` parameter holds the new status.
+- **turn_on_action** (*Optional*, :ref:`Automation <automation>`): An automation to perform when the load is turned on. Can be used to control for example a switch or output component.
+- **turn_off_action** (*Optional*, :ref:`Automation <automation>`): An automation to perform when the load is turned off. ``turn_on_action`` and ``turn_off_action`` must be configured together.
+- All options from :ref:`Output <config-output>`.
+
+.. note::
+
+    - If ``pin`` is defined, the GPIO pin state is writen before any action is executed.
+    - ``state_change_action`` and ``turn_on_action``/``turn_off_action`` can be used togther. ``state_change_action`` is called before ``turn_on_action``/``turn_off_action``. It's recommended to use either ``state_change_action`` or ``turn_on_action``/``turn_off_action`` to change the state of an output. Using both automations together is only recommended for monitoring.
+
+
+.. note::
+
+    If the output must not be active for more than some fixed time before it has
+    to be off for a while to e.g. cool down, :doc:`/components/output/slow_pwm`
+    should be used with a ``max_power`` setting to better control the duty
+    cycle.
+
+See Also
+--------
+
+- :doc:`/components/output/index`
+- `Sigma-Delta <https://en.wikipedia.org/wiki/Delta-sigma_modulation>`__
+- :doc:`/components/output/slow_pwm`
+- :apiref:`sigma_delta_output/sigma_delta_output.h`
+- :ghedit:`Edit`
diff --git a/components/output/slow_pwm.rst b/components/output/slow_pwm.rst
index 6f3ec6f83..9c129f4d9 100644
--- a/components/output/slow_pwm.rst
+++ b/components/output/slow_pwm.rst
@@ -67,12 +67,21 @@ Example:
           - output.turn_off: output1
 
 
+.. note::
+
+    If the duty cycle is not constrained to a maximum value, the
+    :doc:`/components/output/sigma_delta` component offers faster updates and
+    greater control over the switching frequency. This is better for loads that
+    need some time to fully change between on and off, like eletric thermal
+    actuator heads or fans.
+
 See Also
 --------
 
 - :doc:`/components/output/index`
 - :doc:`/components/output/esp8266_pwm`
 - :doc:`/components/output/ledc`
+- :doc:`/components/output/sigma_delta`
 - :doc:`/components/light/monochromatic`
 - :doc:`/components/fan/speed`
 - :doc:`/components/power_supply`
diff --git a/images/sigma-delta.svg b/images/sigma-delta.svg
new file mode 100644
index 000000000..56a417c2f
--- /dev/null
+++ b/images/sigma-delta.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   width="24"
+   height="24"
+   version="1.1"
+   id="svg4"
+   sodipodi:docname="sigma-delta.svg"
+   inkscape:version="1.2.1 (9c6d41e410, 2022-07-14)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs8" />
+  <sodipodi:namedview
+     id="namedview6"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     showgrid="false"
+     inkscape:zoom="56.791667"
+     inkscape:cx="11.920763"
+     inkscape:cy="12.026412"
+     inkscape:window-width="3836"
+     inkscape:window-height="2109"
+     inkscape:window-x="0"
+     inkscape:window-y="47"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="svg4" />
+  <g
+     id="g401"
+     transform="translate(-1.4174133)">
+    <path
+       d="m 3.1866865,6.2376005 h 9.3638995 v 3.6014996 h -0.7203 l -0.7203,-2.1608998 H 6.8314041 l 2.5858764,3.6951387 -2.9604324,4.22816 h 4.6531379 l 0.7203,-1.4406 h 0.7203 v 3.6015 H 3.1866865 L 7.220366,12 Z"
+       id="path2"
+       style="stroke-width:0.7203" />
+    <g
+       aria-label="Δ"
+       id="text946"
+       style="font-size:16.7517px;line-height:1.25;text-align:end;letter-spacing:0px;word-spacing:0px;text-anchor:end;stroke-width:1.57047">
+      <path
+         d="m 17.701614,6.2375126 h 1.77496 L 23.64814,16.60917 v 1.153316 H 13.464612 l 0.0082,-1.153316 z M 22.012232,16.486477 19.247547,9.435713 Q 19.002161,8.830427 18.789493,8.1760637 18.585004,7.5135209 18.568645,7.4153665 l -0.07362,0.2617453 q -0.253565,0.907929 -0.605286,1.7749603 l -2.772864,7.0344049 z"
+         id="path395" />
+    </g>
+  </g>
+</svg>
diff --git a/index.rst b/index.rst
index a12ee82e0..a8a2ecf8d 100644
--- a/index.rst
+++ b/index.rst
@@ -447,6 +447,7 @@ Output Components
     BLE Binary Output, components/output/ble_client, bluetooth.svg
     Modbus Output, components/output/modbus_controller, modbus.png
     Custom Output, components/output/custom, language-cpp.svg
+    Sigma-Delta Output, components/output/sigma_delta, sigma-delta.svg
     Template Output, components/output/template, description.svg
     BP1658CJ, components/output/bp1658cj, bp1658cj.svg
     BP5758D, components/output/bp5758d, bp5758d.svg