From 3bea218b3cb8e0ba28baef861bd7a27813fbbee0 Mon Sep 17 00:00:00 2001 From: Carlos Garcia Saura Date: Mon, 17 May 2021 17:05:55 +0200 Subject: [PATCH] Added warning: GPIOs are LIVE in power measurement devices (#583) --- components/sensor/ade7953.rst | 4 ++++ components/sensor/cse7766.rst | 4 ++++ components/sensor/hlw8012.rst | 4 ++++ devices/sonoff.rst | 4 ++++ 4 files changed, 16 insertions(+) diff --git a/components/sensor/ade7953.rst b/components/sensor/ade7953.rst index eec03f22e..ed0263862 100644 --- a/components/sensor/ade7953.rst +++ b/components/sensor/ade7953.rst @@ -19,6 +19,10 @@ with ESPHome. These are commonly found in **Shelly 2.5** devices. This sensor can measure voltage and has two channels for reading current and active power (A & B). +.. note:: + + SAFETY HAZARD: Some devices such as Sonoff POWs/Shelly/etc, have the digital GND connected directly to mains voltage so **the GPIOs become LIVE during normal operation**. Our advice is to mark these boards to prevent any use of the dangerous digital pins. + The :ref:`I²C Bus ` is required to be set up in your configuration for this sensor to work. diff --git a/components/sensor/cse7766.rst b/components/sensor/cse7766.rst index 287db2c8a..642ea7ca6 100644 --- a/components/sensor/cse7766.rst +++ b/components/sensor/cse7766.rst @@ -11,6 +11,10 @@ The ``cse7766`` sensor platform allows you to use your CSE7766 voltage/current a ESPHome. This sensor is commonly found in Sonoff POW R2. CSE7759B is similar to CSE7766 and works with this integration. +.. note:: + + SAFETY HAZARD: Some devices such as Sonoff POWs/Shelly/etc, have the digital GND connected directly to mains voltage so **the GPIOs become LIVE during normal operation**. Our advice is to mark these boards to prevent any use of the dangerous digital pins. + As the communication with the CSE7766 done using UART, you need to have an :ref:`UART bus ` in your configuration with the ``rx_pin`` connected to the CSE7766. Additionally, you need to set the baud rate to 4800. diff --git a/components/sensor/hlw8012.rst b/components/sensor/hlw8012.rst index f02f5c852..5773159cc 100644 --- a/components/sensor/hlw8012.rst +++ b/components/sensor/hlw8012.rst @@ -12,6 +12,10 @@ ESPHome. This sensor is commonly found in Sonoff POWs. CSE7759 and BL0937 are si and work with this integration. Beware that CSE7759B is different and should be used with the :doc:`CSE7766 ` integration. +.. note:: + + SAFETY HAZARD: Some devices such as Sonoff POWs/Shelly/etc, have the digital GND connected directly to mains voltage so **the GPIOs become LIVE during normal operation**. Our advice is to mark these boards to prevent any use of the dangerous digital pins. + This sensor has two data outputs which both encode values using the frequency of a modulated signal: CF and CF1. CF's frequency is proportional to the (active) power measured and CF1 is proportional to the current/voltage. Using the SEL pin, one can choose between which mode to use. diff --git a/devices/sonoff.rst b/devices/sonoff.rst index 36bc717e7..480bec526 100644 --- a/devices/sonoff.rst +++ b/devices/sonoff.rst @@ -24,6 +24,10 @@ After that use the following list of pin to function mappings to set up your Son This list has been compiled from the Sonoff Tasmota pin source file which can be found here: https://github.com/arendst/Tasmota/blob/development/tasmota/tasmota_template.h ❤️ +.. note:: + + SAFETY HAZARD: Some devices such as Sonoff POWs/Shelly/etc, have the digital GND connected directly to mains voltage so **the GPIOs become LIVE during normal operation**. Our advice is to mark these boards to prevent any use of the dangerous digital pins. + Sonoff RF ---------