docs for Tuya fan, update tuya light (#502)

components/fan/tuya.rst

@@ -0,0 +1,98 @@
+Tuya Fan
+========
+
+.. seo::
+    :description: Instructions for setting up a Tuya ceiling fan switch.
+    :image: fan.svg
+
+The ``tuya`` fan platform creates a variable speed fan from a
+tuya serial component.
+
+.. figure:: images/tuyafan.jpg
+    :align: center
+    :width: 40%
+
+    A Tuya based fan controller wall plate.
+
+There are two components, the Tuya bus and the fan that uses it.  The ``tuya``
+component requires a :ref:`UART bus <uart>` to be configured.  Put the ``tuya`` component in
+the config and it will list the possible devices for you in the config log.
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    # Make sure your wifi will connect
+    wifi:
+      ssid: "ssid"
+      password: "password"
+
+    # Make sure logging is not using the serial port
+    logger:
+      baud_rate: 0
+
+    # Enable Home Assistant API
+    api:
+
+    # Make sure you can upload new firmware OTA
+    ota:
+
+    uart:
+      rx_pin: GPIO3
+      tx_pin: GPIO1
+      baud_rate: 9600
+
+    # Register the Tuya MCU connection
+    tuya:
+
+Here is an example output for a Tuya fan controller:
+
+.. code-block:: text
+
+    [12:39:45][C][tuya:023]: Tuya:
+    [12:39:45][C][tuya:032]:   Datapoint 1: switch (value: ON)
+    [12:39:45][C][tuya:036]:   Datapoint 3: enum (value: 1)
+    [12:39:45][C][tuya:036]:   Datapoint 6: enum (value: 0)
+    [12:39:45][C][tuya:034]:   Datapoint 7: int value (value: 0)
+    [12:39:45][C][tuya:032]:   Datapoint 9: switch (value: OFF)
+    [12:39:45][C][tuya:046]:   Product: '{"p":"hqq73kftvzh8c92u","v":"1.0.0","m":0}'
+
+On this controller, the data points are:
+
+- 1 represents the fan on/off state.
+- 3 represents the speed setting.
+- 9 represents the additional light switch. (use the :doc:`/components/light/tuya` component to control this)
+- 6 & 7 are unknown and don't seem to affect the state.
+
+Based on this, you can create the fan as follows:
+
+.. code-block:: yaml
+
+    # Create a fan
+    fan:
+      - platform: "tuya"
+        name: "MyFan"
+        switch_datapoint: 1
+        speed_datapoint: 3
+
+Configuration variables:
+------------------------
+
+- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
+- **name** (**Required**, string): The name of the fan.
+- **speed_datapoint** (**Required**, int): The datapoint id number of the fan speed.
+- **switch_datapoint** (**Required**, int): The datapoint id number of the fan switch.
+- **oscillation_datapoint** (**Optional**, int): The datapoint id number of the oscillation
+  switch. Probably not supported on any Tuya controllers currently, but it's there if need be.
+- All other options from :ref:`Fan <config-fan>`.
+
+.. note::
+
+    The MCU on the Tuya dimmer handles the LEDs and they dont seem to be controllable
+    over the serial bus.
+
+See Also
+--------
+
+- :doc:`/components/fan/index`
+- :apiref:`tuya/fan/tuya_fan.h`
+- :ghedit:`Edit`

components/light/tuya.rst

@@ -72,7 +72,7 @@ Configuration variables:
 
 - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
 - **name** (**Required**, string): The name of the light.
-- **dimmer_datapoint** (**Required**, int): The datapoint id number of the dimmer value.
+- **dimmer_datapoint** (*Optional*, int): The datapoint id number of the dimmer value.
 - **switch_datapoint** (*Optional*, int): The datapoint id number of the power switch.  My dimmer
   required this to be able to turn the light on and off.  Without this you would only be able to
   change the brightness and would have to toggle the light using the physical buttons.
@@ -81,6 +81,7 @@ Configuration variables:
 - **max_value** (*Optional*, int, default 255): The highest dimmer value allowed.  My dimmer had a
   maximum of 255 which seems like it would be the typical value.
 - All other options from :ref:`Light <config-light>`.
+- At least one of *dimmer_datapoint* or *switch_datapoint* must be provided.
 
 .. note::
 

index.rst

@@ -249,6 +249,7 @@ Fan Components
     Fan Core, components/fan/index, folder-open.svg
     Binary Fan, components/fan/binary, fan.svg
     Speed Fan, components/fan/speed, fan.svg
+    Tuya Fan, components/fan/tuya, fan.svg
 
 Display Components
 ------------------