From 7185bf6fea514adbf0a5edfbb198dca0cc034259 Mon Sep 17 00:00:00 2001 From: "Willem-Jan L. van Rootselaar" Date: Sat, 15 Nov 2025 15:05:12 +0000 Subject: [PATCH 1/4] Add timesync service integration documentation --- source/_integrations/bsblan.markdown | 47 ++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/source/_integrations/bsblan.markdown b/source/_integrations/bsblan.markdown index bd4703718084..23b923ab6f53 100644 --- a/source/_integrations/bsblan.markdown +++ b/source/_integrations/bsblan.markdown @@ -226,3 +226,50 @@ To see a more detailed listing of the reported systems which are successfully us The integration is tested with the stable firmware version `5.0.16-20250525002819`. A newer firmware version may not work because the API could have changed. For autodiscovery, use the latest release. [release 5.0](https://github.com/fredlcore/BSB-LAN/releases/tag/v5.0) + +## Actions + +The **BSB-Lan** integration provides actions to control and manage your BSB-Lan devices. + +### Action `bsblan.sync_time` + +Synchronizes the time on your BSB-Lan device with Home Assistant's system time. This action compares the device time with Home Assistant's time and only updates the device if there is a difference, helping maintain accurate timestamps for your heating system logs and schedules. + +{% configuration_basic %} +Target: + description: Select the BSB-Lan device to sync. If no device is selected, all BSB-Lan devices will be synchronized. +{% endconfiguration_basic %} + +**Action data attributes:** + +| Data attribute | Optional | Description | +| -------------- | -------- | ----------- | +| `config_entry_id` | yes | The configuration entry ID of a specific BSB-Lan device. If not provided, time will be synced for all devices. | + +**Examples:** + +Sync time for all BSB-Lan devices: + +```yaml +action: bsblan.sync_time +``` + +Sync time for a specific device: + +```yaml +action: bsblan.sync_time +data: + config_entry_id: "your_config_entry_id" +``` + +Use in an automation to sync time daily: + +```yaml +automation: + - alias: "Sync BSB-Lan time daily" + triggers: + - trigger: time + at: "03:00:00" + actions: + - action: bsblan.sync_time +``` From 842053214557b4e69cc4d8e7ba975a01f8a8be43 Mon Sep 17 00:00:00 2001 From: Willem-Jan van Rootselaar Date: Thu, 1 Jan 2026 22:21:40 +0000 Subject: [PATCH 2/4] cleanup order --- source/_integrations/bsblan.markdown | 89 ++++++++++++++-------------- 1 file changed, 43 insertions(+), 46 deletions(-) diff --git a/source/_integrations/bsblan.markdown b/source/_integrations/bsblan.markdown index 23b923ab6f53..05ff24c8400a 100644 --- a/source/_integrations/bsblan.markdown +++ b/source/_integrations/bsblan.markdown @@ -77,6 +77,49 @@ Sets the hot water heating schedule for your BSB-Lan device. Each day of the wee Time slots are defined using time pickers for easy configuration without manual formatting. You only need to specify the days you want to configure. +### Action `bsblan.sync_time` + +Synchronizes the time on your BSB-Lan device with Home Assistant's system time. This action compares the device time with Home Assistant's time and only updates the device if there is a difference, helping maintain accurate timestamps for your heating system logs and schedules. + +{% configuration_basic %} +Target: + description: Select the BSB-Lan device to sync. If no device is selected, all BSB-Lan devices will be synchronized. +{% endconfiguration_basic %} + +**Action data attributes:** + +| Data attribute | Optional | Description | +| -------------- | -------- | ----------- | +| `device_id` | yes | The device ID of a specific BSB-Lan device. If provided, only that device will be synced. | + +**Examples:** + +Sync time for all BSB-Lan devices: + +```yaml +action: bsblan.sync_time +``` + +Sync time for a specific device: + +```yaml +action: bsblan.sync_time +target: + device_id: "your_device_id" +``` + +Use in an automation to sync time daily: + +```yaml +automation: + - alias: "Sync BSB-Lan time daily" + triggers: + - trigger: time + at: "03:00:00" + actions: + - action: bsblan.sync_time +``` + ## Examples The following examples show how to use the BSB-Lan integration actions in Home Assistant automations. @@ -227,49 +270,3 @@ To see a more detailed listing of the reported systems which are successfully us The integration is tested with the stable firmware version `5.0.16-20250525002819`. A newer firmware version may not work because the API could have changed. For autodiscovery, use the latest release. [release 5.0](https://github.com/fredlcore/BSB-LAN/releases/tag/v5.0) -## Actions - -The **BSB-Lan** integration provides actions to control and manage your BSB-Lan devices. - -### Action `bsblan.sync_time` - -Synchronizes the time on your BSB-Lan device with Home Assistant's system time. This action compares the device time with Home Assistant's time and only updates the device if there is a difference, helping maintain accurate timestamps for your heating system logs and schedules. - -{% configuration_basic %} -Target: - description: Select the BSB-Lan device to sync. If no device is selected, all BSB-Lan devices will be synchronized. -{% endconfiguration_basic %} - -**Action data attributes:** - -| Data attribute | Optional | Description | -| -------------- | -------- | ----------- | -| `config_entry_id` | yes | The configuration entry ID of a specific BSB-Lan device. If not provided, time will be synced for all devices. | - -**Examples:** - -Sync time for all BSB-Lan devices: - -```yaml -action: bsblan.sync_time -``` - -Sync time for a specific device: - -```yaml -action: bsblan.sync_time -data: - config_entry_id: "your_config_entry_id" -``` - -Use in an automation to sync time daily: - -```yaml -automation: - - alias: "Sync BSB-Lan time daily" - triggers: - - trigger: time - at: "03:00:00" - actions: - - action: bsblan.sync_time -``` From 2b7dfabf64d469e8fd3cef9696f30760dc7f618d Mon Sep 17 00:00:00 2001 From: Willem-Jan van Rootselaar Date: Thu, 1 Jan 2026 22:25:56 +0000 Subject: [PATCH 3/4] Update BSB-Lan integration documentation for clarity and accuracy --- source/_integrations/bsblan.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/bsblan.markdown b/source/_integrations/bsblan.markdown index 05ff24c8400a..0ac00f0da838 100644 --- a/source/_integrations/bsblan.markdown +++ b/source/_integrations/bsblan.markdown @@ -79,18 +79,18 @@ Time slots are defined using time pickers for easy configuration without manual ### Action `bsblan.sync_time` -Synchronizes the time on your BSB-Lan device with Home Assistant's system time. This action compares the device time with Home Assistant's time and only updates the device if there is a difference, helping maintain accurate timestamps for your heating system logs and schedules. +Synchronize Home Assistant time to the BSB-Lan device. Only updates if device time differs from Home Assistant time. {% configuration_basic %} Target: - description: Select the BSB-Lan device to sync. If no device is selected, all BSB-Lan devices will be synchronized. + description: The BSB-LAN device to sync time for. {% endconfiguration_basic %} **Action data attributes:** | Data attribute | Optional | Description | | -------------- | -------- | ----------- | -| `device_id` | yes | The device ID of a specific BSB-Lan device. If provided, only that device will be synced. | +| `device_id` | yes | The BSB-LAN device to sync time for. | **Examples:** From 8991f8386c2fabf6b80c25912a22f398cf41c452 Mon Sep 17 00:00:00 2001 From: Willem-Jan van Rootselaar Date: Thu, 1 Jan 2026 22:44:46 +0000 Subject: [PATCH 4/4] Refine time synchronization action documentation for BSB-Lan integration --- source/_integrations/bsblan.markdown | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/source/_integrations/bsblan.markdown b/source/_integrations/bsblan.markdown index 0ac00f0da838..55599d1939d6 100644 --- a/source/_integrations/bsblan.markdown +++ b/source/_integrations/bsblan.markdown @@ -81,16 +81,9 @@ Time slots are defined using time pickers for easy configuration without manual Synchronize Home Assistant time to the BSB-Lan device. Only updates if device time differs from Home Assistant time. -{% configuration_basic %} -Target: - description: The BSB-LAN device to sync time for. -{% endconfiguration_basic %} - -**Action data attributes:** - -| Data attribute | Optional | Description | -| -------------- | -------- | ----------- | -| `device_id` | yes | The BSB-LAN device to sync time for. | +- **Target**: `device_id` + - **Description**: The BSB-LAN device to sync time for. + - **Required**: Yes **Examples:**