BM8563 时间源

您首先需要设置 I2C 组件。

# 示例配置条目
time:
  - platform: bm8563
    id: bm8563_time

配置变量

• address (可选, int)：手动指定 RTC 的 I²C 地址。默认为 0x51。
• 基本时间配置的所有其他选项。

bm8563.write_time 动作

此 动作 触发将当前系统时间同步到 RTC 硬件。

NOTE

BM8563 组件不会写入 RTC 时钟，除非由此动作显式触发。

on_...:
  - bm8563.write_time

  # 如果您需要指定 BM8563 id
  - bm8563.write_time:
      id: bm8563_time

bm8563.read_time 动作

此 动作 触发从 RTC 硬件同步当前系统时间。

NOTE

BM8563 组件默认每 15 分钟自动读取 RTC 时钟，并在从 RTC 读取到有效时间戳时同步系统时钟。（可以更改 update_interval。）此动作用于触发额外的同步。

on_...:
  - bm8563.read_time

  # 如果您需要指定 BM8563 id
  - bm8563.read_time:
      id: bm8563_time

bm8563.start_timer 动作

此 动作 启动 RTC 定时器。

on_...:
  - bm8563.start_timer:
      duration: 60s

  # 如果您需要指定 BM8563 id
  - bm8563.start_timer:
      id: bm8563_time
      duration: 60s

配置选项：

• duration (必填, 时间)：定时器的时间持续时间。
• id (可选, ID)：如果您有多个组件，手动指定 BM8563 组件的 ID。

完整配置示例

在典型设置中，您至少会有一个额外的时间源来同步 RTC。这种外部时间源可能并不总是可用，例如由于网络连接受限。为了获得有效、可靠的系统时间，系统应在启动时读取一次 RTC，然后尝试与外部可靠时间源同步。当成功同步到另一个时间源时，可以重新同步 RTC。

esphome:
  on_boot:
    then:
      # 系统启动时读取一次 RTC 时间
      bm8563.read_time:

time:
  - platform: bm8563
    # 除非外部 RTC 比内部时钟精确得多，否则不需要重复同步
    update_interval: never
  - platform: homeassistant
    # 而是尝试通过网络重复同步 ...
    on_time_sync:
      then:
        # ... 并在同步成功时更新 RTC
        bm8563.write_time:

另请参阅

• I2C 总线
• 时间组件
• 深度睡眠组件