dubpixel dpx_tc002

Install the dpx_tc002 firmware

This loads the dpx_tc002 firmware — compatible with Matrix Blaster hardware (Ulanzi TC001 LED matrix) — directly onto your device over USB. No PlatformIO, no drivers, no serial terminal. Just this page. Prefer screenshots over text? Try the visual guide.

Before you start

⚠️ Requires desktop Chrome or Edge (Web Serial API). Safari, Firefox, and mobile browsers can't do this — use the PlatformIO CLI instead on those.
  1. Plug the device into this computer via USB.
  2. Click Connect below. Your browser will pop up a port picker — pick the one entry that shows up (usually named after a USB-serial chip, e.g. CP210x or CH340). If nothing shows up, try a different USB cable — some are charge-only, no data lines.
  3. First time flashing this specific device (factory-fresh, still running stock Awtrix, or you're not sure): choose erase device when offered. Skipping this on a first flash can leave old firmware's settings behind and cause boot issues. A device that's already running dpx_tc002 doesn't need it for routine updates.
  4. The buzzer will beep continuously for the ~2 minute duration of the flash — that's expected (electrical noise on the piezo pin while the chip sits in its bootloader, not the actual firmware running yet). It stops on its own once flashing finishes and the device reboots.

After flashing — get it on your WiFi

  1. Once it reboots (buzzer stops), look for a new WiFi network named dpx-tc002-XXXXXX — XXXXXX is unique per device. Give it 10–15 seconds to show up. Password: dubpixel1.
  2. Join that network, then open http://4.3.2.1 in a browser. This page prints the device's exact name at the top — you'll need it in step 4.
  3. Click WiFi settings, pick your home/venue network, enter its password, save. The device reboots again and joins it (this drops you off the dpx-tc002 network — that's expected, you're done with it).
  4. Find the device on your regular network at http://dpx-tc002-XXXXXX.local — same XXXXXX as the WiFi network from step 1 (your device's own unique suffix, not a literal "XXXXXX") — that's /ctrl, the device's control panel.

This device also came pre-configured to reach matrix_blaster over MQTT — once it's on your WiFi, it should show up there as claimable within a few seconds.