{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/scottbambrick/esphome-whale-spout-bidet/blob/7631a44cb1505c33e144e43b7024899071ee5c17/docs/reverse-engineering.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Reconstructs the 433 MHz RF remote protocol of the non-Wi-Fi Xiaomi Whale Spout bidet seat and implements it in ESPHome on an ESP32 with a CC1101 radio. The project documents 2-FSK timing, 32-bit packets, settings fields and checksum behavior, then exposes control and remote-state monitoring through Home Assistant.",
  "description_zh": "项目还原非 Wi-Fi 版 Xiaomi Whale Spout 坐便盖的 433 MHz 射频遥控协议，并用 ESP32 与 CC1101 在 ESPHome 中实现。文档记录了 2-FSK 时序、32 位数据包、设置字段和校验规则，并通过 Home Assistant 提供控制及遥控器状态监听。",
  "entry_url": "https://awesomerea.org/resources/whale-spout-bidet-protocol-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/whale-spout-bidet-protocol-case/",
  "evidence_url": "https://github.com/scottbambrick/esphome-whale-spout-bidet/blob/7631a44cb1505c33e144e43b7024899071ee5c17/README.md",
  "group": "cases",
  "id": "whale-spout-bidet-protocol-case",
  "json_url": "https://awesomerea.org/resources/whale-spout-bidet-protocol-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/whale-spout-bidet-protocol-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/whale-spout-bidet-protocol-case/index.md",
  "name": "Xiaomi Whale Spout bidet: reconstructing its RF remote protocol",
  "name_zh": "Xiaomi Whale Spout bidet：重建射频遥控协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "The remote-controlled non-Wi-Fi Whale Spout seat, its remote, an ESP32, CC1101 module and antenna are specified.",
    "An RTL-SDR is used to calibrate the radio frequency.",
    "The author reports testing with one seat and one remote; reception may miss presses.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要非 Wi-Fi 版 Whale Spout 坐便盖及其遥控器、ESP32、CC1101 模块和天线。",
    "射频校准使用 RTL-SDR。",
    "作者仅在一套坐便盖与遥控器上测试，接收可能漏掉按键。",
    "许可证：MIT。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/scottbambrick/esphome-whale-spout-bidet",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}