From 88dca619f5882012d475b1e51a8ec3854704609e Mon Sep 17 00:00:00 2001
From: Mark Ruys <mark@paracas.nl>
Date: Mon, 9 Sep 2024 13:21:41 +0200
Subject: [PATCH] Create sensoterra.markdown (#33276)

* Create sensoterra.markdown

Initial version

See also PR https://github.com/home-assistant/core/pull/119642

* Update sensoterra.markdown

Add new line for better readability.

* Update sensoterra.markdown

Apply  coderabbitai suggestions

* Tiny tweaks

* Add temperature unit

* add config flow

* Update source/_integrations/sensoterra.markdown

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/sensoterra.markdown | 35 ++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 source/_integrations/sensoterra.markdown

diff --git a/source/_integrations/sensoterra.markdown b/source/_integrations/sensoterra.markdown
new file mode 100644
index 00000000000..49ba117663a
--- /dev/null
+++ b/source/_integrations/sensoterra.markdown
@@ -0,0 +1,35 @@
+---
+title: Sensoterra
+description: Instructions on how to integrate your Sensoterra probes with Home Assistant.
+ha_release: 2024.10
+ha_category:
+  - Sensor
+ha_iot_class: Cloud Poll
+ha_config_flow: true
+ha_domain: sensoterra
+ha_platforms:
+  - sensor
+ha_codeowners:
+  - '@markruys'
+ha_integration_type: integration
+---
+
+This {% term integration %} communicates with your [Sensoterra](https://sensoterra.com) soil moisture probes using the public [Sensoterra Customer API](https://monitor.sensoterra.com/api/v3/) via HTTPS.
+
+## Prerequisites
+
+Soil moisture probes can be purchased at Sensoterra.com. Create a free account in the Sensoterra app and register your probes. The Sensoterra Home Assistant integration needs your credentials to obtain a token to access your probe data.
+
+{% include integrations/config_flow.md %}
+
+## Sensors
+
+The integration provides the following sensors for each probe:
+
+- Soil moisture (either in volumetric-% or in SI)
+- Temperature (in degrees Celsius)
+- LoRaWAN signal strength (RSSI level)
+- Battery level (100, 50 or 10% approximations)
+- Last seen timestamp
+
+Typically, soil moisture probes measure once an hour. The Home Assistant integration polls this data every 15 minutes.