Flash a Tree

Connect your wallet, plug in an ESP32, and flash the Orchard Tree firmware — then the Tree sets up its own WiFi and claims itself to your wallet. An Orchard Pass is required to flash.

1 · Connect wallet + verify your Orchard Pass

Use Connect Wallet (top-right) — works with Sage and Goby. We check that your wallet holds an Orchard Pass before flashing; the Tree binds to this wallet when it's claimed.

Connect your wallet to begin.

2 · Plug in your Tree

USB cable from your computer to the ESP32 board.
Confirm a new serial port shows up (COM4 on Windows, /dev/cu.SLAB_USBtoUART on macOS, /dev/ttyUSB0 on Linux).
If you don't see a port, install the CP210x USB-UART driver (Windows only — macOS and Linux ship it).

3 · Flash your Tree

🔒 Connect your wallet and verify your Orchard Pass (step 1) to unlock flashing.

4 · WiFi + claim — automatic

After flashing, the installer asks for your WiFi and sends it to the Tree over USB. The Tree joins your network, registers its claim code, and hands the browser a link straight to claiming it — your wallet's already connected, so it binds in one step. Then watch it live on the dashboard.

If the installer doesn't offer WiFi (older firmware on the board), claim it manually instead:

🌳 Claim a Tree manually →

What this firmware does

Self-detects the connected sensors (MQ-135, BME280, NEO-6M GPS — others over time).
Stores a per-device node id and HMAC signing secret in NVS on first boot.
Connects to WiFi using credentials you push during provisioning.
POSTs a signed sensor sample to your Oracle every 60 seconds.
Accepts OTA firmware updates from the dashboard on port 80.

Source, build configuration, and audit history: github.com/FlipThisCrypto/the-orchard.