8000 New Entity Proposal: Boiler · Issue #59 · home-assistant/architecture · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

New Entity Proposal: Boiler #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send 8000 you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
zxdavb opened this issue Aug 16, 2018 · 20 comments
Closed

New Entity Proposal: Boiler #59

zxdavb opened this issue Aug 16, 2018 · 20 comments

Comments

@zxdavb
Copy link
zxdavb commented Aug 16, 2018 •
edited
Loading

I am in the process of adding a new CH/HW (central heating / hot water) component. I see that there is no boiler class & @balloob has previously suggested one. With thanks to ideas in another issue herein, I suggest the following as a starting point for discussion...

In my mind, a boiler can be heated by various sources (an electrical element(s), or from (say) a combi/district boiler, via a coil).

A cylinder is a container for HW, filled with (either) cold water, which is heated used one of the two previous methods, or filled with hot water from (say) a combi/district boiler. Cylinders may have an internal 'cylinder stat' which will stop the boilers from exceeding some maximum temperature - this may not be part of the boiler.

icon = "mdi:thermometer-lines"
supported_features = SUPPORT_OPERATION_MODE | SUPPORT_ON_OFF | support_temperature | support_target_temp
state: [
  STATE_OFF,  # boiler not active (not using energy), current temp is irrelevant
  STATE_ON,  # boiler will act to attain/maintain target temp
]

state_attributes: [
  'operation_mode': [manual, schedule, etc]
  'current_temperature', # reported by a temperature sensor
  'target_temperature', # the temperature to reach...
  'temperature_unit',  # TEMP_CELSIUS, or the other one...
  'min_temperature',  # lowest possible target temp
  'max_temperature',  # maximum possible target temp
  'precision',  #  1, 0.5 or 0.1 (PRECISION_WHOLE, HALVES, TENTHS)
]

Services: [  # some devices allow setting these parameters ahead of time
  'set_operation_mode':  { 'service_data': ['operation_mode'] }
  'set_temperature': { 'service_data': ['target_temperature'] }
  'turn_off',
  'turn_on': {}
]
@zxdavb
Copy link
Author
zxdavb commented Aug 16, 2018 •
edited
Loading

[ I will try to keep this comment up to date ]

Current consensus (such as it is) seems to include:

Name
Suggestions include water_heater and boiler.

Description
Stored potable water heated by a system, +/- backup systems. For example main system is district boiler, or solar panels, backup system is electrical immersion heaters.

State
At a minimum, two possible states: STATE_OFF, STATE_ON and, optionally: STATE_HEATING. Some systems will report Off/On only, other may do Off/On (but idle)/Heating.

STATE_OFF means off (current_temp will have no effect on its behaviour), and otherwise it is on/heating (the boiler will do something if current_temp drops below target_temp).

Of course, we still have STATE_UNKNOWN for error states, etc.

Temperatures
Obviously, the stored water will have a current_temperature, and and target_temperature. In the case of a heat exchanger coil, the HW in that coil will also have its own temperature (supply_temperature?).

@elupus
Copy link
elupus commented Sep 3, 2018

Curius how this turns out. I'm author of a nibe heat pump custom component. At the moment I'm pretty much spraying sensor entities, but that is quite messy.

@zxdavb
Copy link
Author
zxdavb commented Sep 4, 2018 •
edited
Loading

@elupus Yeah, me too - I'm waiting for others to contribute!

I was thinking about state. The boiler could be STATE_OFF (not doing anything to raise current_temp to target_temp), or STATE_ON (reading current_temp, and if below that, doing something to raise it to target_temp).

If the boiler is STATE_ON, should we have the option of saying it is STATE_ON_AND_HEATING (or just STATE_ACTIVE/STATE_HEATING), and STATE_ON_BUT_IDLE (or just STATE_IDLE)?

My preference is for just three states: STATE_OFF, STATE_ON, and STATE_HEATING (or STATE_ACTIVE). STATE_OFF means off, and otherwise it is on (and some boilers will be able to says if actively heating).

Of course, we still need STATE_UNKNOWN for error states, etc.

@tsvi
Copy link
tsvi commented Sep 4, 2018 via email

@zxdavb
Copy link
Author
zxdavb commented Sep 4, 2018 •
edited
Loading

I agree - OFF & ON, or OFF, IDLE & ACTIVE it is!

@dgomes
Copy link
dgomes commented Sep 5, 2018

I think boiler is not generic enough.

E.g. I have solar panels for water heating, with state and information much similar to the boiler use-case.

HVAC is too generic (it includes more things besides hot water), but DHW (Domestic Hot Water) is the general term used by manufactures.

@zxdavb
Copy link
Author
zxdavb commented Sep 5, 2018 •
edited
Loading

Do we agree the basic use-case is for stored water to be heated by some system? That would include all 3 means mentioned thus far: 1) electrical element (from mains, PV cells), 2) HW coil (system boiler, district HW, solar panels), and 3) gas-fired.

When you say "boiler is not generic enough", do you mean the name of the entity class? I think DHW doesn't offer enough advantage as a name, e.g. the HW may not be domestic (although we caould ignore that point, I think) - 'domestic-hot-water', or 'domestic-hw'?.

The term 'boiler' is short & sweet: most people would understand 'boiler', even though the water never boils (I understand 50-60C is about right, with 61-62C used to kill any resident pseudomonas bugs).

I am from the UK, and I think the term here would be 'cylinder', since most people have a (tankless) combi boiler, which produces HW on demand.

In the US, I think 'boiler' is the term, and I happen to know that some in some countries it's called a 'geyser'.

@elupus
Copy link
elupus commented Sep 5, 2018

Do you include hot water used for floor heating and radiators in that definition?

@zxdavb
Copy link
Author
zxdavb commented Sep 5, 2018 •
edited
Loading

No, I wouldn't - that will come under climate - even if the HW for the radiators, and the HW for the heat exchanger in the boiler are coming from the same source!

I am making an assumption here - I am limiting my thoughts to stored hot water / DHW. I feel it would open a can of worms to include thing like a combi boiler (a tankless supply of HW), or a system boiler (which supplies HW for a heat exchanger coil in a cylinder).

I have a fancy system boiler that can supply info like: is the fan running (%), the water pressure in the CH circuit, what mode it is in (e.g. igniting, running on), etc. Maybe these things could be device_state_attributes?

So, for @dgomes , any specifics of the solar panels themselves may not be within the realms of this proposed entity, although I think it would be reasonable to track: state (as above), mode, and supply_temp.

@dgomes
Copy link
dgomes commented Sep 5, 2018 •
edited
Loading

My 'cylinder' is heated by my solar panels and by a Heat Pump as a backup (when the desired temperature is not reach due to lack of sun).

DHW is more encompassing, or just hot-water and therefore include other systems such as central heating.

My solar panels just provides states (ON/OFF - circulation pump that transfers heat from the panels to the cylinder) and temperatures (panel temperature + cylinder temperature).

I think temperatures + status should cover most use cases and have leave other aspects to specific components.

@zxdavb
Copy link
Author
zxdavb commented Sep 5, 2018 •
edited
Loading

@dgomes I guess the question is: is this component the source of heat for the cylinder, or is it the cylinder itself? My preference is the latter, because a cylinder can have multiple sources of heat (mine has a backup electrical heater).

I think hot-water is not quite right - stored-hot-water would be better, or stored-dhw? I'd still vote for boiler, tho'. If we can't agree on this, no bother - let's kick it into the grass for now, and until others can view their opinion on it.

Similar to yours, my main heat source (a system boiler that provides HW to the heat exchanger in the cylinder) can track delivered_temp, and return_temp (the difference mostly being transferred to the HW in the cylinder).

We could add heat_source (main_heat_source, backup_heat_source, current_heat_source) as a state_attribute? And something like cutout_temp (the temp beyond which the cylinder will send a signal back to the heat source saying to stop)?

@dgomes
Copy link
dgomes commented Sep 5, 2018 •
edited
Loading

I think it would be most useful to have the combined system, even if not every system can provide all the information.

I'm think along the lines of the weather platform.

Let's agree on stuff:

State:

  • HEATING: heat is being transferred to the system (MANDATORY)
  • IDLE: no heat is being transferred but the system controller is live (MANDATORY)
  • OFF: no heat is being transferred and the system controller if off

Attributes:

  • current_temp: reservoir temperature (MANDATORY)
  • delivered_temp: temperature supplied to the reservoir
  • return_temp: temperature at the exit of the reservoir

@awarecan
Copy link
awarecan commented Sep 5, 2018

"Water Heater" seems more common term used in US, if you don't include "floor heating and radiators in that definition"

More precisely, water heater and boiler are regulated by different code, Uniform Plumbing Code vs Uniform Mechanical Code.

A water-heating device that exceeds any one of the following should be classified as a water boiler:

  • 120 gallons (454.2 liters) nominal water storage capacity;
  • 160 psi (1103.2 kPa) operating pressure;
  • 210 degrees Fahrenheit (99 degrees Celsius) operating temperature; or
  • 200,000 Btu/hr. (58,620 kW) heat input.

Reference: When does a water heater become a boiler?

@zxdavb
Copy link
Author
zxdavb commented Sep 5, 2018 •
edited
Loading

Agreed - I think include target_temp (when it will switch from STATE_HEATING to STATE_IDLE)?

And OK to have STATE_ON for those systems that cannot report if STATE_HEATING vs STATE_IDLE? My experience is most boilers will tell you if they're on or off, but many wont tell you if they're on/heating, or on/idle.

@zxdavb
Copy link
Author
zxdavb commented Sep 5, 2018 •
edited
Loading

FWIW: My 300L cylinder has two safety systems - one is configurable, the other is a hard wired absolute upper limit of: 90C (194F) and 10bar (1000kPa), its usual maximum is 85C/8bar, but usually 55-65C and 3.5bar.

It has 6kW via electrical immersion heaters (takes ~3h to heat up from room temp), and approx 1/3x that via the coil.

So it's a water heater, then!

@dgomes
Copy link
dgomes commented Sep 5, 2018 •
edited
Loading

Mine would also be a water-heater ;)

water-heater

If you can't report HEATING you just stick to ON/OFF

@zxdavb
Copy link
Author
zxdavb commented Sep 6, 2018 •
edited
Loading

OK, lets go with Off/On/Heating - I've updated post 2. Keep an eye on it, and let me know if I'm going off track.

@zxdavb
Copy link
Author
zxdavb commented Sep 6, 2018

Do we want to track the supply type?
SUPPLY_SYSTEM_BOILER, SUPPLY_DISTRICT_BOILER, SUPPLY_SOLAR_PANELS, SUPPLY_IMMERSION_HEATER,
or
SUPPLY_PRIMARY, SUPPLY_BACKUP?

@dgomes
Copy link
dgomes commented Sep 6, 2018

we should use device_class as in other platforms :)

@fabaff fabaff mentioned this issue Sep 26, 2018
Closed
@awarecan awarecan mentioned this issue Oct 2, 2018
Merged
8 tasks
@balloob
Copy link
Member
balloob commented Nov 1, 2018

water heater has been added as a component

@balloob balloob closed this as completed Nov 1, 2018
@elupus elupus mentioned this issue Dec 7, 2018
Closed
4 tasks
@zxdavb zxdavb mentioned this issue Dec 11, 2018
Closed
@dgomes dgomes mentioned this issue Feb 10, 2021
Closed
21 tasks
@karwosts karwosts mentioned this issue Jan 10, 2023
Closed
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
6 participants
@dgomes @elupus @tsvi @balloob @zxdavb @awarecan
0