Flash a Tree
One-click installer for the Orchard Tree firmware. Plug an ESP32 into your computer, click Connect, pick the serial port, and the latest signed firmware flashes in about 30 seconds.
1 · Plug in your Tree
- USB cable from your computer to the ESP32 board.
- Confirm a new serial port shows up
(
COM4on Windows,/dev/cu.SLAB_USBtoUARTon macOS,/dev/ttyUSB0on Linux). - If you don't see a port, install the CP210x USB-UART driver (Windows only — macOS and Linux ship it).
2 · Click Install, pick your board
When you click the button below, your browser opens a
small dialog listing every serial port on your machine —
pick the one labeled Silicon Labs CP210x (Windows)
or cu.SLAB_USBtoUART (macOS) or
ttyUSB0 (Linux). If you have several boards
plugged in, they all appear here so you can choose which one
to flash.
From there the installer will:
- Erase the board's existing firmware.
- Write a fresh Orchard Tree firmware image
(
~1 MB, version0.4.9). - Reboot the board into the Orchard runtime.
https:// or http://localhost.
Requires a Chromium-based browser (Chrome / Edge / Brave / Opera). Firefox and Safari don't expose the Web Serial API yet. Close any other program holding the port (PlatformIO monitor, Arduino IDE, PuTTY) before clicking — Windows lets only one process own a COM port at a time.
3 · Claim your Tree
When the flash finishes, the board reboots and shows a claim code. Head to the claim page, connect your Chia wallet (Sage or Goby), prove your Orchard Pass, and enter the code — your Tree is bound to you and starts reporting.
First connect your WiFi too: point the Tree at your network during setup so it can reach the oracle. New here? The Operator Quickstart walks through the whole flow.
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.