ESPHome E-ink Dashboard

感謝Madelena提供本專案硬體架構與程式碼的發想

Thanks Madelena for inspired this project ideas and source code of weather data

本專案的E-ink資訊板放在玄關處，在指定的時段內每15分鐘，會自動更新顯示內容

另有直式只顯示日期與天氣資訊，可參考E-ink weather board

資訊板顯示內容包括:

• 今天日期
• 各房間溫溼度
• 當下天氣預報
• 未來四小時天氣預報

以下將說明硬體架構、ESPHome yaml code與Home assistant yaml code

Hardware 硬體架構

• 微雪 7.5吋黑白墨水屏裸屏 - 不帶外殼
• 微雪 墨水屏裸屏 SPI驅動板 ESP32 - wifi+藍牙版本(ESP32)
• IKEA RÖDALM 相框 13x18公分 - 外框有木黑白三色，注意裱框紙開孔較小，需要挖大

Installation 安裝方式

1. 將/fonts資料夾內的檔案及esp32-eink-dashboard.yaml放到HA/config/esphome的資料夾內
2. 將eink_dashboard_sensor.yaml放到HA/config/packages內
3. 將esp32-eink-dashboard.yaml及eink_dashboard_sensor.yaml的內容修改成自己HA裡的實體ID，解說在下方
4. HA檢查YAML code有無錯誤
   1. 開發工具>YAML>檢查設定內容，確認左下角通知沒有出現錯誤
   2. YAML 設定新載入中>模板實體
   3. 開發工具>狀態>檢查sensor.eink_sensors有確實出現，以及內容是自己想要的
5. 在ESPhome將esp32-eink-dashboard.yaml燒錄至ESP32模組
6. 完成!

ESPHome yaml 說明

在HA內手動更新面板

button:
  - platform: template
    name: '${devicename} Refresh'
    icon: 'mdi:update'
    on_press:
      then:
        - component.update: 'my_display'
    internal: false

將HA的時間帶進ESPHome

time:
  - platform: homeassistant
    id: ha_time

根據來自HA的binary sensor來決定現在是否要更新面板，晚上睡覺無人時就不用更新以延長面板壽命

binary_sensor:
  - platform: homeassistant
    id: 'eink_refresh'
    entity_id: 'binary_sensor.eink_refresh_time'

面板更新時機

因為預設螢幕不會自動更新update_interval: never，是當資料都差不多收到後就執行腳本來更新內容，流程如下:

1. 等這個sensor有接收到資料後就執行腳本:

  - platform: homeassistant
    entity_id: sensor.eink_sensors
    attribute: forecast_temperature_4
    id: forecast_temperature_4
    on_value: 
      then:
        - script.execute: all_data_received 

2. 執行all_data_received腳本，每15分鐘會重複執行此腳本且當binary_sensor是on才會更新面板

script:
  - id: all_data_received
    mode: single
    then:
      - if:
          condition:
            binary_sensor.is_on: 'eink_refresh'
          then:
            - component.update: 'my_display'
      - delay: 15min
      - script.execute: all_data_received

HA template sensor 說明

要先確認在已經將以下程式碼寫在configuration.yaml內，這樣eink_dashboard_sensor.yaml檔案放進去才會生效

由於天氣預報是weather類型，非sensor類型，沒辦法直接丟給ESPHome處理，所以利用此template sensor

將想要的資料格式化後再丟給ESPHome顯示，weather.myhome是我用的天氣預報實體名稱，請記得更換成自己的ID

在HA 2023.12之後，天氣預報改由呼叫service來取得未來的資訊，所以利用此template sensor將想要的資料格式化後再丟給天氣板顯示

由於預設是顯示取得每小時的預報，請先確認目前用的天氣整合有支援小時預報 (內建的met.no有)

以下YAML表示每小時的1分將會呼叫取得"每小時"的天氣預報服務，同時更新內容在sensor.eink_sensors裡面

要注意更新面板的時機要在更新天氣預報之後，不然都會看到前一個小時的預報

  - trigger:
      - platform: time_pattern     
        hours: "/1" 
        minutes: 1
    action:
      - service: weather.get_forecasts
        target:
          entity_id: weather.myhome #replace with your weather forecast entity id
        data:
          type: hourly
        response_variable: hourly  

attributes是將要使用的資訊從天氣預報拆分成出來，分別是:

• 這小時的氣溫: today_temperature
• 未來四小時的時間: forecast_weekday_1, forecast_weekday_2, forecast_weekday_3, forecast_weekday_4
• 未來四小時的天氣圖示: forecast_condition_1, forecast_condition_2, forecast_condition_3, forecast_condition_4
• 未來四小時的氣溫: forecast_temperature_1, forecast_temperature_2, forecast_temperature_3, forecast_temperature_4

References

• https://github.com/Madelena/esphome-weatherman-dashboard/