# 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.
Select '+' to customize temperature ranges for different meats or cooking stages.
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.
# 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:
# 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:
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"
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
- And finally go into the app settings and toggle "Enable background updates"
# 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
- Go back
- Click on "Nearby devices"
- Click on "Allow"
- Go back 2 times
- Deactivate "Remove permissions if app is unused"
- Click on battery
- Select unrestricted
- And finally go into the app settings and toggle "Enable background updates"
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.