diff --git a/source/_integrations/tedee.markdown b/source/_integrations/tedee.markdown new file mode 100644 index 00000000000..f80718a0ca9 --- /dev/null +++ b/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).