From d242a161f5654b1e65abdcda272232a7f5780f0d Mon Sep 17 00:00:00 2001 From: Jordan Date: Mon, 21 Apr 2025 23:50:28 +0100 Subject: [PATCH 1/8] Add Probe Plus integration documentation --- source/_integrations/probe_plus.markdown | 70 ++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 source/_integrations/probe_plus.markdown diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown new file mode 100644 index 000000000000..c91ccfda5a07 --- /dev/null +++ b/source/_integrations/probe_plus.markdown @@ -0,0 +1,70 @@ +--- +title: Probe Plus +description: Instructions on how to integrate Probe Plus food temperature probes into Home Assistant. +ha_release: 2025.5.0 +ha_category: + - Sensor +ha_iot_class: Local Push +ha_config_flow: true +ha_domain: probe_plus +ha_platforms: + - sensor +ha_bluetooth: true +ha_codeowners: + - '@pantherale0' +ha_integration_type: device +ha_quality_scale: bronze +--- + +The **Probe Plus** {% term integration %} allows you to view food temperate probe details supported by [Probe Plus](https://play.google.com/store/apps/details?id=com.yscoco.thermoex) through Home Assistant. + +If your probe is within Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/bluetooth) integration is fully loaded, the probe should be discovered automatically providing that the model is FM2**. If you are configuring the device manually, your probe needs to be turned on during setup. + +Once the integration is set up, Home Assistant will try to connect to your probe every 15 seconds. This means there is sometimes a small delay between you removing the probe from its dock and Home Assistant connecting to it. + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Device: + description: "The Bluetooth device that is your probe." +{% endconfiguration_basic %} + +## Available platforms & entities + +### Sensors + +- **Battery**: Current battery level of the relay and probe. +- **Temperature**: Current temperature reading from the probe. +- **Probe Signal Strength**: The signal strength of the probe to its charging dock. +- **Relay Voltage**: Voltage of the battery within the charging dock (not supported on all models). +- **Probe Voltage**: Voltage of the battery inside the probe. + +## Supported devices + +The following devices have been tested successfully with this integration: + +- FMC210/FMC213 + +If you have successfully tested this integration with another Acaia model, please let us know by enhancing this documentation, or by opening an issue in GitHub. + +## Possible use-cases + +This integration can be used to monitor food temperatures, you could combine this with your Home Assistant Voice to alert you when the food has finished cooking. As a bonus, multiple probes are supported and therefore if you are cooking a large family meal, you can view all your food temperatures on one dashboard. + +## Known limitations + +- While this integration is configured for your device, you won't be able to use the official app, as only one connection at a time is supported. +- This assumes that the probe is configured to read the temperature in celsius. Make sure you have changed this in the app before setting up in case you are using fahrenheit. A template helper can be used to convert between units. + +## Remove integration + +This integration follows standard integration removal, no extra steps are required. + +{% include integrations/remove_device_service.md %} + +## Troubleshooting + +{% details "Device not discovered or found" %} + +Make sure your probe is removed from the charging dock and the dock is within Bluetooth range to your Home Assistant instance. [ESPHome Bluetooth Proxies](https://esphome.io/components/bluetooth_proxy.html) are a great way to increase the range if your instance is too far away. Turn on debug settings in the Probe Plus integration and check your logs. +{% enddetails %} From abba159cb28dc963e5fc0aea3cf925add701c85b Mon Sep 17 00:00:00 2001 From: Jordan Date: Mon, 21 Apr 2025 23:56:59 +0100 Subject: [PATCH 2/8] Fix typos and standardize 'ha_iot_class' value in Probe Plus documentation --- source/_integrations/probe_plus.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index c91ccfda5a07..83c79bf2b3e3 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -4,7 +4,7 @@ description: Instructions on how to integrate Probe Plus food temperature probes ha_release: 2025.5.0 ha_category: - Sensor -ha_iot_class: Local Push +ha_iot_class: local_push ha_config_flow: true ha_domain: probe_plus ha_platforms: @@ -16,7 +16,7 @@ ha_integration_type: device ha_quality_scale: bronze --- -The **Probe Plus** {% term integration %} allows you to view food temperate probe details supported by [Probe Plus](https://play.google.com/store/apps/details?id=com.yscoco.thermoex) through Home Assistant. +The **Probe Plus** {% term integration %} allows you to view food temperature probe details supported by [Probe Plus](https://play.google.com/store/apps/details?id=com.yscoco.thermoex) through Home Assistant. If your probe is within Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/bluetooth) integration is fully loaded, the probe should be discovered automatically providing that the model is FM2**. If you are configuring the device manually, your probe needs to be turned on during setup. @@ -45,7 +45,7 @@ The following devices have been tested successfully with this integration: - FMC210/FMC213 -If you have successfully tested this integration with another Acaia model, please let us know by enhancing this documentation, or by opening an issue in GitHub. +If you have successfully tested this integration with another probe model, please let us know by enhancing this documentation, or by opening an issue in GitHub. ## Possible use-cases From cde558043dd451dc540f85c8007686b894289715 Mon Sep 17 00:00:00 2001 From: Jordan Date: Mon, 21 Apr 2025 23:58:35 +0100 Subject: [PATCH 3/8] grammer corrections --- source/_integrations/probe_plus.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index 83c79bf2b3e3..6d5eaf4891d8 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -18,7 +18,7 @@ ha_quality_scale: bronze The **Probe Plus** {% term integration %} allows you to view food temperature probe details supported by [Probe Plus](https://play.google.com/store/apps/details?id=com.yscoco.thermoex) through Home Assistant. -If your probe is within Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/bluetooth) integration is fully loaded, the probe should be discovered automatically providing that the model is FM2**. If you are configuring the device manually, your probe needs to be turned on during setup. +If your probe is within Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/bluetooth) integration is fully loaded, the probe should be discovered automatically provided that the model name starts with FM2. If you are configuring the device manually, your probe needs to be turned on during setup. Once the integration is set up, Home Assistant will try to connect to your probe every 15 seconds. This means there is sometimes a small delay between you removing the probe from its dock and Home Assistant connecting to it. @@ -54,7 +54,7 @@ This integration can be used to monitor food temperatures, you could combine thi ## Known limitations - While this integration is configured for your device, you won't be able to use the official app, as only one connection at a time is supported. -- This assumes that the probe is configured to read the temperature in celsius. Make sure you have changed this in the app before setting up in case you are using fahrenheit. A template helper can be used to convert between units. +- This assumes that the probe is configured to read the temperature in Celsius. Make sure you have changed this in the app before setting up in case you are using Fahrenheit. A template helper can be used to convert between units. ## Remove integration From 617981ba1bde3b6eada9220ed97127702aee2ad8 Mon Sep 17 00:00:00 2001 From: Jordan Harvey Date: Tue, 22 Apr 2025 08:00:44 +0100 Subject: [PATCH 4/8] Update source/_integrations/probe_plus.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/probe_plus.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index 6d5eaf4891d8..c39fdef0663a 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -35,7 +35,7 @@ Device: - **Battery**: Current battery level of the relay and probe. - **Temperature**: Current temperature reading from the probe. -- **Probe Signal Strength**: The signal strength of the probe to its charging dock. +- **Probe signal strength**: The signal strength of the probe to its charging dock. - **Relay Voltage**: Voltage of the battery within the charging dock (not supported on all models). - **Probe Voltage**: Voltage of the battery inside the probe. From cc9cf1adf5d418be8d5e16a4bf759f402ed774e4 Mon Sep 17 00:00:00 2001 From: Jordan Harvey Date: Tue, 22 Apr 2025 08:00:54 +0100 Subject: [PATCH 5/8] Update source/_integrations/probe_plus.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/probe_plus.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index c39fdef0663a..976658c9f613 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -36,7 +36,7 @@ Device: - **Battery**: Current battery level of the relay and probe. - **Temperature**: Current temperature reading from the probe. - **Probe signal strength**: The signal strength of the probe to its charging dock. -- **Relay Voltage**: Voltage of the battery within the charging dock (not supported on all models). +- **Relay voltage**: Voltage of the battery within the charging dock (not supported on all models). - **Probe Voltage**: Voltage of the battery inside the probe. ## Supported devices From 95074a54235e5897043c61adcccf11a547e9e14a Mon Sep 17 00:00:00 2001 From: Jordan Harvey Date: Tue, 22 Apr 2025 08:01:05 +0100 Subject: [PATCH 6/8] Update source/_integrations/probe_plus.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/probe_plus.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index 976658c9f613..eb5cae0434b1 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -37,7 +37,7 @@ Device: - **Temperature**: Current temperature reading from the probe. - **Probe signal strength**: The signal strength of the probe to its charging dock. - **Relay voltage**: Voltage of the battery within the charging dock (not supported on all models). -- **Probe Voltage**: Voltage of the battery inside the probe. +- **Probe voltage**: Voltage of the battery inside the probe. ## Supported devices From 72200057a4af5fc1944a8473af426a5ed65709ac Mon Sep 17 00:00:00 2001 From: Jordan Date: Tue, 22 Apr 2025 08:01:51 +0100 Subject: [PATCH 7/8] Move removal section to end of the page --- source/_integrations/probe_plus.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index eb5cae0434b1..85e027fa91e0 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -56,15 +56,15 @@ This integration can be used to monitor food temperatures, you could combine thi - While this integration is configured for your device, you won't be able to use the official app, as only one connection at a time is supported. - This assumes that the probe is configured to read the temperature in Celsius. Make sure you have changed this in the app before setting up in case you are using Fahrenheit. A template helper can be used to convert between units. -## Remove integration - -This integration follows standard integration removal, no extra steps are required. - -{% include integrations/remove_device_service.md %} - ## Troubleshooting {% details "Device not discovered or found" %} Make sure your probe is removed from the charging dock and the dock is within Bluetooth range to your Home Assistant instance. [ESPHome Bluetooth Proxies](https://esphome.io/components/bluetooth_proxy.html) are a great way to increase the range if your instance is too far away. Turn on debug settings in the Probe Plus integration and check your logs. {% enddetails %} + +## Remove integration + +This integration follows standard integration removal, no extra steps are required. + +{% include integrations/remove_device_service.md %} From 165e84309eab115505ea78631b8f61f76a10698f Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Tue, 22 Apr 2025 09:56:06 +0200 Subject: [PATCH 8/8] tiny style tweaks --- source/_integrations/probe_plus.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/probe_plus.markdown b/source/_integrations/probe_plus.markdown index 85e027fa91e0..9f183c65b48a 100644 --- a/source/_integrations/probe_plus.markdown +++ b/source/_integrations/probe_plus.markdown @@ -29,7 +29,7 @@ Device: description: "The Bluetooth device that is your probe." {% endconfiguration_basic %} -## Available platforms & entities +## Available functionality ### Sensors @@ -63,7 +63,7 @@ This integration can be used to monitor food temperatures, you could combine thi Make sure your probe is removed from the charging dock and the dock is within Bluetooth range to your Home Assistant instance. [ESPHome Bluetooth Proxies](https://esphome.io/components/bluetooth_proxy.html) are a great way to increase the range if your instance is too far away. Turn on debug settings in the Probe Plus integration and check your logs. {% enddetails %} -## Remove integration +## Removing the integration This integration follows standard integration removal, no extra steps are required.