jrich523 / hass_traeger

Hass Plugin for Traeger (WIP)

Traeger HASS component

Component to integrate with Traeger WiFire Grills.

This component will set up the following platforms.

Platform	Description
sensor	Shows various temperature readings from the grill or accessories
climate	Allows temperature control of the grill and probe
number	Allows minutes input to the timer
switch	Allow SuperSmoke, Keepwarm, and connectivity switch

Installation (Manual)

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called traeger.
4. Download all the files from the custom_components/traeger/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Traeger"

Platform Details

Some of the platforms are fairly self explanatory, others could use a little more explaining. Below are more details on some of those platforms.

Grill State Sensor

This sensor aligns with the status values in the Traeger app.

State	Description
offline	Powered off (or not accesible)
sleeping	Standing by (power switch on, screen off)
idle	Standing by (power switch on, screen on)
igniting	Igniting the fire pot
preheating	Ignition is complete, heating to set temperature
manual_cook	Cooking mode
custom_cook	Cooking mode, using preset cook cycle
cool_down	Cool down cycle
shutdown	Cool down cycle complete, heading to sleep
unknown	Unkown state, report to developers

Heating State Sensor

This sensor tries to provide more useful insight into the heating status of the grill. Many of these values can be trigger off of to provide notifications that are not available in the Traeger app.

State	Description
idle	Not in igniting, preheating, cooking or cool_down modes
preheating	Igniting or preheating (and under 165°F)
heating	Trying to get temperature up to new target temperature
cooling	Trying to get temperature down to new target temperature
at_temp	Temperature has reached the target temperature (and is holding at ±20°F of target temperature)
over_temp	Was at_temp, but is now more than 20°F above target temperature
under_temp	Was at_temp, but is now more than 20°F below target temperature
cool_down	Cool down cycle

Probe State Sensor

This sensor provides triggers for useful probe events such as being close to the target temperature or reaching the target temperature.

State	Description
idle	Probe target temperature is not set (or grill is not in igniting, preheating or cooking modes)
set	Probe target temperature is set
close	Probe temperature is within 5°F of target temperature
at_temp	Probe alarm has fired
fell_out	Probe probably fell out of the meat (Probe temperature is greater that 215°F)

Installation (HACS)

1. Add this repository to HACS
2. Search for Traeger in HACS

Configuration is done in the UI

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

---