Add ability to lock to set mode

[ysmilda]

What does this implement/fix?

It allows locking the read out of the HLW8012 component to a single mode (e.g current or voltage). This is useful when you're not interested in one of the two values and want to continuously read back the other.

This allows the change_mode_every parameter to be set to "never" which locks the mode to the set initial_mode.

Types of changes

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Other

Pull request in esphome-docs with documentation (if applicable): esphome/esphome-docs#3473

Test Environment

• ESP32
• ESP32 IDF
• ESP8266
• RP2040
• BK72xx
• RTL87xx

Example entry for config.yaml:

With the below config the mode will be locked to VOLTAGE.

# Example config.yaml
  - platform: hlw8012
    change_mode_every: "never"
    initial_mode: VOLTAGE

Checklist:

• The code change is tested and works locally.
• Tests have been added to verify that the new code works (under tests/ folder).

If user exposed functionality or configuration variables are added/changed:

• Documentation added/updated in esphome-docs.

[jesserockz]

This would be better to change change_every to allow never similar to update_intervals do

[ysmilda]

I like that proposal, but I'm not sure how to implement that. The update_intervals take a time string, this is than checked to be never or parsed to an uint32_t in milliseconds. The change_every already takes an uint32_t and changing that to a string would break everyone's config.

Ideally change_every would take either a string or an int but I'm unsure how that could be implemented.

[jesserockz]

You can use something like cv.Any(..., "never") to allow the current time and the hardcoded string never. And then convert never into 0 and check for 0 in the cpp code since the minimum is currently 1

[ysmilda]

Thanks for the insight, I've changed change_every to accept "never" and that locks the mode to the one set in initial_mode.

[kroimon]

LGTM