Skip to content

ESPHome Custom Component for the iGrill Bluetooth Thermometers

License

Notifications You must be signed in to change notification settings

bendikwa/esphome-igrill

Repository files navigation

esphome-igrill

ESPHome Custom Component for the iGrill Bluetooth Thermometers This component will let you use a supported ESP32 to read sensor values from IGrill bluetooth thermometers and Pulse BBQ's.

Installation

To use this component, include it as an External component

external_components:
  - source: github://bendikwa/esphome-igrill@v1.2

Device discovery

IGrill devices can be found using the igrill_ble_listener

To find out your device’s MAC address, add the following to your ESPHome configuration:

esp32_ble_tracker:
igrill_ble_listener:

The device will then listen for nearby devices, and display a message like this one:

[I][igrill_ble_listener:029]: Found IGrill device Name: iGrill_mini (MAC: 70:91:8F:XX:XX:XX)

Once the device is found, take note of the device MAC address. You will use it when configuring a sensor below. You can now remove the igrill_ble_listener device tracker from your configuration.

Supported Devices

In principle, all IGrill devices, including the Pulse 2000 are supported, but I do not own all of them. The ones with a checkmark in the list are confirmed working IGrill models:

  • IGrill mini
  • IGrill mini V2
  • IGrill V2 - Thanks to stogs for verifying
  • IGrill V202
  • IGrill V3
  • Weber Pulse 1000 Thanks to samvanh for verifying
  • Weber Pulse 2000 Thanks to PaulAntonDeen for testing and verifying

If you own one of the untested models, I would be thankfull if you create a ticket so we can get it confirmed working.

Configuration example

esp32_ble_tracker:

ble_client:
  - mac_address: 70:91:8F:XX:XX:XX
    id: igrill_device

sensor:
  - platform: igrill
    ble_client_id: igrill_device
    update_interval: 30s # default
    battery_level:
      name: "IGrill v3 battery"
    temperature_probe1:
      name: "IGrill v3 temp probe 1"
    temperature_probe2:
      name: "IGrill v3 temp probe 2"
    temperature_probe3:
      name: "IGrill v3 temp probe 3"
    temperature_probe4:
      name: "IGrill v3 temp probe 4"

Configuration variables

  • update_interval (Optional, Time) The interval between each read and publish of sensor values. Defaults to "30s"
  • send_value_when_unplugged (Optional, boolean): When set to false, the component will skip publishing for probes that are unplugged. Defaults to true
  • unplugged_probe_value (Optional, integer): The value to publish when a probe is disconnected, and send_value_when_unplugged is true. Defaults to 0

Available Sensors

  • temperature_probe1 (*Optional) The reported temperature of probe 1
  • temperature_probe2 (*Optional) The reported temperature of probe 2
  • temperature_probe3 (*Optional) The reported temperature of probe 3
  • temperature_probe4 (*Optional) The reported temperature of probe 4
  • pulse_heating_actual1 (*Optional) The reported temperature of the left heating element on a Pulse 2000
  • pulse_heating_actual2 (*Optional) The reported temperature of the right heating element on a Pulse 2000
  • pulse_heating_setpoint1 (*Optional) The reported setpoint of the left heating element on a Pulse 2000
  • pulse_heating_setpoint2 (*Optional) The reported setpoint of the right heating element on a Pulse 2000
  • propane_level (*Optional) The propane level on a V3 device
  • battery_level (*Optional) The battery level of the igrill device

Additional diagnostic connection sensors

If you require HA sensors to indicate if a BT connection to the iGrill device is established (e.g. for conditional cards), you can use the automations included in ble_client to update a template binary sensor like this:

ble_client:
  - mac_address: 70:91:8F:XX:XX:XX
    id: igrillv3
    on_connect:
      then:
        - binary_sensor.template.publish:
            id: v3_connection_bin
            state: ON
    on_disconnect:
      then:
        - binary_sensor.template.publish:
            id: v3_connection_bin
            state: OFF

binary_sensor:
  - platform: template
    name: "iGrill V3 connection status"
    id: v3_connection_bin
    device_class: connectivity
    entity_category: diagnostic

Temperature unit:

The temperature unit of the sensors are set to the unit reported by the iGrill device

Troubleshooting

If the ESPHome device can't connect to your IGrill, please make sure that you disconnect it from any other devices you have used in the past. IGrill devices can't maintain multiple connections.

The same goes the other way around. If you use this component to connect to your IGrill, you can not use the mobile app at the same time.

Also, you can turn the log level up to Verbose to see more diagnostics:

logger:
  level: VERBOSE

Disclaimer

This is a work in progress, and some things do not work yet.

What works:

  • MAC address discovery with igrill_ble_listener
  • Connection and authorization
  • Detection of model and number of probes
  • Publishing of probe temperatures
  • Publishing of Pulse 2000 heating element values
  • Publishing of battery level
  • Publishing of propane level (Untested)
  • Use correct temperature unit (read from device)

TODO:

  • Publish firmware version
  • Read and write temperature setpoint on probes
  • Set temperature unit (write to device)

About

ESPHome Custom Component for the iGrill Bluetooth Thermometers

Resources

License

Stars

Watchers

Forks

Packages

No packages published