Case study

Xiaomi Whale Spout bidet: reconstructing its RF remote protocol

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-08

Stars: 0
Last commit: 2026-11-09
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

Prerequisites: The remote-controlled non-Wi-Fi Whale Spout seat, its remote, an ESP32, CC1101 module and antenna are specified.
Prerequisites: An RTL-SDR is used to calibrate the radio frequency.
Limits: The author reports testing with one seat and one remote; reception may miss presses.
License: MIT license.

Cite

BibTeX

@misc{whale-spout-bidet-protocol-case,
  title = {{Xiaomi Whale Spout bidet: reconstructing its RF remote protocol}},
  howpublished = {\url{https://github.com/scottbambrick/esphome-whale-spout-bidet}},
  url = {https://github.com/scottbambrick/esphome-whale-spout-bidet},
  urldate = {2026-11-08},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/whale-spout-bidet-protocol-case/}}
}

Plain text

Xiaomi Whale Spout bidet: reconstructing its RF remote protocol. https://github.com/scottbambrick/esphome-whale-spout-bidet (accessed 2026-11-08). Awesome REA entry: https://awesomerea.org/resources/whale-spout-bidet-protocol-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · scottbambrick/esphome-whale-spout-bidet · Revision 7631a44
docs/reverse-engineering.md GitHub · scottbambrick/esphome-whale-spout-bidet · Revision 7631a44