# I Plugged a Mushroom Grower Into My Laptop

> 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.

- Canonical URL: https://webofmike.com/plugged-a-mushroom-grower-into-my-laptop/
- Author: Mike Moore (https://webofmike.com/about/)
- Published: 2026-10-24
- Last modified: 2026-11-15
- Tags: OpenShrooly, Build in Public, Home Automation
- Cite as: Mike Moore, "I Plugged a Mushroom Grower Into My Laptop", Web of Mike (webofmike.com), 2026-10-24. https://webofmike.com/plugged-a-mushroom-grower-into-my-laptop/


This is episode 1 of [The OpenShrooly Journey](/openshrooly/), 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](https://openshrooly.com/) 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:

```bash
python3 -m venv ~/.openshrooly-venv
~/.openshrooly-venv/bin/pip install esptool
```

Then I asked the chip to identify itself:

```bash
~/.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](https://openshrooly.com/docs/manual-installation/) 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.

```bash
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](/how-grok-and-jev-put-my-mushroom-chambers-on-autopilot/).

Follow along on the [progress tracker](/openshrooly/).

