用 NT$220 让自发电开关接上 Home Assistant

# ─────────────────────────────────────────────────────────────────────────
# rf-bridge —— ESP32-C3 SuperMini + CC1101 的 433MHz 收发闸道
#
# 目的：解决客厅/房间的「自发电无线开关」无法进 HA 的问题。
#   • RM4 Pro 收不到这种开关（它的射频只认特定协定，且时间解析度不够细）
#   • CC1101 能侧录任意 OOK 原始波形 → 录下开关的码 → 用同一片发射给通断器
#
# 用法分两阶段：
#   阶段一（录波）：dump: raw，按墙上开关，看 log 印出的原始时序。
#                  这时把本装置拿到开关旁边（行动电源供电）确保收得到。
#   阶段二（控灯）：把录到的码填进下面 script 的 transmit_raw，找个收得到两间房的位置常驻。
#
# 脚位对照 ESP32-C3 SuperMini 的丝印：
#   SPI 走板子本来就标好的 SCK(IO4) / MISO(IO5) / MOSI(IO6) / SS(IO7)
#   两支 GDO 走板上「完全没有开机或系统职责」的自由脚：IO3 和 IO10
#   （另外两支自由脚 IO0 / IO1 留着备用）
# 避开 IO2 / IO8 / IO9 这三支 strapping，以及 IO20 / IO21 这两支 UART。
# 注：IO4~IO7 在资料上标为 JTAG(MTMS/MTDI/MTCK/MTDO)，但 C3 内建 USB-JTAG，
#     不接外部 JTAG 的话拿来当 SPI 是正常用法，那也是板厂标示的用途。
# ─────────────────────────────────────────────────────────────────────────

substitutions:
  name: rf-bridge
  friendly_name: "RF Bridge (CC1101)"

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  min_version: 2024.6.0
  on_boot:
    # 保险：明确让 CC1101 开机就进接收模式。
    # 官方范例只在「发射完成后」才 begin_rx，没交代开机初始状态，
    # 录波阶段收不到东西的话会很难分辨是没讯号还是没在收。
    priority: -100
    then:
      - cc1101.begin_rx: transceiver
      # 把记住的灯状态「显示」回 HA，只 publish 不执行动作，不会送任何 RF 讯号
      - lambda: |-
          id(room_light).publish_state(id(room_light_saved));
          id(mom_light).publish_state(id(mom_light_saved));

esp32:
  board: esp32-c3-devkitm-1     # C3 SuperMini 用这个 board 设定即可
  framework:
    type: esp-idf

logger:
  # 平常用 INFO。要再录新的遥控器时改回 DEBUG，并把下面 remote_receiver
  # 的 dump: raw 打开，才看得到原始 µs 时序。
  level: INFO
  # ⚠️ ESP32-C3 的 logger 预设输出到 UART0（实体脚 GPIO20/21），
  #    那两支没接任何东西 → 从 USB 读 log 会是一片空白（我第一次烧就踩到）。
  #    要明确指定走晶片原生的 USB Serial/JTAG 才看得到开机讯息。
  hardware_uart: USB_SERIAL_JTAG

api:
  # 给 HA 的「只改显示、不发射」指令：HA 用光线感测器发现状态对不上时呼叫，
  # publish_state 会触发 on_state，所以快闪里记的状态也会一起更新。
  actions:
    - action: set_room_light_state
      variables:
        state: bool
      then:
        - lambda: id(room_light).publish_state(state);
    - action: set_mom_light_state
      variables:
        state: bool
      then:
        - lambda: id(mom_light).publish_state(state);
  encryption:
    key: !secret rf_bridge_api_key

ota:
  - platform: esphome
    password: !secret rf_bridge_ota_password

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  # ⚠️ 必须关省电。ESP32-C3 的 WiFi light sleep 会造成两个问题（都实际踩过）：
  #   1. 区网内 ping 延迟飙到 67~147ms 且剧烈抖动 —— 对要即时反应的 RF 桥接器不能接受
  #   2. USB Serial/JTAG 会跟着失效，序列埠变成一片空白，害我一度以为晶片当机
  power_save_mode: NONE
  # ⚠️ 不要长期插在伺服器 / 电脑的 USB 3.0 孔上：那里的 2.4GHz 杂讯让它一天断 17 次，
  #    改插手机充电头后 2 天 0 次。
  #    试过 output_power: 8.5dB → 断电重开后也完全连不上，比预设更糟，已拿掉。
  # 断线时记一笔，连回来后 HA 就看得到这次开机断了几次
  on_disconnect:
    - lambda: id(wifi_drops) += 1;
  # 收讯不稳时的后援热点（第一次设定用）
  ap:
    ssid: "rf-bridge-setup"
    password: !secret rf_bridge_ap_password

globals:
  - id: wifi_drops
    type: int
    restore_value: no
    initial_value: '0'
  # 两盏灯最后的状态，存在快闪里，重开机后拿来还原 HA 的显示
  - id: room_light_saved
    type: bool
    restore_value: yes
    initial_value: 'false'
  - id: mom_light_saved
    type: bool
    restore_value: yes
    initial_value: 'false'
  # 记录最后一次发射的时间，给 on_raw 做冷却判断用
  - id: last_tx_ms
    type: uint32_t
    initial_value: '0'

captive_portal:

# 内建网页介面 —— 用来直接测试按钮，不必先接进 HA。
# 之后要拿掉就删这段（会省下一点 flash）。
web_server:
  port: 80
  version: 3

# 首次用 USB 序列烧录后，之后可走 WiFi OTA
improv_serial:

# ─── SPI 汇流排：软体 SPI，用避开雷脚的一般 GPIO ───
spi:
  clk_pin: GPIO4
  miso_pin: GPIO5
  mosi_pin: GPIO6

# ─── CC1101 本体 ───
# 频率锁 433.92（我的开关晶振 26.2982×16.5 换算出来的值）。
cc1101:
  id: transceiver
  cs_pin: GPIO7
  frequency: 433.92MHz
  modulation_type: ASK/OOK
  # 350kHz 太宽，AGC 会把底噪也放大进来。收窄到 200kHz 压杂讯。
  # （实测 325kHz 时每按一次开关会收到 8 笔长度不一的碎片）
  filter_bandwidth: 200kHz
  # ⚠️ symbol_rate 会影响 CC1101 的资料滤波器频宽，不是「只在发射时有用」。
  #    原本设 5000（5 kbaud = 200µs/符号），但实测讯号的基本时间单位是 25µs
  #    （所有脉冲宽度都是 25 的整数倍：25/50/75/100/.../475/875），
  #    等于快了 8 倍，滤波器会把快速变化抹掉 → 每次解调出来都不一样。
  #    40000 baud = 25µs/符号，刚好对上讯号的最小特征。
  symbol_rate: 40000
  output_power: 10             # dBm，最大约 +11
  # 注：cc1101 没有 rssi / lqi 这两个设定项（我一开始写错，compile 直接挡下来）。
  #     RSSI 和 LQI 只在 packet_mode 的 on_packet 触发器里当变数用，
  #     async 模式（我们用的这个）拿不到，也挂不出感测器实体。

# ─── 接收（双针接法，GDO2）───
remote_receiver:
  id: rx
  pin:
    number: GPIO3               # 接 CC1101 GDO2
  # 录波时打开 `dump: raw` 才看得到原始 µs 时序。
  # ⚠️ 不要用 dump: all —— 那只启用「协定解码器」，不含原始波形，
  #    而且会把杂讯硬套成 Pronto / Beo4 等红外线协定，洗版又没用。
  # 平常关掉：反向侦测靠的是下面的 on_raw，不需要 dump 就能运作，
  #          开着会把邻居的遥控器和杂讯也全部印进 log。
  # dump: raw
  # ⚠️ filter 不只是「丢掉短脉冲」，它会把短脉冲两侧的讯号「合并」起来：
  #      真实 185高 / 60低 / 185高  →  filter 90µs 之后变成单一个 430µs 高
  #    所以 90µs 时录到的 477 / 327 很可能是这样造出来的假值。
  #    近距离录波时讯号远高于杂讯，filter 可以放低才录得到真实结构。
  filter: 20us
  # idle 拉长，确保一次按压的所有重复框都收在同一笔里，不会被切断
  idle: 25ms
  tolerance: 45%
  # 注：接收端不需要（也不接受）on_transmit / on_complete。
  #     模式切换全部由 remote_transmitter 那边负责，发射完会自己切回 rx。
  #
  # ── 反向侦测：有人按实体开关时，翻转 HA 里的状态 ──
  # 不用 ESPHome 内建的 raw 比对，因为那要求从框的开头对齐，
  # 而我们的撷取起始相位不固定（同一次按压会收到 2~4 次重复，起点不一定）。
  # 改成自己解成 26 bit 再比数值，不管从哪里开始都认得出来。
  on_raw:
    then:
      - lambda: |-
          // 发射后 1 秒内忽略，避免自己发的讯号把状态翻两次
          static uint32_t last_seen = 0;
          if (millis() - id(last_tx_ms) < 1000) return;

          uint32_t code = 0; int nbits = 0;
          for (size_t i = 0; i + 1 < x.size(); i += 2) {
            int32_t m = x[i], sp = -x[i+1];
            if (m < 20 || sp < 20) { code = 0; nbits = 0; continue; }
            if (sp > 400) {            // 同步间隔 → 一个框结束
              code = 0; nbits = 0; continue;
            }
            code = (code << 1) | (m > sp ? 1 : 0);
            if (++nbits > 26) { code &= 0x3FFFFFF; nbits = 26; }

            if (nbits == 26) {
              if (millis() - last_seen < 800) break;   // 同一次按压的重复框只算一次
              if (code == 0x0000000UL) {     // 换成房间灯的 26 bit 数值
                last_seen = millis();
                ESP_LOGI("rf", "侦测到实体开关：房间灯");
                id(room_light).publish_state(!id(room_light).state);
                break;
              } else if (code == 0x0000001UL) {   // 换成妈妈房间灯的 26 bit 数值
                last_seen = millis();
                ESP_LOGI("rf", "侦测到实体开关：妈妈房间灯");
                id(mom_light).publish_state(!id(mom_light).state);
                break;
              }
            }
          }

# ─── 发射（双针接法，GDO0）───
remote_transmitter:
  id: tx
  pin:
    number: GPIO10              # 接 CC1101 GDO0
  carrier_duty_percent: 100%
  on_transmit:
    then:
      - lambda: 'id(last_tx_ms) = millis();'
      - cc1101.begin_tx: transceiver
  on_complete:
    then:
      - cc1101.begin_rx: transceiver

# ─── 灯的开关实体 ───
# 用 switch 而不是 button，这样 HA 有「开/关」状态可以显示与自动化。
# RF 这种开关只有「切换」一个动作（没有分开的开/关指令），
# 所以 turn_on 和 turn_off 送的是同一组码，靠 optimistic 维持状态。
# 有人按实体开关时，上面 remote_receiver 的 on_raw 会把状态翻过来。
#
# 两颗开关的码（2026-09-09 录，各自贴着模组按十次取共识）：
#   房间灯     26 bit = <你的码>
#   妈妈房间灯 26 bit = <你的码>
#   前 10 bit 相同（同型号厂商码），之后分歧 → 不会互相干扰
switch:
  - platform: template
    name: "房间灯"
    id: room_light
    icon: "mdi:ceiling-light"
    optimistic: true
    # ⚠️ 预设 restore_mode 是 ALWAYS_OFF，开机时会「真的执行一次 turn_off」，
    #    而 turn_off 送的是切换码 → 每次重开机灯都被切换一次。所以必须 DISABLED，
    #    状态改由上面 globals 记住、on_boot 只显示不发射。
    restore_mode: DISABLED
    on_state:
      - lambda: id(room_light_saved) = x;
    turn_on_action: &toggle_room
      - script.execute: tx_room_light
    turn_off_action: *toggle_room

  - platform: template
    name: "妈妈房间灯"
    id: mom_light
    icon: "mdi:ceiling-light"
    optimistic: true
    # ⚠️ 预设 restore_mode 是 ALWAYS_OFF，开机时会「真的执行一次 turn_off」，
    #    而 turn_off 送的是切换码 → 每次重开机灯都被切换一次。所以必须 DISABLED，
    #    状态改由上面 globals 记住、on_boot 只显示不发射。
    restore_mode: DISABLED
    on_state:
      - lambda: id(mom_light_saved) = x;
    turn_on_action: &toggle_mom
      - script.execute: tx_mom_light
    turn_off_action: *toggle_mom

# ─── 发射排队 ───
# HA 上连按时，两串讯号若黏在一起，灯只会当成按一次，但 HA 已经翻了两次 → 不同步。
# 所以每盏灯一个 queued script：一次只发一串，发完至少隔 700ms 才发下一串。
script:
  - id: tx_room_light
    mode: queued
    max_runs: 6
    then:
      - remote_transmitter.transmit_raw:
          code: [<换成你录到的码>]
          repeat:
            times: 8
            wait_time: 0s
      - delay: 700ms
  - id: tx_mom_light
    mode: queued
    max_runs: 6
    then:
      - remote_transmitter.transmit_raw:
          code: [<换成你录到的码>]
          repeat:
            times: 8
            wait_time: 0s
      - delay: 700ms

# ─── 诊断 ───
sensor:
  - platform: wifi_signal
    name: "${friendly_name} WiFi"
    update_interval: 60s
    entity_category: diagnostic
  - platform: uptime
    name: "${friendly_name} 开机时间"
    update_interval: 60s
    entity_category: diagnostic
  - platform: template
    name: "${friendly_name} WiFi 断线次数"
    lambda: return id(wifi_drops);
    accuracy_decimals: 0
    state_class: measurement
    update_interval: 60s
    entity_category: diagnostic

text_sensor:
  - platform: wifi_info
    ip_address:
      name: "${friendly_name} IP"
    bssid:
      name: "${friendly_name} BSSID"
  - platform: debug
    reset_reason:
      name: "${friendly_name} 重开原因"

debug:
  update_interval: 5min