Linked Lamp | Flash Software

Step 3: Flash Your Lamps

Enter your details below to generate your unique configuration. None of this data leaves your browser — a temporary, secure connection may be made to the broker to retrieve device data.

MQTT Broker URL info

MQTT Username

MQTT Password

← Back to Assembly

usb

Flash Lamp A

Connect the first ESP32 to your computer via USB.

0%

check_circle

Lamp A Flashed Successfully!

Unplug this ESP32. Now connect the second one.

usb

Flash Lamp B

Disconnect Lamp A's ESP32 and connect the second ESP32 via USB.

0%

check_circle

Lamp B Flashed Successfully!

Both lamps are now programmed! 🎉

Device A: Setup Config

You'll Need VS Code + PlatformIO

Since your browser doesn't support one-click flashing, you'll use VS Code with the PlatformIO extension to flash the lamp.

1. Download the Code

Go to the GitHub Repository, click the green "<> Code" button, and select Download ZIP. Extract the folder.

2. Open the Firmware Folder

Open VS Code. Go to File > Open Folder and select either the firmware/pcb folder OR the firmware/neopixel folder depending on what hardware you built. Wait a minute for the PlatformIO extension to install its tools.

3. Create your Config

Below is the exact config.json file for your first lamp. In VS Code, open the folder data/, rename config.example.json to config.json, and paste this text inside it.

Device A: Flash Firmware

Now that your config file is saved, plug Lamp A's ESP32 into your computer via USB.

In PlatformIO (VS Code), do these two steps:

1. Upload File System Image: Click the PlatformIO Ant head icon on the left sidebar, open esp32dev > Platform, and click Upload Filesystem Image. *(This pushes your config info into the lamp's storage).*

2. Upload Code: Click the Upload button (→ arrow in the bottom blue bar) to flash the main firmware.

Tip: Depending on your ESP32 board, if it fails to flash, you may need to press and hold the BOOT button on the ESP32 when the upload process starts, and let go once it begins flashing.

Wait for both to say SUCCESS. If they do, Lamp A is fully programmed!

Device B: Setup Config

Now unplug Lamp A and plug in Lamp B's ESP32.

Here is the second config. Replace the contents of your config.json file with this new text. Notice the device_id is now "B".

Device B: Flash Firmware

Same as before, upload the new config and firmware to Lamp B.

1. Upload Filesystem Image (Pushes the new "B" config)

2. Upload (Flashes the firmware)

Tip: Depending on your ESP32 board, if it fails to flash, you may need to press and hold the BOOT button on the ESP32 when the upload process starts, and let go once it begins flashing.

Wait for both to say SUCCESS. You're done programming!

celebration

Setup Complete!

Here are the Unique IDs (UIDs) used to connect your lamps to the Dashboard.
Save these! Send the second one to your partner.

Device A

Device B

Open Dashboard
How to Use Your Lamps →
Return Home