PCF8563 时间源

您首先需要设置 I2C 组件。

# 示例配置条目
time:
  - platform: pcf8563
    id: pcf8563_time

配置变量

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

pcf8563.write_time 动作

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

NOTE

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

on_...:
  - pcf8563.write_time

  # 如果您需要指定 PCF8563 id
  - pcf8563.write_time:
      id: pcf8563_time

pcf8563.read_time 动作

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

NOTE

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

on_...:
  - pcf8563.read_time

  # 如果您需要指定 PCF8563 id
  - pcf8563.read_time:
      id: pcf8563_time

完整配置示例

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

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

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