Frostcaller ยท the writing desk

THE SCRIBE

Plug the board into this computer and talk to it from this page โ€” no drivers to hunt down, no serial monitor to install, nothing uploaded anywhere. Identify the chip, watch the live log, catch the codes your remote is shouting, and send commands back. It speaks Flipper Zero too.

The console

Everything the board says, as it says it. This is the same stream ESPHome shows you in its LOGS window, and the same one the Arduino Serial Monitor would show โ€” only you did not have to install either.

Not connected

The dolphin is welcome here

A Flipper Zero is a serial port with a command line on it, which means this page can drive it. It becomes the best infrared receiver in the house โ€” no wiring, no config, no board to flash โ€” and whatever it catches is converted straight into ESPHome, Tasmota, Broadlink or SmartIR.

Bring a .ir file in

Somebody has probably already captured your air conditioner. Take the file from one of the databases below, drop it here, and it becomes ESPHome config โ€” you do not even need to own a Flipper for this part.

Drop .ir files here

or paste one โ–พ

Send one back out

Everything in your capture list can be written back as a .ir file and copied onto the Flipper over USB โ€” so a code caught by an ESP board ends up on the dolphin, and the other way around.

Put the file in /ext/infrared/ on the SD card. The Flipper lists it under Infrared โ†’ Saved Remotes.

Where the codes already live

The community has captured an enormous number of remotes already, air conditioners very much included. All free, all plain text files.

Caught in the act

Anything that looks like an infrared code gets pulled out of the stream and kept here โ€” from an ESP board, from a Flipper, or from a file you dropped in. They survive a reload, so an evening of pressing buttons is not lost to a stray refresh.

For an ESP board you need a config with remote_receiver: and dump: all โ€” the capturing chapter has the eight lines, and the config writer can tick the box for you. For a Flipper, just press Listen above.

none yet

Compare two of them

Capture the same thing twice with one setting changed โ€” 22 degrees, then 23 โ€” tick both, and see exactly which part of the message carries the temperature. This is how an unknown protocol gets taken apart, and nothing else makes it easy.

The laboratory

Past copying codes and into understanding them. This is what turns โ€œa few buttons that workโ€ into a driver that gives everybody a real thermostat.

๐Ÿงฎ Work out the checksum

Nearly every air-conditioner message ends with a check byte, and until you know how it is calculated you can only replay the states you captured. Tick two or more raw captures above: this decodes them into bytes, highlights the ones that move, and tries the common schemes until one explains every message.

๐Ÿงฌ Generate an ESPHome component

The real prize. If you have worked out a protocol nobody supports, this writes the skeleton of a climate_ir component using the timings from your own captures โ€” so your unit can become natively supported for everybody.

๐ŸŽฌ Record and replay

Save everything on screen โ€” the log and the captures โ€” into one file. Somebody else can load it here and see exactly what you saw, which makes helping a stranger remotely genuinely possible.

๐ŸŒ Pull from Flipper-IRDB

Writing back

The console works both ways. What that gets you depends entirely on what the board is running โ€” so read the honest note before wondering why nothing happens.

Ready-made air-conditioner commands

For a board running Tasmota, these are complete working commands. Build one, send it, and the unit should answer.

Which protocol is it?

Stop guessing from a brand table. Send one candidate at a time and watch the unit โ€” the one it answers to is the one you want.

Putting firmware on it

The honest state of play, and the two buttons that actually do it today.

This page does not write firmware yet โ€” on purpose. Reading from a board is harmless; writing to one can leave you holding a brick, and I will not ship flashing code I have not run against real hardware. What this page does do is prove the hard part works: your cable, your driver, your port and your chip, all confirmed by the Identify the board button above. Once that succeeds, either installer below will succeed too. The full plan for bringing flashing in-page โ€” including why it is more than a weekend โ€” is written out in todo-writer.md.

ESPHome Web

The official browser installer. Prepares a blank board, joins it to your Wi-Fi and hands it to your own ESPHome. This is the route the guide assumes.

Open ESPHome Web โ†—

Tasmota installer

Pick the tasmota-ir build and you get a finished infrared firmware with no compiling at all. It talks to Home Assistant over MQTT, and the Writing back section above drives it directly.

Open the Tasmota installer โ†—

Close this page's connection first. A serial port belongs to one tab at a time โ€” press Disconnect above before an installer tries to open it, or it will tell you the port is unavailable and you will blame the cable.