Documentation

Learn how to use your MatriXDeck with comprehensive guides, examples, and reference material.

Topics

Need Help?

Join our community for additional support and resources.

Join Discord

Getting Started with MatriXDeck

Welcome to the MatriXDeck community! This guide will help you set up your MatriXDeck and get started with your first project.

What's in Your Kit

Depending on which kit you purchased (Basic, Pro, or Ultimate), your package will include:

  • MatriXDeck main board with 32x16 LED matrix
  • ESP32 microcontroller (pre-installed)
  • USB-C cable for power and programming
  • (Pro/Ultimate) MPU6050 motion sensor
  • (Pro/Ultimate) Speaker and microphone modules
  • (Pro/Ultimate) Joystick and buttons
  • (Pro/Ultimate) Battery pack

Setup Instructions

  1. Connect your MatriXDeck

    Use the included USB-C cable to connect your MatriXDeck to your computer.

  2. Install the required software

    You'll need the Arduino IDE or ESP-IDF to program your MatriXDeck. Download and install from:

  3. Install the MatriXDeck library

    Download the MatriXDeck library from our GitHub repository and install it in your Arduino IDE.

    git clone https://github.com/matrixdeck/MatriXDeck-Library.git

  4. Upload your first sketch

    Try the "Hello World" example from the Examples section to verify everything is working.

Troubleshooting

MatriXDeck not detected by computer?

Ensure you're using a data-capable USB-C cable, not just a charging cable.

LED matrix not lighting up?

Check that your power supply is adequate (at least 5V/1A) and try a different USB port.