From 918508113002de0fa9ccf4cde383aee7c0062977 Mon Sep 17 00:00:00 2001 From: Fabian Leutgeb Date: Mon, 14 Jul 2025 16:27:51 +0200 Subject: [PATCH 1/5] Document linked entities for duration characteristics (valve switch and valve) --- source/_integrations/homekit.markdown | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index 8338f889af69..d7be5b2907e0 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -194,6 +194,14 @@ homekit: description: The `entity_id` of a `sensor` entity to use as the temperature sensor of the air purifier accessory. required: false type: string + linked_valve_duration: + description: The `entity_id` of a `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Mininum value: `300` seconds. Maximum value: `3600` seconds. Step size: `300` seconds. Changes in HomeKit will change the sensor state (and vice verca). + required: false + type: string + linked_valve_end_time: + description: The `entity_id` of a `sensor` (timestamp) entity to use for calculating the remaining time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. The end time has to be maintained in Home Assistant. HomeKit will not update the state of this sensor. + required: false + type: string low_battery_threshold: description: Minimum battery level before the accessory starts reporting a low battery. required: false @@ -450,10 +458,10 @@ The following integrations are currently supported: | sensor | CarbonMonoxideSensor | All sensors that have `carbon_monoxide` as their `device_class` | | sensor | CarbonDioxideSensor | All sensors that have `co2` as part of their `entity_id` or `carbon_dioxide` as their `device_class` | | sensor | LightSensor | All sensors that have `lm` or `lx` as their `unit_of_measurement` or `illuminance` as their `device_class` | -| switch | Switch | Represented as a switch by default but can be changed by using `type` within `entity_config`. | +| switch | Switch | Represented as a switch by default but can be changed by using `type` within `entity_config`. Valve switches (type `faucet`, `shower`, `sprinkler`, or `valve`) can be linked with `linked_valve_duration` and/or `linked_valve_end_time`. | | water_heater | WaterHeater | All `water_heater` devices. | | device_automation | DeviceTriggerAccessory | All devices that support triggers. | -| valve | Valve | All `valve` devices. | +| valve | Valve | All `valve` devices. Can be linked with `linked_valve_duration` and/or `linked_valve_end_time`. | # Device triggers From 6b134c6f9e7e5f2df9e66a6b536edc025639d131 Mon Sep 17 00:00:00 2001 From: Fabian Leutgeb Date: Wed, 30 Jul 2025 22:18:13 +0200 Subject: [PATCH 2/5] Improve text and format --- source/_integrations/homekit.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index d7be5b2907e0..42074252f220 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -458,10 +458,10 @@ The following integrations are currently supported: | sensor | CarbonMonoxideSensor | All sensors that have `carbon_monoxide` as their `device_class` | | sensor | CarbonDioxideSensor | All sensors that have `co2` as part of their `entity_id` or `carbon_dioxide` as their `device_class` | | sensor | LightSensor | All sensors that have `lm` or `lx` as their `unit_of_measurement` or `illuminance` as their `device_class` | -| switch | Switch | Represented as a switch by default but can be changed by using `type` within `entity_config`. Valve switches (type `faucet`, `shower`, `sprinkler`, or `valve`) can be linked with `linked_valve_duration` and/or `linked_valve_end_time`. | +| switch | Switch | Represented as a switch by default but can be changed by using `type` within `entity_config`. Valve switches (type `faucet`, `shower`, `sprinkler`, or `valve`) can be linked with `linked_valve_duration` and `linked_valve_end_time`. | | water_heater | WaterHeater | All `water_heater` devices. | | device_automation | DeviceTriggerAccessory | All devices that support triggers. | -| valve | Valve | All `valve` devices. Can be linked with `linked_valve_duration` and/or `linked_valve_end_time`. | +| valve | Valve | All `valve` devices can be linked with `linked_valve_duration` and `linked_valve_end_time`. | # Device triggers From 97d73c4a2a01e71c31e0bce9ccd771708f61f899 Mon Sep 17 00:00:00 2001 From: Fabian Leutgeb Date: Wed, 30 Jul 2025 22:52:00 +0200 Subject: [PATCH 3/5] Remove colons from description --- source/_integrations/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index 42074252f220..96f40d747e01 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -195,7 +195,7 @@ homekit: required: false type: string linked_valve_duration: - description: The `entity_id` of a `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Mininum value: `300` seconds. Maximum value: `3600` seconds. Step size: `300` seconds. Changes in HomeKit will change the sensor state (and vice verca). + description: The `entity_id` of a `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Mininum value `300` seconds. Maximum value `3600` seconds. Step size `300` seconds. Changes in HomeKit will change the sensor state (and vice verca). required: false type: string linked_valve_end_time: From 4fa60409f41a1e97c97fa658bd43fd9f26fe1e34 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 31 Jul 2025 05:58:38 +0200 Subject: [PATCH 4/5] tiny tweak --- source/_integrations/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index 96f40d747e01..a0814c0f362d 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -195,7 +195,7 @@ homekit: required: false type: string linked_valve_duration: - description: The `entity_id` of a `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Mininum value `300` seconds. Maximum value `3600` seconds. Step size `300` seconds. Changes in HomeKit will change the sensor state (and vice verca). + description: The `entity_id` of a `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Minimum value `300` seconds. Maximum value `3600` seconds. Step size `300` seconds. Changes in HomeKit will change the sensor state (and vice versa). required: false type: string linked_valve_end_time: From 9570749de2e024e3b5c20af3489ebf11701b5ecb Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 31 Jul 2025 05:59:26 +0200 Subject: [PATCH 5/5] tiny tweak --- source/_integrations/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index a0814c0f362d..27be6c3e4a6a 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -195,7 +195,7 @@ homekit: required: false type: string linked_valve_duration: - description: The `entity_id` of a `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Minimum value `300` seconds. Maximum value `3600` seconds. Step size `300` seconds. Changes in HomeKit will change the sensor state (and vice versa). + description: The `entity_id` of an `input_number` entity to use as the default run time of a valve switch (switch type `faucet`, `shower`, `sprinkler`, or `valve`), or valve accessory. Minimum value `300` seconds. Maximum value `3600` seconds. Step size `300` seconds. Changes in HomeKit will change the sensor state (and vice versa). required: false type: string linked_valve_end_time: