This integration lets you control a Proflame2 fireplace from Home Assistant using a supported controller and your original handheld remote for setup. The Proflame2 fireplace receiver is part of a modular remote control and electronic ignition system used across many modern gas fireplace brands, log sets, and hearth appliances.
Available controls depend on the features installed in your fireplace and the features you enable during setup.
- Power
- Flame level
- Fan level
- Light level
- Front burner
- Aux output
- CPI / pilot mode
- Saved fireplace profiles
The supported controllers contain the radio needed to communicate with the Proflame2 fireplace receiver. You need one supported controller for each fireplace and it must be close enough to the fireplace to work reliably in your home.
| Controller | Controls Fireplace | Guided Learning | Active Listening | Summary |
|---|---|---|---|---|
| LilyGO T-Embed CC1101 | Yes | Yes | Yes | Wi-Fi controller that can be installed near the fireplace. |
| YardStick One | Yes | Yes | No | USB controller connected to the Home Assistant host. |
LilyGO is a full-featured Proflame2 controller with a built-in display that shows the fireplace status and uses Wi-Fi to connect to Home Assistant. This allows you to place the LilyGO in a convenient location near the fireplace to ensure reliable control. With support for active listening, you can continue using the original remote while Home Assistant stays updated with the current fireplace status.
Note: ESPHome Builder is required in order to configure the LilyGO firmware. The LilyGO setup guide includes a browser YAML helper that updates the ESPHome Builder generated YAML for Proflame2.
Setup guide: LilyGO CC1101 controller
YardStick One allows full control of the fireplace but does not have a display and does not currently support active listening. It connects directly to Home Assistant via USB, so setup is simpler because ESPHome Builder is not required. Since it remains connected to the computer running Home Assistant by USB, it may be harder to position close enough to the Proflame2 fireplace for reliable communication.
Setup guide: YardStick controller
There are two ways you can install the Proflame2 integration: HACS or manual. The preferred approach is HACS since you will be notified of updates and can apply them easily through the HACS user interface.
The easiest way to install the Proflame2 integration before it is available in the default HACS catalog is to add it as a custom HACS repository.
- Click
Add to HACS. - Confirm the repository in Home Assistant.
- Install the integration from HACS.
- Restart Home Assistant.
- Add the
Proflame2integration from Home Assistant settings.
If the button does not work, add the repository manually:
- Open Home Assistant.
- Open
HACS. - Open
Custom repositories. - Add this repository URL:
https://github.com/jeffgregx2/HACS-Proflame2 - Select category
Integration. - Install the integration.
- Restart Home Assistant.
- Add the
Proflame2integration from Home Assistant settings.
HACS is the recommended install path. If you need a manual install, copy
custom_components/proflame2 into /config/custom_components/proflame2, restart
Home Assistant, then add the Proflame2 integration.
Once the Proflame2 integration is installed in Home Assistant, it is easy to add a fireplace:
- Choose a controller: LilyGO T-Embed CC1101 or YardStick One.
- Follow the controller setup guide linked above.
- Add the
Proflame2integration in Home Assistant. - Select the controller type.
- For LilyGO, select the matching ESPHome device when prompted.
- Start guided learning.
- Hold the original remote within about 3 feet of the controller during learning.
- Follow the prompts and press the requested buttons on the original remote.
- Select the fireplace features your installation supports.
- Validate basic controls from Home Assistant.
During setup, learning mode asks you to press specific buttons on your original fireplace remote. This is used to learn the proper control codes used to establish communications. You must have a functioning original remote in order to set up this integration.
Remember: If you are using a LilyGO controller, you must install it first before adding the fireplace.
Reliable range depends on the controller, its antenna, and how close it can be placed to the fireplace.
- LilyGO:
- Internal antenna, shorter range.
- Best to use within about 15 feet of the fireplace.
- YardStick:
- External antenna, longer range.
- Best to use within about 20 feet of the fireplace.
- Range can improve with an antenna designed for 315 MHz, which is the frequency used by Proflame2 remotes.
These are practical starting points, not guarantees. Fireplace location, walls, metal, USB placement, Wi-Fi, and local interference can change the reliable range.
After setup, Home Assistant can control the fireplace from dashboards, scripts, scenes, automations, and profiles.
There are three different ways you can control your fireplace from within Home Assistant.
Each fireplace created by this integration includes controls for the supported fireplace settings, such as Power, Flame, Fan, and Light. When you adjust those controls, the integration briefly waits before sending the update because Proflame2 fireplaces receive a complete fireplace state rather than individual setting changes. This allows several quick adjustments to be combined into one command instead of sending multiple one-second updates to the fireplace.
Individual dashboard controls briefly wait before sending so multiple setting changes can be combined into one fireplace command. When an automation or script already knows the full desired fireplace state, use the proflame2.set_state service to send it immediately. For example:
service: proflame2.set_state
target:
device_id: YOUR_FIREPLACE_DEVICE_ID
data:
power: true
flame: 1
fan: 0
light: 0
front: false
aux: false
cpi: falseSettings for features you did not enable during setup will be ignored.
A profile is a saved fireplace state with a name, such as evening_relax. Each profile defines all of the fireplace settings you want to apply, including power, flame, fan, light, and any other enabled features. Profiles are useful for common settings based on time of day or routine, similar to a Home Assistant scene. When you activate a profile, the full saved state is sent immediately:
service: proflame2.apply_profile
target:
device_id: YOUR_FIREPLACE_DEVICE_ID
data:
profile_id: evening_relaxTo manage profiles, open Settings -> Devices & services -> Proflame 2 Fireplace in Home Assistant and select the Gear icon next to your existing fireplace. You can add, edit, or remove saved profiles there. Profiles can also appear as Home Assistant controls and can be called from automations.
For automations, use profiles or the service interface to ensure the fireplace is in the desired state. Use of individual controls is less efficient and unless you change all controls the fireplace may not be in the desired state. This is especially true if you continue to use the original remote.
Active listening lets Home Assistant update when the original remote changes the fireplace settings. This is supported by LilyGO and is enabled by default.
YardStick does not currently support active listening. It can learn from the original remote during setup and it can control the fireplace, but it will not keep Home Assistant synchronized when another remote is used later.
To change the Active Listening settings, open Settings -> Devices & services -> Proflame 2 Fireplace in Home Assistant and select the Gear icon next to your existing fireplace. Select Edit supported features -> Enable active listening and change it to the desired value.
The Proflame2 integration can support multiple fireplaces. Each fireplace will need its own controller set up using that fireplace's original remote. Simply use "Add entry" multiple times, once per fireplace.
At this time, one controller can only control one fireplace.
SmartFire demonstrated that Proflame2 fireplaces can be controlled programmatically and provides valuable reference behavior for packet construction, ECC handling, and transmit timing.
This project builds on that work with a different product goal: a Home Assistant integration with guided learning, pluggable controllers, multi-fireplace support, feature-gated configuration, diagnostics, saved profiles, and atomic full-state control. Thank you to everyone who worked on SmartFire for the information that made this project possible.
No warranty is provided. You are responsible for safe operation of your fireplace and automation. Avoid unattended operation that could leave the fireplace running longer than intended.
GNU General Public License v3.0. See LICENSE.