DeckSmith firmware

The firmware that runs every DeckSmith deck, including the free DeckSmith Mini from MakerWorld. It's free. Your PC sees the deck as a normal keyboard and media controller, so it needs no drivers.

Download firmware v0.3.2 For the ESP32-S3 DevKitC-1 N16R8 · one file, flashed at address 0x0

Flash it from your browser

  1. Plug the board into your PC using the USB-C port marked COM (sometimes UART).
  2. Open espressif.github.io/esptool-js in Chrome or Edge.
  3. Press Connect, pick the board's port and set the baud rate to 921600.
  4. Set Flash Address to 0x0, choose the file you downloaded and press Program.
  5. When it's done, move the cable to the port marked USB. The deck shows up as a device called “DeckSmith”.

Set up your deck

  1. The first time it starts, the deck makes its own Wi-Fi network, DeckSmith-xxxx, with the password decksmith.
  2. Connect to it and open http://192.168.4.1. Enter your home Wi-Fi; after a restart the deck is at http://deck.local.
  3. Load the deck.json that came with your files and press Save to deck. Press each key to check the wiring: it lights up on the page.

Built your own layout? Try the generator: it makes the print files, the wiring diagram and the deck.json for any layout of keys, knobs, faders and a screen.