Add documentation for tedee integration (#30554)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>

source/_integrations/tedee.markdown

@@ -0,0 +1,50 @@
+---
+title: Tedee
+description: Instructions on how to integrate your Tedee lock with Home Assistant.
+ha_release: 2024.2
+ha_category:
+  - Binary sensor
+  - Lock
+  - Sensor
+ha_iot_class: Local Push
+ha_config_flow: true
+ha_domain: tedee
+ha_platforms:
+  - binary_sensor
+  - lock
+  - sensor
+ha_codeowners:
+  - '@zweckj'
+  - '@patrickhilker'
+ha_integration_type: integration
+---
+
+This integration interacts with your [Tedee](https://tedee.com) locks by communicating with the Tedee bridge through HTTP. The integration will communicate with your lock locally.
+
+## Pre-requisites
+
+- You will need the bridge to add your locks using this integration.
+- You need to have the local API enabled.
+
+If you do not own the bridge, you can still add your locks to Home Assistant through the [HomeKit device integration](/integrations/homekit_controller.markdown). Communication will happen over Bluetooth in that case, and features will be limited.
+
+{% include integrations/config_flow.md %}
+
+{% configuration_basic %}
+Host:
+  description: "The IP address of your bridge. You can find it in your router or in the Tedee app under **Bridge Settings** -> **Local API**."
+  required: false
+  type: string
+Local Access Token:
+  description: "The local access token for your bridge. You can find it in the Tedee app under **Bridge Settings** -> **Local API**."
+  required: false
+  type: string
+{% endconfiguration_basic %}
+
+## Binary sensors
+
+We have three binary sensors: One that indicates whether the battery is currently charging, one indicating if the pull spring is enabled, and one indicating whether the lock is in a "semi-locked" position, meaning the lock has been turned manually and between its normal end positions.
+
+## Sensors
+
+The integration currently offers two sensors: A battery sensor, indicating the charge of your lock, and a "pull spring duration" sensor, indicating how long (in seconds) your latch will stay pulled after a pull operation (if supported).