Released on September 14, 2025

Release Notes

Updates in this release:

  • This fixes the issue with humidity control. We’ve introduced a new ESPHome component called SWDProgrammer that sends the original shrooly coprocessor firmware to the RP2040 on the other board. This should mean no more issues with Humidity control becoming unavailable after a power cycle. Super indebted to @SukuWc for the sample code that made this possible, and a few others for their moral and technical support!

    • This was surprisingly difficult to get right. The SWD Programming Code required a lot of ChatGPT, and I don’t fully understand it, but it seems pretty reliable.

    • Right now this isn’t fully open source because I’m using the compiled code that I captured from their device. It should be pretty easy to write an open-source firmware for the RP2040, but it’s past 1am and not happening tonight.

  • Added touch sensing on the 4 capacitive buttons on top. These don’t do anything yet but you can now detect them all and this could be used to build an on-device UI

  • Added water level sensing. To make this work properly you’ll need to completely dry out your water reservoir and then pretty the “Calibrate Dry Tank” button twice. That’ll take a set of reading and save them to nvram that can be used to estimate the water level. This is still pretty iffy, but I gave it a good shot.

  • We monitor the system 12V supply - uhh because we can.

  • Cleaned up the LED intensities so they are all in percentages

  • Added Timezone support so you can set your sunrise time in local time. This should print lots of good debugging information when you adjust times to show when they turn on.

  • Added debugging scripts that fire warnings if your Air Exchange fan doesn’t start or if the humidifier runs without increasing humidity.

  • Broke the code down into even more YAML files to try and keep it better organized for other people to work with

Web Install

Install OpenShrooly 0.4.0 directly from your browser - no downloads or command line required!

🚀 Install v0.4.0

Requires Chrome, Edge, or Opera browser on desktop and a USB cable

Direct Downloads

Factory Binary

openshrooly-esp32s3.factory.bin

1.1 MB

For first-time installation or recovery

OTA Binary

openshrooly-esp32s3.ota.bin

1015.0 KB

For updating existing installations

More Information

View this release on GitHub: Release 0.4.0