diff --git a/docs/README.md b/docs/README.md index 061bc48..b7596db 100644 --- a/docs/README.md +++ b/docs/README.md @@ -3,36 +3,51 @@ title: Theengs BLE mobile application --- # Theengs BLE mobile application -**Theengs app** is a multi platforms, multi devices **application** and BLE to MQTT **gateway** that leverages the [Theengs Decoder library](https://github.com/theengs/decoder). -It retrieves data from a wide range of [BLE sensors](prerequisites/devices) from Xiaomi, Inkbird, Govee, ClearGrass, Qingping, Ruuvi, Switchbot, Thermopro; LYWSD03MMC, CGD1, CGP1W, CGDN1, CGG1, H5055, H5072, H5075, H5102, TH1, TH2, BBQ, CGH1, CGDK2, CGPR1, RuuviTag, WS02, WS08, TPMS, MiScale, LYWSD02, LYWSDCGQ, MiFlora... and enables to read the advertised real time data from these sensors. +## 🌟 Local Smart Sensor Integration 🌟 -It also translates this information into a readable JSON format and pushes those to an MQTT broker if you need. The Home Assistant MQTT convention is followed so that you can see your add your sensors in a few steps into your favorite controller. - -The app uses the bluetooth component of your Phone/Tablet to read the sensor data. +Theengs App seamlessly reads a wide array of Bluetooth Low Energy (BLE) sensors, gathering real-time data on environmental parameters such as temperature, humidity, moisture, etc. It displays these readings intuitively and enables integration with your Smart Home setup via MQTT. Compatible with platforms like Home Assistant, Theengs App is a vendor-agnostic reader of [your sensors](https://decoder.theengs.io/devices/devices.html). ![Iot](./img/Theengs-app-home-reduced-1280.png) -**Theengs app** can be used as a standalone solution or as a complementary solution to [OpenMQTTGateway](https://docs.openmqttgateway.com/) and/or [Theengs gateway](https://gateway.theengs.io) if you want a continuously running gateway. +## πŸ”₯ Elevate Your Grilling Game + +Theengs App now offers a dedicated live monitoring feature for BBQ enthusiasts. Track your cooking with a dynamic chart that displays temperature trends in real time. Set personalized thresholds for different cooking stages and receive instant notifications based on these criteria. Whether you prefer your meat rare, medium, or well-done, Theengs App ensures your grilling is done to perfection. + +
+ +![live bbq monitoring](./img/Theengs-app-live.png) -The app will retrieve data from BLE sensors from Govee, Xiaomi, Inkbird, QingPing, ThermoBeacon, ClearGrass, Blue Maestro and many more. +
-For more information view the [documentation](https://app.theengs.io/) +## πŸ”’Respecting Your Privacy +With Theengs App, your data stays local by default. For more details, please refer to our [privacy policy](https://app.theengs.io/use/privacy.html). +## 🏑 Take control with Smart Home Integration +Theengs App syncs with platforms like Home Assistant via MQTT. Record sensor data on your preferred server - your home, your choice. + +## Choose Your Platform and Download Now + +
+
Download on the App Store
Get it on Google Play
::: tip Note -Theengs app read data "broadcasted" by the devices and does not connect to them, only the Mi Flora and ThermoBeacon historical data are retrieved through a connection. For the rest of the devices the data is read real time when the device emit it. +The Theengs app reads data that is 'broadcasted' by devices, operating primarily in a passive mode without direct connections, except for Mi Flora and ThermoBeacon, where historical data is accessed through a connection. For all other devices, the app captures data as it is emitted by the sensors. + +BBQ Live monitoring and notifications require the app to be active on the sensor screen. ::: -Features comparison between OS: -| OS | Real time data | MQTT integration | Running in background | Home Assistant Auto Discovery | -|:-:|:-:|:-:|:-:|:-:| -|iOS|β˜‘οΈ|β˜‘οΈ||β˜‘οΈ| -|Android|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ *experimental*|β˜‘οΈ| +## Features comparison between Operating Systems +| OS | Real time data | BBQ monitoring |MQTT integration | Running in background | Home Assistant Auto Discovery | +|:-:|:-:|:-:|:-:|:-:|:-:| +|iOS|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ||β˜‘οΈ| +|Android|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ *experimental*|β˜‘οΈ| + +**Theengs app** can be used as a standalone solution or as a complementary solution to [OpenMQTTGateway](https://docs.openmqttgateway.com/) and/or [Theengs gateway](https://gateway.theengs.io) if you want a continuously running gateway. -#### Third party projects used by Theengs app +## Third party projects used by Theengs app * [Qt](https://www.qt.io) ([LGPL 3](https://www.gnu.org/licenses/lgpl-3.0.txt)) * [QtMqtt](https://www.qt.io) ([GPL 3](https://www.gnu.org/licenses/gpl-3.0.txt)) @@ -53,5 +68,5 @@ All product and company names are trademarks or registered trademarks of their r ::: ::: slot footer -[GPLv3 Licensed](https://github.com/theengs/home/blob/main/LICENSE) | Copyright Β© 2022-present Theengs +[GPLv3 Licensed](https://github.com/theengs/home/blob/main/LICENSE) | Copyright Β© 2024 Theengs ::: diff --git a/docs/img/Theengs-app-live-monitoring.png b/docs/img/Theengs-app-live-monitoring.png new file mode 100644 index 0000000..e01afff Binary files /dev/null and b/docs/img/Theengs-app-live-monitoring.png differ diff --git a/docs/img/Theengs-app-live.png b/docs/img/Theengs-app-live.png new file mode 100644 index 0000000..cbca869 Binary files /dev/null and b/docs/img/Theengs-app-live.png differ diff --git a/docs/img/Theengs-app-threshold-settings-default.png b/docs/img/Theengs-app-threshold-settings-default.png new file mode 100644 index 0000000..96afedc Binary files /dev/null and b/docs/img/Theengs-app-threshold-settings-default.png differ diff --git a/docs/img/Theengs-app-threshold-settings.png b/docs/img/Theengs-app-threshold-settings.png new file mode 100644 index 0000000..81fd630 Binary files /dev/null and b/docs/img/Theengs-app-threshold-settings.png differ diff --git a/docs/prerequisites/devices.md b/docs/prerequisites/devices.md index 6db5621..fb3dc0a 100644 --- a/docs/prerequisites/devices.md +++ b/docs/prerequisites/devices.md @@ -3,7 +3,7 @@ pageClass: table-generated-page --- # Devices supported -Here is the list of supported devices by the app, more details in the Compatible section of the top nav bar. +Here is the list of supported devices by the app, more details in the Compatible Devices section of the top nav bar. |Model_Id|Mobile App| |-|-| @@ -41,6 +41,8 @@ Here is the list of supported devices by the app, more details in the Compatible |IBT_4X(S/C)|βœ…| |IBT_6X(S)|βœ…| |JQJCY01YM|βœ…| +|K6P|βœ…| +|K9|βœ…| |LYWSD02|βœ…| |LYWSD03MMC_ATC/PVVX|βœ…| |MJWSD05MMC_ATC/PVVX|βœ…| @@ -57,6 +59,10 @@ Here is the list of supported devices by the app, more details in the Compatible |W110150X|βœ…| |THX1(W230150X)|βœ…| |SDLS|βœ…| +|SE_MAG|βœ…| +|SE_RHT|βœ…| +|SE_TEMP|βœ…| +|SE_TPROBE|βœ…| |SHT4X|βœ…| |SOLIS_6|βœ…| |T201|βœ…| diff --git a/docs/use/use.md b/docs/use/use.md index 7331c8f..46ba470 100644 --- a/docs/use/use.md +++ b/docs/use/use.md @@ -1,10 +1,10 @@ # Use -## Features comparison between OS -| OS | Real time data | MQTT integration | Running in background | Home Assistant Auto Discovery | -|:-:|:-:|:-:|:-:|:-:| -|iOS|β˜‘οΈ|β˜‘οΈ||β˜‘οΈ| -|Android|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ *experimental*|β˜‘οΈ| +## Features comparison between Operating Systems +| OS | Real time data | BBQ monitoring |MQTT integration | Running in background | Home Assistant Auto Discovery | +|:-:|:-:|:-:|:-:|:-:|:-:| +|iOS|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ||β˜‘οΈ| +|Android|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ|β˜‘οΈ *experimental*|β˜‘οΈ| ## Overview @@ -24,6 +24,57 @@ 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](./../img/Theengs-app-threshold-settings.png) + +Select '+' to customize temperature ranges for different meats or cooking stages. + +![Threshold settings choice](./../img/Theengs-app-threshold-settings-default.png) + +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 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](./../img/Theengs-app-live-monitoring.png) + +### 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. + +::: tip 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: