main.yaml

substitutions:
  device_name: 3by3-espdeck-sg
  board: d1mini   # change to wt32 when needed
  click_min_ms: 10ms
  click_max_ms: 400ms
  double_gap_ms: 200ms
  hold_ms: 600ms
  single_delay_ms: 180ms

# Fallback; hardware file will override as packages merge (per docs merge rules)
esphome:
  name: ${device_name}
  friendly_name: ${device_name}

# IMPORTANT: include only the chosen board (no relative includes here)
packages:
  hardware: github://m-s-e/espdeckenc/hardware/${board}.yaml@<LATEST_COMMIT_SHA>
  pins:     github://m-s-e/espdeckenc/pins/${board}.yaml@<LATEST_COMMIT_SHA>

# ========= Core services =========
logger:
api:
ota:

# ========= Matrix Keypad (3×3) =========
# Uses ${ROWx_PIN}, ${COLx_PIN}, and ${COL3_MODE} from pins/<board>.yaml
matrix_keypad:
  id: espdeck_keypad
  rows:
    - pin:
        number: ${ROW1_PIN}
        mode: OUTPUT
    - pin:
        number: ${ROW2_PIN}
        mode: OUTPUT
    - pin:
        number: ${ROW3_PIN}
        mode: OUTPUT
  columns:
    - pin:
        number: ${COL1_PIN}
        mode: INPUT_PULLUP
    - pin:
        number: ${COL2_PIN}
        mode: INPUT_PULLUP
    - pin:
        number: ${COL3_PIN}
        mode: ${COL3_MODE}
  keys:
    - "1"
    - "2"
    - "3"
    - "4"
    - "5"
    - "6"
    - "7"
    - "8"
    - "9"
  debounce_ms: 5

# ========= Single-click deferral scripts (doubles cancel pending single) =========
script:
  - id: defer_single_k1
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "1"

  - id: defer_single_k2
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "2"

  - id: defer_single_k3
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "3"

  - id: defer_single_k4
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "4"

  - id: defer_single_k5
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "5"

  - id: defer_single_k6
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "6"

  - id: defer_single_k7
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "7"

  - id: defer_single_k8
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "8"

  - id: defer_single_k9
    mode: restart
    then:
      - delay: ${single_delay_ms}
      - homeassistant.event:
          event: keypad_single
          data:
            key: "9"

# ========= Per-key handlers: single / double / hold =========
binary_sensor:
  # Map:
  # (0,0)->"1" (0,1)->"2" (0,2)->"3"
  # (1,0)->"4" (1,1)->"5" (1,2)->"6"
  # (2,0)->"7" (2,1)->"8" (2,2)->"9"

  # --- Key "1" (r0 c0) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_1
    row: 0
    col: 0
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k1
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k1
          - homeassistant.event:
              event: keypad_double
              data:
                key: "1"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k1
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "1"

  # --- Key "2" (r0 c1) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_2
    row: 0
    col: 1
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k2
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k2
          - homeassistant.event:
              event: keypad_double
              data:
                key: "2"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k2
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "2"

  # --- Key "3" (r0 c2) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_3
    row: 0
    col: 2
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k3
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k3
          - homeassistant.event:
              event: keypad_double
              data:
                key: "3"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k3
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "3"

  # --- Key "4" (r1 c0) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_4
    row: 1
    col: 0
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k4
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k4
          - homeassistant.event:
              event: keypad_double
              data:
                key: "4"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k4
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "4"

  # --- Key "5" (r1 c1) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_5
    row: 1
    col: 1
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k5
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k5
          - homeassistant.event:
              event: keypad_double
              data:
                key: "5"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k5
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "5"

  # --- Key "6" (r1 c2) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_6
    row: 1
    col: 2
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k6
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k6
          - homeassistant.event:
              event: keypad_double
              data:
                key: "6"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k6
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "6"

  # --- Key "7" (r2 c0) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_7
    row: 2
    col: 0
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k7
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k7
          - homeassistant.event:
              event: keypad_double
              data:
                key: "7"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k7
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "7"

  # --- Key "8" (r2 c1) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_8
    row: 2
    col: 1
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k8
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k8
          - homeassistant.event:
              event: keypad_double
              data:
                key: "8"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k8
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "8"

  # --- Key "9" (r2 c2) ---
  - platform: matrix_keypad
    keypad_id: espdeck_keypad
    id: key_9
    row: 2
    col: 2
    on_click:
      min_length: ${click_min_ms}
      max_length: ${click_max_ms}
      then:
        - script.execute: defer_single_k9
    on_multi_click:
      - timing:
          - "ON for ${click_min_ms} to ${click_max_ms}"
          - "OFF for at most ${double_gap_ms}"
          - "ON for ${click_min_ms} to ${click_max_ms}"
        then:
          - script.stop: defer_single_k9
          - homeassistant.event:
              event: keypad_double
              data:
                key: "9"
      - timing:
          - "ON for at least ${hold_ms}"
        then:
          - script.stop: defer_single_k9
          - homeassistant.event:
              event: keypad_hold
              data:
                key: "9"

# ========= Sensors =========
sensor:
  # Rotary Encoder — event-only (+1 / -1 per step), hidden numeric value
  - platform: rotary_encoder
    id: encoder_raw
    internal: true
    pin_a:
      number: ${ENC_A_PIN}
      mode: INPUT_PULLUP
    pin_b:
      number: ${ENC_B_PIN}
      mode: INPUT_PULLUP
    # Tuning: 1, 2, or 4 (2 suits many EC11 encoders)
    resolution: 2
    on_clockwise:
      - homeassistant.event:
          event: encoder_step
          data:
            delta: 1
    on_anticlockwise:
      - homeassistant.event:
          event: encoder_step
          data:
            delta: -1

  # Uptime (seconds)
  - platform: uptime
    name: "${device_name} Uptime Seconds"
    id: uptime_seconds

# ========= Text sensors (single block) =========
text_sensor:
  # Optional: last pressed key from the matrix_keypad platform
  - platform: matrix_keypad
    name: "${device_name} Keypad"
    id: keypad_text

  # Uptime (formatted)
  - platform: template
    name: "${device_name} Uptime"
    id: uptime_pretty
    icon: mdi:clock-outline
    update_interval: 60s
    lambda: |-
      if (!id(uptime_seconds).has_state()) return std::string("—");
      uint32_t sec = (uint32_t) id(uptime_seconds).state;
      uint32_t days = sec / 86400;   sec %= 86400;
      uint32_t hours = sec / 3600;   sec %= 3600;
      uint32_t mins = sec / 60;      sec %= 60;
      char buf[32];
      if (days > 0) snprintf(buf, sizeof(buf), "%ud %02u:%02u:%02u", days, hours, mins, sec);
      else          snprintf(buf, sizeof(buf), "%02u:%02u:%02u", hours, mins, sec);
      return std::string(buf);