From 88f8b81e9f551cb027bd1eea2dcaede1403cee30 Mon Sep 17 00:00:00 2001 From: salleq Date: Tue, 16 Aug 2022 07:02:25 +0300 Subject: [PATCH 1/6] Update remote_transmitter.rst (#2228) --- components/remote_transmitter.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/remote_transmitter.rst b/components/remote_transmitter.rst index 87a2896d2..5e5978809 100644 --- a/components/remote_transmitter.rst +++ b/components/remote_transmitter.rst @@ -224,7 +224,7 @@ This :ref:`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 From 362aff8f9752a9703db965a45dacb2e0ef481708 Mon Sep 17 00:00:00 2001 From: Samuel Sieb Date: Mon, 15 Aug 2022 21:03:13 -0700 Subject: [PATCH 2/6] Fix pca9685 example (#2223) --- components/output/pca9685.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/components/output/pca9685.rst b/components/output/pca9685.rst index 20ae7408f..8c07a7df0 100644 --- a/components/output/pca9685.rst +++ b/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: From aa67443feca4a248d19508dad12f7f793f2a5c4d Mon Sep 17 00:00:00 2001 From: "@RubenKelevra" Date: Tue, 16 Aug 2022 06:03:38 +0200 Subject: [PATCH 3/6] diy: add tcs34725 ambient light sensor example (#2132) --- guides/diy.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/guides/diy.rst b/guides/diy.rst index 742d9a83e..005ac7b17 100644 --- a/guides/diy.rst +++ b/guides/diy.rst @@ -118,3 +118,4 @@ Sample Configurations - `ESPHome floor heating controller (proportional valves) `__ by :ghuser:`nliaudat` - `ESPHome Curtain/Cover/Shutter Switch from a noname Tuya switch `__ by :ghuser:`ludrao` - `ESPHome Free your Thomson Guardian gate controller `__ by :ghuser:`ludrao` +- `Ambient Light Sensor tcs34725 example `__ by :ghuser:`RubenKelevra` From 1216519178d126f64d13f3f8caad62df5bb9ea01 Mon Sep 17 00:00:00 2001 From: Daniel H Brown <58566661+brauhausdc@users.noreply.github.com> Date: Tue, 16 Aug 2022 00:05:34 -0400 Subject: [PATCH 4/6] =?UTF-8?q?Added=20=E2=80=9Cdevices=E2=80=9D=20example?= =?UTF-8?q?=20to=20docker-compose=20=20notes=20(#2220)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- guides/faq.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/guides/faq.rst b/guides/faq.rst index be015c94c..958162713 100644 --- a/guides/faq.rst +++ b/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:: From 4c907ac5932e0c98ae3432faaaa216eddc113aa0 Mon Sep 17 00:00:00 2001 From: Jon Little Date: Mon, 15 Aug 2022 23:08:09 -0500 Subject: [PATCH 5/6] Adding notes about mulit-phase applications. (#2151) --- components/sensor/atm90e32.rst | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/components/sensor/atm90e32.rst b/components/sensor/atm90e32.rst index 84ac5ede2..5d5f3524e 100644 --- a/components/sensor/atm90e32.rst +++ b/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 ------------------- From 3fb810b46ecd671a313932a8a04cbfd9e77dcd4a Mon Sep 17 00:00:00 2001 From: "@RubenKelevra" Date: Tue, 16 Aug 2022 06:08:16 +0200 Subject: [PATCH 6/6] tcs34725: Add overexposure quirk note (#2127) Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com> --- components/sensor/tcs34725.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/components/sensor/tcs34725.rst b/components/sensor/tcs34725.rst index 42dfa4af1..4def11916 100644 --- a/components/sensor/tcs34725.rst +++ b/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 ` 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%