reTerminal E10xx 与 ESPHome 配合 Home Assistant 使用

立即获取 🖱️

Home Assistant 简介

Home Assistant 是一个功能强大的开源家庭自动化平台，允许您从单一统一界面控制和监控智能家居设备。它充当智能家居的中央枢纽，使您能够自动化日常任务、监控传感器并创建更智能的生活空间。

为什么选择 Home Assistant？

本地控制：与许多基于云的解决方案不同，Home Assistant 在您的网络上本地运行，确保您的数据保持私密，即使没有互联网连接，您的自动化功能也能正常工作。
广泛的设备支持：Home Assistant 集成了数千种不同的智能家居设备和服务，使其具有高度的通用性和面向未来的特性。
强大的自动化功能：创建复杂的自动化规则，可以响应各种触发器，如时间、设备状态、传感器读数等。
可定制的仪表板：设计您自己的用户界面，显示对您最重要的信息。

了解更多 🖱️

为什么 reTerminal E10xx 适合与 Home Assistant 配合使用？

reTerminal E10xx 是 Home Assistant 的绝佳伴侣，原因如下：

节能高效：电子纸显示屏仅在更新内容时消耗电力，非常适合显示持久信息，如天气预报、日历事件或系统状态。
清晰可见：与 LCD 屏幕不同，电子纸显示屏在任何光照条件下都易于阅读，包括直射阳光，使其成为壁挂式家庭控制面板的理想选择。
长电池续航：结合深度睡眠模式，显示屏可以在单次电池充电下运行数月，同时仍能提供一目了然的有价值信息。
灵活集成：通过 ESPHome，显示屏与 Home Assistant 无缝集成，允许您以优雅、始终可见的格式显示智能家居系统中的任何数据。

这些优势使 reTerminal E10xx 成为为您的 Home Assistant 设置创建节能、始终在线信息显示屏的理想选择。

ESPHome 集成

ESPHome 是专为 ESP8266/ESP32 设备设计的开源固件创建工具。它允许您使用简单的 YAML 配置文件创建自定义固件，然后可以刷写到您的设备上。对于 reTerminal E10xx，ESPHome 充当重要的中间件，实现设备与 Home Assistant 之间的通信。

该系统通过将您的 YAML 配置转换为在 ESP 设备上运行的功能齐全的固件来工作。该固件处理连接到网络、与 Home Assistant 通信以及控制电子纸显示屏的所有复杂任务。当与 Home Assistant 结合使用时，ESPHome 为创建复杂的家庭自动化显示屏和控制器提供了强大的平台。

让我们探索如何设置并充分利用这个多功能显示屏。

开始使用

在本文教程内容开始之前，您可能需要准备以下硬件。

所需材料

reTerminal E10xx	Home Assistant Green

立即获取 🖱️	立即获取 🖱️

Home Assistant Green 是自动化您家庭的最简单且最注重隐私的方式。它提供轻松的设置，让您只需一个系统就能控制所有智能设备，默认情况下所有数据都存储在本地。这款板子受益于蓬勃发展的 Home Assistant 生态系统，并且每月都会通过开源得到改进。

我们建议在本教程中使用 Home Assistant Green 作为 Home Assistant 主机，或者您可以使用任何带有 Supervisor 的 Home Assistant 主机。

安装 Home Assistant

我们还为一些 Seeed Studio 产品编写了如何安装 Home Assistant 的教程，请参考它们。

如果您没有使用 Seeed Studio 产品，您也可以在官方 Home Assistant 网站上查看并学习如何为其他产品安装 Home Assistant。

Home Assistant 安装

步骤 1. 安装 ESPHome

note

如果您已经安装了 ESPHome，可以跳过此步骤。

转到 Settings -> Add-ons -> ADD-ON STORE

输入搜索词 ESPHome。

点击 INSTALL 和 START。

tip

如果您在附加组件商店中找不到 ESPHome，请确保您使用的是支持附加组件的 Home Assistant 安装（如 Home Assistant OS 或监督安装）。对于其他安装类型（如 Home Assistant Container），您可能需要使用 Docker 独立运行 ESPHome Device Builder。有关更多详细信息，请参阅官方 ESPHome 文档。

步骤 2. 添加新设备

转到 ESPHome 并点击 NEW DEVICE。

给设备起一个您喜欢的名称，选择 ESP32-S3 作为芯片类型，然后点击 SKIP。

创建新设备后，点击 EDIT。

在默认生成的代码中，esp32 的框架可能是 esp-idf，我们需要将其更改为 arduino。

步骤 3. 安装固件

这是一个非常基本的示例，将在显示屏上显示"Hello World!"。

主要目的是向您展示将固件安装到设备的不同方法。

您可以通过复制下面的代码并将其粘贴到 Yaml 文件中 captive_portal 代码行之后来使用此示例。

# define font to display words
font:
  - file: "gfonts://Inter@700"
    id: font1
    size: 24

# define SPI interface
spi:
  clk_pin: GPIO7
  mosi_pin: GPIO9

display:
  - platform: waveshare_epaper
    id: epaper_display
    model: 7.50inv2
    cs_pin: GPIO10
    dc_pin: GPIO11
    reset_pin:
      number: GPIO12
      inverted: false
    busy_pin:
      number: GPIO13
      inverted: true
    update_interval: 30s
    lambda: |-
      it.print(0, 0, id(font1), "Hello World!");

点击 INSTALL 将代码安装到设备，您将看到以下图像。

Install through browser
Install through host
Install through Wi-Fi

tip

如果您的 Home Assistant 主机（Raspberry PI/Green/Yellow 等）离您很远，我们建议使用此方法。您可以使用手头的计算机进行安装。

首先，您需要点击 Manual download 来下载编译好的固件。

打开这个网站，我们将在这里上传固件到电子纸面板。

回到 ESPHome 下载固件。

选择 Factory 格式。

使用 USB 线缆 将电子纸面板连接到您的计算机 并点击 CONNECT。

选择 usbmodemxxx（Windows 是 COMxxx）并点击连接。遇到问题？点击这里。

点击 INSTALL 并选择您刚刚下载的固件。

稍等片刻，您将在显示屏上看到 'Hello world!' ～

tip

这是最简单的方法，但前提是在第一次安装程序时，您应该首先使用左侧的方法将程序上传到电子纸面板。之后，您可以通过 wifi 上传。另外，请确保您的 YAML 配置包含正确配置的 ota 和 api 部分以及有效的加密密钥，这样此方法才能工作。

通过这种方式，您不需要将电子纸面板连接到任何设备，只需确保它在线即可。

点击选项，然后固件将自动安装到电子纸面板。

稍等片刻，您将看到如下图所示的反馈。如果失败，可能是由于信号较弱。请将设备移近您的路由器。遇到问题？点击这里。

在 ESPHome 中绘图的基础知识

绘制简单图形

这个示例 YAML 代码为 ESPHome 项目配置了 SPI 接口和 reTerminal E10xx。lambda 部分包含在屏幕上渲染简单形状的绘图命令：

两个矩形（一个位于位置 (10, 10)，大小为 100x50，另一个位于 (150, 10)，大小为 50x50）
一个位于 (250, 35) 的圆，半径为 25
两个填充矩形（位于 (10, 80) 和 (150, 80)）
一个位于 (250, 105) 的填充圆，半径为 25

您可以通过复制下面的代码并将其粘贴到 Yaml 文件中 captive_portal 代码行之后来使用此示例。

spi:
  clk_pin: GPIO7
  mosi_pin: GPIO9

display:
  - platform: waveshare_epaper
    id: epaper_display
    model: 7.50inv2
    cs_pin: GPIO10
    dc_pin: GPIO11
    reset_pin:
      number: GPIO12
      inverted: false
    busy_pin:
      number: GPIO13
      inverted: true
    update_interval: 30s
    lambda: |-
      it.rectangle(10, 10, 100, 50);
      it.rectangle(150, 10, 50, 50);
      it.circle(250, 35, 25);
      it.filled_rectangle(10, 80, 100, 50);
      it.filled_rectangle(150, 80, 50, 50);
      it.filled_circle(250, 105, 25);

当您看到如下图所示的反馈时，说明代码运行成功。

由于篇幅限制，我们不会过多阐述其他图案的绘制方法和原理，如有需要，建议读者阅读 ESPHome 这部分的详细示例。

从 Home Assistant 获取值用于显示

要在您的 reTerminal E10xx 设备上显示天气数据，您需要从 Home Assistant 访问温度、天气状况和风速数据。Open-Meteo 集成提供可靠的天气数据，可以通过开发者工具访问。

安装 Open-Meteo 集成

步骤 1. 打开您的 Home Assistant 仪表板并导航到设置 → 设备和服务。

步骤 2. 点击右下角的 添加集成 按钮。

步骤 3. 搜索 "Open-Meteo" 并从列表中选择它。

步骤 4. 按照配置向导设置您的位置和首选单位。

步骤 5. 安装完成后，Open-Meteo 集成将在您的 Home Assistant 实例中创建几个与天气相关的实体。

在开发者工具中访问天气数据

安装 Open-Meteo 集成后，您可以通过开发者工具访问天气数据：

步骤 1. 在您的 Home Assistant 仪表板中，导航到 开发者工具 → 状态。

步骤 2. 在过滤框中，输入 weather 来查找主要的天气实体。

步骤 3. 点击实体以查看所有可用属性。关键的天气属性包括：

temperature：当前温度（以您配置的单位）
wind_bearing：风向
wind_speed：风速

在 ESPHome 中使用天气数据

要在您的 reTerminal E10xx 的 ESPHome 配置中使用此天气数据，您需要在 ESPHome YAML 配置中设置 Home Assistant API 连接：

# 检索天气数据的示例 ESPHome 配置
# 从 HA 获取信息，字符串格式
text_sensor:
  - platform: homeassistant
    entity_id: weather.home
    id: myWeather
    internal: true
  - platform: homeassistant
    entity_id: weather.home
    id: myTemperature
    attribute: "temperature"
    internal: true

# 从 HA 获取信息，浮点格式
sensor:
  - platform: homeassistant
    entity_id: weather.home
    id: myWindBearing
    attribute: "wind_bearing"
    internal: true

此配置在您的 ESPHome 设备中创建传感器实体，从 Home Assistant 天气集成中提取数据。然后您可以使用这些传感器来更新您的 reTerminal E10xx 显示屏上的当前天气信息。

tip

对于预报数据，您需要使用包含未来几天预测值的 weather.open_meteo_forecast 实体。

最后，添加显示部分的代码以使用上述这些值。完整代码如下：

# 检索天气数据的示例 ESPHome 配置
# 从 HA 获取信息，字符串格式
text_sensor:
  - platform: homeassistant
    entity_id: weather.home
    id: myWeather
    internal: true
  - platform: homeassistant
    entity_id: weather.home
    id: myTemperature
    attribute: "temperature"
    internal: true

# 从 HA 获取信息，浮点格式
sensor:
  - platform: homeassistant
    entity_id: weather.home
    id: myWindBearing
    attribute: "wind_bearing"
    internal: true

font:
  - file: "gfonts://Inter@700"
    id: myFont
    size: 24

# 定义 SPI 接口
spi:
  clk_pin: GPIO7
  mosi_pin: GPIO9

display:
  - platform: waveshare_epaper
    id: epaper_display
    model: 7.50inv2
    cs_pin: GPIO10
    dc_pin: GPIO11
    reset_pin:
      number: GPIO12
      inverted: false
    busy_pin:
      number: GPIO13
      inverted: true
    update_interval: 30s
    lambda: |-
      //在日志中打印信息
      ESP_LOGD("epaper", "weather: %s", id(myWeather).state.c_str());
      ESP_LOGD("epaper", "temperature: %s", id(myTemperature).state.c_str());
      ESP_LOGD("epaper", "pressure: %.1f", id(myWindBearing).state);
      //在电子纸屏幕上显示信息
      it.printf(100, 100, id(myFont), "%s", id(myWeather).state.c_str());
      it.printf(100, 150, id(myFont), "%s", id(myTemperature).state.c_str());
      it.printf(100, 200, id(myFont), "%.1f", id(myWindBearing).state);

编译上述代码并上传到您的设备后，您可能首先会看到屏幕上显示 NaN，请不要担心，这是正常的。这是因为设备尚未添加到 Home Assistant 环境中，所以 reTerminal 还无法获取 Home Assistant 数据。我们只需要按照以下步骤添加设备即可。

将 reTerminal E10xx 添加到 Home Assistant

步骤 1. 刷写设备后，返回 Home Assistant 并导航到 设置 → 设备与服务。

步骤 3. Home Assistant 应该会通过 mDNS 自动发现您的 reTerminal E10xx 设备。如果它出现在已发现设备部分，请点击配置来添加它。

步骤 4. 如果设备没有自动发现，请点击添加集成并搜索"ESPHome"。

步骤 5. 输入您的 reTerminal E10xx 设备的 IP 地址，如果您设置了 API 加密密钥，也请输入。

步骤 6. 连接后，您的 reTerminal E10xx 将作为设备出现在 Home Assistant 中，其所有传感器和组件都可用。

以下是增强的演示 3 内容，具有改进的格式、图像放置和附加描述：

绘制 TrueType 字体

此示例演示如何使用 TrueType 字体在您的 reTerminal E10xx 上显示自定义图标。Material Design Icons 提供了大量可缩放的符号，非常适合电子纸显示器。

安装所需工具

步骤 1. 首先，我们需要安装 Studio Code Server 插件来管理文件。导航到 Home Assistant 插件商店，搜索 Studio Code Server 并点击它。

步骤 2. 点击安装并等待安装完成。安装完成后，点击启动来启动编辑器。

设置图标字体

步骤 3. 在您的 ESPHome 配置目录中创建一个名为 fonts 的新文件夹。此文件夹将存储显示图标所需的 TrueType 字体文件。

步骤 4. 点击下面的按钮下载 Material Design Icons 字体文件并解压内容。

步骤 5. 将下载的字体文件（materialdesignicons-webfont.ttf）上传到您之前创建的 fonts 文件夹中。

为图标配置 ESPHome

步骤 6. 在 captive_portal 部分之后，将以下代码添加到您的 ESPHome 配置文件中。此代码定义了两种图标字体大小，并配置显示器显示天气图标。

font:
  - file: 'fonts/materialdesignicons-webfont.ttf'  # 字体文件路径
    id: font_mdi_large
    size: 200        # 大图标尺寸
    glyphs: &mdi-weather-glyphs
      - "\U000F0595" # weather-cloudy 图标
      - "\U000F0592" # weather-hail 图标
  - file: 'fonts/materialdesignicons-webfont.ttf'
    id: font_mdi_medium   # 中等图标尺寸
    size: 40
    glyphs: *mdi-weather-glyphs

spi:
  clk_pin: GPIO7
  mosi_pin: GPIO9

display:
  - platform: waveshare_epaper
    id: epaper_display
    model: 7.50inv2
    cs_pin: GPIO10
    dc_pin: GPIO11
    reset_pin:
      number: GPIO12
      inverted: false
    busy_pin:
      number: GPIO13
      inverted: true
    update_interval: 30s
    lambda: |-
      it.printf(100, 200, id(font_mdi_medium), TextAlign::CENTER, "\U000F0595");
      it.printf(400, 200, id(font_mdi_large), TextAlign::CENTER, "\U000F0592");

note

glyphs 部分定义了要从字体文件中加载哪些图标。仅加载您需要的图标可以节省设备内存。

步骤 7. 保存您的配置并将其上传到您的 reTerminal E10xx。当您看到如下图所示的反馈时，表示代码运行成功。

使用不同图标进行自定义

Material Design Icons 库包含数千个可在您的项目中使用的图标。以下是如何查找和使用不同图标的方法：

步骤 1. 点击下面的按钮访问 Material Design Icons 网站。

步骤 2. 搜索您想在项目中使用的图标。您可以按类别浏览或使用搜索功能。

步骤 3. 当您找到喜欢的图标时，点击它查看详细信息。查找 Unicode 值，格式为 F0595。

步骤 4. 通过以下方式将 Unicode 值添加到您的 ESPHome 配置中：

将其添加到字体配置中的 glyphs 列表
更新显示代码以使用新图标

例如，要使用 Unicode 为 F0123 的新图标：

glyphs:
  - "\U000F0595" # weather-cloudy icon
  - "\U000F0592" # weather-hail icon
  - "\U000F0123" # your new icon

在显示 lambda 中：

lambda: |-
  it.printf(100, 200, id(font_mdi_medium), TextAlign::CENTER, "\U000F0123");

步骤 5. 保存更新的配置并将其上传到您的设备以查看新图标。

tip

对于天气仪表板，考虑使用诸如 F0590（晴天）、F0591（多云）、F0593（雨天）和 F059E（有风）等图标。

通过将这些图标与我们之前设置的来自 Home Assistant 的天气数据相结合，您可以创建一个动态天气显示，使用适当的图标显示当前条件。

显示自定义图像

此示例演示如何在您的 reTerminal E10xx 电子纸显示屏上显示自定义图像。您可以使用此功能显示徽标、图标或任何增强仪表板体验的图形。

准备工作

步骤 1. 确保您已在 Home Assistant 中安装了 Studio Code Server 插件。如果您尚未安装，请按照前面示例中的说明进行操作。

步骤 2. 在您的 ESPHome 配置目录中创建一个名为 image 的新文件夹。此文件夹将存储您要显示的图像文件。

config/
└── esphome/
    ├── your_device.yaml
    └── image/         <- Create this folder

添加图像

步骤 3. 下载一个示例图像来测试功能。您可以使用下面提供的 WiFi 图标或使用您自己的图像。

步骤 4. 使用 Studio Code Server 文件管理器将下载的图像上传到您之前创建的 image 文件夹。

tip

为了在电子纸显示屏上获得最佳效果，请使用具有清晰黑白区域的高对比度图像。支持 JPG 和 PNG 格式。

配置 ESPHome 进行图像显示

步骤 5. 在 captive_portal 部分之后，将以下代码添加到您的 ESPHome 配置文件中。此代码定义图像资源并配置显示屏以显示它。

image:
  - file: /config/esphome/image/wifi.jpg    # Path to your image file (JPG or PNG)
    id: myImage
    type: BINARY                            # Binary mode works best for e-paper
    resize: 800x480                         # Resize to match display resolution
    invert_alpha: true                      # Invert colors if needed

spi:
  clk_pin: GPIO7
  mosi_pin: GPIO9

display:
  - platform: waveshare_epaper
    id: epaper_display
    model: 7.50inv2
    cs_pin: GPIO10
    dc_pin: GPIO11
    reset_pin:
      number: GPIO12
      inverted: false
    busy_pin:
      number: GPIO13
      inverted: true
    update_interval: 30s
    lambda: |-
      it.image(0, 0, id(myImage));          # Display image at position (0,0)

步骤 6. 保存您的配置并将其上传到您的 reTerminal E10xx。更新完成后，您的电子纸显示屏将显示图像。

高级图像技术

您可以使用这些附加技术增强图像显示：

定位图像

要将图像定位在屏幕上的特定坐标：

lambda: |-
  // Display image at position (100,50)
  it.image(100, 50, id(myImage));

将图像与文本结合

您可以在同一屏幕上显示图像和文本：

lambda: |-
  // Display image
  it.image(0, 0, id(myImage));
  
  // Add text below or beside the image
  it.printf(400, 400, id(font1), TextAlign::CENTER, "WiFi Connected");

使用多个图像

要在同一屏幕上显示多个图像，请在配置中定义每个图像：

image:
  - file: /config/esphome/image/wifi.jpg
    id: wifiImage
    type: BINARY
    resize: 200x200
  
  - file: /config/esphome/image/temperature.png
    id: tempImage
    type: BINARY
    resize: 200x200

# In the display lambda:
lambda: |-
  it.image(50, 50, id(wifiImage));
  it.image(300, 50, id(tempImage));

caution

请记住，电子纸显示屏的刷新率有限。update_interval: 30s 设置意味着您的显示屏只会每 30 秒刷新一次。根据您的需要调整此值，但请注意频繁刷新可能会缩短电子纸显示屏的使用寿命。

通过将图像与前面示例中涵盖的文本和其他显示元素相结合，您可以在 reTerminal E10xx 上创建丰富、信息丰富的仪表板。

继续阅读

由于篇幅限制，本文仅涵盖了设备的一些基本用例和绘图示例。我们将在 reTerminal E10xx 在 Home Assistant 中的高级 ESPHome 使用的 Wiki 中更详细地介绍 reTerminal 硬件在 ESPHome 上的使用，您可以继续阅读。

FAQ

Q1: 为什么没有数据？

在这种情况下，您应该转到设置 -> 设备和服务 -> 集成来重新配置设备。没有找到您的 reTerminal？尝试重启 Home Assistant。

Q2: 为什么我无法在 Home Assistant 中获取这些数据？

在这种情况下，您应该转到设置 -> 设备和服务 -> 集成来添加您的设备到 HA。

Q3: reTerminal E10xx 无法连接到您的计算机？

尝试多次拔插，或者根据提示安装驱动程序。

技术支持与产品讨论

感谢您选择我们的产品！我们在这里为您提供不同的支持，以确保您使用我们产品的体验尽可能顺畅。我们提供多种沟通渠道，以满足不同的偏好和需求。

Home Assistant 简介​

为什么选择 Home Assistant？​

为什么 reTerminal E10xx 适合与 Home Assistant 配合使用？​

ESPHome 集成​

开始使用​

所需材料​

步骤 1. 安装 ESPHome​

步骤 2. 添加新设备​

步骤 3. 安装固件​

在 ESPHome 中绘图的基础知识​

绘制简单图形​

从 Home Assistant 获取值用于显示​

安装 Open-Meteo 集成​

在开发者工具中访问天气数据​

在 ESPHome 中使用天气数据​

将 reTerminal E10xx 添加到 Home Assistant​

绘制 TrueType 字体​

安装所需工具​

设置图标字体​

为图标配置 ESPHome​

使用不同图标进行自定义​

显示自定义图像​

准备工作​

添加图像​

配置 ESPHome 进行图像显示​

高级图像技术​

继续阅读​

FAQ​

Q1: 为什么没有数据？​

Q2: 为什么我无法在 Home Assistant 中获取这些数据？​

Q3: reTerminal E10xx 无法连接到您的计算机？​

技术支持与产品讨论​