I Plugged a Mushroom Grower Into My Laptop

Part of: The OpenShrooly Journey

Episode 1 of the OpenShrooly journey: finding the ESP32-S3 inside my Shrooly mushroom grower over USB, the esptool setup, and the replug that fixed it.

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.

Frequently asked questions

How does a Shrooly show up when you plug it into a Mac?

Mine showed up as an Espressif USB JTAG serial debug unit at /dev/cu.usbmodem2101. That’s the built-in USB port on the ESP32 chip inside, so no extra driver was needed on macOS.

What chip is inside the Shrooly?

An ESP32-S3 with 16MB of flash and 2MB of PSRAM, with Wi-Fi and Bluetooth LE. esptool reported all of that with its flash_id command.

What if esptool says it can't connect to the Shrooly?

My first attempts failed with No serial data received, even with a forced USB reset, and nothing else was holding the port. Unplugging the USB cable and plugging it back in fixed it. If that doesn’t work for you, try holding the BOOT button while you reconnect.

Should I back up the Shrooly firmware before flashing OpenShrooly?

Yes. The OpenShrooly manual install guide says to read the full 16MB flash to a file with esptool read_flash before writing anything. That backup is your way back to stock.

Disagree or have a war story? Reply on X