# LED Drone Matrix
## Overview
https://youtu.be/ioF61wFq-PM
Make a nighttime display in the sky with an LED Matrix attached to a drone.
Powered by a Mini Sparkle Motion board and DJI Mavic Pro, this 1x1 meter 20x20 NeoPixel LED netting can display custom animated GIFs!
The 3D printed mounts allows the drone carry and power this matrix display without any modifications to the hardware.
3D print the parts in TPU filament. The printed legs extend the height of the drone for clearance, while the TPU clips on the arms hold the nylon line attached to a stake holding the matrix net.
The Mini Sparkle Motion board runs WLED to display complex animations.
With the PixelMagic Tool, we can build custom animated GIFs to run as playlists inside of WLED. We set timing and even randomize the animation to build a creative nighttime show for events!
Danger: This guide assumes you are licensed and know how to fly without the assistance of GPS mode in case a gust of wind makes the drone drift.
## Parts
### Mini Sparkle Motion with Pre-soldered Terminal Block
[Mini Sparkle Motion with Pre-soldered Terminal Block](https://www.adafruit.com/product/6314)
The **Adafruit Sparkle Motion Mini** is part of our series of "Sparkle Motion" boards, which are our attempt to make the best small WLED-friendly smart LED driving board in the whole world. Our resident mermaid,
In Stock
[Buy Now](https://www.adafruit.com/product/6314)
[Related Guides to the Product](https://learn.adafruit.com/products/6314/guides)
### Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver
[Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver](https://www.adafruit.com/product/6160)
The **Adafruit Sparkle Motion Mini** is part of our series of "Sparkle Motion" boards, that are our attempt to make the best small WLED-friendly smart LED driving board in the whole world. Our resident mermaid,
In Stock
[Buy Now](https://www.adafruit.com/product/6160)
[Related Guides to the Product](https://learn.adafruit.com/products/6160/guides)
### NeoPixel LED Outdoor Netting - 20 x 20 LEDs - 1x1 Meter Sizing
[NeoPixel LED Outdoor Netting - 20 x 20 LEDs - 1x1 Meter Sizing](https://www.adafruit.com/product/6159)
This ready-to-go **NeoPixel LED Outdoor Netting ** will make it easy to make large grids easy without having to piece together multiple LED strips. It looks like a 20 x 20 RGB LED grid, but requires only a single pin for drawing to the entire 400-point...
In Stock
[Buy Now](https://www.adafruit.com/product/6159)
[Related Guides to the Product](https://learn.adafruit.com/products/6159/guides)
### 2.54mm/0.1" Pitch Terminal Block - 4-pin
[2.54mm/0.1" Pitch Terminal Block - 4-pin](https://www.adafruit.com/product/2137)
After a long day out harvesting in the terminal block fields, we've returned with a veritable bounty of these very nice and compact 2.54mm/0.1" terminal blocks in a variety of sizes.
Our harvest of terminal blocks is great news since nothing makes a project harder to...
In Stock
[Buy Now](https://www.adafruit.com/product/2137)
[Related Guides to the Product](https://learn.adafruit.com/products/2137/guides)
### USB-A Plug to USB-C Plug Adapter
[USB-A Plug to USB-C Plug Adapter](https://www.adafruit.com/product/5329)
If your computer has a USB A port still, and you want a small, cable-less way to connect our modern USB C devices, this little dongle will do the job nicely. It's quite simple - you've got your USB A plug on one side, a C plug on the other. Since C is reversible, you can always plug in...
In Stock
[Buy Now](https://www.adafruit.com/product/5329)
[Related Guides to the Product](https://learn.adafruit.com/products/5329/guides)
### USB OTG Host Cable - MicroB OTG male to A female
[USB OTG Host Cable - MicroB OTG male to A female](https://www.adafruit.com/product/1099)
This cable looks like a USB micro cable but it isn't! Instead of a USB A Plug, it has a USB A Socket on the end. This cable is designed for use with OTG (On the Go) host devices (like the Arduino Due or many tablets) so you can connect a mouse, keyboard, or any other USB device. You'll...
In Stock
[Buy Now](https://www.adafruit.com/product/1099)
[Related Guides to the Product](https://learn.adafruit.com/products/1099/guides)
### Part: Garden stake 48in
quantity: 1
Garden stake
[Garden stake 48in](https://www.lowes.com/pd/Gardener-s-Blue-Ribbon-4-Ft-Sturdy-Stake/1002275458)
### Part: M2.5x8mm screws
quantity: 2
M2.5x8mm screws
[M2.5x8mm screws](https://amzn.to/3Ip3PgU)
# LED Drone Matrix
## 3D Printing
## 3D Printed Parts
STL files for 3D printing will need to be oriented for printing using FDM machines.
Parts were printed with TPU 95A or 60D filament.
Original design source files may be downloaded using the links below.
These parts are designed for the **DJI Mavic Pro** , edit the files below to fit your specific drone model.
Info: The dropdown on the Fusion 360 site allows you to pick your preferred 3D file format like STEP, STL, etc.
[Mini Sparkle Motion Case with Terminal Block](https://a360.co/4es7c2G)
[Drone Back Leg](https://a360.co/4l7cbs9)
[Back Arm Clip](https://a360.co/44HiLjh)
[Front Arm clip](https://a360.co/40ymptg)
[Front Legs](https://a360.co/46otRLl)
[3MF LED Drone Net parts](https://cdn-learn.adafruit.com/assets/assets/000/138/073/original/3MF_LED_Drone_Net_parts.zip?1751311473)
### Slice with settings for TPU material
The parts were sliced using BambuStudio using the slice settings below.
- AMS TPU filament from Bambu
- 230c extruder
- 0.2 layer height
- 15% rectilinear infill
- 200mm/s print speed
- 30c heated bed
- Supports: tree
# LED Drone Matrix
## Circuit Diagram
## Circuit Diagram
The diagram below provides a general visual reference for wiring of the components once you get to the **Assembly** page. This diagram was created using the software package [Fritzing](http://fritzing.org/download/).
## Adafruit Library for Fritzing
Adafruit uses the Adafruit's Fritzing parts library to create circuit diagrams for projects. You can download the library or just grab individual parts. Get the library and parts from [GitHub - Adafruit Fritzing Parts](https://github.com/adafruit/Fritzing-Library/tree/master/parts).
## Solder Terminal blocks
Solder 2.54mm/0.1" Pitch Terminal Block - 4-pin to make connections modular.
These are compatible with the V2 3D printed case for the Mini Sparkle Motion with terminal cutout.
**Ground** on the matrix connects to **G** on the board
**Input** wire on the matrix connects to **33** pin on the board
**5V** on the matrix connects to **5V** on the board
## Power with USB Host cable
Connect a USB-A Plug to USB-C Plug Adapter into the Mini Sparkle Motion port.
Connect the A connector to the USB host socket. The MicroB OTG plug connects to the port on the DJI Mavic Pro.
# LED Drone Matrix
## WLED Software
## Board Choices
WLED runs on several different boards in Adafruit's collection. There are different benefits to each, but the installation process is largely the same. This page contains instructions for multiple boards -- be sure to use the pinouts and installation instructions for the one you're using,
**Sparkle Motion**
This is our flagship ESP32 board, designed with WLED and Xlights in mind. It has 4 outputs and is set up to drive either 5v, 12v or 24v pixels. It's a workhorse of a board and for larger projects it's the clear winner. It has an onboard microphone for instant sound-reactive support, and an IR sensor built in, to make it easy to control your project with an infrared remote. It also has a couple stemma ports so you can add your own sensors or peripherals.
**Sparkle Motion Mini**
The Sparkle Motion Mini is a smaller version of the Sparkle Motion board. It has two LED outputs, a microphone, and two stemma ports that make it easy to add an IR sensor or other peripherals. It's got an onboard NeoPixel and a small footprint, making it perfect for wearables or smaller projects. It will power a whole lot of pixels through the onboard USB port: it's safe to draw up to 4A through this port, giving you plenty of power for most wearable projects.
Info: For Sparkle Motion Mini use at least the 0.15.1 release of WLED.
**QT Py Pico ESP32**
The [QT Py Pico](https://www.adafruit.com/product/5395) is small and affordable, so usually my go-to for smaller costumes or wearables. It also has a range of BFF add-on boards that add functionality. [Here's a guide with more QT Py info](https://learn.adafruit.com/adafruit-qt-py-esp32-pico/overview). The QT Py will drive up to around 30 pixels through the onboard USB port, so if you have more LEDs than that you may want to consider the Sparkle Motion Mini instead, or you can power the board through the +5v pin.
Note: WLED works on the QT Py Pico but NOT on the S2 or S3 versions, at the time of writing.
**Feather Huzzah ESP32 **
The [Feather Huzzah ESP32](https://www.adafruit.com/product/3405) the top of the line. It's a great choice for projects where you want to add sensors, interaction, or drive a whole lot of LEDs. It's the most reliable as well -- I've run these for two months straight with no power cycling and they just keep on truckin. Adafruit has a very wide selection of Feather Wing boards that connect to the Feather microcontroller line. The sky is the limit with these boards.
It also comes in a version with a high-powered WiFi range extender! If you're trying to sync multiple instances across distance, check this one out. [Feather Huzzah ESP32 V2 w.FL Antenna](https://www.adafruit.com/product/5438)
**Feather Huzzah ESP8266**
The [Feather Huzzah ESP8266](https://www.adafruit.com/product/2821) will run WLED as well, but won't drive as many pixels: the ESP32 limit on WLED is around 1000 pixels per input, but the ESP8266 tops out at around 500. It's about $5 cheaper though, so for smaller projects it's a great way to save a little money and still have access to all the Featherwing options in the Adafruit store.
## Driver Update
Some versions of our controllers have a new serial chip which needs a driver installed before we can install WLED. Head over to our [How to Install Drivers for WCH USB to Serial Chips](https://learn.adafruit.com/how-to-install-drivers-for-wch-usb-to-serial-chips) tutorial, and download and install the new driver.
If you have an older QT Py with CP2102 USB-to-Serial bridge, [use SiLabs’ driver instead](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads).
## Install WLED
These next steps require a **_Web Serial_-compatible browser**. As of this writing, that means **Google Chrome** , **Microsoft Edge** or **Opera** “desktop” browsers. Other browsers (Safari, Firefox, Explorer and _anything_ mobile) won’t work.
Visit [https://install.wled.me/](https://install.wled.me/)
Plug your microcontroller into your computer with a known good USB cable. Click "Install" and select the port for your board.
Depending on the USB-to-serial bridge chip on the board, you might see one _or two_ serial ports. On Mac, for instance, there might be both “/dev/cu.usbmodem[number]” _and_ “/dev/cu.wchusbserial[number]”. Use the “ **wchusbserial** ” one.
After successful installation, enter your WiFi network name and password when prompted. This must be a **2.4 GHz** WiFi network; ESP32 does not support 5 GHz networks. If it can’t connect, then as a fallback WLED will create its own 2.4 GHz WiFi access point.
Danger: Sometimes the "Connect to Wi-Fi" prompt doesn't show up. Don't panic, just see the step below on connecting your computer or mobile device to the WLED-AP access point created on the microcontroller itself!
If you don't see the "Connect to Wi-Fi" prompt, you'll need to set up your WiFi network using AP (access point) mode. Open up your WiFi settings and look for a WiFi network called `WLED-AP`. (Note, this access point can take up to 30 seconds to appear sometimes.) Connect to this network using the default password `wled1234`. The WLED interface will pop up in its own captive browser window.
From here, go into **Config/Wifi Settings** and enter your WiFi credentials for the access point you normally use near the top.
Give your project a name in the mDNS field a little further down the page. Now you can type in "projectname.local" (where "projectname" is your mDNS name) into any web browser on the same wifi network to access your microcontroller.
You can also scan the QR code below to open access point mode.
For more help and troubleshooting tips visit the [Getting Started page on the WLED knowledge base.](https://kno.wled.ge/basics/getting-started/)
## Setup & Preferences
### WiFi Setup
Head to the **WiFi Setup** screen under Config and create a good URL so you can control your project from any web-enabled device. Call it something you'll remember, that's easy to type into any web browser on your WiFi network in order to connect to your project.
In Safari or Chrome on your phone or computer, type in this web address to access the WLED interface: [http://projectname.local](http://projectname.local) (where "projectname" is whatever you put into this field).
Check out the Additional Settings page for more info on accessing your project. WLED has an "access point mode" that doesn't require a WiFi network for when you're out on the go. It's also helpful to download one of the WLED apps to help manage and organize your projects.
### LED Preferences
Next, head to the **LED Preferences** tab under the Config menu.
Scroll down to **Hardware Setup**. Put your total number of LEDs into the "Length" field, and change GPIO to the pin number associated with the pin you soldered to. Check the pinout diagram for the board you're using (it's the number in yellow).
- [Sparkle Motion Pinout](https://learn.adafruit.com/adafruit-sparkle-motion)
- [Sparkle Motion Mini Pinout](https://learn.adafruit.com/adafruit-sparkle-motion-mini/overview)
- [QT Py Pico Pinout](https://learn.adafruit.com/assets/112309)
- [Feather Huzzah ESP8266 Pinout](https://learn.adafruit.com/assets/46249)
- [Feather Huzzah ESP32 Pinout](https://learn.adafruit.com/adafruit-huzzah32-esp32-feather/pinouts)
## Use It
Now you can use any computer or handheld device to control your LEDs.
Make sure your device is on the same WiFi network as your board. Navigate to your custom URL (projectname.local/ ) in a web browser. You'll see a color picker above a whole bunch of color palette choices.
Choose a color, choose an effect, and watch your lights animate and glow!
Save your favorite combinations as presets, create playlists, control the speed and intensity of the animations, and lots more. This web app is incredibly intuitive and easy to use.
Head over to the WLED wiki at [https://kno.wled.ge/](https://kno.wled.ge/) to delve into all the particulars.
# LED Drone Matrix
## WLED Configuration
## LED Settings
The 20x20 NeoPixel matrix will need to be configured in order to display the animations correctly. Follow the settings below to configure the LED matrix.
- Click on the **Config** icon on the homepage of WLED, then click on **LED Preferences**
- Under section **LED outputs** set the following
- 1: **WS281x**
- mA/LED: **35aA (eco WS2812)**
- Color order: **RGB**
- Start: 0 Length: **400**
- Data GPIO: **33**
- Click **save** at the top when settings have been updated.
## 2D Configuration
In the Configuration menu, click on 2D configuration and make the following settings.
- Under the 2D setup section, select **2D matrix** from the dropdown menu.
- Under the **LED panel layout** section make the following adjustments
- 1st LED: **Top** **Left**
- Orientation: **Vertical**
- Serpentine: **Off**
- Dimensions: **20** x **20**
- Click **save** at the top when settings have been applied.
## 2D Effects
On the WLED homepage, under the **Effect** mode, click on the search box. In the categories popup, click on the matrix icon. The list of effects will filter out all effects and will show all available 2D effects. Click on any of these effects to display on the 20x20 NeoPixel Matrix.
## Exporting Presets
Follow the link for instructions to export presets:
[https://kno.wled.ge/features/presets/](https://kno.wled.ge/features/presets/)
# LED Drone Matrix
## PIXEL MAGIC TOOL Process
This tool helps converts images into code in **JSON WLED** format for **2D Matrix** panels! This is perfect for adding an animated gif to the display.
Most gifs will work, but images pixel detail with an animation with 5 frames or less will show up the best on the matrix.
Download the .htm file from [https://github.com/ajotanc/PixelMagicTool](https://github.com/ajotanc/PixelMagicTool "PixelMagicTool GitHub") and upload the .htm file to the Sparkle board. Use the UI to navigate the files on host.local address [http:// **customname**.local/edit](http://customname.local/edit)
Now you can navigate to [http:// **customname**.local/pxmagic.htm](http://customname.local/pxmagic.htm) to see the UI and upload images
## Load Saved Preset Animations
You can load the presets created for this project below. Once loaded you can Create add each preset frame into a playlist to play in order.
[presets.json](https://cdn-learn.adafruit.com/assets/assets/000/138/082/original/presets.json?1751377360)
## Creating Custom Animations
Add the host name with the .local ending
Add the preset name for your image
Brightness: To save battery power set to about 80
Enable Animation, Transparent image and Resize image.
Set the width and height to 20x20
Drag and drop an image into the selection box and tap on generate to preview the layout
Tap save to export each frame as a preset into WLED
## Arrange Presets into a Playlist
Pixel Magic will save each frame as a Preset. Tap the +Playlist button and add each Preset in order to the playlist.
Inside the new playlist you can set the length of each frame, transition timing, how many times to loop and even set each frame to shuffle the frames to add randomness to the an animation like the eye gif.
Build multiple playlists and have them play in a loop by selecting which playlist plays after it completes.
# LED Drone Matrix
## Assemble
## Assemble the Mini Sparkle Motion case
Place the board aligned to the USB C cutout.
Align the terminal cutout on the lid and press fit the edges to snap together.
## Mount case
Use M2.5x8mm screws to mount the case to the back leg. Place screws in the center of each tab and fasten to the screw hole on the back leg part.
## Attach Back Leg
The tabs on the back leg snap into the existing back leg loops by inserting at an angle. Bending the second tab to press fit into the leg loop.
## Drone USB port
The Mirco USB host cable connects to the port on the side of the drone.
## Attach front legs
Align the triangular shapes on the legs and insert the drone leg into the printed leg extenders.
## Attach arm clips
Align the trapezoidal clips to the front and back arms with the loops pointed down. Firmly bend the clips back to fit over the arms.
## Prepare LED Net
Use a green metal garden stake to hold the LED net up.
Cut the stake to 36" inches wide and thread the stake over and under the net at the top (under the square boxes).
Connect the stake to the arm clips with nylon fishing line.
Measure two 34" inch pieces of line and tie both ends to each side of the stake to create a loop.
## Connect line to arms
The nylon lines are inserted into the clips through the cutouts. Pass lines into the loops on the left, back and front arms. Repeat for the right, front and back arms.
# LED Drone Matrix
## Flying the Matrix
## Position Net for take off
Lay the LED net to the back of the drone. Keep the net back far enough so the line is taut, pulled tight, with no slack or looseness to avoid the blades.
Make sure to take off slowly.
While in the air make sure to maintain direct sight. Wind gusts will rock the drone and make it drift. Fly in open areas.
To land, slowing lower altitude. Once the net touches the ground, slowing fly forward while descending to avoid catching the net.
## Featured Products
### Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver
[Mini Sparkle Motion - WLED-friendly ESP32 NeoPixel LED Driver](https://www.adafruit.com/product/6160)
The **Adafruit Sparkle Motion Mini** is part of our series of "Sparkle Motion" boards, that are our attempt to make the best small WLED-friendly smart LED driving board in the whole world. Our resident mermaid,
In Stock
[Buy Now](https://www.adafruit.com/product/6160)
[Related Guides to the Product](https://learn.adafruit.com/products/6160/guides)
### NeoPixel LED Outdoor Netting - 20 x 20 LEDs - 1x1 Meter Sizing
[NeoPixel LED Outdoor Netting - 20 x 20 LEDs - 1x1 Meter Sizing](https://www.adafruit.com/product/6159)
This ready-to-go **NeoPixel LED Outdoor Netting ** will make it easy to make large grids easy without having to piece together multiple LED strips. It looks like a 20 x 20 RGB LED grid, but requires only a single pin for drawing to the entire 400-point...
In Stock
[Buy Now](https://www.adafruit.com/product/6159)
[Related Guides to the Product](https://learn.adafruit.com/products/6159/guides)
### 2.54mm/0.1" Pitch Terminal Block - 4-pin
[2.54mm/0.1" Pitch Terminal Block - 4-pin](https://www.adafruit.com/product/2137)
After a long day out harvesting in the terminal block fields, we've returned with a veritable bounty of these very nice and compact 2.54mm/0.1" terminal blocks in a variety of sizes.
Our harvest of terminal blocks is great news since nothing makes a project harder to...
In Stock
[Buy Now](https://www.adafruit.com/product/2137)
[Related Guides to the Product](https://learn.adafruit.com/products/2137/guides)
### USB-A Plug to USB-C Plug Adapter
[USB-A Plug to USB-C Plug Adapter](https://www.adafruit.com/product/5329)
If your computer has a USB A port still, and you want a small, cable-less way to connect our modern USB C devices, this little dongle will do the job nicely. It's quite simple - you've got your USB A plug on one side, a C plug on the other. Since C is reversible, you can always plug in...
In Stock
[Buy Now](https://www.adafruit.com/product/5329)
[Related Guides to the Product](https://learn.adafruit.com/products/5329/guides)
### USB OTG Host Cable - MicroB OTG male to A female
[USB OTG Host Cable - MicroB OTG male to A female](https://www.adafruit.com/product/1099)
This cable looks like a USB micro cable but it isn't! Instead of a USB A Plug, it has a USB A Socket on the end. This cable is designed for use with OTG (On the Go) host devices (like the Arduino Due or many tablets) so you can connect a mouse, keyboard, or any other USB device. You'll...
In Stock
[Buy Now](https://www.adafruit.com/product/1099)
[Related Guides to the Product](https://learn.adafruit.com/products/1099/guides)
### Mini Sparkle Motion with Pre-soldered Terminal Block
[Mini Sparkle Motion with Pre-soldered Terminal Block](https://www.adafruit.com/product/6314)
The **Adafruit Sparkle Motion Mini** is part of our series of "Sparkle Motion" boards, which are our attempt to make the best small WLED-friendly smart LED driving board in the whole world. Our resident mermaid,
In Stock
[Buy Now](https://www.adafruit.com/product/6314)
[Related Guides to the Product](https://learn.adafruit.com/products/6314/guides)
## Related Guides
- [Adafruit Sparkle Motion Mini](https://learn.adafruit.com/adafruit-sparkle-motion-mini.md)
- [LED Noodle Lamp](https://learn.adafruit.com/led-noodle-lamp.md)
- [Arcade Button Control Box](https://learn.adafruit.com/arcade-button-control-box.md)
- [Sparkle Motion Skirt with 2D Mapping](https://learn.adafruit.com/sparkle-motion-skirt-with-2d-mapping.md)
- [Fisher-Price USB Controller](https://learn.adafruit.com/fisher-price-usb-controller.md)
- [Commodore 64 - The Most Popular Retro Computer of All Time](https://learn.adafruit.com/commodore-64-retro-guide.md)
- [Raspberry Pi Thermal Camera](https://learn.adafruit.com/raspberry-pi-thermal-camera.md)
- [BLE Feather Lamp](https://learn.adafruit.com/ble-feather-lamp.md)
- [DIY Desktop Calculator with CircuitPython ](https://learn.adafruit.com/diy-rpn-desktop-calculator-with-circuitpython.md)
- [Glowy Message Crown](https://learn.adafruit.com/glowy-message-crown.md)
- [Web Enabled PIXEL on Raspberry Pi](https://learn.adafruit.com/web-enabled-pixel-on-raspberry-pi.md)
- [3D Printing on Diffraction Grating Sheets](https://learn.adafruit.com/3d-printing-on-diffraction-grating-sheets.md)
- [USB Rechargeable Mini Solder Fume Extractor](https://learn.adafruit.com/usb-rechargeable-mini-solder-fume-extractor.md)
- [Cappy Monster M4sk with Animated Eyes](https://learn.adafruit.com/cappy-monster-m4sk.md)
- [ItsyBitsy ESP32 wFL case](https://learn.adafruit.com/itsybitsy-esp32-wfl-case.md)
- [Multi-tasking the Arduino - Part 3](https://learn.adafruit.com/multi-tasking-the-arduino-part-3.md)