Merge branch 'current' into beta

components/output/pca9685.rst

@@ -24,7 +24,8 @@ global ``pca9685`` hub and give it an id, and then define the
 
     # Example configuration entry
     pca9685:
-      frequency: 500
+      - id: pca9685_hub1
+        frequency: 500
 
     # Individual outputs
     output:

components/remote_transmitter.rst

@@ -224,7 +224,7 @@ This :ref:`action <config-action>` a Nexa RF remote code to a remote transmitter
 .. code-block:: yaml
 
     on_...:
-      - remote_transmitter.nexa:
+      - remote_transmitter.transmit_nexa:
           device: 0x38DDB4A
           state: 1
           group: 0

components/sensor/atm90e32.rst

@@ -138,7 +138,7 @@ Here are common current calibrations for the **Expandable 6 Channel Energy Meter
    - 20A/25mA SCT-006: 11131
    - 30A/1V SCT-013-030: 8650
    - 50A/1V SCT-013-050: 15420
-   - 80A/26.6mA SCT-010: 41996
+   - 80A/26.6mA SCT-010: 41996 (note this will saturate at 2^16/10^3 amps)
    - 100A/50ma SCT-013-000: 27961
    - 120A/40mA: SCT-016: 41880
 
@@ -172,6 +172,28 @@ a time-series-database, e.g. InfluxDB.
             id: ct1RAWattHours
             state_topic: ${disp_name}/ct1/reverse_active_energy
 
+If the power, power_factor, reactive_power, forward_active_energy, or reverse_active_energy configuraion variables
+are used, care must be taken to ensure that the line ATM90E32's voltage is from is the same phase as the current
+transformer is installed on.  This is significant in split-phase or multi phase installations.  On a house with 240
+split-phase wiring (very common in the US), one simple test is to reverse the orentation of the current transformer
+on a line. If the power factor doesn't change sign, it is likely that the voltage fed to the ATM90E32 is from the other
+phase.
+
+The CircuitSetup Expandable 6 channel board can easilly handle this situation by cutting the jumpers JP12/13 to
+allow a seperate VA2 to be input on the J3 pads. Make sure that current taps connected to CT 1-3 are on the phase
+from which VA is fed (the barrel jack) and the taps connected to CT3-6 are on the phase from which VA2 is fed. See
+the CicuitSetup repo for more details on this.
+
+If a mulit board stack is being used, remember to cut JP12/13 on all boards and to feed VA2 to each board. VA is
+fed to all boards through the stacking headers. Another detail is that each voltage transformer needs to have the
+same polarity; getting this backwards will be just like having it on the wrong phase.
+
+Note that the current measurement is the RMS value so is always positive. They only way to determine directon is to
+look at the power factor. If there are only largly resistive loads and no power sources, (PF almost 1), it is simpler
+to just create a template sensor that computes power from Irms*Vrms and ignore all these details. On the other
+hand, one might be surprised how reactive some loads are and the CirciuitSetup designs are able to 
+handle these situations well.
+
 
 Additional Examples
 -------------------

components/sensor/tcs34725.rst

@@ -11,6 +11,12 @@ The ``tcs34725`` sensor platform allows you to use your TCS34725 RGB color senso
 `Adafruit`_), color temperature and illuminance sensors with ESPHome. The :ref:`I²C <i2c>` is
 required to be set up in your configuration for this sensor to work.
 
+Note: If the `integration_time` is set too long for the light conditions, the sensor will overexpose.
+In this case the sensor may not show 100% on its clear channel. With an `integration_time` of `614ms`
+and a `gain` of `1x` the sensor will max out at around 4100 lx. In this case the individual color
+channels will show `100%`, the clear channel `25%`. The illumination in lux is shown as `0` as well
+as the color temperature in kelvin will show `0`.
+
 .. figure:: images/tcs34725-full.jpg
     :align: center
     :width: 50.0%

guides/diy.rst

@@ -118,3 +118,4 @@ Sample Configurations
 - `ESPHome floor heating controller (proportional valves) <https://github.com/nliaudat/floor-heating-controller>`__ by :ghuser:`nliaudat`
 - `ESPHome Curtain/Cover/Shutter Switch from a noname Tuya switch <https://github.com/ludrao/esphome-shutterswitch>`__ by :ghuser:`ludrao`
 - `ESPHome Free your Thomson Guardian gate controller <https://github.com/ludrao/esphome-guardian>`__ by :ghuser:`ludrao`
+- `Ambient Light Sensor tcs34725 example <https://gist.github.com/RubenKelevra/0d70d6b4c8e4bc9aedc8682865731d65>`__ by :ghuser:`RubenKelevra`

guides/faq.rst

@@ -350,8 +350,13 @@ And a docker compose file looks like this:
           - ./:/config:rw
           # Use local time for logging timestamps
           - /etc/localtime:/etc/localtime:ro
+        devices:
+          # if needed, add esp device(s) as in command line examples above
+          - /dev/ttyUSB0:/dev/ttyUSB0
+          - /dev/ttyACM0:/dev/ttyACM0
         network_mode: host
         restart: always
+        
 
 .. _docker-reference-notes:
 .. note::