mirror of
https://github.com/letscontrolit/ESPEasy.git
synced 2026-09-12 09:36:59 +00:00
112 lines
3.4 KiB
ReStructuredText
112 lines
3.4 KiB
ReStructuredText
.. include:: ../Plugin/_plugin_substitutions_p07x.repl
|
|
.. _P077_page:
|
|
|
|
|P077_typename|
|
|
==================================================
|
|
|
|
|P077_shortinfo|
|
|
|
|
Plugin details
|
|
--------------
|
|
|
|
Type: |P077_type|
|
|
|
|
Name: |P077_name|
|
|
|
|
Status: |P077_status|
|
|
|
|
GitHub: |P077_github|_
|
|
|
|
Maintainer: |P077_maintainer|
|
|
|
|
Used libraries: |P077_usedlibraries|
|
|
|
|
.. warning::
|
|
This device is intended to be connected to mains power (110V/220V).
|
|
Safety is of utmost importance, so the unit should not be connected to a computer if it also connected to the mains power, and it should be sufficiently isolated to prevent touching parts that can be connected to mains power!
|
|
|
|
See :ref:`safety_page`
|
|
|
|
Supported hardware
|
|
------------------
|
|
|
|
|P077_usedby|
|
|
|
|
:ref:`P077pow3xx_page`
|
|
|
|
Introduction
|
|
------------
|
|
|
|
To measure the power used by an electric device, the Sonoff POW units, running either on an ESP8266 or ESP32, can be used. The installed power-sensor is the CSE7766, that makes the measured data available via a serial output at 4800 baud.
|
|
|
|
This plugin can read the measured data, and apply a correction value to show calibrated values for Voltage, Power and Current, and it will also make available a pulse count.
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
.. image:: P077_DeviceConfiguration.png
|
|
|
|
* **Name** A unique name should be entered here.
|
|
|
|
* **Enabled** The device can be disabled or enabled. When not enabled the device should not use any resources.
|
|
|
|
Sensor
|
|
^^^^^^
|
|
|
|
See: :ref:`SerialHelper_page`
|
|
|
|
Device Settings
|
|
^^^^^^^^^^^^^^^
|
|
|
|
* **U Ref**: The calibration value for the Voltage measurement. When set to 0, a default value of ``1950`` will be used, see Calibration, below.
|
|
|
|
* **I Ref**: The calibration value for the Current measurement. When set to 0, a default value of ``3500`` will be used, see Calibration, below.
|
|
|
|
* **P Ref**: The calibration value for the Power measurement. When set to 0, a default value of ``12530`` will be used, see Calibration, below.
|
|
|
|
.. include:: DataAcquisition.repl
|
|
|
|
* **Interval** By default, Interval will be set to 0 sec. as this is optional for this plugin.
|
|
|
|
Values
|
|
^^^^^^
|
|
|
|
The measured values are available in ``Voltage``, ``Power``, ``Current`` and ``Pulses``. A formula can be set to recalculate. The number of decimals is by default set to 2, and can be set to 0 for ``Pulses``, as no decimals are provided from the measurement. When enabling the Stats checkbox for a value, statistics will be gathered and a graph of the last 16 (ESP8266) or 64 (ESP32) measurements will be shown.
|
|
|
|
Calibration
|
|
-----------
|
|
|
|
Easiest way to calibrate the plugin is to connect a known (resistive) load to the unit, measure the actual voltage, calculate the current from the power and voltage (``current = power/voltage``) and use the ``csecalibrate,<voltage>,<current>,<power>`` command (the Command input on the Tools page in the web UI will doen fine for that) to set the calibration values.
|
|
|
|
Commands available
|
|
------------------
|
|
|
|
.. include:: P077_commands.repl
|
|
|
|
.. Events
|
|
.. ~~~~~~
|
|
|
|
.. .. include:: P077_events.repl
|
|
|
|
Change log
|
|
----------
|
|
|
|
.. versionchanged:: 2.0
|
|
...
|
|
|
|
|changed| 2023-02-11 Use ESPEasySerial to allow more flexible Serial/GPIO configuration and support new Sonoff POW models (ESP32)
|
|
|
|
|added|
|
|
Major overhaul for 2.0 release.
|
|
|
|
.. versionadded:: 1.0
|
|
...
|
|
|
|
|added|
|
|
Initial release version.
|
|
|
|
|
|
|
|
|
|
|