staircase-light: add second PIR sensor

creality_cfs reads the Creality tags of the spools, sends their record
to Home Assistant (esphome.creality_cfs) and writes them through the
creality_cfs_write action; the success tune gets a valid default
duration.

.github/workflows/ci.yml

@@ -10,35 +10,42 @@ jobs:
     name: YAML lint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - name: Get changed YAML files
         id: changed
-        uses: tj-actions/changed-files@v46
+        uses: tj-actions/changed-files@v47
         with:
           files: "**/*.yaml"
 
-      - uses: ibiqlik/action-yamllint@v3
+      # yamllint straight from pip: Gitea's runner image doesn't ship it like GitHub's does
+      - name: Lint changed YAML files
         if: steps.changed.outputs.any_changed == 'true'
-        with:
-          config_file: .yamllint.yml
-          file_or_dir: ${{ steps.changed.outputs.all_changed_files }}
+        env:
+          PIP_BREAK_SYSTEM_PACKAGES: "1"
+        run: |
+          pip install --ignore-installed yamllint
+          yamllint -c .yamllint.yml -f parsable ${{ steps.changed.outputs.all_changed_files }}
 
   validate:
     name: ESPHome config validation
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - name: Get changed device configs
         id: changed
-        uses: tj-actions/changed-files@v46
+        uses: tj-actions/changed-files@v47
         with:
           files: "mcu-*.yaml"
 
       - name: Install ESPHome (dev)
         if: steps.changed.outputs.any_changed == 'true'
-        run: pip install git+https://github.com/esphome/esphome.git@dev
+        # Gitea's runner image marks the system Python as externally managed (PEP 668)
+        # and has Debian packages pip can't uninstall (pyparsing), so don't touch them
+        env:
+          PIP_BREAK_SYSTEM_PACKAGES: "1"
+        run: pip install --ignore-installed git+https://github.com/esphome/esphome.git@dev
 
       - name: Prepare secrets
         if: steps.changed.outputs.any_changed == 'true'
@@ -48,6 +55,8 @@ jobs:
         if: steps.changed.outputs.any_changed == 'true'
         run: |
           for f in ${{ steps.changed.outputs.all_changed_files }}; do
+            # zephyr: needs the esphomeplatformzephyr fork, upstream doesn't know it yet
+            if grep -q '^zephyr:' "$f"; then echo "Skipping $f (zephyr fork)"; continue; fi
             echo "Validating $f..."
             esphome config "$f"
           done

.gitignore

@@ -2,7 +2,7 @@
 # This is an example and may include too much for your use-case.
 # You can modify this file to suit your needs.
 /.claude/
-/.esphome/
+.esphome/
 /secrets.yaml
 /archive/
 /trash/

.yamllint.yml

@@ -25,3 +25,7 @@ rules:
 
   comments:
     require-starting-space: false
+
+  # Aligned values (e.g. the bedroom lamp presets) are intentional
+  colons:
+    max-spaces-after: -1

common/esp8266_mdns_ipv6.yaml

@@ -0,0 +1,10 @@
+---
+# ESP8266 core with LEAmDNS announcing the IPv6 addresses (AAAA, ff02::fb) from
+# randybb/Arduino@mdns-ipv6-aaaa (esp8266/Arduino#9068); add next to common_esp8266.yaml.
+# The device must not set 'toolchain: arduino' (no custom framework source there).
+# Drop once it's upstream and in an ESPHome release.
+esp8266:
+  toolchain: platformio
+  framework:
+    version: 3.1.2
+    source: https://github.com/randybb/Arduino.git#mdns-ipv6-aaaa

common/ipv6_only.yaml

@@ -3,36 +3,12 @@
 #   packages:
 #     common: !include common/common.yaml
 #     ipv6_only: !include common/ipv6_only.yaml
-external_components:
-  # network enable_ipv4 (esphome/esphome#19750), drop once merged
-  - source: github://pr#19750
-    components: [const, network, wifi]
-  # audio HTTP reader over IPv6 (dual-stack hosts resolve A first), drop once in #19750
-  - source: github://randybb/esphome-components
-    components: [audio]
-    refresh: 1h
+# Ethernet devices use common/ipv6_only_eth.yaml (this without the WiFi part)
+packages:
+  base: !include ipv6_only_eth.yaml
 
 wifi:
   networks:
     - id: !extend wifi_iot
       ssid: !secret wifi_ssid_ipv6
       password: !secret wifi_password_ipv6
-
-esp32:
-  framework:
-    components:
-      # mdns 1.12.0 + fix for "A 0.0.0.0" without IPv4 (espressif/esp-protocols PR pending), drop once released
-      - name: espressif/mdns
-        source: https://github.com/randybb/esp-protocols.git
-        ref: mdns-v1.12.0-zero-ipv4-test
-        path: components/mdns
-      # IDF v5.5.5 lwip + .local resolution over IPv6 (espressif/esp-lwip#94), drop once in IDF
-      - name: lwip
-        source: https://github.com/randybb/esp-lwip.git
-        ref: idf-v5.5.5-lwip-component
-        path: lwip
-
-network:
-  enable_ipv6: true
-  enable_ipv4: false
-  min_ipv6_addr_count: 1

common/ipv6_only_eth.yaml

@@ -0,0 +1,29 @@
+---
+# IPv6-only IoT network (SLAAC, no DHCPv4) for ethernet devices; add next to a common package:
+#   packages:
+#     common_eth: !include common/common_eth.yaml
+#     ipv6_only: !include common/ipv6_only_eth.yaml
+# WiFi devices use common/ipv6_only.yaml (this + the IPv6 SSID)
+external_components:
+  # network enable_ipv4 + audio HTTP reader over IPv6 (esphome/esphome#19750), drop once merged
+  - source: github://pr#19750
+    components: [const, network, wifi, ethernet, audio]
+    refresh: 1h
+
+esp32:
+  framework:
+    components:
+      # mdns 1.14.0: no "A 0.0.0.0" without IPv4 + IPv6 on ETH-only builds (espressif/esp-protocols#1156, #1161),
+      # drop once on ESPHome 2026.10.0 (esphome/esphome#20383 bumps the pin from 1.12.0)
+      - name: espressif/mdns
+        ref: 1.14.0
+      # IDF v5.5.5 lwip + .local resolution over IPv6 (espressif/esp-lwip#94), drop once in IDF
+      - name: lwip
+        source: https://github.com/randybb/esp-lwip.git
+        ref: idf-v5.5.5-lwip-component
+        path: lwip
+
+network:
+  enable_ipv6: true
+  enable_ipv4: false
+  min_ipv6_addr_count: 1

common/nspanel.yaml

@@ -28,9 +28,13 @@ esp32:
   framework:
     type: esp-idf
     advanced:
+      flash_chip: generic
       minimum_chip_revision: 3.0
       sram1_as_iram: true
 
+packages:
+  popup: !include nspanel_popup.yaml
+
 external_components:
   - source:
       type: git

common/nspanel_popup.yaml

@@ -0,0 +1,98 @@
+---
+# NSPanel popups (popupNotify page), without changes to nspanel_lovelace:
+# - OTA progress
+# - device info (version, IPs) via the show_info API action
+# Needs nspanel_lovelace (id nspanel_id), its uart (id display_uart) and the
+# ota id ota_esphome (common/ota_esp32.yaml).
+# The component doesn't track these popups; the panel either reboots (OTA)
+# or goes back to the default page afterwards.
+api:
+  actions:
+    - action: show_info
+      then:
+        - script.execute: info_popup
+
+script:
+  - id: info_popup
+    mode: restart
+    then:
+      - lambda: |-
+          char build[Application::BUILD_TIME_STR_SIZE];
+          App.get_build_time_string(build);
+          std::string msg = "ESPHome " ESPHOME_VERSION "\r\n";
+          msg += build;
+          // global/ULA first, link-local last
+          std::vector<std::string> ips;
+          for (int pass = 0; pass < 2; pass++) {
+            for (auto &ip : wifi::global_wifi_component->wifi_sta_ip_addresses()) {
+              if (!ip.is_set()) continue;
+              char buf[network::IP_ADDRESS_BUFFER_SIZE];
+              ip.str_to(buf);
+              bool ll = strncmp(buf, "fe80", 4) == 0;
+              if (ll == (pass == 1)) ips.emplace_back(buf);
+            }
+          }
+          for (auto &ip : ips) msg += "\r\n" + ip;
+          id(nspanel_id).send_display_command("pageType~popupNotify");
+          id(nspanel_id).send_display_command(
+              "entityUpdateDetail~info~" + App.get_friendly_name() + "~65535~~65535~~65535~" + msg + "~65535~15");
+      - delay: 15s
+      - lambda: 'id(nspanel_id).render_default_page();'
+
+  # OTA blocks the main loop, and nspanel_lovelace only sends its queued
+  # commands from loop(), so these frames go straight to the uart in the
+  # component's format: 55 BB, length (LE), command, CRC16 (LE).
+  - id: ota_popup
+    parameters:
+      message: string
+    then:
+      - lambda: |-
+          auto send = [](const std::string &cmd) {
+            uint8_t hdr[4] = {0x55, 0xBB, uint8_t(cmd.size() & 0xFF), uint8_t(cmd.size() >> 8)};
+            uint16_t crc = crc16(hdr, 4);
+            crc = crc16(reinterpret_cast<const uint8_t *>(cmd.data()), cmd.size(), crc);
+            uint8_t tail[2] = {uint8_t(crc & 0xFF), uint8_t(crc >> 8)};
+            id(display_uart).write_array(hdr, 4);
+            id(display_uart).write_array(reinterpret_cast<const uint8_t *>(cmd.data()), cmd.size());
+            id(display_uart).write_array(tail, 2);
+            id(display_uart).flush();
+          };
+          send("dimmode~100~100");
+          send("pageType~popupNotify");
+          send("entityUpdateDetail~ota~Aktualizácia firmvéru~65535~~65535~~65535~" + message + "~65535~0");
+
+ota:
+  - id: !extend ota_esphome
+    on_begin:
+      - script.execute:
+          id: ota_popup
+          message: Nahrávam…
+    on_progress:
+      - lambda: |-
+          static int last = -1;
+          int pct = (int) x / 10 * 10;
+          if (pct != last) {
+            last = pct;
+            id(ota_popup)->execute("Nahrávam… " + std::to_string(pct) + " %");
+          }
+    on_end:
+      - script.execute:
+          id: ota_popup
+          message: Hotovo, reštartujem
+    on_error:
+      - script.execute:
+          id: ota_popup
+          message: Aktualizácia zlyhala
+      - delay: 5s
+      - lambda: |-
+          id(nspanel_id).set_display_dim(5, 80);
+          id(nspanel_id).render_default_page();
+
+button:
+  # put button.<device>_info on a card: the panel presses it through HA
+  - platform: template
+    name: Info
+    id: info_button
+    entity_category: diagnostic
+    on_press:
+      - script.execute: info_popup

common/ota.yaml

@@ -2,3 +2,7 @@
 ota:
   - platform: esphome
     password: !secret ota_password
+    # migration to encrypted OTA (api key): once every device encrypts,
+    # remove allow_plaintext_upload together with the password
+    encryption:
+      allow_plaintext_upload: true

common/ota_esp32.yaml

@@ -1,5 +1,10 @@
 ---
 ota:
   - platform: esphome
+    id: ota_esphome
     password: !secret ota_password
+    # migration to encrypted OTA (api key): once every device encrypts,
+    # remove allow_plaintext_upload together with the password
+    encryption:
+      allow_plaintext_upload: true
     allow_partition_access: true

common/sensor/uptime.yaml

@@ -7,4 +7,3 @@ accuracy_decimals: 2
 update_interval: 60s
 filters:
   - lambda: return x / 86400;
-

common/status_led.yaml

@@ -0,0 +1,127 @@
+---
+# Status on a visible RGB light, which stays a normal light otherwise:
+#   network down         red, slow blink
+#   no API client (HA)   orange, slow blink
+#   component error      purple, steady (only with show_errors: "true", for a dedicated status LED)
+#   OTA                  blue, fast blink; green when done, 3 red blinks on error
+#   back to normal       green for 1 s, then the light goes back to how it was
+#   packages:
+#     status_led: !include
+#       file: common/status_led.yaml
+#       vars:
+#         light_id: led_light
+# Needs the ota id ota_esphome (common/ota_esp32.yaml).
+defaults:
+  brightness: "0.3"
+  show_errors: "false"  # a failed component would take over a display or a shared light for good
+
+globals:
+  - id: status_led_active
+    type: bool
+    initial_value: "false"
+  - id: status_led_saved
+    type: light::LightColorValues
+  - id: status_led_last
+    type: uint32_t
+    initial_value: "0xFFFFFFFF"
+
+script:
+  - id: status_led_show
+    parameters:
+      r: float
+      g: float
+      b: float
+      lit: bool
+    then:
+      - lambda: |-
+          auto *l = id(${light_id});
+          uint32_t key = (lit << 24) | (uint32_t(r * 255) << 16) | (uint32_t(g * 255) << 8) | uint32_t(b * 255);
+          if (!id(status_led_active)) {
+            id(status_led_saved) = l->remote_values;
+            id(status_led_active) = true;
+          } else if (key == id(status_led_last)) {
+            return;  // unchanged: don't flood Home Assistant with the same state
+          }
+          id(status_led_last) = key;
+          if (lit) {
+            l->turn_on().set_rgb(r, g, b).set_brightness(${brightness}).set_transition_length(0).set_effect("None").perform();
+          } else {
+            l->turn_off().set_transition_length(0).perform();
+          }
+          l->loop();  // write now: OTA blocks the main loop
+  - id: status_led_restore
+    parameters:
+      confirm: bool
+    then:
+      - lambda: |-
+          if (id(status_led_active) && confirm) id(status_led_show)->execute(0.0f, 1.0f, 0.0f, true);
+      - if:
+          condition:
+            lambda: 'return id(status_led_active) && confirm;'
+          then:
+            - delay: 1s  # green: back to normal
+      - lambda: |-
+          if (!id(status_led_active)) return;
+          id(status_led_active) = false;
+          id(status_led_last) = 0xFFFFFFFF;
+          id(${light_id})->make_call().from_light_color_values(id(status_led_saved)).set_transition_length(0).perform();
+
+interval:
+  - interval: 500ms
+    then:
+      - lambda: |-
+          static uint8_t tick = 0;
+          tick++;
+          bool slow = (tick / 2) % 2 == 0;  // 1 s on, 1 s off
+          bool error = ${show_errors} && (App.get_app_state() & STATUS_LED_ERROR);
+          bool problem = !network::is_connected() || !api::global_api_server->is_connected() || error;
+          if (problem) id(status_led_restore)->stop();
+          if (!network::is_connected()) {
+            id(status_led_show)->execute(1.0f, 0.0f, 0.0f, slow);
+          } else if (!api::global_api_server->is_connected()) {
+            id(status_led_show)->execute(1.0f, 0.4f, 0.0f, slow);
+          } else if (error) {
+            id(status_led_show)->execute(0.6f, 0.0f, 1.0f, true);
+          } else if (id(status_led_active) && !id(status_led_restore)->is_running()) {
+            id(status_led_restore)->execute(true);
+          }
+
+ota:
+  - id: !extend ota_esphome
+    on_begin:
+      - script.execute:
+          id: status_led_show
+          r: 0.0
+          g: 0.0
+          b: 1.0
+          lit: true
+    on_progress:
+      - lambda: 'id(status_led_show)->execute(0.0f, 0.0f, 1.0f, (millis() / 250) % 2 == 0);'
+    on_end:
+      - script.execute:
+          id: status_led_show
+          r: 0.0
+          g: 1.0
+          b: 0.0
+          lit: true
+    on_error:
+      - repeat:
+          count: 3
+          then:
+            - script.execute:
+                id: status_led_show
+                r: 1.0
+                g: 0.0
+                b: 0.0
+                lit: true
+            - delay: 250ms
+            - script.execute:
+                id: status_led_show
+                r: 1.0
+                g: 0.0
+                b: 0.0
+                lit: false
+            - delay: 250ms
+      - script.execute:
+          id: status_led_restore
+          confirm: false

common/status_led_atom.yaml

@@ -0,0 +1,19 @@
+---
+# Status LED on the M5Stack ATOM Lite's own RGB LED (G27), see common/status_led.yaml
+packages:
+  status_led: !include
+    file: status_led.yaml
+    vars:
+      light_id: atom_led
+      show_errors: "true"  # dedicated status LED
+
+light:
+  - platform: esp32_rmt_led_strip
+    id: atom_led
+    internal: true
+    pin: 27
+    num_leds: 1
+    rmt_symbols: 64  # 1 LED is 24 bits; leave RMT memory for remote_transmitter/receiver
+    chipset: ws2812
+    channel_colors: GRB
+    restore_mode: ALWAYS_OFF

common/vehicle_base.yaml

@@ -2,6 +2,8 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd  # ESP32-PICO-D4, like every other ATOM Lite
     type: esp-idf
 
 external_components:

common/wifi.yaml

@@ -9,3 +9,4 @@ wifi:
   enable_btm: true
   enable_rrm: true
   min_auth_mode: WPA3
+  power_save_mode: none

include/moonraker.h

@@ -0,0 +1,148 @@
+#pragma once
+// Moonraker client for mcu-cnc-pendant on its own FreeRTOS task: esp_http_client blocks
+// (DNS is not bounded by timeout_ms), so the main loop only queues commands and reads
+// the last polled status. An unreachable Klipper shows as "offline" instead of starving
+// the loop into the task watchdog.
+
+#include <deque>
+#include <mutex>
+#include <string>
+
+#include "esp_http_client.h"
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+
+#include "esphome/components/json/json_util.h"
+#include "esphome/core/hal.h"
+#include "esphome/core/log.h"
+
+namespace moonraker {
+
+struct Status {
+  float pos[3]{};
+  std::string homed;
+  std::string state{"offline"};
+};
+
+class Client {
+ public:
+  void start(const char *base) {
+    this->base_ = base;
+    xTaskCreate(task, "moonraker", 6144, this, 1, nullptr);
+  }
+
+  // Run G-code; dropped when Klipper is not keeping up.
+  void gcode(const std::string &script) {
+    JsonDocument doc;
+    doc["script"] = script;
+    std::string body;
+    serializeJson(doc, body);
+    this->post("/printer/gcode/script", body);
+  }
+
+  // urgent: throw away everything queued and send this first (emergency stop)
+  void post(const std::string &path, const std::string &body = "", bool urgent = false) {
+    std::lock_guard<std::mutex> lock(this->mutex_);
+    if (urgent) {
+      this->queue_.clear();
+    } else if (this->queue_.size() >= MAX_QUEUE) {
+      return;
+    }
+    this->queue_.emplace_back(path, body);
+  }
+
+  Status status() {
+    std::lock_guard<std::mutex> lock(this->mutex_);
+    return this->status_;
+  }
+
+ protected:
+  static constexpr size_t MAX_QUEUE = 8;
+  static constexpr uint32_t POLL_MS = 250;
+  static constexpr int TIMEOUT_MS = 1000;
+
+  static void task(void *arg) {
+    auto *self = static_cast<Client *>(arg);
+    uint32_t last_poll = 0;
+    for (;;) {
+      std::pair<std::string, std::string> cmd;
+      bool have_cmd = false;
+      {
+        std::lock_guard<std::mutex> lock(self->mutex_);
+        if (!self->queue_.empty()) {
+          cmd = std::move(self->queue_.front());
+          self->queue_.pop_front();
+          have_cmd = true;
+        }
+      }
+      if (have_cmd) {
+        int code = self->request(cmd.first, &cmd.second, nullptr);
+        if (code != 200)
+          ESP_LOGW("moonraker", "POST %s failed (%d): %s", cmd.first.c_str(), code, cmd.second.c_str());
+        continue;  // drain commands before the next poll
+      }
+      if (esphome::millis() - last_poll >= POLL_MS) {
+        last_poll = esphome::millis();
+        self->poll();
+      }
+      vTaskDelay(pdMS_TO_TICKS(10));
+    }
+  }
+
+  void poll() {
+    std::string body;
+    Status s;
+    if (this->request("/printer/objects/query?gcode_move=gcode_position&toolhead=homed_axes&print_stats=state",
+                      nullptr, &body) == 200) {
+      auto doc = esphome::json::parse_json(body);
+      JsonObject st = doc["result"]["status"];
+      JsonArray p = st["gcode_move"]["gcode_position"];
+      for (int i = 0; i < 3; i++)
+        s.pos[i] = p[i];
+      s.homed = st["toolhead"]["homed_axes"].as<std::string>();
+      s.state = st["print_stats"]["state"].as<std::string>();
+    } else {
+      std::lock_guard<std::mutex> lock(this->mutex_);
+      s.pos[0] = this->status_.pos[0];  // keep the last position, only flag offline
+      s.pos[1] = this->status_.pos[1];
+      s.pos[2] = this->status_.pos[2];
+    }
+    std::lock_guard<std::mutex> lock(this->mutex_);
+    this->status_ = std::move(s);
+  }
+
+  // POST when body is set, GET otherwise; returns the HTTP status or -1
+  int request(const std::string &path, const std::string *body, std::string *out) {
+    std::string url = this->base_ + path;
+    esp_http_client_config_t cfg{};
+    cfg.url = url.c_str();
+    cfg.timeout_ms = TIMEOUT_MS;
+    cfg.method = body ? HTTP_METHOD_POST : HTTP_METHOD_GET;
+    esp_http_client_handle_t c = esp_http_client_init(&cfg);
+    if (c == nullptr)
+      return -1;
+    int code = -1;
+    int len = body ? body->size() : 0;
+    if (len > 0)
+      esp_http_client_set_header(c, "Content-Type", "application/json");
+    if (esp_http_client_open(c, len) == ESP_OK && (len == 0 || esp_http_client_write(c, body->data(), len) == len)) {
+      esp_http_client_fetch_headers(c);
+      code = esp_http_client_get_status_code(c);
+      char buf[256];
+      int n;
+      while (out != nullptr && (n = esp_http_client_read(c, buf, sizeof(buf))) > 0)
+        out->append(buf, n);
+    }
+    esp_http_client_cleanup(c);
+    return code;
+  }
+
+  std::string base_;
+  std::mutex mutex_;
+  std::deque<std::pair<std::string, std::string>> queue_;
+  Status status_;
+};
+
+inline Client client;
+
+}  // namespace moonraker

mcu-air-office-r.yaml

@@ -1,4 +1,12 @@
 ---
+# Hardware: IKEA VINDRIKTNING (modded) + M5Stack M5Stamp Pico
+# Pinout:
+#   GPIO21  PM1006 UART                -> particle_uart (uart tx_pin)
+#   GPIO22  PM1006 UART                -> particle_uart (uart rx_pin)
+#   GPIO25  TZT 8-bit WS2812 5050 stick (8 LEDs, 7 visible outside) -> NEO [neo] (light esp32_rmt_led_strip), also status
+#   GPIO27  Onboard RGB LED (1x WS2812, inside), unused
+#   GPIO32  Grove SDA                  -> i2c (i2c sda)
+#   GPIO33  Grove SCL                  -> i2c (i2c scl)
 substitutions:
   device: air-office-r
   name: Office R Air
@@ -16,10 +24,16 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
+  status_led: !include
+    file: common/status_led.yaml
+    vars:
+      light_id: neo
 
 i2c:
   # - id: i2c0
@@ -46,20 +60,13 @@ uart:
 #       inverted: true
 
 light:
-  - platform: esp32_rmt_led_strip
-    # name: LED
-    id: neo
-    channel_colors: GRB
-    pin: 27
-    num_leds: 1
-    chipset: ws2812
-    restore_mode: ALWAYS_OFF
+  # also the status light (common/status_led.yaml): back to its previous state when all is fine
   - platform: esp32_rmt_led_strip
     name: NEO
-    id: neo_strip
+    id: neo
     channel_colors: GRB
     pin: 25
-    num_leds: 7
+    num_leds: 7  # 8 on the stick, the 8th one is hidden
     chipset: ws2812
     restore_mode: ALWAYS_OFF
     effects:

mcu-apollo-dev.yaml

@@ -1,4 +1,14 @@
 ---
+# Hardware: Apollo Automation ESK-1 ESPHome Starter Kit
+# Pinout:
+#   GPIO0                              -> i2c_1 (i2c scl)
+#   GPIO1                              -> i2c_1 (i2c sda)
+#   GPIO4                              -> Accessory Power (switch gpio)
+#   GPIO5                              -> Onboard RGB LED (light esp32_rmt_led_strip)
+#   GPIO14                             -> RGB LEDs (light esp32_rmt_led_strip)
+#   GPIO18                             -> buzzer_output (output ledc)
+# I2C:
+#   0x38  aht20 (sensor aht10)
 substitutions:
   device: apollo-dev #test
   name: Apollo DEV #test
@@ -16,6 +26,8 @@ esp32:
   flash_size: 8MB
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: generic
     type: esp-idf
 
 packages:

mcu-atoms3.yaml

@@ -1,4 +1,23 @@
 ---
+# Hardware: M5Stack AtomS3
+# Pinout:
+#   GPIO1   Grove SCL                  -> motor_in1 (output gpio)
+#   GPIO2   Grove SDA                  -> motor_in2 (output gpio)
+#   GPIO5                              -> canbus/esp32_can (canbus esp32_can tx_pin)
+#   GPIO6                              -> canbus/esp32_can (canbus esp32_can rx_pin)
+#   GPIO15                             -> display_tft (display mipi_spi cs_pin)
+#   GPIO16                             -> gpio_tft_backlight (output ledc)
+#   GPIO17                             -> spi (spi clk_pin)
+#   GPIO21                             -> spi (spi mosi_pin)
+#   GPIO33                             -> display_tft (display mipi_spi dc_pin)
+#   GPIO34                             -> display_tft (display mipi_spi reset_pin)
+#   GPIO38                             -> i2c_main (i2c sda)
+#   GPIO39                             -> i2c_main (i2c scl)
+#   GPIO41                             -> Button (binary_sensor gpio) (inverted)
+# I2C:
+#   0x21  pcf8574_hub (pcf8574)
+#   0x26  m5stack_relay_1 (m5stack_4relay)
+#   0x3C  lcd (display ssd1306_i2c)
 substitutions:
   device: atoms3
   name: AtomS3
@@ -23,6 +42,8 @@ esp32:
   flash_size: 8MB
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 ota:
@@ -33,12 +54,14 @@ pcf8574:
     address: 0x21
     pcf8575: true
 
-animation:
-  - file: "assets/images/blinky.gif"
+image:
+  - platform: animation
+    file: "assets/images/blinky.gif"
     id: blinky
     resize: 128x128
     type: RGB565
-  - file: "assets/images/vault_boy_walking.gif"
+  - platform: animation
+    file: "assets/images/vault_boy_walking.gif"
     id: vaultboy
     resize: 168x121
     type: RGB565
@@ -108,6 +131,11 @@ external_components:
 
 packages:
   common: !include common/common.yaml
+  ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include
+    file: common/status_led.yaml
+    vars:
+      light_id: status_frame
   # common: !include common/common_wo_debug.yaml
   # common: !include common/common_dev.yaml
 
@@ -211,12 +239,32 @@ output:
   - platform: ledc
     pin: 16
     id: gpio_tft_backlight
+  # virtual RGB light for common/status_led.yaml, shown full screen on the display
+  - platform: template
+    id: status_frame_r
+    type: float
+    write_action: []
+  - platform: template
+    id: status_frame_g
+    type: float
+    write_action: []
+  - platform: template
+    id: status_frame_b
+    type: float
+    write_action: []
 
 light:
   - platform: monochromatic
     id: display_tft_backlight
     output: gpio_tft_backlight
     restore_mode: ALWAYS_ON
+  - platform: rgb
+    id: status_frame
+    internal: true
+    red: status_frame_r
+    green: status_frame_g
+    blue: status_frame_b
+    restore_mode: ALWAYS_OFF
 
 switch:
   - platform: template
@@ -372,6 +420,7 @@ display:
   - platform: mipi_spi
     model: ST7789V
     id: display_tft
+    byte_order: little_endian  # colours were byte-swapped (purple showed as green)
     dimensions:
       height: 128
       width: 128
@@ -384,11 +433,18 @@ display:
     # eightbitcolor: true
     update_interval: 1s
     lambda: |-
+      // status screen (common/status_led.yaml): the whole display in the status colour
+      auto &sv = id(status_frame)->current_values;
+      if (sv.is_on()) {
+        it.fill(Color(sv.get_red() * 255, sv.get_green() * 255, sv.get_blue() * 255));
+        return;
+      }
       //Ingress shown animation Frame.
       id(blinky).next_frame();
       // Draw the animation my_animation at position [x=0,y=0]
       it.image(0, 0, id(blinky), COLOR_ON, COLOR_OFF);
 
+
       // // it.print(0, 0, id(font_default), "Hello World!");
       // // it.strftime(0, 0, id(font_default), TextAlign::TOP_LEFT, "%H:%M", id(ha_time).now());
       // it.rectangle(0,  0, it.get_width(), it.get_height(), id(my_blue));

mcu-basement-2.yaml

@@ -1,4 +1,12 @@
 ---
+# Hardware: Sonoff Dual R2
+# Pinout:
+#   GPIO0   Pin "button 0" on expansion header
+#   GPIO5   Relay #2 and green color on LED -> relay_2 (output gpio)
+#   GPIO9   Pin "button 1" on expansion header
+#   GPIO10  Push Button
+#   GPIO12  Relay #1 and red color on LED -> relay_1 (output gpio)
+#   GPIO13  Blue Status LED            -> status_led (status_led) (inverted)
 substitutions:
   device: basement-2
   name_short: Basement
@@ -17,14 +25,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
-
-# Sonoff Dual R2
-# GPIO10	Push Button
-# GPIO00	Pin "button 0" on expansion header
-# GPIO09	Pin "button 1" on expansion header
-# GPIO12	Relay #1 and red color on LED
-# GPIO05	Relay #2 and green color on LED
-# GPIO13	Blue Status LED
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 status_led:
   pin:

mcu-basement.yaml

@@ -1,4 +1,12 @@
 ---
+# Hardware: Sonoff Dual R2
+# Pinout:
+#   GPIO0   Pin "button 0" on expansion header -> Light Switch (binary_sensor gpio) (inverted)
+#   GPIO5   Relay #2 and green color on LED -> Socket 1 (switch gpio)
+#   GPIO9   Pin "button 1" on expansion header -> Door (binary_sensor gpio) (inverted)
+#   GPIO10  Push Button                -> Socket 1 Switch (binary_sensor gpio) (inverted)
+#   GPIO12  Relay #1 and red color on LED -> Sewage Treatment Aerator Pump [relay_1] (switch gpio)
+#   GPIO13  Blue Status LED            -> status_led (status_led) (inverted)
 substitutions:
   device: basement
   name: Basement
@@ -16,15 +24,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
-
-# Sonoff Dual R2
-# Pin 	  Function
-# GPIO10	Push Button
-# GPIO00	Pin "button 0" on expansion header
-# GPIO09	Pin "button 1" on expansion header
-# GPIO12	Relay #1 and red color on LED
-# GPIO05	Relay #2 and green color on LED
-# GPIO13	Blue Status LED
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 globals:
   - id: aerator_auto

mcu-bedroom-lamp-left.yaml

@@ -1,4 +1,23 @@
 ---
+# Hardware: Xiaomi Mi Bedside Lamp 2 (ESP-WROOM-32D, single core; RGBW LEDs)
+# Pinout (github.com/mmakaay/esphome-xiaomi_bslamp2, doc/technical_details.md):
+#   GPIO1   Debug pad TX
+#   GPIO2   Debug pad, free I/O
+#   GPIO3   Debug pad RX
+#   GPIO4   LEDs master switch 2
+#   GPIO5   LEDs blue PWM
+#   GPIO12  LEDs white PWM
+#   GPIO13  LEDs red PWM
+#   GPIO14  LEDs green PWM
+#   GPIO16  Front panel interrupt
+#   GPIO17  EEPROM I2C SDA
+#   GPIO18  EEPROM I2C SCL
+#   GPIO19  Front panel I2C SCL        -> front_panel_i2c (i2c scl)
+#   GPIO21  Front panel I2C SDA        -> front_panel_i2c (i2c sda)
+#   GPIO33  LEDs master switch 1
+# I2C:
+#   0x10  EEPROM-like IC on its own bus (GPIO17/18), not configured
+#   0x2C  Front panel
 substitutions:
   device: bedroom-lamp-left
   name: Bedroom Lamp Left
@@ -20,26 +39,21 @@ esp32:
     sdkconfig_options:
       CONFIG_FREERTOS_UNICORE: y
     advanced:
+      flash_chip: generic
       ignore_efuse_custom_mac: true
       ignore_efuse_mac_crc: true
 
 external_components:
   - source:
       type: git
-      url: https://github.com/mmakaay/esphome-xiaomi_bslamp2
-      ref: dev
+      # fork: fix for ESPHome 2026.10 (restore_mode -> restore_state), back to mmakaay once merged
+      url: https://github.com/randybb/esphome-xiaomi_bslamp2
+      ref: fix-light-restore-state
     refresh: 1h
 
 packages:
   common: !include common/common.yaml
-
-# Mi Desk Lamp
-# Pin 	  Function (Name)
-# GPIO02: Button (GPIO_KEY1)
-# GPIO04: Cold White (GPIO_PWM1)
-# GPIO05: Warm White (GPIO_PWM2)
-# GPIO12: Rotary switch A pin (GPIO_ROT_A)
-# GPIO13: Rotary switch B pin (GPIO_ROT_B)
+  ipv6_only: !include common/ipv6_only.yaml
 
 # ------------------------------------------------------------------------
 # Behavior: default

mcu-bedroom-lamp-right.yaml

@@ -1,4 +1,23 @@
 ---
+# Hardware: Xiaomi Mi Bedside Lamp 2 (ESP-WROOM-32D, single core; RGBW LEDs)
+# Pinout (github.com/mmakaay/esphome-xiaomi_bslamp2, doc/technical_details.md):
+#   GPIO1   Debug pad TX
+#   GPIO2   Debug pad, free I/O
+#   GPIO3   Debug pad RX
+#   GPIO4   LEDs master switch 2
+#   GPIO5   LEDs blue PWM
+#   GPIO12  LEDs white PWM
+#   GPIO13  LEDs red PWM
+#   GPIO14  LEDs green PWM
+#   GPIO16  Front panel interrupt
+#   GPIO17  EEPROM I2C SDA
+#   GPIO18  EEPROM I2C SCL
+#   GPIO19  Front panel I2C SCL        -> front_panel_i2c (i2c scl)
+#   GPIO21  Front panel I2C SDA        -> front_panel_i2c (i2c sda)
+#   GPIO33  LEDs master switch 1
+# I2C:
+#   0x10  EEPROM-like IC on its own bus (GPIO17/18), not configured
+#   0x2C  Front panel
 substitutions:
   device: bedroom-lamp-right
   name: Bedroom Lamp Right
@@ -20,26 +39,21 @@ esp32:
     sdkconfig_options:
       CONFIG_FREERTOS_UNICORE: y
     advanced:
+      flash_chip: generic
       ignore_efuse_custom_mac: true
       ignore_efuse_mac_crc: true
 
 external_components:
   - source:
       type: git
-      url: https://github.com/mmakaay/esphome-xiaomi_bslamp2
-      ref: dev
+      # fork: fix for ESPHome 2026.10 (restore_mode -> restore_state), back to mmakaay once merged
+      url: https://github.com/randybb/esphome-xiaomi_bslamp2
+      ref: fix-light-restore-state
     refresh: 60s
 
 packages:
   common: !include common/common.yaml
-
-# Mi Desk Lamp
-# Pin 	  Function (Name)
-# GPIO02: Button (GPIO_KEY1)
-# GPIO04: Cold White (GPIO_PWM1)
-# GPIO05: Warm White (GPIO_PWM2)
-# GPIO12: Rotary switch A pin (GPIO_ROT_A)
-# GPIO13: Rotary switch B pin (GPIO_ROT_B)
+  ipv6_only: !include common/ipv6_only.yaml
 
 # ------------------------------------------------------------------------
 # Behavior: default

mcu-c6-test-1.yaml

@@ -1,4 +1,7 @@
 ---
+# Hardware: Espressif ESP32-C6-DevKitC-1
+# Pinout:
+#   GPIO8                              -> LED (light esp32_rmt_led_strip)
 substitutions:
   device: c6-test-1
   name: C6 TEST 1

mcu-c6-test-2.yaml

@@ -1,4 +1,7 @@
 ---
+# Hardware: Espressif ESP32-C6-DevKitC-1
+# Pinout:
+#   GPIO8                              -> LED (light esp32_rmt_led_strip)
 substitutions:
   device: c6-test-2
   name: C6 TEST 2

mcu-cam-1.yaml

@@ -1,4 +1,21 @@
 ---
+# Hardware: ESP32-CAM (AI-Thinker style, runs hot)
+# Pinout:
+#   GPIO0                              -> Camera (esp32_camera)
+#   GPIO5                              -> Camera (esp32_camera data_pins)
+#   GPIO18                             -> Camera (esp32_camera data_pins)
+#   GPIO19                             -> Camera (esp32_camera data_pins)
+#   GPIO21                             -> Camera (esp32_camera data_pins)
+#   GPIO22                             -> Camera (esp32_camera pixel_clock_pin)
+#   GPIO23                             -> Camera (esp32_camera href_pin)
+#   GPIO25                             -> Camera (esp32_camera vsync_pin)
+#   GPIO26                             -> i2c_bus (i2c sda)
+#   GPIO27                             -> i2c_bus (i2c scl)
+#   GPIO32                             -> Enable (switch gpio)
+#   GPIO34                             -> Camera (esp32_camera data_pins)
+#   GPIO35                             -> Camera (esp32_camera data_pins)
+#   GPIO36                             -> Camera (esp32_camera data_pins)
+#   GPIO39                             -> Camera (esp32_camera data_pins)
 substitutions:
   device: cam-1
   name: Cam 1

mcu-can-node-1.yaml

@@ -1,4 +1,10 @@
 ---
+# Hardware: ESP32 DevKit
+# Pinout:
+#   GPIO0                              -> Boot (binary_sensor gpio) (inverted)
+#   GPIO2                              -> LED (switch gpio)
+#   GPIO22                             -> can_bus (canbus esp32_can rx_pin)
+#   GPIO23                             -> can_bus (canbus esp32_can tx_pin)
 substitutions:
   device: can-node-1
   name: CAN Node 1

mcu-can-node-2.yaml

@@ -1,4 +1,13 @@
 ---
+# Hardware: ESP32 DevKit
+# Pinout:
+#   GPIO17                             -> i2c (i2c sda)
+#   GPIO18                             -> i2c (i2c scl)
+#   GPIO19                             -> as3935_i2c (as3935_i2c irq_pin)
+#   GPIO22                             -> can_bus (canbus esp32_can rx_pin)
+#   GPIO23                             -> can_bus (canbus esp32_can tx_pin)
+# I2C:
+#   0x03  as3935_i2c (as3935_i2c)
 substitutions:
   device: can-node-2
   name: CAN Node 2

mcu-cec-bedroom.yaml

@@ -1,4 +1,13 @@
 ---
+# Hardware: M5Stack M5Stamp Pico
+# Pinout:
+#   GPIO22                             -> uart_distance (uart rx_pin)
+#   GPIO25                             -> uart_distance (uart tx_pin)
+#   GPIO26                             -> hdmi_cec (hdmi_cec)
+#   GPIO27                             -> LED (light esp32_rmt_led_strip)
+#   GPIO32  Grove SDA                  -> i2c (i2c sda)
+#   GPIO33  Grove SCL                  -> i2c (i2c scl)
+#   GPIO39                             -> Bedroom TV Button (binary_sensor gpio) (inverted)
 substitutions:
   device: cec-bedroom
   name: Bedroom TV
@@ -15,6 +24,8 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd  # ESP32-PICO-D4, like the other M5Stamp Pico (not read from the device)
     type: esp-idf
 
 external_components:

mcu-clock-1.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: M5Stack M5Stamp C3
+# Pinout:
+#   GPIO0   I2C SCL
+#   GPIO1   I2C SDA, BUTTON
+#   GPIO2   RGB
+#   GPIO4   DISPLAY CLOCK              -> tm1637_display (display tm1637 clk_pin)
+#   GPIO5   DISPLAY DIO                -> tm1637_display (display tm1637 dio_pin)
+#   GPIO6   GPIO
+#   GPIO7   GPIO
+#   GPIO8   GPIO
+#   GPIO9   GPIO (BUZZER?)             -> rtttl_out (output ledc)
+#   GPIO10  GPIO
+#   GPIO20  UART RX
+#   GPIO21  UART TX
 substitutions:
   device: clock-1
   name: Clock 1
@@ -17,6 +31,8 @@ esp32:
   variant: esp32c3
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: generic
     type: esp-idf
     # version: 5.4.2
     # platform_version: 54.03.21
@@ -25,21 +41,6 @@ packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
 
-# GPIO21  UART TX
-# GPIO20  UART RX
-# GPIO0   I2C SCL
-# GPIO1   I2C SDA
-# GPIO2   RGB
-# GPIO1   BUTTON
-# GPIO4   DISPLAY CLOCK
-# GPIO5   DISPLAY DIO
-# GPIO6   GPIO
-# GPIO7   GPIO
-# GPIO8   GPIO
-# GPIO10   GPIO
-#
-# GPIO9   GPIO (BUZZER?)
-
 # https://github.com/granadaxronos/120-SONG_NOKIA_RTTTL_RINGTONE_PLAYER_FOR_ARDUINO_UNO/blob/master/RTTTL_PLAYER/songs.h
 api:
   actions:

mcu-clock-living-room.yaml

@@ -1,4 +1,13 @@
 ---
+# Hardware: M5Stack M5Stamp Pico
+# Pinout:
+#   GPIO25                             -> rtttl_out (output ledc)
+#   GPIO27                             -> LED (light esp32_rmt_led_strip)
+#   GPIO32  Grove SDA                  -> i2c_main (i2c sda)
+#   GPIO33  Grove SCL                  -> i2c_main (i2c scl)
+#   GPIO39                             -> Button (binary_sensor gpio) (inverted)
+# I2C:
+#   0x24  tm1650_display (display tm1650)
 substitutions:
   device: clock-living-room
   name: Living room Clock
@@ -15,6 +24,8 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd  # ESP32-PICO-D4, like the other M5Stamp Pico (not read from the device)
     type: esp-idf
 
 external_components:

mcu-cnc-pendant.yaml

@@ -0,0 +1,235 @@
+---
+# Hardware: M5Stack M5Stamp S3 in the ESPendant case (github.com/positron96/ESP32_CNC_Pendant),
+#           talks to Klipper over Moonraker HTTP API
+# Pinout:
+#   GPIO0   Stamp button (boot)        -> stamp_button (binary_sensor gpio) (inverted)
+#   GPIO1   Handwheel A                -> handwheel (sensor rotary_encoder pin_a)
+#   GPIO2   Handwheel B                -> handwheel (sensor rotary_encoder pin_b)
+#   GPIO4   Axis encoder A             -> axis_encoder (sensor rotary_encoder pin_a)
+#   GPIO5   Axis encoder B             -> axis_encoder (sensor rotary_encoder pin_b)
+#   GPIO6   Axis encoder push          -> axis_button (binary_sensor gpio) (inverted)
+#   GPIO7   Step encoder A             -> step_encoder (sensor rotary_encoder pin_a)
+#   GPIO8   Step encoder B             -> step_encoder (sensor rotary_encoder pin_b)
+#   GPIO9   Step encoder push          -> step_button (binary_sensor gpio) (inverted)
+#   GPIO10  BT1                        -> bt1 (binary_sensor gpio) (inverted)
+#   GPIO11  BT2                        -> bt2 (binary_sensor gpio) (inverted)
+#   GPIO12  BT3                        -> bt3 (binary_sensor gpio) (inverted)
+#   GPIO13  LCD E (SCK)                -> spi (spi clk_pin)
+#   GPIO14  LCD R/W (MOSI)             -> spi (spi mosi_pin)
+#   GPIO15  LCD RS (CS)                -> lcd (display st7920 cs_pin)
+#   GPIO21  RGB LED                    -> status_rgb (light esp32_rmt_led_strip)
+#   GPIO39-44                          free (BT4-BT6 later)
+#   LCD RST: RC to 3.3 V, PSB to GND (serial mode)
+substitutions:
+  device: cnc-pendant
+  name: CNC Pendant
+  area: Workshop
+  comment: Klipper CNC pendant
+  moonraker: http://klipper.local:7125
+  max_feed: "3000"  # mm/min, handwheel jog feed cap
+
+esphome:
+  name: mcu-${device}
+  friendly_name: ${name}
+  area: ${area}
+  comment: ${comment}
+  includes:
+    - include/moonraker.h
+  on_boot:
+    - lambda: 'moonraker::client.start("${moonraker}");'
+
+esp32:
+  variant: esp32s3
+  flash_size: 8MB
+  toolchain: esp-idf
+  framework:
+    type: esp-idf
+
+packages:
+  common: !include common/common.yaml
+  # ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include
+    file: common/status_led.yaml
+    vars:
+      light_id: status_rgb
+
+light:
+  - platform: esp32_rmt_led_strip
+    id: status_rgb
+    name: LED
+    pin: 21
+    num_leds: 1
+    chipset: ws2812
+    rgb_order: GRB
+    restore_mode: ALWAYS_OFF
+
+# only links esp_http_client for include/moonraker.h, which runs requests on its own task
+http_request:
+
+globals:
+  - id: axis
+    type: int
+    initial_value: "0"  # 0 X, 1 Y, 2 Z
+  - id: step
+    type: int
+    initial_value: "1"  # index into steps[] in the jog interval
+  - id: wheel_sent
+    type: float
+    initial_value: "0"
+
+interval:
+  # handwheel: send the counts since the last jog as one relative move
+  - interval: 100ms
+    then:
+      - lambda: |-
+          static const float steps[] = {0.01f, 0.1f, 1.0f};
+          float delta = id(handwheel).state - id(wheel_sent);
+          if (delta == 0 || std::isnan(delta)) return;
+          id(wheel_sent) = id(handwheel).state;
+          float dist = delta * steps[id(step)];
+          // feed so the move takes ~100 ms, i.e. about one interval
+          // ponytail: capped feed lets fast spins queue moves that keep running after the wheel stops; drop excess counts if that bites
+          float feed = std::min(std::max(std::fabs(dist) * 600.0f, 60.0f), ${max_feed}.0f);
+          moonraker::client.gcode(str_sprintf("G91\nG1 %c%.3f F%.0f\nG90", "XYZ"[id(axis)], dist, feed));
+
+sensor:
+  - platform: rotary_encoder
+    id: handwheel
+    pin_a:
+      number: 1
+      mode: INPUT_PULLUP
+    pin_b:
+      number: 2
+      mode: INPUT_PULLUP
+    resolution: 1  # calibration: counts per detent, flip pin_a/pin_b if direction is wrong
+  - platform: rotary_encoder
+    id: axis_encoder
+    pin_a:
+      number: 4
+      mode: INPUT_PULLUP
+    pin_b:
+      number: 5
+      mode: INPUT_PULLUP
+    on_clockwise:
+      - lambda: 'id(axis) = std::min(id(axis) + 1, 2);'
+    on_anticlockwise:
+      - lambda: 'id(axis) = std::max(id(axis) - 1, 0);'
+  - platform: rotary_encoder
+    id: step_encoder
+    pin_a:
+      number: 7
+      mode: INPUT_PULLUP
+    pin_b:
+      number: 8
+      mode: INPUT_PULLUP
+    on_clockwise:
+      - lambda: 'id(step) = std::min(id(step) + 1, 2);'
+    on_anticlockwise:
+      - lambda: 'id(step) = std::max(id(step) - 1, 0);'
+
+binary_sensor:
+  - platform: gpio
+    id: stamp_button
+    name: Stamp Button
+    pin:
+      number: 0
+      inverted: true
+  # axis push: zero the selected axis in work coordinates
+  - platform: gpio
+    id: axis_button
+    name: Axis Button
+    pin:
+      number: 6
+      mode: INPUT_PULLUP
+      inverted: true
+    filters:
+      - delayed_on_off: 20ms
+    on_press:
+      - lambda: 'moonraker::client.gcode(str_sprintf("G92 %c0", "XYZ"[id(axis)]));'
+  - platform: gpio
+    id: step_button
+    name: Step Button
+    pin:
+      number: 9
+      mode: INPUT_PULLUP
+      inverted: true
+    filters:
+      - delayed_on_off: 20ms
+  # BT1: home all
+  - platform: gpio
+    id: bt1
+    name: BT1
+    pin:
+      number: 10
+      mode: INPUT_PULLUP
+      inverted: true
+    filters:
+      - delayed_on_off: 20ms
+    on_press:
+      - lambda: 'moonraker::client.gcode("G28");'
+  # BT2: pause / resume
+  - platform: gpio
+    id: bt2
+    name: BT2
+    pin:
+      number: 11
+      mode: INPUT_PULLUP
+      inverted: true
+    filters:
+      - delayed_on_off: 20ms
+    on_press:
+      - lambda: 'moonraker::client.post(moonraker::client.status().state == "paused" ? "/printer/print/resume" : "/printer/print/pause");'
+  # BT3: hold 1 s for emergency stop (Klipper needs FIRMWARE_RESTART afterwards)
+  - platform: gpio
+    id: bt3
+    name: BT3
+    pin:
+      number: 12
+      mode: INPUT_PULLUP
+      inverted: true
+    filters:
+      - delayed_on_off: 20ms
+    on_multi_click:
+      - timing:
+          - ON for at least 1s
+        then:
+          - lambda: 'moonraker::client.post("/printer/emergency_stop", "", true);'
+
+font:
+  # X11 misc-fixed bitmap fonts (as in u8g2 / Marlin), 6 px wide: axis letter + "-123.456" fits 64 px
+  - file: assets/fonts/6x13.bdf
+    id: font_big
+  - file: assets/fonts/6x10.bdf
+    id: font_small
+
+spi:
+  clk_pin: 13
+  mosi_pin: 14
+
+display:
+  - platform: st7920
+    id: lcd
+    cs_pin:
+      number: 15
+      inverted: true  # ST7920 RS/CS is active high
+    data_rate: 1MHz  # default 200kHz takes ~220 ms per frame; drop back if the picture garbles
+    width: 128
+    height: 64
+    rotation: 90  # mounted portrait, 270 if upside down
+    update_interval: 200ms
+    lambda: |-
+      static const char *steps[] = {"0.01", "0.1", "1"};
+      auto s = moonraker::client.status();
+      it.printf(0, 0, id(font_small), "%s", s.state.c_str());
+      it.printf(0, 10, id(font_small), "H:%s", s.homed.empty() ? "-" : s.homed.c_str());
+      for (int i = 0; i < 3; i++) {
+        int y = 22 + i * 14;
+        Color c = COLOR_ON;
+        if (i == id(axis)) {
+          it.filled_rectangle(0, y, 64, 13);
+          c = COLOR_OFF;
+        }
+        it.printf(1, y + 1, id(font_big), c, "%c", "XYZ"[i]);
+        it.printf(63, y + 1, id(font_big), c, TextAlign::TOP_RIGHT, "%.3f", s.pos[i]);
+      }
+      it.printf(0, 118, id(font_small), "%s mm", steps[id(step)]);

mcu-desk-lamp.yaml

@@ -1,4 +1,11 @@
 ---
+# Hardware: Xiaomi Mi Desk Lamp, brain transplant: M5Stack M5Stamp Pico (originally ESP8266)
+# Pinout:
+#   GPIO18  Warm White (GPIO_PWM2)     -> warm_white (output ledc)
+#   GPIO19  Cold White (GPIO_PWM1)     -> cold_white (output ledc)
+#   GPIO21  Rotary switch A pin (GPIO_ROT_A) -> rotary (sensor rotary_encoder pin_a)
+#   GPIO26  Rotary switch B pin (GPIO_ROT_B) -> rotary (sensor rotary_encoder pin_b)
+#   GPIO36  Button (GPIO_KEY1)         -> rotary_button (binary_sensor gpio) (inverted)
 substitutions:
   device: desk-lamp
   name: Desk Lamp
@@ -15,20 +22,14 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
 
-# Mi Desk Lamp
-# Pin 	  Function (Name)
-# GPIO18: Warm White (GPIO_PWM2)
-# GPIO19: Cold White (GPIO_PWM1)
-# GPIO21: Rotary switch A pin (GPIO_ROT_A)
-# GPIO26: Rotary switch B pin (GPIO_ROT_B)
-# GPIO36: Button (GPIO_KEY1)
-
 
 binary_sensor:
   - platform: gpio

mcu-dimmer.yaml

@@ -1,4 +1,11 @@
 ---
+# Hardware: M5Stack M5Stamp Pico
+# Pinout:
+#   GPIO22                             -> dimmer1 (output ac_dimmer gate_pin)
+#   GPIO25                             -> dimmer1 (output ac_dimmer zero_cross_pin) (inverted)
+#   GPIO27                             -> LED (light esp32_rmt_led_strip)
+#   GPIO32  Grove SDA
+#   GPIO33  Grove SCL
 substitutions:
   device: dimmer
   name: Dimmer
@@ -30,6 +37,8 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:

mcu-echo-1.yaml

@@ -1,4 +1,14 @@
 ---
+# Hardware: M5Stack ATOM Echo
+# Pinout:
+#   GPIO19                             -> speaker_bus (i2s_audio i2s_bclk_pin)
+#   GPIO22                             -> speaker_id (speaker i2s_audio i2s_dout_pin)
+#   GPIO23                             -> echo_microphone (microphone i2s_audio i2s_din_pin)
+#   GPIO26  Grove SDA
+#   GPIO27  ATOM RGB LED               -> LED [neo_buildin] (light esp32_rmt_led_strip), also status
+#   GPIO32  Grove SCL
+#   GPIO33                             -> speaker_bus (i2s_audio i2s_lrclk_pin)
+#   GPIO39                             -> Button (binary_sensor gpio) (inverted)
 substitutions:
   device: echo-1
   name: Echo 1
@@ -15,16 +25,17 @@ esphome:
 esp32:
   variant: esp32
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
-
-external_components:
-  # speaker media player: skip a failed playlist item (esphome#19862), drop once merged
-  - source: github://randybb/esphome-components
-    components: [speaker]
-    refresh: 1h
+  ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include
+    file: common/status_led.yaml
+    vars:
+      light_id: neo_buildin
 
 api:
   actions:
@@ -137,10 +148,10 @@ media_player:
     buffer_size: 14000
     media_pipeline:
       speaker: media_spk_resampling_input
-      format: NONE
+      format: WAV  # no PSRAM: HA transcodes to WAV, decoding MP3/FLAC here runs the heap out
     announcement_pipeline:
       speaker: announcement_spk_resampling_input
-      format: NONE
+      format: WAV  # no PSRAM: HA transcodes to WAV, decoding MP3/FLAC here runs the heap out
 
 rtttl:
   id: my_rtttl

mcu-echo.yaml

@@ -1,4 +1,16 @@
 ---
+# Hardware: Xiaomi Mijia Gateway, brain transplant: M5Stack ATOM Echo (kept the speaker, LEDs and PSU)
+# Pinout:
+#   GPIO12                             -> Button (binary_sensor gpio) (inverted)
+#   GPIO19                             -> speaker_bus (i2s_audio i2s_bclk_pin)
+#   GPIO21  Gateway LED ring red       -> led_red (output ledc)
+#   GPIO22                             -> speaker_id (speaker i2s_audio i2s_dout_pin)
+#   GPIO23  Gateway LED ring blue      -> led_blue (output ledc)
+#   GPIO25  Gateway LED ring green     -> led_green (output ledc)
+#   GPIO26  Grove SDA                  -> i2c (i2c sda)
+#   GPIO27  ATOM onboard RGB LED (inside, not visible)
+#   GPIO32  Grove SCL                  -> i2c (i2c scl)
+#   GPIO33                             -> speaker_bus (i2s_audio i2s_lrclk_pin)
 substitutions:
   device: echo
   name: Echo
@@ -16,16 +28,17 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
-
-external_components:
-  # speaker media player: skip a failed playlist item (esphome#19862), drop once merged
-  - source: github://randybb/esphome-components
-    components: [speaker]
-    refresh: 1h
+  ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include
+    file: common/status_led.yaml
+    vars:
+      light_id: led_light
 
 api:
   actions:
@@ -77,11 +90,6 @@ light:
     red: led_red
     green: led_green
     blue: led_blue
-  - platform: status_led
-    id: led_status
-    pin:
-      number: 23
-      allow_other_uses: true
 
 output:
   - platform: ledc
@@ -92,9 +100,7 @@ output:
     pin: 25
   - platform: ledc
     id: led_blue
-    pin:
-      number: 23
-      allow_other_uses: true
+    pin: 23
 
 i2s_audio:
   - id: speaker_bus

mcu-eworkbench.yaml

@@ -1,4 +1,22 @@
 ---
+# Hardware: M5Stack M5Stamp C3
+# Pinout:
+#   GPIO0   I2C SCL                    -> i2c_grove (i2c scl)
+#   GPIO1   I2C SDA, BUTTON            -> i2c_grove (i2c sda)
+#   GPIO2   RGB
+#   GPIO4   GPIO
+#   GPIO5   GPIO
+#   GPIO6   GPIO
+#   GPIO7   GPIO
+#   GPIO8   GPIO
+#   GPIO9   GPIO
+#   GPIO10  GPIO
+#   GPIO18  UART RX                    -> uart_hdmi_switch (uart rx_pin)
+#   GPIO19  UART TX                    -> uart_hdmi_switch (uart tx_pin)
+#   GPIO20  UART RX, LOGGER            -> uart_log (uart rx_pin)
+#   GPIO21  UART TX, LOGGER            -> uart_log (uart tx_pin)
+# I2C:
+#   0x20  pcf8574_hub (pcf8574)
 substitutions:
   device: eworkbench
   name: Electronics Workbench
@@ -22,23 +40,6 @@ esp32:
 packages:
   common: !include common/common.yaml
 
-# GPIO20  UART RX, LOGGER
-# GPIO21  UART TX, LOGGER
-# GPIO9   GPIO
-#
-# GPIO0   I2C SCL
-# GPIO1   I2C SDA
-# GPIO2   RGB
-# GPIO1   BUTTON
-# GPIO4   GPIO
-# GPIO5   GPIO
-# GPIO6   GPIO
-# GPIO7   GPIO
-# GPIO8   GPIO
-# GPIO10   GPIO
-# GPIO18   UART RX
-# GPIO19   UART TX
-
 i2c:
   - id: i2c_grove
     sda: 1

mcu-fireplace.yaml

@@ -1,4 +1,22 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO1   UART0 TX
+#   GPIO3   UART0 RX
+#   GPIO12  IR
+#   GPIO19  Relay2
+#   GPIO21  I2C1 SCL                   -> i2c (i2c scl)
+#   GPIO22  Relay1
+#   GPIO23  RS485 Tx
+#   GPIO25  I2C1 SDA - red             -> i2c (i2c sda)
+#   GPIO26  I2C0 SDA - white
+#   GPIO27  NEO 1x                     -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  I2C0 SCL
+#   GPIO33  RS485 Rx
+#   GPIO39  BUTTON                     -> Status Button (binary_sensor gpio)
+# I2C:
+#   0x18  one_wire_bus (one_wire ds2482)
+#   0x27  pca9554_module (pca9554)
 substitutions:
   device: fireplace
   name: Heating Fireplace
@@ -15,72 +33,30 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
-external_components:
-  # - source: github://pr#12717
-  #   components: [ds248x]
-  #   refresh: 1h
-  - source: github://pr#13534
-    components: [ds2482, ds2484, ds248x_base]
-    refresh: 1h
-
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
-
-
-# PINOUTS: M5ATOM+Atom Hub Switch
-# IR        G12
-# NEO       G27 1x
-# BUTTON    G39
-# I2C0 SDA  G26 - white
-# I2C0 SCL  G32
-# I2C1 SDA  G25 - red
-# I2C1 SCL  G21
-# UART0 RX  G3
-# UART0 TX  G1
-# RS485 Rx  G33
-# RS485 Tx  G23
-# Relay1    G22
-# Relay2    G19
+  status_led: !include common/status_led_atom.yaml
 
 i2c:
-  # - id: i2c0
-  #   sda: 26
-  #   scl: 32
-  #   scan: true #false
-  # - id: i2c1
   sda: 25
   scl: 21
   scan: true #false
 
-# ds248x:
-#   # i2c_id: i2c_main
-#   address: 0x18 # should be the default
-#   # sleep_pin: 32 # remove if not needed, if set the ds248x sleeps when no transaction is in progress
-#   active_pullup: true # adds a active pullup which should improve signal integrity
-#   strong_pullup: false # enables a strong pullup used to provide the needed current for temperature reading without vcc connected
-#   bus_sleep: true # power down the bus when no transaction is in progres
-
-# one_wire:
-#   id: one_wire_bus
-#   platform: ds2484
-#   active_pullup: true
-
-# ds248x:
-#   id: ds2484_module
-#   address: 0x18
-
-# one_wire:
-#   - platform: ds248x
-#     ds248x_id: ds2484_module
-#     id: one_wire_bus
+ds248x:
+  id: ds2484_module
+  type: ds2482-100
+  address: 0x18
+  active_pullup: true
 
 one_wire:
-  id: one_wire_bus
-  platform: ds2482
-  active_pullup: true
+  - platform: ds248x
+    ds248x_id: ds2484_module
+    id: one_wire_bus
 
 pca9554:
   - id: pca9554_module
@@ -127,16 +103,6 @@ sensor:
     # index: 0
     name: Temperature
     id: 'heating_fireplace_temperature'
-#   - platform: dht
-#     pin: 14
-#     temperature:
-#       name: "Kitchen Temperature"
-#       id: 'kitchen_temperature'
-#     humidity:
-#       name: "Kitchen Humidity"
-#       id: 'kitchen_humidity'
-#     update_interval: 60s
-#     model: si7021
 
 bluetooth_proxy:
   active: true

mcu-gate.yaml

@@ -1,4 +1,19 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO1   UART0 TX
+#   GPIO3   UART0 RX
+#   GPIO12  IR
+#   GPIO19  RELAY-2                    -> relay_2 (output gpio)
+#   GPIO21  I2C1 SCL
+#   GPIO22  RELAY-1                    -> relay_1 (output gpio)
+#   GPIO23  RS485 TX
+#   GPIO25  I2C1 SDA red
+#   GPIO26  I2C0 SDA white
+#   GPIO27  NEO                        -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  I2C0 SCL                   -> gate_ogi_state (binary_sensor gpio) (inverted); gate_ogi_blink (binary_sensor gpio) (inverted)
+#   GPIO33  RS485 RX
+#   GPIO39  BUTTON
 substitutions:
   device: gate
   name: Gate
@@ -15,26 +30,14 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
-
-# PINOUTS: M5ATOM
-# IR        G12
-# NEO       G27
-# BUTTON    G39
-# I2C0 SDA  G26 white
-# I2C0 SCL  G32
-# I2C1 SDA  G25 red
-# I2C1 SCL  G21
-# UART0 RX  G3
-# UART0 TX  G1
-# RS485 RX  G33
-# RS485 TX  G23
-# RELAY-1   G22
-# RELAY-2   G19
+  status_led: !include common/status_led_atom.yaml
 
 button:
   - platform: output

mcu-gateway.yaml

@@ -1,4 +1,31 @@
 ---
+# Hardware: Olimex ESP32-POE-ISO
+# Pinout:
+#   # UEXT
+#       3V3    1 2   GND
+#     GPIO4    3 4   GPIO36  U1TXD/U1RXD
+#    GPIO16    5 6   GPIO13  I2C-SCL/I2C-SDA
+#    GPIO15    7 8   GPIO2   HS2_CMD/HS2_DATA0
+#    GPIO14    9 10  GPIO5   HS2_CLK/SPI_CS
+#
+#    SD/MMC; shared with UEXT, no CS!!!
+#    GPIO15  HS2_CMD
+#    GPIO14  HS2_CLK
+#    GPIO2   HS2_DATA0
+#
+#    GPIO34  BUT1
+#    GPIO35  Battery Measurment ADC
+#    GPIO39  Ext Power Sense ADC
+# Used:
+#   GPIO4   uart_modbus (uart tx_pin)
+#   GPIO12  ethernet (ethernet power_pin)
+#   GPIO13  i2c (i2c sda)
+#   GPIO16  i2c (i2c scl)
+#   GPIO17  ethernet (ethernet)
+#   GPIO18  ethernet (ethernet mdio_pin)
+#   GPIO23  ethernet (ethernet mdc_pin)
+#   GPIO34  user_button (binary_sensor gpio) (inverted)
+#   GPIO36  uart_modbus (uart rx_pin)
 substitutions:
   device: gateway
   name: Gateway
@@ -17,6 +44,7 @@ esp32:
   framework:
     type: esp-idf
     advanced:
+      flash_chip: generic
       minimum_chip_revision: 3.0
       sram1_as_iram: true
 
@@ -32,22 +60,7 @@ external_components:
 packages:
   # common: !include common/common.yaml
   common_eth: !include common/common_eth.yaml
-
-## UEXT
-#    3V3    1 2   GND
-#  GPIO4    3 4   GPIO36  U1TXD/U1RXD
-# GPIO16    5 6   GPIO13  I2C-SCL/I2C-SDA
-# GPIO15    7 8   GPIO2   HS2_CMD/HS2_DATA0
-# GPIO14    9 10  GPIO5   HS2_CLK/SPI_CS
-#
-# SD/MMC; shared with UEXT, no CS!!!
-# GPIO15  HS2_CMD
-# GPIO14  HS2_CLK
-# GPIO2   HS2_DATA0
-
-# GPIO34  BUT1
-# GPIO35  Battery Measurment ADC
-# GPIO39  Ext Power Sense ADC
+  ipv6_only: !include common/ipv6_only_eth.yaml
 
 i2c:
   sda: 13

mcu-heater.yaml

@@ -1,4 +1,22 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO1   UART0 TX
+#   GPIO3   UART0 RX
+#   GPIO12  IR
+#   GPIO19  NC                         -> Demand [heating_demand] (switch gpio)
+#   GPIO21  I2C1 SCL                   -> i2c (i2c scl)
+#   GPIO22  1-WIRE                     -> Demand [hot_water_demand] (switch gpio)
+#   GPIO23  UART1 RX                   -> uart_modbus (uart rx_pin)
+#   GPIO25  I2C1 SDA                   -> i2c (i2c sda)
+#   GPIO26  I2C0 SDA
+#   GPIO27  NEO                        -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  I2C0 SCL
+#   GPIO33  UART1 TX                   -> uart_modbus (uart tx_pin)
+#   GPIO39  BUTTON
+# I2C:
+#   0x18  one_wire_bus (one_wire ds2482)
+#   0x27  pca9554_module (pca9554)
 substitutions:
   device: heater
   name: Heater
@@ -25,41 +43,14 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
-external_components:
-  # - source: github://pr#12717
-  #   components: [ds248x]
-  #   refresh: 1h
-  - source: github://pr#13534
-    components: [ds2482, ds2484, ds248x_base]
-    refresh: 1h
-
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
-
-# PINOUTS: M5ATOM
-# IR        G12
-# NEO       G27
-# BUTTON    G39
-# I2C0 SDA  G26
-# I2C0 SCL  G32
-# I2C1 SDA  G25
-# I2C1 SCL  G21
-# UART0 RX  G3
-# UART0 TX  G1
-# UART1 RX  G23
-# UART1 TX  G33
-# 1-WIRE    G22
-# NC        G19
-
-#logger:
-#  level: VERBOSE
-#  logs:
-#    dallas.component: ERROR
-#    uart.component: ERROR
-#    i2c.component: VERBOSE
+  status_led: !include common/status_led_atom.yaml
 
 # Heating / Hot water Controller
 # temp_1: Solar Collector
@@ -164,36 +155,22 @@ climate:
       default_target_temperature_high: 40 °C
 
 i2c:
-  # - id: i2c0
-  # sda: 26
-  # scl: 32
-  # scan: true #false
-  # - id: i2c1
+
   sda: 25
   scl: 21
   scan: true #false
 
-# one_wire:
-#   id: one_wire_bus
-#   # i2c_id: i2c_main
-#   platform: ds2484
-#   active_pullup: true
 
-# ds248x:
-#   id: ds2484_module
-#   address: 0x18
-#   active_pullup: true
-
-# one_wire:
-#   - platform: ds248x
-#     ds248x_id: ds2484_module
-#     id: one_wire_bus
+ds248x:
+  id: ds2482_module
+  type: ds2482-100
+  address: 0x18
+  active_pullup: true
 
 one_wire:
-  id: one_wire_bus
-  # i2c_id: i2c_main
-  platform: ds2482
-  active_pullup: true
+  - platform: ds248x
+    ds248x_id: ds2482_module
+    id: one_wire_bus
 
 modbus:
   uart_id: uart_modbus

mcu-kitchen.yaml

@@ -1,4 +1,21 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO1   UART0 TX
+#   GPIO3   UART0 RX
+#   GPIO12  IR
+#   GPIO19  Relay2
+#   GPIO21  I2C1 SCL                   -> i2c (i2c scl)
+#   GPIO22  Relay1                     -> power_supply1 (power_supply)
+#   GPIO23  RS485 Tx
+#   GPIO25  I2C1 SDA - red             -> i2c (i2c sda)
+#   GPIO26  I2C0 SDA - white
+#   GPIO27  NEO 1x                     -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  I2C0 SCL
+#   GPIO33  RS485 Rx
+#   GPIO39  BUTTON                     -> Status Button (binary_sensor gpio)
+# I2C:
+#   0x40  pca9685_hub1 (pca9685)
 substitutions:
   device: kitchen
   name: Kitchen
@@ -32,29 +49,17 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include common/status_led_atom.yaml
 
-api:
-  reboot_timeout: 300s
-
-# PINOUTS: M5ATOM+Atom Hub Switch
-# IR        G12
-# NEO       G27 1x
-# BUTTON    G39
-# I2C0 SDA  G26 - white
-# I2C0 SCL  G32
-# I2C1 SDA  G25 - red
-# I2C1 SCL  G21
-# UART0 RX  G3
-# UART0 TX  G1
-# RS485 Rx  G33
-# RS485 Tx  G23
-# Relay1    G22
-# Relay2    G19
+# api:
+#   reboot_timeout: 300s
 
 i2c:
   # - id: i2c0

mcu-lightening.yaml

@@ -1,4 +1,14 @@
 ---
+# Hardware: M5Stack M5Stamp Pico
+# Pinout:
+#   GPIO22                             -> i2c (i2c scl)
+#   GPIO25                             -> i2c (i2c sda)
+#   GPIO26                             -> as3935_i2c (as3935_i2c irq_pin)
+#   GPIO27                             -> neo (light esp32_rmt_led_strip)
+#   GPIO32  Grove SDA
+#   GPIO33  Grove SCL
+# I2C:
+#   0x03  as3935_i2c (as3935_i2c)
 substitutions:
   device: lightening
   name: Lightening detector
@@ -16,6 +26,8 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd  # ESP32-PICO-D4, like the other M5Stamp Pico (not read from the device)
     type: esp-idf
 
 packages:

mcu-lvgl-4848s040.yaml

@@ -1,4 +1,51 @@
 ---
+# Hardware: Guition ESP32-S3-4848S040
+# Pinout:
+#   # Display (RGB, pins in the mipi_rgb model)
+#    CS        39
+#    SCK       48  ST7701S init (3-wire SPI)
+#    SDA       47
+#    DE        18
+#    HSYNC     16
+#    VSYNC     17
+#    PCLK      21
+#    BL        38
+#   # Capacitive Touch (GT911)
+#    TP_SDA    19
+#    TP_SCL    45
+#   # Relays (86 box variant)
+#    RELAY1    40
+#    RELAY2     2
+#    RELAY3     1
+# Used:
+#   GPIO0   main_display (display mipi_rgb data_pins.red)
+#   GPIO3   main_display (display mipi_rgb data_pins.green)
+#   GPIO4   main_display (display mipi_rgb data_pins.blue)
+#   GPIO5   main_display (display mipi_rgb data_pins.blue)
+#   GPIO6   main_display (display mipi_rgb data_pins.blue)
+#   GPIO7   main_display (display mipi_rgb data_pins.blue)
+#   GPIO8   main_display (display mipi_rgb data_pins.green)
+#   GPIO9   main_display (display mipi_rgb data_pins.green)
+#   GPIO10  main_display (display mipi_rgb data_pins.green)
+#   GPIO11  main_display (display mipi_rgb data_pins.red)
+#   GPIO12  main_display (display mipi_rgb data_pins.red)
+#   GPIO13  main_display (display mipi_rgb data_pins.red)
+#   GPIO14  main_display (display mipi_rgb data_pins.red)
+#   GPIO15  main_display (display mipi_rgb data_pins.blue)
+#   GPIO16  main_display (display mipi_rgb hsync_pin)
+#   GPIO17  main_display (display mipi_rgb vsync_pin)
+#   GPIO18  main_display (display mipi_rgb de_pin)
+#   GPIO19  i2c_main (i2c sda)
+#   GPIO20  main_display (display mipi_rgb data_pins.green)
+#   GPIO21  main_display (display mipi_rgb pclk_pin)
+#   GPIO38  gpio_backlight_pwm (output ledc)
+#   GPIO39  main_display (display mipi_rgb cs_pin)
+#   GPIO45  i2c_main (i2c scl)
+#   GPIO46  main_display (display mipi_rgb data_pins.green)
+#   GPIO47  lcd_spi (spi mosi_pin)
+#   GPIO48  lcd_spi (spi clk_pin)
+# I2C:
+#   0x5D  main_touch (touchscreen gt911)
 substitutions:
   device: lvgl-4848s040
   name: LVGL 4848S040
@@ -19,6 +66,8 @@ esp32:
   variant: esp32s3
   flash_size: 16MB
   framework:
+    advanced:
+      flash_chip: boya
     type: esp-idf
     # PSRAM bandwidth for the RGB panel (not set by ESPHome); without it the
     # image shifts during flash/WiFi activity
@@ -35,24 +84,6 @@ packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
 
-# PINOUTS: Guition ESP32-S3-4848S040, 4", 480x480, ST7701S, capacitive
-## Display (RGB, pins in the mipi_rgb model)
-# CS        39
-# SCK       48  ST7701S init (3-wire SPI)
-# SDA       47
-# DE        18
-# HSYNC     16
-# VSYNC     17
-# PCLK      21
-# BL        38
-## Capacitive Touch (GT911)
-# TP_SDA    19
-# TP_SCL    45
-## Relays (86 box variant)
-# RELAY1    40
-# RELAY2     2
-# RELAY3     1
-
 api:
   # status page until Home Assistant connects (log viewers don't subscribe to states)
   on_client_connected:

mcu-lvgl-eworkbench.yaml

@@ -1,4 +1,17 @@
 ---
+# Hardware: Guition JC3248W535
+# Pinout:
+#   GPIO1                              -> main_backlight (power_supply)
+#   GPIO4                              -> touchscreen_bus (i2c sda)
+#   GPIO8                              -> touchscreen_bus (i2c scl)
+#   GPIO21                             -> display_qspi (spi data_pins)
+#   GPIO39                             -> display_qspi (spi data_pins)
+#   GPIO40                             -> display_qspi (spi data_pins)
+#   GPIO45                             -> main_display (display mipi_spi cs_pin)
+#   GPIO47                             -> display_qspi (spi clk_pin)
+#   GPIO48                             -> display_qspi (spi data_pins)
+# I2C:
+#   0x3B  main_touch (touchscreen axs15231)
 substitutions:
   device: lvgl-eworkbench
   name: Electronics Workbench Display
@@ -16,6 +29,8 @@ esp32:
   flash_size: 16MB
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: generic  # same board as lvgl-trainer (not read from the device)
     type: esp-idf
 
 packages:

mcu-lvgl-trainer.yaml

@@ -1,4 +1,19 @@
 ---
+# Hardware: Guition JC3248W535
+# Pinout:
+#   GPIO1                              -> gpio_backlight_pwm (output ledc)
+#   GPIO4                              -> touchscreen_bus (i2c sda)
+#   GPIO8                              -> touchscreen_bus (i2c scl)
+#   GPIO21                             -> display_qspi (spi data_pins)
+#   GPIO39                             -> display_qspi (spi data_pins)
+#   GPIO40                             -> display_qspi (spi data_pins)
+#   GPIO43                             -> ext_uart (uart tx_pin)
+#   GPIO44                             -> ext_uart (uart rx_pin)
+#   GPIO45                             -> main_display (display mipi_spi cs_pin)
+#   GPIO47                             -> display_qspi (spi clk_pin)
+#   GPIO48                             -> display_qspi (spi data_pins)
+# I2C:
+#   0x3B  main_touch (touchscreen axs15231)
 substitutions:
   device: lvgl-trainer
   name: Trainer Display
@@ -22,6 +37,8 @@ esp32:
   variant: esp32s3
   flash_size: 16MB
   framework:
+    advanced:
+      flash_chip: generic
     type: esp-idf
 
 packages:

mcu-lvgl.yaml

@@ -1,4 +1,88 @@
 ---
+# Hardware: Sunton ESP32-8048S043 (CYD 4.3", 800x480, capacitive touch)
+# Pinout:
+#   # Display
+#    R0        GND
+#    R1        GND
+#    R2        GND
+#    R3        45
+#    R4        48
+#    R5        47
+#    R6        21
+#    R7        14
+#    G0        GND
+#    G1        GND
+#    G2         5
+#    G3         6
+#    G4         7
+#    G5        15
+#    G6        16
+#    G7         4
+#    B0        GND
+#    B1        GND
+#    B2        GND
+#    B3         8
+#    B4         3
+#    B5        46
+#    B6         9
+#    B7         1
+#    DCLK      42
+#    HSYNC     39
+#    VSYNC     41
+#    DE        40
+#    BL         2
+#   # Capacitive Touch
+#    TP_INT
+#    TP_RST    38
+#    TP_SDA    19
+#    TP_SCL    20
+#   # SDCARD
+#    TF_CS     10
+#    SPI_MOSI  11
+#    SPI_CLK   12
+#    SPI_MISO  13
+#   # SPI Conector (HC1.25-4)
+#    SPI_CS    19
+#    SPI_MOSI  11
+#    SPI_CLK   12
+#    SPI_MISO  13
+#   # UART1 (SH1.0-4)
+#    1         GND
+#    2         3V3-ESP
+#    3         17
+#    4         18
+#   # UART1, USB Connector (Resistive) / I2C (Capacitive) (HC1.25-4)
+#    1         17
+#    2         18
+#    3         19  TP_SDA
+#    4         20  TP_SCL
+# Used:
+#   GPIO1   main_display (display mipi_rgb data_pins.blue)
+#   GPIO2   gpio_backlight_pwm (output ledc)
+#   GPIO3   main_display (display mipi_rgb data_pins.blue)
+#   GPIO4   main_display (display mipi_rgb data_pins.green)
+#   GPIO5   main_display (display mipi_rgb data_pins.green)
+#   GPIO6   main_display (display mipi_rgb data_pins.green)
+#   GPIO7   main_display (display mipi_rgb data_pins.green)
+#   GPIO8   main_display (display mipi_rgb data_pins.blue)
+#   GPIO9   main_display (display mipi_rgb data_pins.blue)
+#   GPIO14  main_display (display mipi_rgb data_pins.red)
+#   GPIO15  main_display (display mipi_rgb data_pins.green)
+#   GPIO16  main_display (display mipi_rgb data_pins.green)
+#   GPIO19  i2c_main (i2c sda)
+#   GPIO20  i2c_main (i2c scl)
+#   GPIO21  main_display (display mipi_rgb data_pins.red)
+#   GPIO38  main_touch (touchscreen gt911 reset_pin)
+#   GPIO39  main_display (display mipi_rgb hsync_pin)
+#   GPIO40  main_display (display mipi_rgb de_pin)
+#   GPIO41  main_display (display mipi_rgb vsync_pin)
+#   GPIO42  main_display (display mipi_rgb pclk_pin)
+#   GPIO45  main_display (display mipi_rgb data_pins.red)
+#   GPIO46  main_display (display mipi_rgb data_pins.blue)
+#   GPIO47  main_display (display mipi_rgb data_pins.red)
+#   GPIO48  main_display (display mipi_rgb data_pins.red)
+# I2C:
+#   0x5D  main_touch (touchscreen gt911)
 substitutions:
   device: lvgl
   name: LVGL
@@ -20,6 +104,8 @@ esp32:
   flash_size: 16MB
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
     # PSRAM bandwidth for the RGB panel (not set by ESPHome); without it the
     # image shifts during flash/WiFi activity
@@ -36,63 +122,6 @@ packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
 
-# PINOUTS: ESP32 Cheap Yellow Display, 4.3", IPS, Capacitive
-## Display
-# R0        GND
-# R1        GND
-# R2        GND
-# R3        45
-# R4        48
-# R5        47
-# R6        21
-# R7        14
-# G0        GND
-# G1        GND
-# G2         5
-# G3         6
-# G4         7
-# G5        15
-# G6        16
-# G7         4
-# B0        GND
-# B1        GND
-# B2        GND
-# B3         8
-# B4         3
-# B5        46
-# B6         9
-# B7         1
-# DCLK      42
-# HSYNC     39
-# VSYNC     41
-# DE        40
-# BL         2
-## Capacitive Touch
-# TP_INT
-# TP_RST    38
-# TP_SDA    19
-# TP_SCL    20
-## SDCARD
-# TF_CS     10
-# SPI_MOSI  11
-# SPI_CLK   12
-# SPI_MISO  13
-## SPI Conector (HC1.25-4)
-# SPI_CS    19
-# SPI_MOSI  11
-# SPI_CLK   12
-# SPI_MISO  13
-## UART1 (SH1.0-4)
-# 1         GND
-# 2         3V3-ESP
-# 3         17
-# 4         18
-## UART1, USB Connector (Resistive) / I2C (Capacitive) (HC1.25-4)
-# 1         17
-# 2         18
-# 3         19  TP_SDA
-# 4         20  TP_SCL
-
 api:
   # status page until Home Assistant connects (log viewers don't subscribe to states)
   on_client_connected:

mcu-m5paper.yaml

@@ -1,4 +1,25 @@
 ---
+# Hardware: M5Stack M5Paper
+# Pinout:
+#   GPIO2                              -> main_power (switch gpio)
+#   GPIO5                              -> ext_power (switch gpio)
+#   GPIO12                             -> spi (spi mosi_pin)
+#   GPIO13                             -> spi (spi miso_pin)
+#   GPIO14                             -> spi (spi clk_pin)
+#   GPIO15                             -> m5paper_display (display it8951 cs_pin)
+#   GPIO21                             -> i2c_main (i2c sda)
+#   GPIO22                             -> i2c_main (i2c scl)
+#   GPIO23                             -> m5paper_display (display it8951 reset_pin)
+#   GPIO27                             -> m5paper_display (display it8951 busy_pin)
+#   GPIO35                             -> Battery Voltage (sensor adc)
+#   GPIO36                             -> gt911_touchscreen (touchscreen gt911 interrupt_pin)
+#   GPIO37                             -> M5Paper Button UP (binary_sensor gpio) (inverted)
+#   GPIO38                             -> M5Paper Button Press (binary_sensor gpio) (inverted)
+#   GPIO39                             -> M5Paper Button Down (binary_sensor gpio) (inverted)
+# I2C:
+#   0x44  sensor sht3xd (sensor sht3xd)
+#   0x51  rtc_time (time bm8563)
+#   0x5D  gt911_touchscreen (touchscreen gt911)
 substitutions:
   device: m5paper
   name: M5Paper

mcu-mains-power.yaml

@@ -1,4 +1,19 @@
 ---
+# Hardware: M5Stack ATOM Lite
+# Pinout:
+#   GPIO1   UART0 TX
+#   GPIO3   UART0 RX
+#   GPIO12  IR
+#   GPIO19  NC
+#   GPIO21  I2C1 SCL
+#   GPIO22  1-WIRE
+#   GPIO23  UART1 RX
+#   GPIO25  I2C1 SDA
+#   GPIO26  I2C0 SDA                   -> uart_modbus (uart rx_pin)
+#   GPIO27  NEO                        -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  I2C0 SCL                   -> uart_modbus (uart tx_pin)
+#   GPIO33  UART1 TX
+#   GPIO39  BUTTON
 substitutions:
   device: mains-power
   name: Mains Power
@@ -22,26 +37,14 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
-
-# PINOUTS: M5ATOM
-# IR        G12
-# NEO       G27
-# BUTTON    G39
-# I2C0 SDA  G26
-# I2C0 SCL  G32
-# I2C1 SDA  G25
-# I2C1 SCL  G21
-# UART0 RX  G3
-# UART0 TX  G1
-# UART1 RX  G23
-# UART1 TX  G33
-# 1-WIRE    G22
-# NC        G19
+  status_led: !include common/status_led_atom.yaml
 
 modbus:
   uart_id: uart_modbus

mcu-nrf-ant.yaml

@@ -0,0 +1,185 @@
+---
+# Hardware: Nordic nRF52840 DK
+# Pinout:
+#   P0.06   UART0 TX                   -> logger (J-Link VCOM)
+#   P0.13   LED 1 (active low)         -> ANT+ Connected (a configured device is received)
+#   P0.14   LED 2 (active low)         -> ANT+ Unknown Device (an unconfigured one is in range)
+#   P1.01   UART1 RX                   <- mcu-nrf-dk UART1 TX (P1.02), packet_transport
+#   P1.02   UART1 TX                   -> mcu-nrf-dk UART1 RX (P1.01), packet_transport; plus GND
+# Radio: ANT+ receiver (RadiANT), no network of its own; values go to mcu-nrf-dk
+# ANT+ devices:
+#   655730   Garmin HRM-Pro          heart rate
+#   498521   Concept2 PM5 (rower)    fitness equipment (FE-C)
+#   1044953  Garmin Tempe            environment (temperature)
+#   604693   Garmin Varia RTL515     bike radar, battery only
+#   136052   Garmin HRM-Dual         heart rate (pain cave)
+#   334424   Garmin HRM-Tri          heart rate (bike)
+#   886796   Garmin Rally RS200      power + cadence
+#   343922   Garmin Speed Sensor 2   speed
+#   42898    SRAM Force AXS          shifting (Cube Litening C:68X), battery only
+esphome:
+  name: mcu-nrf-ant
+  friendly_name: nRF ANT+
+
+# needs the esphomeplatformzephyr fork (esphome-zephyr); RadiANT needs NCS
+zephyr:
+  variant: NRF52
+  board: nrf52840dk/nrf52840
+  framework:
+    type: ncs
+
+logger:
+  hardware_uart: UART0
+
+external_components:
+  - source: github://randybb/esphome-components
+    components: [ant_plus]
+
+output:
+  - platform: gpio
+    id: led_known
+    pin: {number: P0.13, inverted: true}
+  - platform: gpio
+    id: led_unknown
+    pin: {number: P0.14, inverted: true}
+
+ant_plus:
+  network_key: !secret ant_plus_network_key
+  connected:
+    id: ant_connected
+    name: ANT+ Connected
+    on_press: {output.turn_on: led_known}
+    on_release: {output.turn_off: led_known}
+  unknown_device:
+    id: ant_unknown_device
+    name: ANT+ Unknown Device
+    on_press: {output.turn_on: led_unknown}
+    on_release: {output.turn_off: led_unknown}
+  devices:
+    - type: heart_rate  # Garmin HRM-Pro
+      device_number: 655730
+      heart_rate:
+        id: hrm_pro_heart_rate
+        name: Garmin HRM-Pro Heart Rate
+      battery_level:
+        id: hrm_pro_battery
+        name: Garmin HRM-Pro Battery
+    - type: fitness_equipment  # Concept2 PM5 (rower)
+      device_number: 498521
+      power:
+        id: pm5_power
+        name: Concept2 PM5 Power
+      cadence:
+        id: pm5_stroke_rate
+        name: Concept2 PM5 Stroke Rate
+      in_use:
+        id: pm5_in_use
+        name: Concept2 PM5 In Use
+    - type: temperature  # Garmin Tempe
+      device_number: 1044953
+      temperature:
+        id: tempe_temperature
+        name: Garmin Tempe Temperature
+      temperature_min:
+        id: tempe_temperature_min
+        name: Garmin Tempe Temperature 24h Min
+      temperature_max:
+        id: tempe_temperature_max
+        name: Garmin Tempe Temperature 24h Max
+      battery_voltage:
+        id: tempe_battery
+        name: Garmin Tempe Battery
+      battery_low:
+        id: tempe_battery_low
+        name: Garmin Tempe Battery Low
+    - type: bike_radar  # Garmin Varia RTL515
+      device_number: 604693
+      battery_voltage:
+        id: varia_battery
+        name: Garmin Varia RTL515 Battery
+      battery_low:
+        id: varia_battery_low
+        name: Garmin Varia RTL515 Battery Low
+    - type: heart_rate  # Garmin HRM-Dual
+      device_number: 136052
+      heart_rate:
+        id: hrm_dual_heart_rate
+        name: Garmin HRM-Dual Heart Rate
+      battery_level:
+        id: hrm_dual_battery
+        name: Garmin HRM-Dual Battery
+    - type: heart_rate  # Garmin HRM-Tri
+      device_number: 334424
+      heart_rate:
+        id: hrm_tri_heart_rate
+        name: Garmin HRM-Tri Heart Rate
+      battery_level:
+        id: hrm_tri_battery
+        name: Garmin HRM-Tri Battery
+    - type: power  # Garmin Rally RS200 (a battery in each pedal)
+      device_number: 886796
+      power:
+        id: rally_power
+        name: Garmin Rally RS200 Power
+      cadence:
+        id: rally_cadence
+        name: Garmin Rally RS200 Cadence
+      battery_low:
+        id: rally_battery_low
+        name: Garmin Rally RS200 Battery Low
+    - type: speed  # Garmin Speed Sensor 2
+      device_number: 343922
+      speed:
+        id: speed2_speed
+        name: Garmin Speed Sensor 2 Speed
+      battery_voltage:
+        id: speed2_battery
+        name: Garmin Speed Sensor 2 Battery
+      battery_low:
+        id: speed2_battery_low
+        name: Garmin Speed Sensor 2 Battery Low
+    - type: shifting  # SRAM Force AXS (Cube Litening C:68X)
+      device_number: 42898
+      battery_low:
+        id: sram_battery_low
+        name: SRAM Force AXS Battery Low
+
+uart:
+  id: link
+  port: UART1
+  # the DK's default UART1 pins, same on both boards, wires crossed
+  tx_pin: P1.02
+  rx_pin: P1.01
+  baud_rate: 115200
+
+packet_transport:
+  - platform: uart
+    uart_id: link
+    update_interval: 1s
+    sensors:
+      - hrm_pro_heart_rate
+      - hrm_pro_battery
+      - pm5_power
+      - pm5_stroke_rate
+      - tempe_temperature
+      - tempe_temperature_min
+      - tempe_temperature_max
+      - tempe_battery
+      - varia_battery
+      - hrm_dual_heart_rate
+      - hrm_dual_battery
+      - hrm_tri_heart_rate
+      - hrm_tri_battery
+      - rally_power
+      - rally_cadence
+      - speed2_speed
+      - speed2_battery
+    binary_sensors:
+      - ant_connected
+      - ant_unknown_device
+      - pm5_in_use
+      - tempe_battery_low
+      - varia_battery_low
+      - rally_battery_low
+      - speed2_battery_low
+      - sram_battery_low

mcu-nrf-dk.yaml

@@ -1,11 +1,296 @@
 ---
+# Hardware: Nordic nRF52840 DK
+# Pinout:
+#   P0.11   Button 1 (active low)      -> Button 1 (binary_sensor gpio)
+#   P0.12   Button 2 (active low)      -> Button 2 (binary_sensor gpio)
+#   P0.13   LED 1 (active low)         -> LED 1 (light binary)
+#   P0.14   LED 2 (active low)         -> LED 2 (light binary)
+#   P0.15   LED 3 (active low)         -> LED 3 (light binary)
+#   P0.16   LED 4 (active low)         -> LED 4 (light binary)
+#   P0.24   Button 3 (active low)      -> Button 3 (binary_sensor gpio)
+#   P0.25   Button 4 (active low)      -> Button 4 (binary_sensor gpio)
+#   P1.01   UART1 RX                   <- mcu-nrf-ant UART1 TX (P1.02), packet_transport; plus GND
+#   P1.02   UART1 TX                   -> mcu-nrf-ant UART1 RX (P1.01), packet_transport
+# ANT+ values (Garmin HRM-Pro, Concept2 PM5, Garmin Tempe, Garmin Varia RTL515) come from mcu-nrf-ant
 esphome:
   name: mcu-nrf-dk
-  friendly_name: mcu-nrf-dk
+  friendly_name: nRF DK
 
-nrf52:
-  board: nrf52840_dk
-  bootloader: adafruit_nrf52_sd140_v7
+# needs the esphomeplatformzephyr fork (esphome-zephyr), upstream has no zephyr: platform yet
+zephyr:
+  variant: NRF52
+  board: nrf52840dk/nrf52840
+  framework:
+    type: zephyr
 
-# Enable logging
 logger:
+
+network:
+  enable_ipv6: true
+
+# Active dataset of the Thread network (HA: Settings > Thread > ... > dataset TLV)
+openthread:
+  tlv: !secret thread_tlv
+  # end device, doesn't route for others; saves flash (FTD fills the MCUboot slot)
+  device_type: MTD
+
+api:
+  encryption:
+    key: !secret api_key
+
+# ANT+ values from mcu-nrf-ant (second nRF52840 DK) over UART
+uart:
+  id: ant_link
+  port: UART1
+  # the DK's default UART1 pins, same on both boards, wires crossed
+  rx_pin: P1.01
+  tx_pin: P1.02
+  baud_rate: 115200
+
+packet_transport:
+  - platform: uart
+    uart_id: ant_link
+    providers:
+      - name: mcu-nrf-ant
+
+sensor:
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: hrm_pro_heart_rate
+    name: Garmin HRM-Pro Heart Rate
+    internal: false
+    unit_of_measurement: bpm
+    icon: mdi:heart-pulse
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: hrm_pro_battery
+    name: Garmin HRM-Pro Battery
+    internal: false
+    unit_of_measurement: "%"
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: pm5_power
+    name: Concept2 PM5 Power
+    internal: false
+    unit_of_measurement: W
+    device_class: power
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: pm5_stroke_rate
+    name: Concept2 PM5 Stroke Rate
+    internal: false
+    unit_of_measurement: spm
+    icon: mdi:rowing
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: tempe_temperature
+    name: Garmin Tempe Temperature
+    internal: false
+    unit_of_measurement: °C
+    device_class: temperature
+    accuracy_decimals: 1
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: tempe_temperature_min
+    name: Garmin Tempe Temperature 24h Min
+    internal: false
+    unit_of_measurement: °C
+    device_class: temperature
+    accuracy_decimals: 1
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: tempe_temperature_max
+    name: Garmin Tempe Temperature 24h Max
+    internal: false
+    unit_of_measurement: °C
+    device_class: temperature
+    accuracy_decimals: 1
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: tempe_battery
+    name: Garmin Tempe Battery
+    internal: false
+    unit_of_measurement: V
+    device_class: voltage
+    accuracy_decimals: 2
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: varia_battery
+    name: Garmin Varia RTL515 Battery
+    internal: false
+    unit_of_measurement: V
+    device_class: voltage
+    accuracy_decimals: 2
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: hrm_dual_heart_rate
+    name: Garmin HRM-Dual Heart Rate
+    internal: false
+    unit_of_measurement: bpm
+    icon: mdi:heart-pulse
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: hrm_dual_battery
+    name: Garmin HRM-Dual Battery
+    internal: false
+    unit_of_measurement: "%"
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: hrm_tri_heart_rate
+    name: Garmin HRM-Tri Heart Rate
+    internal: false
+    unit_of_measurement: bpm
+    icon: mdi:heart-pulse
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: hrm_tri_battery
+    name: Garmin HRM-Tri Battery
+    internal: false
+    unit_of_measurement: "%"
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: rally_power
+    name: Garmin Rally RS200 Power
+    internal: false
+    unit_of_measurement: W
+    device_class: power
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: rally_cadence
+    name: Garmin Rally RS200 Cadence
+    internal: false
+    unit_of_measurement: rpm
+    icon: mdi:rotate-right
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: speed2_speed
+    name: Garmin Speed Sensor 2 Speed
+    internal: false
+    unit_of_measurement: m/s
+    device_class: speed
+    accuracy_decimals: 2
+    filters:
+      - throttle: 1s
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: speed2_battery
+    name: Garmin Speed Sensor 2 Battery
+    internal: false
+    unit_of_measurement: V
+    device_class: voltage
+    accuracy_decimals: 2
+    entity_category: diagnostic
+
+output:
+  - platform: gpio
+    id: led_1_out
+    pin: {number: P0.13, inverted: true}
+  - platform: gpio
+    id: led_2_out
+    pin: {number: P0.14, inverted: true}
+  - platform: gpio
+    id: led_3_out
+    pin: {number: P0.15, inverted: true}
+  - platform: gpio
+    id: led_4_out
+    pin: {number: P0.16, inverted: true}
+
+light:
+  - {platform: binary, name: LED 1, id: led_1, output: led_1_out}
+  - {platform: binary, name: LED 2, id: led_2, output: led_2_out}
+  - {platform: binary, name: LED 3, id: led_3, output: led_3_out}
+  - {platform: binary, name: LED 4, id: led_4, output: led_4_out}
+
+# each button toggles its LED locally and is visible in HA
+binary_sensor:
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: ant_connected
+    name: ANT+ Connected
+    internal: false
+    device_class: connectivity
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: ant_unknown_device
+    name: ANT+ Unknown Device
+    internal: false
+    icon: mdi:access-point
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: pm5_in_use
+    name: Concept2 PM5 In Use
+    internal: false
+    device_class: running
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: tempe_battery_low
+    name: Garmin Tempe Battery Low
+    internal: false
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: varia_battery_low
+    name: Garmin Varia RTL515 Battery Low
+    internal: false
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: rally_battery_low
+    name: Garmin Rally RS200 Battery Low
+    internal: false
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: speed2_battery_low
+    name: Garmin Speed Sensor 2 Battery Low
+    internal: false
+    device_class: battery
+    entity_category: diagnostic
+  - platform: packet_transport
+    provider: mcu-nrf-ant
+    remote_id: sram_battery_low
+    name: SRAM Force AXS Battery Low
+    internal: false
+    device_class: battery
+    entity_category: diagnostic
+  - platform: gpio
+    name: Button 1
+    pin: {number: P0.11, inverted: true, mode: {input: true, pullup: true}}
+    on_press: {light.toggle: led_1}
+  - platform: gpio
+    name: Button 2
+    pin: {number: P0.12, inverted: true, mode: {input: true, pullup: true}}
+    on_press: {light.toggle: led_2}
+  - platform: gpio
+    name: Button 3
+    pin: {number: P0.24, inverted: true, mode: {input: true, pullup: true}}
+    on_press: {light.toggle: led_3}
+  - platform: gpio
+    name: Button 4
+    pin: {number: P0.25, inverted: true, mode: {input: true, pullup: true}}
+    on_press: {light.toggle: led_4}

mcu-nspanel-bedroom.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: Sonoff NSPanel (EU)
+# Pinout:
+#   GPIO2   IO2
+#   GPIO4   Screen power                  -> Screen Power (switch gpio) (inverted)
+#   GPIO14  Left button                   -> Left Button (binary_sensor gpio) (inverted)
+#   GPIO16  Display UART TX               -> display_uart (uart tx_pin)
+#   GPIO17  Display UART RX               -> display_uart (uart rx_pin)
+#   GPIO19  Relay 2
+#   GPIO21  Buzzer                        -> buzzer_out (output ledc)
+#   GPIO22  Relay 1                       -> relay_1 (output gpio)
+#   GPIO23  Relay 3 (no relay, connector)
+#   GPIO27  Right button                  -> Right Button (binary_sensor gpio) (inverted)
+#   GPIO37  ALS (light sensor)
+#   GPIO38  NTC temperature (ADC)         -> ntc_source (sensor adc)
 substitutions:
   device: nspanel-bedroom
   name: Bedroom NSPanel
@@ -14,6 +28,7 @@ esphome:
 
 packages:
   common: !include common/common.yaml
+  ipv6_only: !include common/ipv6_only.yaml
   nspanel: !include
     file: common/nspanel.yaml
     vars:
@@ -51,6 +66,13 @@ nspanel_lovelace:
       title: Kúrenie
       thermo_entity_id: climate.bt_trv_bedroom
 
+    - type: cardEntities
+      title: Info
+      entities:
+        - name: Zariadenie
+          entity_id: button.bedroom_nspanel_info
+          icon: information-outline
+
 binary_sensor:
   - platform: gpio
     name: Left Button

mcu-nspanel-dev.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: Sonoff NSPanel (EU)
+# Pinout:
+#   GPIO2   IO2
+#   GPIO4   Screen power                  -> Screen Power (switch gpio) (inverted)
+#   GPIO14  Left button                   -> Left Button (binary_sensor gpio) (inverted)
+#   GPIO16  Display UART TX               -> display_uart (uart tx_pin)
+#   GPIO17  Display UART RX               -> display_uart (uart rx_pin)
+#   GPIO19  Relay 2                       -> Relay 2 (switch gpio)
+#   GPIO21  Buzzer                        -> buzzer_out (output ledc)
+#   GPIO22  Relay 1                       -> Relay 1 (switch gpio)
+#   GPIO23  Relay 3 (no relay, connector)
+#   GPIO27  Right button                  -> Right Button (binary_sensor gpio) (inverted)
+#   GPIO37  ALS (light sensor)
+#   GPIO38  NTC temperature (ADC)         -> ntc_source (sensor adc)
 substitutions:
   device: nspanel-dev
   name: NSPanel DEV
@@ -37,6 +51,7 @@ esp32:
   framework:
     type: esp-idf
     advanced:
+      flash_chip: generic
       minimum_chip_revision: 3.0
       sram1_as_iram: true
 
@@ -60,6 +75,7 @@ external_components:
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
+  nspanel_popup: !include common/nspanel_popup.yaml
   # common: !include common/common_dev.yaml
 
 # web_server:
@@ -441,6 +457,13 @@ nspanel_lovelace:
         - name: Rast trávy
           entity_id: automation.irrigation_grow_grass
 
+    - type: cardEntities
+      title: Info
+      entities:
+        - name: Zariadenie
+          entity_id: button.nspanel_dev_info
+          icon: information-outline
+
 binary_sensor:
   - platform: gpio
     name: Left Button

mcu-nspanel-fireplace.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: Sonoff NSPanel (EU)
+# Pinout:
+#   GPIO2   IO2
+#   GPIO4   Screen power                  -> Screen Power (switch gpio) (inverted)
+#   GPIO14  Left button                   -> Left Button (binary_sensor gpio) (inverted)
+#   GPIO16  Display UART TX               -> display_uart (uart tx_pin)
+#   GPIO17  Display UART RX               -> display_uart (uart rx_pin)
+#   GPIO19  Relay 2                       -> Dining Table Light MAIN (switch gpio)
+#   GPIO21  Buzzer                        -> buzzer_out (output ledc)
+#   GPIO22  Relay 1                       -> Kitchen Worktop Light (switch gpio)
+#   GPIO23  Relay 3 (no relay, connector)
+#   GPIO27  Right button                  -> Right Button (binary_sensor gpio) (inverted)
+#   GPIO37  ALS (light sensor)
+#   GPIO38  NTC temperature (ADC)         -> ntc_source (sensor adc)
 substitutions:
   device: nspanel-fireplace
   name: Fireplace NSPanel
@@ -13,6 +27,7 @@ esphome:
 
 packages:
   common: !include common/common.yaml
+  ipv6_only: !include common/ipv6_only.yaml
   nspanel: !include
     file: common/nspanel.yaml
     vars:
@@ -108,6 +123,13 @@ nspanel_lovelace:
         - name: Auto-zatváranie
           entity_id: switch.gate_auto_close
 
+    - type: cardEntities
+      title: Info
+      entities:
+        - name: Zariadenie
+          entity_id: button.fireplace_nspanel_info
+          icon: information-outline
+
 binary_sensor:
   - platform: gpio
     name: Left Button

mcu-nspanel-office-j.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: Sonoff NSPanel (EU)
+# Pinout:
+#   GPIO2   IO2
+#   GPIO4   Screen power                  -> Screen Power (switch gpio) (inverted)
+#   GPIO14  Left button                   -> Left Button (binary_sensor gpio) (inverted)
+#   GPIO16  Display UART TX               -> display_uart (uart tx_pin)
+#   GPIO17  Display UART RX               -> display_uart (uart rx_pin)
+#   GPIO19  Relay 2
+#   GPIO21  Buzzer                        -> buzzer_out (output ledc)
+#   GPIO22  Relay 1                       -> relay_1 (output gpio)
+#   GPIO23  Relay 3 (no relay, connector)
+#   GPIO27  Right button                  -> Right Button (binary_sensor gpio) (inverted)
+#   GPIO37  ALS (light sensor)
+#   GPIO38  NTC temperature (ADC)         -> ntc_source (sensor adc)
 substitutions:
   device: nspanel-office-j
   name: Office J NSPanel
@@ -13,6 +27,7 @@ esphome:
 
 packages:
   common: !include common/common.yaml
+  ipv6_only: !include common/ipv6_only.yaml
   nspanel: !include
     file: common/nspanel.yaml
     vars:
@@ -61,6 +76,13 @@ nspanel_lovelace:
         - name: Auto-zatváranie
           entity_id: switch.gate_auto_close
 
+    - type: cardEntities
+      title: Info
+      entities:
+        - name: Zariadenie
+          entity_id: button.office_j_nspanel_info
+          icon: information-outline
+
 binary_sensor:
   - platform: gpio
     name: Left Button

mcu-nspanel-office-r.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: Sonoff NSPanel (EU)
+# Pinout:
+#   GPIO2   IO2
+#   GPIO4   Screen power                  -> Screen Power (switch gpio) (inverted)
+#   GPIO14  Left button                   -> Left Button (binary_sensor gpio) (inverted)
+#   GPIO16  Display UART TX               -> display_uart (uart tx_pin)
+#   GPIO17  Display UART RX               -> display_uart (uart rx_pin)
+#   GPIO19  Relay 2                       -> relay_2 (switch gpio)
+#   GPIO21  Buzzer                        -> buzzer_out (output ledc)
+#   GPIO22  Relay 1                       -> relay_1 (output gpio)
+#   GPIO23  Relay 3 (no relay, connector) -> Presence Light (light esp32_rmt_led_strip)
+#   GPIO27  Right button                  -> Right Button (binary_sensor gpio) (inverted)
+#   GPIO37  ALS (light sensor)
+#   GPIO38  NTC temperature (ADC)         -> ntc_source (sensor adc)
 substitutions:
   device: nspanel-office-r
   name: Office R NSPanel
@@ -82,6 +96,13 @@ nspanel_lovelace:
         - name: Auto-zatváranie
           entity_id: switch.gate_auto_close
 
+    - type: cardEntities
+      title: Info
+      entities:
+        - name: Zariadenie
+          entity_id: button.office_r_nspanel_info
+          icon: information-outline
+
 binary_sensor:
   - platform: gpio
     name: Left Button

mcu-nspanel-patio.yaml

@@ -1,4 +1,18 @@
 ---
+# Hardware: Sonoff NSPanel (EU)
+# Pinout:
+#   GPIO2   IO2
+#   GPIO4   Screen power                  -> Screen Power (switch gpio) (inverted)
+#   GPIO14  Left button                   -> Left Button (binary_sensor gpio) (inverted)
+#   GPIO16  Display UART TX               -> display_uart (uart tx_pin)
+#   GPIO17  Display UART RX               -> display_uart (uart rx_pin)
+#   GPIO19  Relay 2                       -> Light MAIN (switch gpio)
+#   GPIO21  Buzzer                        -> buzzer_out (output ledc)
+#   GPIO22  Relay 1                       -> Outside Light Back (switch gpio)
+#   GPIO23  Relay 3 (no relay, connector)
+#   GPIO27  Right button                  -> Right Button (binary_sensor gpio) (inverted)
+#   GPIO37  ALS (light sensor)
+#   GPIO38  NTC temperature (ADC)         -> ntc_source (sensor adc)
 substitutions:
   device: nspanel-patio
   name: Patio NSPanel
@@ -13,6 +27,7 @@ esphome:
 
 packages:
   common: !include common/common.yaml
+  ipv6_only: !include common/ipv6_only.yaml
   nspanel: !include
     file: common/nspanel.yaml
     vars:
@@ -23,6 +38,7 @@ nspanel_lovelace:
   cards:
     - type: cardGrid
       title: Kuchyňa / Obývačka
+      id: card_home
       entities:
         - name: Kuchyňa / Obývačka
           entity_id: light.kitchen
@@ -55,6 +71,7 @@ nspanel_lovelace:
 
     - type: cardGrid
       title: Von
+      id: card_outside
       entities:
         - name: Terasa
           entity_id: light.patio_lights
@@ -137,6 +154,13 @@ nspanel_lovelace:
         - name: Rast trávy
           entity_id: automation.irrigation_grow_grass
 
+    - type: cardEntities
+      title: Info
+      entities:
+        - name: Zariadenie
+          entity_id: button.patio_nspanel_info
+          icon: information-outline
+
 binary_sensor:
   - platform: gpio
     name: Left Button
@@ -145,9 +169,7 @@ binary_sensor:
       inverted: true
     on_click:
       - switch.toggle: relay_1
-      - lambda: 'id(nspanel_id).render_default_page();'
-      - lambda: 'id(nspanel_id).render_next_page();'
-      - lambda: 'id(nspanel_id).render_next_page();'
+      - script.execute: show_outside_card
 
   - platform: gpio
     name: Right Button
@@ -166,9 +188,7 @@ binary_sensor:
               action: light.toggle
               data:
                 entity_id: light.patio_lights
-          - lambda: 'id(nspanel_id).render_default_page();'
-          - lambda: 'id(nspanel_id).render_next_page();'
-          - lambda: 'id(nspanel_id).render_next_page();'
+          - script.execute: show_outside_card
         else:
           - switch.toggle: relay_2
 
@@ -190,3 +210,13 @@ switch:
     entity_category: config
     pin:
       number: 19
+
+script:
+  # jump straight to the "Von" card (one render instead of home + next + next):
+  # make it the default page for a moment, render it, restore the home card
+  - id: show_outside_card
+    then:
+      - lambda: |-
+          id(nspanel_id).set_default_page("card_outside");
+          id(nspanel_id).render_default_page();
+          id(nspanel_id).set_default_page("card_home");

mcu-office-r.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: M5Stack M5Stamp C3
+# Pinout:
+#   GPIO0   I2C SDA
+#   GPIO1   I2C SCL
+#   GPIO2   NEO
+#   GPIO3   BUTTON
+#   GPIO4                              -> led_red (output ledc)
+#   GPIO5                              -> led_green (output ledc)
+#   GPIO6                              -> led_blue (output ledc)
+#   GPIO20  UART RX
+#   GPIO21  UART TX
 substitutions:
   device: office-r
   name: Office R
@@ -18,19 +29,14 @@ esp32:
   variant: esp32c3
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: generic
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
 
-# GPIO21   UART TX
-# GPIO20   UART RX
-# GPIO0   I2C SDA
-# GPIO1   I2C SCL
-# GPIO2  NEO
-# GPIO3  BUTTON
-
 light:
   - platform: rgb
     name: "MS Teams Presence Light"

mcu-patio.yaml

@@ -1,4 +1,21 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO1   UART0 TX
+#   GPIO3   UART0 RX
+#   GPIO12  IR
+#   GPIO19  Relay2                     -> Relay (switch gpio)
+#   GPIO21  I2C1 SCL                   -> i2c (i2c scl)
+#   GPIO22  Relay1                     -> power_supply1 (power_supply)
+#   GPIO23  RS485 Tx
+#   GPIO25  I2C1 SDA - red             -> i2c (i2c sda)
+#   GPIO26  I2C0 SDA - white
+#   GPIO27  NEO 1x                     -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  I2C0 SCL
+#   GPIO33  RS485 Rx
+#   GPIO39  BUTTON                     -> Status Button (binary_sensor gpio)
+# I2C:
+#   0x40  pca9685_hub1 (pca9685)
 substitutions:
   device: patio
   name: Patio
@@ -33,28 +50,16 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include common/status_led_atom.yaml
 
 
-# PINOUTS: M5ATOM+Atom Hub Switch
-# IR        G12
-# NEO       G27 1x
-# BUTTON    G39
-# I2C0 SDA  G26 - white
-# I2C0 SCL  G32
-# I2C1 SDA  G25 - red
-# I2C1 SCL  G21
-# UART0 RX  G3
-# UART0 TX  G1
-# RS485 Rx  G33
-# RS485 Tx  G23
-# Relay1    G22
-# Relay2    G19
-
 i2c:
   # - id: i2c0
   #   sda: 26

mcu-pow-dishwasher.yaml

@@ -1,4 +1,16 @@
 ---
+# Hardware: Sonoff POW Elite
+# Pinout:
+#   GPIO0                              -> reset (binary_sensor gpio)
+#   GPIO2                              -> relay_on (switch gpio)
+#   GPIO4                              -> relay_off (switch gpio)
+#   GPIO5                              -> wifi_status_led (light status_led) (inverted)
+#   GPIO14                             -> tm1621_display (display tm1621 data_pin)
+#   GPIO16                             -> cse7766_uart (uart rx_pin)
+#   GPIO18                             -> led (output ledc) (inverted)
+#   GPIO25                             -> tm1621_display (display tm1621 cs_pin)
+#   GPIO26                             -> tm1621_display (display tm1621 read_pin)
+#   GPIO27                             -> tm1621_display (display tm1621 write_pin)
 substitutions:
   device: pow-dishwasher
   name: Dishwasher POW
@@ -18,6 +30,7 @@ esp32:
   framework:
     type: esp-idf
     advanced:
+      flash_chip: gd
       minimum_chip_revision: 3.1
       sram1_as_iram: true
 
@@ -187,4 +200,3 @@ switch:
       - delay: 500ms
       - switch.turn_off: relay_off # bi-stable relay so no need to keep on
     interlock: [relay_on]
-

mcu-pow-washer.yaml

@@ -1,4 +1,16 @@
 ---
+# Hardware: Sonoff POW Elite
+# Pinout:
+#   GPIO0                              -> reset (binary_sensor gpio)
+#   GPIO2                              -> relay_on (switch gpio)
+#   GPIO4                              -> relay_off (switch gpio)
+#   GPIO5                              -> wifi_status_led (light status_led) (inverted)
+#   GPIO14                             -> tm1621_display (display tm1621 data_pin)
+#   GPIO16                             -> cse7766_uart (uart rx_pin)
+#   GPIO18                             -> led (output ledc) (inverted)
+#   GPIO25                             -> tm1621_display (display tm1621 cs_pin)
+#   GPIO26                             -> tm1621_display (display tm1621 read_pin)
+#   GPIO27                             -> tm1621_display (display tm1621 write_pin)
 substitutions:
   device: pow-washer
   name: Washer POW
@@ -18,6 +30,7 @@ esp32:
   framework:
     type: esp-idf
     advanced:
+      flash_chip: gd  # same device as pow-dishwasher (not read from the device)
       minimum_chip_revision: 3.1
       sram1_as_iram: true
 

mcu-rf.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: M5Stack ATOM Lite
+# Pinout:
+#   GPIO19                             -> spi (spi mosi_pin)
+#   GPIO21                             -> rf_tx (remote_transmitter)
+#   GPIO22                             -> spi (spi miso_pin)
+#   GPIO23                             -> spi (spi clk_pin)
+#   GPIO25                             -> rf_rx (remote_receiver)
+#   GPIO26  Grove SDA
+#   GPIO27  NEO (ATOM RGB LED)         -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  Grove SCL
+#   GPIO33                             -> cc1101 (cc1101 cs_pin)
 substitutions:
   device: rf
   name: RF Bridge
@@ -15,11 +26,14 @@ esp32:
   variant: esp32
   flash_size: 4MB
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include common/status_led_atom.yaml
 
 spi:
   clk_pin: 23

mcu-rf433.yaml

@@ -1,4 +1,9 @@
 ---
+# Hardware: Sonoff RF Bridge (obsolete)
+# Pinout:
+#   GPIO4                              -> remote_receiver (remote_receiver)
+#   GPIO5                              -> remote_transmitter (remote_transmitter)
+#   GPIO13                             -> status_led (status_led) (inverted)
 substitutions:
   device: rf433
   name: RF433 Bridge
@@ -16,6 +21,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 remote_receiver:
   pin: 4

mcu-rfid-openprinttag.yaml

@@ -0,0 +1,285 @@
+---
+# Hardware: M5Stack M5Stamp S3 + PN5180 module (5 V and 3.3 V both needed)
+# Pinout:
+#   GPIO0   Button
+#   GPIO3   (external RFID LED, not fitted yet; notify_led uses the onboard RGB for now)
+#   GPIO4   Buzzer                     -> buzzer (output ledc)
+#   GPIO5                              -> spi (spi miso_pin)          PN5180 MISO
+#   GPIO6                              -> spi (spi mosi_pin)          PN5180 MOSI
+#   GPIO7                              -> spi (spi clk_pin)           PN5180 SCK
+#   GPIO8                              -> pn5180 (cs_pin)             PN5180 NSS
+#   GPIO9                              -> pn5180 (busy_pin)           PN5180 BUSY
+#   GPIO10                             -> pn5180 (reset_pin)          PN5180 RST
+#   GPIO11                             -> pn5180 (irq_pin)            PN5180 IRQ
+#   GPIO19  U-
+#   GPIO20  U+
+#   GPIO21  RGB                        -> notify_led (light esp32_rmt_led_strip), also status_led
+# PN5180 REQ, AUX, GPIO left open (REQ high at reset = firmware download mode)
+substitutions:
+  device: rfid-openprinttag
+  name: OpenPrintTag
+  area: DEV
+  comment: Filament spool reader (OpenPrintTag, Creality CFS)
+
+esphome:
+  name: mcu-${device}
+  friendly_name: ${name}
+  area: ${area}
+  comment: ${comment}
+
+esp32:
+  variant: esp32s3
+  toolchain: esp-idf
+  framework:
+    advanced:
+      flash_chip: gd
+    type: esp-idf
+
+packages:
+  common: !include common/common.yaml
+  ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include
+    file: common/status_led.yaml
+    vars:
+      light_id: notify_led
+      show_errors: "true"
+
+external_components:
+  - source: github://randybb/esphome-components
+    components: [pn5180, openprinttag, creality_cfs]
+    refresh: 1h
+
+# Called by the OpenPrintTag integration (openprinttag.update) to update the aux region
+api:
+  actions:
+    - action: openprinttag_write_aux
+      variables:
+        uid: string
+        aux: string
+      then:
+        - if:
+            condition:
+              switch.is_on: led_enabled
+            then:
+              - light.turn_on:
+                  id: notify_led
+                  brightness: 100%
+                  red: 100%
+                  green: 0%
+                  blue: 0%
+                  flash_length: 500ms
+        - lambda: id(spool).write_aux(uid, aux);
+    # Writes a Creality CFS record (48 characters, optionally 48 more for sector 2) to the
+    # Creality tag on the reader
+    - action: creality_cfs_write
+      variables:
+        uid: string
+        data: string
+      then:
+        - if:
+            condition:
+              switch.is_on: led_enabled
+            then:
+              - light.turn_on:
+                  id: notify_led
+                  brightness: 100%
+                  red: 100%
+                  green: 0%
+                  blue: 0%
+                  flash_length: 500ms
+        - lambda: id(creality).write(uid, data);
+
+spi:
+  clk_pin: GPIO7
+  mosi_pin: GPIO6
+  miso_pin: GPIO5
+
+pn5180:
+  id: pn5180_reader
+  cs_pin: GPIO8
+  busy_pin: GPIO9
+  reset_pin: GPIO10
+  irq_pin: GPIO11
+  on_tag:
+    - if:
+        condition:
+          switch.is_on: led_enabled
+        then:
+          - light.turn_on:
+              id: notify_led
+              brightness: 100%
+              red: 0%
+              green: 100%
+              blue: 0%
+              flash_length: 500ms
+    - if:
+        condition:
+          switch.is_on: buzzer_enabled
+        then:
+          - rtttl.play: "success:d=32,o=5,b=100:c,g,b"
+    - homeassistant.tag_scanned: !lambda return x;
+  on_tag_removed:
+    - if:
+        condition:
+          switch.is_on: buzzer_enabled
+        then:
+          - rtttl.play: "removed:d=16,o=5,b=100:b"
+
+openprinttag:
+  id: spool
+  # Raw tag record for the OpenPrintTag integration (randybb/ha-openprinttag), empty when removed
+  on_openprinttag:
+    - homeassistant.event:
+        event: esphome.openprinttag
+        data:
+          uid: !lambda return uid;
+          payload: !lambda return payload;
+
+creality_cfs:
+  id: creality
+  # The Creality record (ASCII) for Home Assistant, empty when removed
+  on_creality:
+    - homeassistant.event:
+        event: esphome.creality_cfs
+        data:
+          uid: !lambda return uid;
+          data: !lambda return data;
+
+sensor:
+  - platform: creality_cfs
+    name: Creality length
+  - platform: openprinttag
+    type: remaining_weight
+    name: Remaining weight
+  - platform: openprinttag
+    type: consumed_weight
+    name: Consumed weight
+  - platform: openprinttag
+    type: actual_weight
+    name: Full weight
+  - platform: openprinttag
+    type: min_print_temperature
+    name: Min print temperature
+  - platform: openprinttag
+    type: max_print_temperature
+    name: Max print temperature
+  - platform: openprinttag
+    type: max_bed_temperature
+    name: Max bed temperature
+  - platform: openprinttag
+    type: drying_temperature
+    name: Drying temperature
+  - platform: openprinttag
+    type: drying_time
+    name: Drying time
+
+text_sensor:
+  - platform: pn5180
+    name: Tag UID
+  - platform: creality_cfs
+    type: material_id
+    name: Creality material ID
+  - platform: creality_cfs
+    type: color
+    name: Creality color
+    id: creality_color
+    on_value:
+      - script.execute: show_filament_color
+  - platform: creality_cfs
+    type: serial
+    name: Creality serial
+  - platform: openprinttag
+    type: material_type
+    name: Material
+  - platform: openprinttag
+    type: material_name
+    name: Material name
+  - platform: openprinttag
+    type: brand_name
+    name: Brand
+  - platform: openprinttag
+    type: primary_color
+    name: Color
+    id: openprinttag_color
+    on_value:
+      - script.execute: show_filament_color
+
+script:
+  # The filament color on the filament_color light: the OpenPrintTag's, else the Creality tag's
+  - id: show_filament_color
+    then:
+      - lambda: |-
+          std::string x = id(openprinttag_color).state;
+          if (x.size() < 7)
+            x = id(creality_color).state;
+          if (x.size() < 7) {
+            id(filament_color).turn_off().set_transition_length(0).perform();
+            return;
+          }
+          uint32_t c = strtoul(x.c_str() + 1, nullptr, 16);
+          if (x.size() > 7)
+            c >>= 8;  // #rrggbbaa
+          // ESPHome scales the strongest channel to 100 %, the darkness goes to the brightness
+          const float r = ((c >> 16) & 0xFF) / 255.0f, g = ((c >> 8) & 0xFF) / 255.0f, b = (c & 0xFF) / 255.0f;
+          const float m = std::max({r, g, b});
+          if (m == 0.0f) {
+            id(filament_color).turn_off().set_transition_length(0).perform();  // black
+            return;
+          }
+          id(filament_color).turn_on()
+              .set_rgb(r, g, b)
+              .set_brightness(m)
+              .set_transition_length(0)
+              .perform();
+
+light:
+  # Onboard RGB for now: tag feedback and status. With the external LED fitted, move
+  # notify_led to pin 3 and give the onboard one back to status_led (as on mcu-rfid-reader)
+  - platform: esp32_rmt_led_strip
+    id: notify_led
+    name: Notify LED
+    channel_colors: GRB
+    pin: 21
+    num_leds: 1
+    chipset: ws2812
+    restore_mode: ALWAYS_OFF
+    rmt_symbols: 96
+
+  # Shows the filament color in Home Assistant; drives nothing, the next tag read overwrites it
+  - platform: rgb
+    id: filament_color
+    name: Filament color
+    icon: mdi:printer-3d-nozzle
+    red: color_none
+    green: color_none
+    blue: color_none
+    restore_mode: ALWAYS_OFF
+    default_transition_length: 0s
+
+output:
+  - platform: ledc
+    pin: 4
+    id: buzzer
+  - platform: template
+    id: color_none
+    type: float
+    write_action: []
+
+rtttl:
+  output: buzzer
+
+switch:
+  - platform: template
+    name: Buzzer Enabled
+    id: buzzer_enabled
+    icon: mdi:volume-high
+    optimistic: true
+    restore_mode: RESTORE_DEFAULT_ON
+    entity_category: config
+  - platform: template
+    name: LED enabled
+    id: led_enabled
+    icon: mdi:alarm-light-outline
+    optimistic: true
+    restore_mode: RESTORE_DEFAULT_ON
+    entity_category: config

mcu-rfid-reader.yaml

@@ -1,4 +1,16 @@
 ---
+# Hardware: M5Stack M5Stamp S3
+# Pinout:
+#   GPIO0   Button
+#   GPIO1   I2C SDA                    -> i2c_rfid (i2c sda)
+#   GPIO2   I2C SDA, Notify LED        -> i2c_rfid (i2c scl)
+#   GPIO3                              -> notify_led (light esp32_rmt_led_strip)
+#   GPIO4   Buzzer                     -> buzzer (output ledc)
+#   GPIO19  U-
+#   GPIO20  U+
+#   GPIO21  RGB                        -> status_led (light esp32_rmt_led_strip)
+# I2C:
+#   0x24  pn532_module (pn532_i2c)
 substitutions:
   device: rfid-reader
   name: RFID Reader
@@ -16,7 +28,7 @@ esphome:
   #   - wait_until:
   #       api.connected:
   #   - logger.log: API is connected!
-  #   - rtttl.play: "success:d=24,o=5,b=100:c,g,b"
+  #   - rtttl.play: "success:d=32,o=5,b=100:c,g,b"
   #   - light.turn_on:
   #       id: notify_led
   #       brightness: 100%
@@ -31,6 +43,8 @@ esp32:
   variant: esp32s3
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
 
 # external_components:
@@ -45,15 +59,6 @@ packages:
 # logger:
 #   hardware_uart: UART0
 
-# GPIO20  U+
-# GPIO19  U-
-# GPIO0   Button
-# GPIO1   I2C SDA
-# GPIO2   I2C SDA
-# GPIO2   Notify LED
-# GPIO4   Buzzer
-# GPIO21  RGB
-
 api:
   actions:
   - action: rfidreader_tag_ok
@@ -86,13 +91,13 @@ api:
         uri += tag_id;
         message->add_uri_record(uri);
         id(pn532_module).write_mode(message);
-    - rtttl.play: "write:d=24,o=5,b=100:b"
+    - rtttl.play: "write:d=32,o=5,b=100:b"
     - wait_until:
         not:
           pn532.is_writing:
     - light.turn_off:
         id: notify_led
-    - rtttl.play: "write:d=24,o=5,b=100:b,b"
+    - rtttl.play: "write:d=32,o=5,b=100:b,b"
 
   - action: write_music_tag
     variables:
@@ -118,13 +123,13 @@ api:
           message->add_text_record(text);
         }
         id(pn532_module).write_mode(message);
-    - rtttl.play: "write:d=24,o=5,b=100:b"
+    - rtttl.play: "write:d=32,o=5,b=100:b"
     - wait_until:
         not:
           pn532.is_writing:
     - light.turn_off:
         id: notify_led
-    - rtttl.play: "write:d=24,o=5,b=100:b,b"
+    - rtttl.play: "write:d=32,o=5,b=100:b,b"
 
 globals:
   - id: source
@@ -166,7 +171,7 @@ pn532_i2c:
         id(info)="";
         if (tag.has_ndef_message()) {
           auto message = tag.get_ndef_message();
-          auto records = message->get_records();
+          const auto &records = message->get_records();
           for (auto &record : records) {
             std::string payload = record->get_payload();
             std::string type = record->get_type();
@@ -266,7 +271,7 @@ pn532_i2c:
         condition:
           switch.is_on: buzzer_enabled
         then:
-        - rtttl.play: "success:d=24,o=5,b=100:c,g,b"
+        - rtttl.play: "success:d=32,o=5,b=100:c,g,b"
   on_tag_removed:
     then:
     - homeassistant.event:
@@ -308,13 +313,13 @@ button:
           message->add_uri_record(uri);
           ESP_LOGD("tagreader", "Writing payload: %s", uri.c_str());
           id(pn532_module).write_mode(message);
-      - rtttl.play: "write:d=24,o=5,b=100:b"
+      - rtttl.play: "write:d=32,o=5,b=100:b"
       - wait_until:
           not:
             pn532.is_writing:
       - light.turn_off:
           id: notify_led
-      - rtttl.play: "write:d=24,o=5,b=100:b,b"
+      - rtttl.play: "write:d=32,o=5,b=100:b,b"
   - platform: template
     name: Clean Tag
     id: clean_tag
@@ -328,13 +333,13 @@ button:
           green: 64.7%
           blue: 0%
       - lambda: 'id(pn532_module).clean_mode();'
-      - rtttl.play: "write:d=24,o=5,b=100:b"
+      - rtttl.play: "write:d=32,o=5,b=100:b"
       - wait_until:
           not:
             pn532.is_writing:
       - light.turn_off:
           id: notify_led
-      - rtttl.play: "write:d=24,o=5,b=100:b,b"
+      - rtttl.play: "write:d=32,o=5,b=100:b,b"
   - platform: template
     name: Cancel writing
     id: cancel_writing
@@ -344,7 +349,7 @@ button:
       - lambda: 'id(pn532_module).read_mode();'
       - light.turn_off:
           id: notify_led
-      - rtttl.play: "write:d=24,o=5,b=100:b,b"
+      - rtttl.play: "write:d=32,o=5,b=100:b,b"
 
 light:
   - platform: esp32_rmt_led_strip

mcu-shed.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO19                             -> Light (switch gpio)
+#   GPIO21                             -> i2c (i2c scl)
+#   GPIO22                             -> Garden Light (switch gpio)
+#   GPIO25                             -> i2c (i2c sda)
+#   GPIO26  Grove SDA
+#   GPIO27  NEO (ATOM RGB LED)         -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  Grove SCL
+# I2C:
+#   0x27  pca9554_module (pca9554)
 substitutions:
   device: shed
   name: Shed
@@ -15,6 +26,8 @@ esp32:
   variant: esp32
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: gd
     type: esp-idf
     # version: 5.4.2
     # platform_version: 54.03.21
@@ -22,6 +35,7 @@ esp32:
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include common/status_led_atom.yaml
 
 i2c:
   sda: 25
@@ -109,4 +123,3 @@ switch:
     pin:
       number: 19
       mode: OUTPUT
-

mcu-socket-01.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: BlitzWolf BW-SHP2/SHP6
+# Pinout:
+#   GPIO0   GPIO_LED1_INV Red LED (inverted), Power Status -> led_red (output gpio)
+#   GPIO1   GPIO_USER RXD, Optional sensor
+#   GPIO2   GPIO_LEDLNK_INV Blue LED (inverted), Link Status -> led_blue (output gpio)
+#   GPIO3   GPIO_USER TXD, Optional sensor
+#   GPIO5   GPIO_HJL_CF BL0937 or HJL-01 CF power -> sensor/hlw8012 (sensor hlw8012 cf_pin)
+#   GPIO12  GPIO_NRG_SEL_INV BL0937 or HJL-01 Sel output (0 = Voltage) -> sensor/hlw8012 (sensor hlw8012 sel_pin) (inverted)
+#   GPIO13  GPIO_KEY1 Button           -> Button (binary_sensor gpio) (inverted)
+#   GPIO14  GPIO_NRG_CF1 BL0937 or HJL-01 CF1 current / voltage -> sensor/hlw8012 (sensor hlw8012 cf1_pin)
+#   GPIO15  GPIO_REL1 Relay            -> Relay (switch gpio)
 substitutions:
   device: socket-01
   name: Socket 01
@@ -18,18 +29,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
-
-# BlitzWolf BW-SHP2 and BW-SHP6 (ESP8285 - BL0937 or HJL-01 Energy Monitoring)
-# Pin 	  Name              Function
-# GPIO15 	GPIO_REL1         Relay
-# GPIO13 	GPIO_KEY1         Button
-# GPIO00 	GPIO_LED1_INV     Red LED (inverted), Power Status
-# GPIO02 	GPIO_LEDLNK_INV   Blue LED (inverted), Link Status
-# GPIO05  GPIO_HJL_CF       BL0937 or HJL-01 CF power
-# GPIO12  GPIO_NRG_SEL_INV  BL0937 or HJL-01 Sel output (0 = Voltage)
-# GPIO14  GPIO_NRG_CF1      BL0937 or HJL-01 CF1 current / voltage
-# GPIO01 	GPIO_USER         RXD, Optional sensor
-# GPIO03 	GPIO_USER         TXD, Optional sensor
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 binary_sensor:
   - platform: gpio

mcu-socket-02.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: BlitzWolf BW-SHP2/SHP6
+# Pinout:
+#   GPIO0   GPIO_LED1_INV Red LED (inverted), Power Status -> led_red (output gpio)
+#   GPIO1   GPIO_USER RXD, Optional sensor
+#   GPIO2   GPIO_LEDLNK_INV Blue LED (inverted), Link Status -> led_blue (output gpio)
+#   GPIO3   GPIO_USER TXD, Optional sensor
+#   GPIO5   GPIO_HJL_CF BL0937 or HJL-01 CF power -> sensor/hlw8012 (sensor hlw8012 cf_pin)
+#   GPIO12  GPIO_NRG_SEL_INV BL0937 or HJL-01 Sel output (0 = Voltage) -> sensor/hlw8012 (sensor hlw8012 sel_pin) (inverted)
+#   GPIO13  GPIO_KEY1 Button           -> Button (binary_sensor gpio) (inverted)
+#   GPIO14  GPIO_NRG_CF1 BL0937 or HJL-01 CF1 current / voltage -> sensor/hlw8012 (sensor hlw8012 cf1_pin)
+#   GPIO15  GPIO_REL1 Relay            -> Relay (switch gpio)
 substitutions:
   device: socket-02
   name: Socket 02
@@ -18,18 +29,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
-
-# BlitzWolf BW-SHP2 and BW-SHP6 (ESP8285 - BL0937 or HJL-01 Energy Monitoring)
-# Pin 	  Name              Function
-# GPIO15 	GPIO_REL1         Relay
-# GPIO13 	GPIO_KEY1         Button
-# GPIO00 	GPIO_LED1_INV     Red LED (inverted), Power Status
-# GPIO02 	GPIO_LEDLNK_INV   Blue LED (inverted), Link Status
-# GPIO05  GPIO_HJL_CF       BL0937 or HJL-01 CF power
-# GPIO12  GPIO_NRG_SEL_INV  BL0937 or HJL-01 Sel output (0 = Voltage)
-# GPIO14  GPIO_NRG_CF1      BL0937 or HJL-01 CF1 current / voltage
-# GPIO01 	GPIO_USER         RXD, Optional sensor
-# GPIO03 	GPIO_USER         TXD, Optional sensor
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 binary_sensor:
   - platform: gpio

mcu-socket-03.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: BlitzWolf BW-SHP2/SHP6
+# Pinout:
+#   GPIO0   GPIO_LED1_INV Red LED (inverted), Power Status -> led_red (output gpio)
+#   GPIO1   GPIO_USER RXD, Optional sensor
+#   GPIO2   GPIO_LEDLNK_INV Blue LED (inverted), Link Status -> led_blue (output gpio)
+#   GPIO3   GPIO_USER TXD, Optional sensor
+#   GPIO5   GPIO_HJL_CF BL0937 or HJL-01 CF power -> sensor/hlw8012 (sensor hlw8012 cf_pin)
+#   GPIO12  GPIO_NRG_SEL_INV BL0937 or HJL-01 Sel output (0 = Voltage) -> sensor/hlw8012 (sensor hlw8012 sel_pin) (inverted)
+#   GPIO13  GPIO_KEY1 Button           -> Button (binary_sensor gpio) (inverted)
+#   GPIO14  GPIO_NRG_CF1 BL0937 or HJL-01 CF1 current / voltage -> sensor/hlw8012 (sensor hlw8012 cf1_pin)
+#   GPIO15  GPIO_REL1 Relay            -> Relay (switch gpio)
 substitutions:
   device: socket-03
   name: Socket 03
@@ -19,23 +30,13 @@ esphome:
   friendly_name: ${name}
   area: ${area}
   comment: ${comment}
+
 esp8266:
   board: esp01_1m
 
 packages:
   common: !include common/common_esp8266.yaml
-
-# BlitzWolf BW-SHP2 and BW-SHP6 (ESP8285 - BL0937 or HJL-01 Energy Monitoring)
-# Pin 	  Name              Function
-# GPIO15 	GPIO_REL1         Relay
-# GPIO13 	GPIO_KEY1         Button
-# GPIO00 	GPIO_LED1_INV     Red LED (inverted), Power Status
-# GPIO02 	GPIO_LEDLNK_INV   Blue LED (inverted), Link Status
-# GPIO05  GPIO_HJL_CF       BL0937 or HJL-01 CF power
-# GPIO12  GPIO_NRG_SEL_INV  BL0937 or HJL-01 Sel output (0 = Voltage)
-# GPIO14  GPIO_NRG_CF1      BL0937 or HJL-01 CF1 current / voltage
-# GPIO01 	GPIO_USER         RXD, Optional sensor
-# GPIO03 	GPIO_USER         TXD, Optional sensor
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 binary_sensor:
   - platform: gpio

mcu-stackchan.yaml

@@ -1,3 +1,43 @@
+# Hardware: M5Stack CoreS3 + Stack-chan kit
+# Pinout:
+#   GPIO0                              -> i2s_bus (i2s_audio i2s_mclk_pin)
+#   GPIO2                              -> Camera (esp32_camera)
+#   GPIO3                              -> display_tft (display mipi_spi cs_pin)
+#   GPIO5                              -> ir_tx (remote_transmitter)
+#   GPIO6                              -> uart_servo (uart tx_pin)
+#   GPIO7                              -> uart_servo (uart rx_pin)
+#   GPIO10                             -> ir_rx (remote_receiver)
+#   GPIO11                             -> i2c_bsp (i2c scl)
+#   GPIO12                             -> i2c_bsp (i2c sda)
+#   GPIO13                             -> speaker_id (speaker i2s_audio i2s_dout_pin)
+#   GPIO14                             -> stackchan_microphone (microphone i2s_audio i2s_din_pin)
+#   GPIO15                             -> Camera (esp32_camera data_pins)
+#   GPIO16                             -> Camera (esp32_camera data_pins)
+#   GPIO33                             -> i2s_bus (i2s_audio i2s_lrclk_pin)
+#   GPIO34                             -> i2s_bus (i2s_audio i2s_bclk_pin)
+#   GPIO35                             -> display_tft (display mipi_spi dc_pin)
+#   GPIO36                             -> spi_bus (spi clk_pin)
+#   GPIO37                             -> spi_bus (spi mosi_pin)
+#   GPIO38                             -> Camera (esp32_camera href_pin)
+#   GPIO39                             -> Camera (esp32_camera data_pins)
+#   GPIO40                             -> Camera (esp32_camera data_pins)
+#   GPIO41                             -> Camera (esp32_camera data_pins)
+#   GPIO42                             -> Camera (esp32_camera data_pins)
+#   GPIO45                             -> Camera (esp32_camera pixel_clock_pin)
+#   GPIO46                             -> Camera (esp32_camera vsync_pin)
+#   GPIO47                             -> Camera (esp32_camera data_pins)
+#   GPIO48                             -> Camera (esp32_camera data_pins)
+# I2C:
+#   0x23  sensor ltr_als_ps (sensor ltr_als_ps)
+#   0x34  axp2101_pmu (axp2101)
+#   0x36  aw88298_dac (audio_dac aw88298)
+#   0x38  touch_lcd (touchscreen ft63x6)
+#   0x40  es7210_adc (audio_adc es7210)
+#   0x41  sensor ina226 (sensor ina226)
+#   0x51  rtc_time (time bm8563)
+#   0x58  aw9523b_hub (aw9523b)
+#   0x68  touch_hub (si12t)
+#   0x6F  m5ioe1_hub (m5ioe1)
 substitutions:
   device: stackchan
   name: StackChan
@@ -23,8 +63,11 @@ esphome:
 esp32:
   variant: esp32s3
   flash_size: 16MB
+  flash_frequency: 40MHz  # the IDF 5.5.5 bootloader reads garbage from this flash (mfr 0x46) at 80MHz
   toolchain: esp-idf
   framework:
+    advanced:
+      flash_chip: generic
     type: esp-idf
 
 psram:
@@ -40,7 +83,7 @@ external_components:
     components: [axp2101, aw88298, aw9523b, si12t, m5ioe1, ftservo, scs9009]
     refresh: 0s
   - source: github://randybb/esphome-components
-    components: [audio_spectrum, speaker]  # speaker: esphome#19862, drop once merged
+    components: [audio_spectrum]
     refresh: 1h
 
 globals:

mcu-staircase-light.yaml

@@ -1,4 +1,8 @@
 ---
+# Hardware: Sonoff Mini
+# Pinout:
+#   GPIO12                             -> relay (output gpio)
+#   GPIO13                             -> led_blue (output gpio)
 substitutions:
   device: staircase-light
   name: Staircase
@@ -16,6 +20,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 # wifi:
 #   use_address: mcu-mini-04.local
@@ -49,8 +54,18 @@ binary_sensor:
     entity_id: binary_sensor.zigbee_staircase_pir_occupancy
     on_state:
       if:
-        condition:
-          binary_sensor.is_off: motion
+        condition: &no_motion
+          and:
+            - binary_sensor.is_off: motion
+            - binary_sensor.is_off: motion_2
+        then:
+          - light.turn_off: light_relay
+  - platform: homeassistant
+    id: motion_2
+    entity_id: binary_sensor.zigbee_staircase_2_pir_occupancy
+    on_state:
+      if:
+        condition: *no_motion
         then:
           - light.turn_off: light_relay
 

mcu-tft.yaml

@@ -1,4 +1,14 @@
 ---
+# Hardware: M5Stack M5Stamp C3
+# Pinout:
+#   GPIO0   Grove SCL                  -> touchscreen/xpt2046 (touchscreen xpt2046 cs_pin)
+#   GPIO1   Grove SDA                  -> touchscreen/xpt2046 (touchscreen xpt2046 interrupt_pin)
+#   GPIO4                              -> spi (spi clk_pin)
+#   GPIO5                              -> spi (spi mosi_pin)
+#   GPIO6                              -> spi (spi miso_pin)
+#   GPIO7                              -> main_display (display mipi_spi cs_pin)
+#   GPIO8                              -> main_display (display mipi_spi dc_pin)
+#   GPIO10                             -> main_display (display mipi_spi reset_pin)
 substitutions:
   device: tft
   name: TFT
@@ -18,6 +28,8 @@ esphome:
 esp32:
   variant: esp32c3
   framework:
+    advanced:
+      flash_chip: generic
     type: esp-idf
 
 packages:

mcu-tracker.yaml

@@ -1,4 +1,5 @@
 ---
+# Hardware: LilyGO T-PCIE
 substitutions:
   device: tracker
   name: Tracker

mcu-tv-light.yaml

@@ -1,4 +1,22 @@
 ---
+# Hardware: Huacanxing H801
+# Pinout:
+#   # H801 LED module
+#    Function       Pin       Channel
+#    R            GPIO15    PWM1
+#    G            GPIO13    PWM2
+#    B            GPIO12    PWM3
+#    W1           GPIO14    PWM4
+#    W2           GPIO04    PWM5
+#    LED D1 R       GPIO05
+#    LED D2 G       GPIO01
+# Used:
+#   GPIO4   pwm_warm_white (output esp8266_pwm)
+#   GPIO5   status_led_id (light status_led)
+#   GPIO12  pwm_blue (output esp8266_pwm)
+#   GPIO13  pwm_green (output esp8266_pwm)
+#   GPIO14  pwm_cold_white (output esp8266_pwm)
+#   GPIO15  pwm_red (output esp8266_pwm)
 substitutions:
   device: tv-light
   name: TV Light
@@ -16,16 +34,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
-
-## H801 LED module
-# Function 	Pin 	  Channel
-# R 	      GPIO15 	PWM1
-# G 	      GPIO13 	PWM2
-# B 	      GPIO12 	PWM3
-# W1 	      GPIO14 	PWM4
-# W2 	      GPIO04 	PWM5
-# LED D1 R 	GPIO05
-# LED D2 G 	GPIO01
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 light:
   - platform: status_led

mcu-vehicle-honda-pcx125.yaml

@@ -1,4 +1,6 @@
 ---
+# Hardware: M5Stack ATOM Lite
+# Pinout: see common/vehicle_base.yaml
 substitutions:
   device: vehicle-honda-pcx125
   name: Vehicle Honda PCX125

mcu-vehicle-suzuki-dl650.yaml

@@ -1,4 +1,6 @@
 ---
+# Hardware: M5Stack ATOM Lite
+# Pinout: see common/vehicle_base.yaml
 substitutions:
   device: vehicle-suzuki-dl650
   name: Vehicle Suzuki DL650

mcu-vehicle-toyota-auris-ts.yaml

@@ -1,4 +1,6 @@
 ---
+# Hardware: M5Stack ATOM Lite
+# Pinout: see common/vehicle_base.yaml
 substitutions:
   device: vehicle-toyota-auris-ts
   name: Vehicle Toyota Auris TS

mcu-vehicle-toyota-yaris-cross.yaml

@@ -1,4 +1,6 @@
 ---
+# Hardware: M5Stack ATOM Lite
+# Pinout: see common/vehicle_base.yaml
 substitutions:
   device: vehicle-toyota-yaris-cross
   name: Vehicle Toyota Yaris Cross

mcu-waterproof-socket.yaml

@@ -1,4 +1,11 @@
 ---
+# Hardware: Sonoff Basic R2
+# Pinout:
+#   GPIO0   BUTTON                     -> Button (binary_sensor gpio) (inverted)
+#   GPIO1   TX PIN
+#   GPIO3   RX PIN
+#   GPIO12  RELAY                      -> Relay (switch gpio)
+#   GPIO13  LED1                       -> led (output gpio)
 substitutions:
   device: waterproof-socket
   name: Waterproof Socket
@@ -16,13 +23,7 @@ esp8266:
 
 packages:
   common: !include common/common_esp8266.yaml
-
-# Sonoff Basic R2
-# GPIO00 - BUTTON
-# GPIO12 - RELAY
-# GPIO13 - LED1
-# GPIO03 - RX PIN
-# GPIO01 - TX PIN
+  mdns_ipv6: !include common/esp8266_mdns_ipv6.yaml
 
 binary_sensor:
   - platform: gpio

mcu-well.yaml

@@ -1,4 +1,15 @@
 ---
+# Hardware: M5Stack ATOM Lite + ATOM Hub Switch
+# Pinout:
+#   GPIO21                             -> i2c (i2c scl)
+#   GPIO23                             -> modbus_uart (uart tx_pin)
+#   GPIO25                             -> i2c (i2c sda)
+#   GPIO26  Grove SDA
+#   GPIO27  NEO (ATOM RGB LED)         -> atom_led (status LED, common/status_led_atom.yaml)
+#   GPIO32  Grove SCL
+#   GPIO33                             -> modbus_uart (uart rx_pin)
+# I2C:
+#   0x27  relay_module (pca9554)
 substitutions:
   device: well
   name: Well
@@ -30,11 +41,13 @@ esp32:
   framework:
     type: esp-idf
     advanced:
+      flash_chip: gd
       sram1_as_iram: true
 
 packages:
   common: !include common/common.yaml
   ipv6_only: !include common/ipv6_only.yaml
+  status_led: !include common/status_led_atom.yaml
 
 api:
   actions:
@@ -358,4 +371,3 @@ valve:
       - switch.turn_on: irrigation_relay_8
     close_action:
       - switch.turn_off: irrigation_relay_8
-

secrets.yaml.default

@@ -29,3 +29,9 @@ ble_beacon_toyota_auris_minor: 61958
 ble_beacon_toyota_yaris_uuid: "00000000-0000-0000-0000-000000000000"
 ble_beacon_toyota_yaris_honda_major: 10167
 ble_beacon_toyota_yaris_honda_minor: 61958
+
+# Thread active dataset (hex TLV) from Home Assistant
+thread_tlv: "0E080000000000010000"
+
+# ANT+ network key (8 bytes hex), from thisisant.com
+ant_plus_network_key: "0000000000000000"