MicroNova based pellet stove¶
The MicroNova component allows you to integrate a pellet stove with a MicroNova board in ESPHome. It uses UART for communication.
The UART must be configured with a baud rate 1200, 8 data bits, 2 stop bits, no parity, no flow control.
MicroNova bords come in various flavours. This code is only tested on an ExtraFlame Ketty Evo 2.0 stove. The protocol is not documented but has been reverse engineerd by others. See the links below for all the info that helped me. The different sensors, buttons and stove switch may require specific memory_location and memory_address parameters that match your MicroNova specific board.
Also, switching your stove on or off can behave different on the various MicroNova flavours.
Use this integration at your own risk.
Connecting your stove¶
Most MicroNova based pellet stoves have a serial output. In most cases this output has 4 pins: GND, 5v, 20V and DATA.
You will have to build a simple circuit to interface with your stove. It is based on optocouplers for galvanic separation and logic level shifting between 5v and 3V3.
See the references below for all the details about te circuit.
You can use the 5V output from the stove to power the ESP module, but you will have to put a voltage regulator in between to get 3v3.
micronova: enable_rx_pin: REPLACEME
enable_rx_pin (Required, Pin): Output pin to be used to switch the line between RX and TX.
update_interval (Optional, Time): The interval that the sensors should be checked. Defaults to 60 seconds.
For all text sensors, sensors, numbers, buttons and switches hereafter most of the the default memory_location and memory_address parameters will work so you should not specify them. However your Micronova boad may require you to specify alternate values. So every text sensor, button, switch or number accepts these parameters:
memory_location (Optional): The memory location where the parameter must be read. For most stoves this is 0x00 for RAM or 0x20 for EPROM.
memory_address (Optional): The address where the parameter is stored.
text_sensor: - platform: micronova stove_state: name: Stove status
stove_state (Optional): The current stove state. All options from Text Sensor.
sensor: - platform: micronova room_temperature: name: Room temperature fumes_temperature: name: Fumes temperature stove_power: name: Stove power level fan_speed: fan_rpm_offset: 240 name: Fan RPM water_temperature: name: Water temperature water_pressure: name: Water pressure memory_address_sensor: memory_location: 0x20 memory_address: 0x7d name: Custom Address sensor
room_temperature (Optional): Sensor that reads the stoves ambient room temperature. All options from Sensor.
fumes_temperature (Optional): Fumes temperature. All options from Sensor.
stove_power (Optional): Current stove power. All options from Sensor.
fan_speed (Optional): Current fan speed. The raw value from the stove is multiplied by 10 +
fan_rpm_offset (Optional, integer): Offset the reported RPM value. Must be between 0 and 255. Defaults to 0.
All other options from Sensor.
water_temperature (Optional): Internal boiler water termperature. All options from Sensor.
water_pressure (Optional): Internal boiler water pressure. All options from Sensor.
memory_address_sensor (Optional): Can be any memory_location / memory_address you want to track. Usefull when you don’t know where the parameter is for your stove is. All options from Sensor.
number: - platform: micronova thermostat_temperature: name: Thermostat temperature step: 0.5 power_level: name: Thermostat temperature
- thermostat_temperature (Optional): Number that holds the current stove thermostat value.
step (Optional): Temperature step. This value is used to multiply/devide the raw value when setting/reading the thermostat_temperature
All other options from Number.
power_level (Optional): Number that sets/reads the requested stove power. All options from Number.
Besides memory_location and memory_address you can specify a specific memory_write_location parameter. This parameter is a hex value for the memory_location where the new thermostat value must be written.
memory_write_location (Optional): The memory_location where to write the new thermostat value.
switch: - platform: micronova stove: name: Stove on/off switch
stove (Optional): Turn the stove on or off. This switch will also reflect the current stove state. If the stove_state is “Off” the switch will be off, in all other states, the switch wil be on. All options from Switch.
Besides memory_location and memory_address you can specify specific memory_data_on and memory_data_off parameters. These parameters contain the hex value to be written to the memory_location and memory_address when the switch turns on or off.
memory_data_on (Optional): The data to write when turning the switch on.
memory_data_off (Optional): The data to write when turning the switch off.