Energy (AC) - HLW8012/BL0937¶

Power measuring sensor used to measure (AC) voltage, current, power and power factor.

Plugin details¶

Type: Energy (AC)

Name: HLW8012/BL0937

Status: TESTING

GitHub: P076_HLW8012.ino

Maintainer: TD-er

Used libraries: https://github.com/xoseperez/hlw8012/tree/1.1.1

Configuration¶

The easiest way to configure this plugin, is to select the right device from the Device list in the “Predefined Pin settings”. After saving the settings, all parameters will be set.

When enabling the device, it will load the default calibration values.

If some specific setting is needed to support some device not in the list, this Device selection must be set to Custom.

Supported hardware¶

Sonoff POW (r1), Huafan SS, KMC 70011, Aplic WDP303075, SK03 Outdoor, BlitzWolf SHP, Teckin, Teckin US, Gosund SP1 v23

Commands available¶

Command (GPIO/Value)	Extra information
`hlwcalibrate,<CalibVolt>,<CalibCurr>,<CalibAcPwr>` Examples: `hlwcalibrate,229` to set the current reported voltage to 229V AC `hlwcalibrate,0,0.1` To set the calibration to report 100 mA as actual current.	Will set the used calibration factors to some known current value. For example, if the device using this sensor is plugged into mains power, it may report 200 Volt AC, while it actually is 229V. So the value given to this command should then be `229`, since that’s what is supposed to be read. The last two parameters are optional, but their position determines what unit it represents. If the setting for current has to be updated, at least 2 parameters must be given of which the first must then be set to `0`.
`hlwreset`	Will reset the calibration values used in the sensor’s library.

Command (GPIO/Value)

Extra information

hlwcalibrate,<CalibVolt>,<CalibCurr>,<CalibAcPwr>

Examples:

hlwcalibrate,229 to set the current reported voltage to 229V AC

hlwcalibrate,0,0.1 To set the calibration to report 100 mA as actual current.

Will set the used calibration factors to some known current value. For example, if the device using this sensor is plugged into mains power, it may report 200 Volt AC, while it actually is 229V. So the value given to this command should then be 229, since that’s what is supposed to be read.

The last two parameters are optional, but their position determines what unit it represents. If the setting for current has to be updated, at least 2 parameters must be given of which the first must then be set to 0.

hlwreset

Will reset the calibration values used in the sensor’s library.

Change log¶

Changed in version 2.0: …

added 2019-01-06 Added pre-defined config selector for several devices this sensor is used in.