# Use

# Features comparison between Operating Systems

OS Real time data BBQ monitoring MQTT integration Running in background Home Assistant Auto Discovery
iOS ☑️ ☑️ ☑️ ☑️
Android ☑️ ☑️ ☑️ ☑️ experimental ☑️

# Overview

# Real time data

The app enables to retrieve BLE sensor real time data, to add new sensors tap "Search for new sensors" in the hamburger menu.

To refresh the sensor data tap "Refresh sensor data" in the hamburger menu.

Note

Why does Theengs App needs the location permission?

Theengs App requires the location permission to access your device Bluetooth and retrieves sensor data. Theengs is not accessing your location with GPS/GLONASS/BAIDU.

# Live BBQ monitoring

# Introduction

Live BBQ Monitoring allows you to track the temperature of your grill in real time, ensuring perfect cooking results. The feature includes different Threshold Settings, a Live Chart, and Notifications for comprehensive monitoring. This feature requires staying on the BBQ sensor screen to function effectively.

# Compatible devices

This feature is compatible with the following devices:

  • Govee H5055
  • Inkbird IBT-2X(S)
  • Inkbird IBT-4X(S/C)
  • Inkbird IBT-6X(S)
  • SOLIS_6

# Threshold settings

Access the threshold settings from the hamburger menu.

Threshold settings

Select '+' to customize temperature ranges for different meats or cooking stages.

Threshold settings choice

Name your preset for easy identification, e.g., 'Poultry', 'Rare Steak'. Enter your desired temperature range. You can modify these presets anytime.

From the BBQ sensor view you can select the presets of your choice.

Warning

The cooking temperatures provided in this app are general recommendations. Variations in equipment, ingredients, and conditions can affect cooking outcomes. Always verify food is cooked to safe temperatures. The application developer is not liable for any cooking results.

# Live monitoring

The Live Chart displays live temperature data from your BBQ sensor. To view, tap on your BBQ device from the main screen. The chart shows temperature changes over time, helping you monitor the cooking process.

Live monitoring

# Notifications

Enable notifications when prompted. Your phone must not be in silent or do not disturb mode. Set temperature thresholds based on your meal. When the sensor detects temperatures beyond this range, you'll receive an alert.

Note

For continuous monitoring and notifications, you must keep the app open on the BBQ sensor screen. Update frequency and real-time responsiveness depend on your smartphone’s processing capabilities, not the app. For best results, close unnecessary apps and ensure you are not far from the sensor.

# MQTT integration

Prerequisites:

  • MQTT broker setup in your local network (Mosquitto is a well known broker)

Theengs app can publish the data to an MQTT broker, to do so go to the hamburger menu, select Integration. Enter the following informations:

  • Broker host IP (compulsory)
  • Broker port (compulsory, default: 1883)
  • Username (optional)
  • Password (optional)
  • Topic (compulsory, default: home)
  • SubTopic (compulsory, default: TheengsApp)

Once done click on the MQTT switch to activate the integration, if the app can connect to the broker, it will display "Connected" in the top right.

# iOS specificity

If you want to push data to an MQTT broker you will need to manually enter a MAC address for the sensor, this is done from the sensor page see below:

add-mac

# Home Assistant Auto Discovery

Theengs app can publish your sensor definition following Home Assistant MQTT convention, so as to do this you need to activate “Enable discovery” into your MQTT Options and follow the steps below:

location

The sensor definition will be publish when the app connect to the broker. You can retrigger the publication by deactivating and reactivating the MQTT integration from the application.

# iOS permissions

The application will ask you for permission to use Bluetooth. You can learn more on Apple website (opens new window).

# Android permissions

The Android operating system requires applications to ask for device location permission in order to scan for nearby Bluetooth Low Energy sensors. You would need to go into the app information (long press on the icon -> (i)) so as to configure the app permissions properly.

# Android 8+

  • Click on Permissions
  • Activate "your location"

location

You can now use the application. If you want to run the application in the background follow the process below:

  • Go back
  • Click on "Battery"
  • Click on "Power saving exclusions"
  • Activate the exclusion for Theengs

location

  • And finally go into the app settings and toggle "Enable background updates"

background

# Android 10+

# Running when displayed only

  • Click on Permissions
  • Click on Location permission
  • Select "Allow only while using the app", if you want the app to update sensors data only when the app is running at the front
  • Enable "Use precise location" if you have this option

# Running in the background (experimental)

If you want the app to retrieve data in the background you will need to do the following steps:

  • Click on "Permissions"
  • Click on "Location"
  • Select "Allow all the time" if you want to update the sensors data in the background
  • Enable "Use precise location" if you have this option

location

  • Go back
  • Click on "Nearby devices"
  • Click on "Allow"

nearby

  • Go back 2 times
  • Deactivate "Remove permissions if app is unused"

unused

  • Click on battery

battery

  • Select unrestricted

unrestricted

  • And finally go into the app settings and toggle "Enable background updates"

background

Some devices also require the GPS to be turned on while scanning for new sensors.

Note

Android has drastically reduced the capabilities of apps to run in the background, as a consequence the Update interval set into the app may not be followed by the operating system. You may also have more regular results when the device is charging.