Get your node online

Three steps: flash the firmware, connect to WiFi, personalize your node. Takes about 5 minutes. No coding required.

Flash the firmware

Connect your SenseCAP D1 (the physical device) to your computer via USB-C, then click the button below. Your browser will ask you to select a device, pick the one named “USB Serial” / “CP210x”, not the one named “RP2040 / INDICATOR” (that's the other chip and the flash will time out). The flash takes about 30 seconds.

⚠ Requires Chrome or Edge on desktop. Firefox and Safari don't support WebSerial yet.

Latest firmware:checking…

Both the Install button and the sensor-chip download below always fetch this latest version.

Your browser doesn't support WebSerial. Please use Chrome or Edge on desktop.

The flasher will ask: “Erase device? All data will be lost.”

That prompt comes from the flashing tool, not from us. Here's when to say yes:

First time on a brand-new device (still on the factory firmware): erase: it clears the old factory data for a clean start.
Updating a device that already runs TurboUSD: don't erase. Erasing wipes your saved WiFi, node identity and settings, so you'd have to set the device up from scratch. A normal update keeps everything.

Having trouble? Manual flash instructions

If the browser flasher doesn't work, you can flash manually with PlatformIO:

Install PlatformIO (free, works with VS Code)
Download the latest firmware from GitHub Releases
Run: pio run --target upload from the firmware-esp32/ folder

"Port not found" error? Hold the BOOT button on the device while connecting the USB cable, then try again.

🔔 Also flash the buzzer chip, one-time, takes 30 seconds

The SenseCAP D1 has a second chip (the RP2040) that drives the alarm buzzer. Until you flash it, the alarm stays silent. It can't be flashed via browser, you need to drag a file onto it like a USB drive.

Enter bootloader mode: With the device unplugged, find the tiny pinhole button on the bottom edge, next to the USB-C port, and press it in with a paperclip or needle. Keep it held while you plug in the USB-C cable, then release. A drive called RPI-RP2 appears on your desktop like a USB stick or external hard drive (look on the Mac desktop / in Finder, or under This PC on Windows).
Download the file below and drag it onto the RPI-RP2 drive. The drive will disappear and the device restarts automatically, that means it worked.

⬇ Download latest RP2040 firmware

Connect to WiFi

After flashing, the device restarts and shows: "Connect your phone to: TurboUSD-Setup-XXXX".

📱On your phone, open WiFi settings and connect to the TurboUSD-Setup network.

🌐A setup page opens automatically (like a hotel captive portal). If not, go to 192.168.4.1 in your browser.

✅Enter your home WiFi name and password, then tap "Save". The device connects and shows the main clock screen.

Tip: The device connects to 2.4 GHz networks only. If your router broadcasts both bands, make sure 2.4 GHz is enabled or use its dedicated SSID.

Set up your node

Once online, your node appears in the TurboUSD Network with a temporary name. Scan the QR code on your device screen (on the footer), it opens your personal setup page directly, no code needed.

✏️Set a name and bio, shown on the public network page.

💳Add your wallet address (Base network), required to receive ₸USD mining rewards.

🌍Set your country and optional city.

🏆Submit for verification: post a video on X tagging @turbousd and showing your node's home screen (it must match your node ID) to earn the ✓ badge and start receiving rewards.

Already flashed and connected your node to WiFi?

Open Settings on your device (tap the QR icon in the footer) and scan the QR code: it opens your private setup page directly. Your setup link includes a secret owner token, so only whoever holds the device can edit your node. Can't scan? Type the exact URL shown right below the QR instead.

Entering just the node code opens the public profile (no editing):

Questions? Find us on X (@TurboUSD) | Software is open source.