dubpixel dpx_tc002

Visual install guide

Same install as the quick-flash page, walked through screen by screen — useful if you'd rather see it than read it.

Quick guide Visual guide
⚠️ Requires desktop Chrome or Edge (Web Serial API). Safari, Firefox, and mobile browsers can't do this — use the PlatformIO CLI instead on those.

Start here

ℹ️ These screenshots show a specific firmware version number as an example — you do not need to match it. Always install whatever build the dropdown above shows; the version in these images will look older than that, and that's fine.
1

Plug in the device, then click Connect above

Use a real data cable, not a charge-only one. Click the install button in the panel above — it opens a small dialog like this:

ESP Web Tools dialog showing 'dpx_tc002 v0.4.7 (Ulanzi TC001)' with an Install option

Click "Install dpx_tc002 …" — not "Logs & Console" (that's for debugging an already-flashed device).

2

Pick the serial port

Your browser will list available ports. Look for one named after a USB-serial chip (e.g. CP210x, CH340) or marked USB Serial — not Bluetooth ports.

Browser serial port picker dialog with the correct USB Serial (Paired) entry selected and Connect enabled
3

Erase device — check this box if it's the first flash

Factory-fresh device, or previously ran stock Awtrix/other firmware? Check Erase device. Skipping this on a true first flash can leave old settings behind and cause boot issues.

Erase device dialog with the Erase device checkbox checked
Already running dpx_tc002 and just updating? Leave it unchecked — your WiFi and settings stay put: Erase device dialog with the checkbox left unchecked, for a routine update
4

Confirm and install

Click Install. This is the last step before it actually starts writing to the device.

Confirm Installation dialog
5

Wait for it to finish — keep this tab open

Takes about 2 minutes. The buzzer will beep continuously the whole time — that's expected electrical noise while the chip sits in its bootloader, not the actual firmware running. It stops on its own once done.

Installing progress screen at 10 percent
6

Join the device's WiFi network

Once it reboots (buzzer stops), look for a new network named dpx-tc002-XXXXXX in your WiFi list — give it 10–15 seconds to show up. Password: dubpixel1.

XXXXXX is 6 characters unique to your specific device (from its MAC address) — yours will not say "2dfab0" like the example below, it'll be its own combination of letters/numbers. Same suffix shows up everywhere this device is named: the AP, the mDNS address in the next step, and the welcome page after that.

macOS WiFi menu showing a dpx-tc002-2dfab0 network, one example device's actual suffix
7

You'll land on this page automatically

Your browser should pop this up on its own (that's the device's captive portal). If it doesn't, open http://4.3.2.1 manually. It shows the device's exact name and firmware version — click Set up WiFi →.

Same hex suffix again (2dfab0 in this example) — yours will show its own unique characters here, not this exact one.

dpx_tc002 welcome page prompting to set up WiFi, showing device name and firmware version
8

Pick your real network

Hit Scan to list nearby networks, or type the name in directly.

WiFi settings page with a blank network name field

Select your home/venue network, enter its password, then Save & Connect.

WiFi settings page with a network selected from the scan dropdown
9

Done

The device reboots and joins your real network (you'll drop off the dpx-tc002 WiFi — expected). Find it afterward at http://dpx-tc002-XXXXXX.local — same XXXXXX from step 6, your device's own unique suffix, not a literal "XXXXXX". It's pre-configured to reach matrix_blaster over MQTT, so it should show up there as claimable within a few seconds.