0xreversed/with.ai
Firmware and hardwareWorksSource available
Target: Xiaomi Whale Spout remote-controlled bidet seat

Xiaomi Whale Spout ESPHome Integration

What was done

An ESP32 and CC1101 integration controls a remote-only Xiaomi Whale Spout bidet seat through its 433 MHz RF protocol and mirrors remote changes into Home Assistant.

This ESPHome project controls the remote-controlled Xiaomi Whale Spout bidet seat using an ESP32 and CC1101 radio module. It reverse engineers the seat’s 433 MHz remote protocol and listens to the physical remote so Home Assistant can reflect settings that the seat itself does not report.

Protocol and features

The project documents fixed 32-bit 2-FSK packets at 433.908 MHz, including the command and settings fields and checksum. Its Home Assistant entities control wash, dry, seat and water settings, and show the last remote button and packets heard. A control lock requires a press on the physical remote before remote operation is enabled. The README includes wiring, frequency calibration steps, an example ESPHome configuration and an optional dashboard and away automation.

AI contribution and limits

The repository’s initial release and follow-up integration commits include Claude Sonnet 5.5 co-author trailers. This shows Claude participating in implementation and documentation around the protocol integration; the author does not separately attribute individual protocol discoveries to the model. The project is for the non-Wi-Fi remote-controlled seat, not the Wi-Fi Pro model, and the README says the protocol was verified on that seat.