This is episode 1 of The OpenShrooly Journey, where I take my Shrooly mushroom grower off a dead cloud and onto open firmware.
The short version: the Shrooly company looks to be gone, and per the OpenShrooly project a lot of owners lost their app. The hardware is still fine. It just needs new brains.
What did the Mac see when I plugged the Shrooly in?
I plugged the Shrooly into my MacBook Pro with a USB cable and asked the Mac what it saw. It came back as:
- Vendor: Espressif
- Product: USB JTAG serial debug unit
- Port: /dev/cu.usbmodem2101
That’s the giveaway. Espressif makes the ESP32 family, and that name means the chip’s own USB port is wired straight out. No adapter board, no driver hunt.
How do you install esptool for this?
The flashing tool for ESP32 chips is esptool. I didn’t want it loose on my system, so it got its own Python virtual environment:
python3 -m venv ~/.openshrooly-venv
~/.openshrooly-venv/bin/pip install esptool
Then I asked the chip to identify itself:
~/.openshrooly-venv/bin/esptool.py --port /dev/cu.usbmodem2101 flash_id
What happens if esptool cannot connect?
A fatal error occurred: Failed to connect to Espressif device: No serial data received.
I tried again with a forced USB reset. Same thing. I checked whether some other app was holding the port. Nothing was.
The fix was the oldest trick there is. I unplugged it and plugged it back in. That’s it.
What chip is inside the Shrooly?
Second run, it answered right away:
- Chip: ESP32-S3 (QFN56), revision v0.2
- Features: Wi-Fi, Bluetooth LE, 2MB embedded PSRAM
- Flash: 16MB, quad mode, 3.3V
- USB mode: USB-Serial/JTAG
The chip also reports its MAC address. I’m not posting mine, and you shouldn’t post yours either.
16MB of flash is what the OpenShrooly manual install guide expects, so we’re on the right path.
What comes after identifying the chip?
Nothing has been written to the grower yet. The next step is the one you never skip: read the full 16MB of stock flash to a file so there’s always a way back.
esptool --port /dev/cu.usbmodem2101 read_flash 0x000000 0x1000000 shrooly_backup.bin
After that came the backup, the flashes, and the Autopilot loop. I wrote that up in I Used a Grok Bot and Jev to Put My Mushroom Chambers on Autopilot.
Follow along on the progress tracker.