跳转到内容
ESPHome - 让智能家居更简单2026.7.0

Uponor Smatrix Base Pulse 地板供暖

Uponor Smatrix 组件允许你在 ESPHome 中集成 Uponor Smatrix Base Pulse 地板供暖控制系统，而无需使用 Smatrix Pulse Com R-208 通信模块。 它通过 RS485 恒温器总线直接与控制器和恒温器通信。

连接到总线

Section titled “连接到总线”

此组件能够直接与 RS485 恒温器总线通信。为此，你需要将一个 RS485 转 TTL 转换器连接到你的 ESPHome 设备的一个 UART 总线上。

转换器的 RS485 一侧可以连接到控制器或恒温器上的任意一个 A/B 端子。 +/- 端子提供 5 伏电压，可用于为你的 ESPHome 设备供电。

UART 组件 必须配置为波特率 19200、8 个数据位、无校验、1 个停止位。

入门

Section titled “入门”

恒温器有用于通信的唯一地址，这些地址不会在任何地方显示，只能在扫描总线时找到。 从仅包含 UART 和 Uponor 中心组件的基本配置开始。确保 UART 引脚已根据你的接线进行配置，且波特率设置为 19200。

uponor_smatrix:

当你将此配置上传到你的 ESPHome 设备并将其连接到 Uponor Smatrix 总线时，它会在日志输出中打印检测到的地址列表。

[00:00:00][C][uponor_smatrix:020]: Uponor Smatrix
[00:00:00][C][uponor_smatrix:031]:   Detected unknown device addresses:
[00:00:00][C][uponor_smatrix:033]:     0x110BDE62
[00:00:00][C][uponor_smatrix:033]:     0x110BDDFF
[00:00:00][C][uponor_smatrix:033]:     0x110BDE72
[00:00:00][C][uponor_smatrix:033]:     0x110BDE4A
[00:00:00][C][uponor_smatrix:033]:     0x110BDE13

有了这些，你就可以为检测到的设备添加 climate 或 sensor 组件。

uponor_smatrix:


climate:
  - platform: uponor_smatrix
    address: 0x110BDE13
    name: Thermostat Living Room

IMPORTANT

组件的早期版本在 16 位设备地址之外还使用了一个 16 位系统地址。 现在已将这些合并为 32 位设备地址。 请通过在设备地址前添加旧的系统地址来更新你的配置。 示例： 系统地址 0x110B 和设备地址 0xDE13 现在应成为 0x110BDE13。

组件/中心

Section titled “组件/中心”

主 uponor_smatrix 组件负责与控制器和恒温器的通信，并将数据分发给下面描述的 climate 和 sensor 组件。

它还能够在系统中存在可以按时间表编程的恒温器时，将恒温器的日期和时间与时间源同步。

uponor_smatrix:
  uart_id: my_uart
  time_id: my_time

配置变量

Section titled “配置变量”
  • uart_id (可选, ID): 如果你想使用多个 UART 总线，可手动指定 UART 组件 的 ID。
  • time_id (可选, ID): 如果你想让 ESPHome 自动 同步恒温器的日期和时间，请指定 时间组件 的 ID 作为时间源。
  • time_device_address (可选, int): 保存系统时间的恒温器的 32 位设备地址。 如果未指定，将从总线自动检测。 它必须是第一个配对到控制器的恒温器的设备地址，也是你可以通过恒温器上的按钮手动更改日期和时间的恒温器。

NOTE

如果配置中未指定，保存时间的恒温器地址将从总线自动检测！ 在几乎所有情况下都可以放心地省略它。只要在配置中添加任何时间组件，时间同步就应该自动工作。

Climate

Section titled “Climate”
climate:
  - platform: uponor_smatrix
    address: 0x110BDE13
    name: Thermostat Living Room

配置变量

Section titled “配置变量”
  • address (必选, int): 恒温器的 32 位设备地址。 参见 入门 以了解如何查找地址。
  • uponor_smatrix_id (可选, ID): 如果你想在一个 ESPHome 设备上使用多个中心组件，可手动指定 uponor_smatrix 中心组件的 ID。
  • 所有选项来自 Climate。

Sensor

Section titled “Sensor”
sensor:
  - platform: uponor_smatrix
    address: 0x110BDE13
    humidity:
      name: Humidity Living Room
    temperature:
      name: Temperature Living Room
    external_temperature:
      name: Floor Temperature Living Room
    target_temperature:
      name: Thermostat Target Temperature Living Room

配置变量

Section titled “配置变量”

  • address (必选, int): 恒温器的 32 位设备地址。 参见 入门 以了解如何查找地址。

  • uponor_smatrix_id (可选, ID): 如果你想在一个 ESPHome 设备上使用多个中心组件，可手动指定 uponor_smatrix 中心组件的 ID。

  • humidity (可选): 一个读取恒温器报告的当前湿度的传感器。 所有选项来自 Sensor。

  • temperature (可选): 一个读取恒温器报告的当前温度的传感器。 所有选项来自 Sensor。

  • external_temperature (可选): 一个读取恒温器报告的当前外部温度的传感器。 这来自一个可选连接的外部温度传感器，可以测量地板或室外温度。 所有选项来自 Sensor。

  • target_temperature (可选): 一个读取恒温器报告的当前设定目标温度的传感器。 所有选项来自 Sensor。

参见

Section titled “参见”