In this tutorial we will show you how to add RGB LED to a mini quad and setup through Betaflight, so that the colour of the LED can be controlled by the flight controller.
Take a look at our Betaflight setup guide for more tutorials.
Why Adding LED to a Quadcopter?
Having LED on your quadcopter is perfect for night time flying or in low light conditions. When flying LOS (line of sight) it is a major help in maintaining your orientation of the craft, especially for beginners. It’s great for personalizing your quad or just separating you from the competition. You can also use LED as status indicators!
And let’s be honest, they just look plain COOL!
Wiring and setting up our mini quad are much easier today (2018) than it was just a year or two ago, and the same goes for adding LEDs. Here I will show you how.
Recommended LED Strip for Betaflight
The LED feature in Betaflight is primarily designed for addressable LED strips. The recommended types of LED are WS2812 and WS2811.
You can get them from Banggood or Amazon.
WS2812 5050 LEDs come in a variety of forms. The most common form is long flexible strip that is rolled on spools and sold by the meter. These can be cut into individual LED’s or to any desired length strips for the perfect fit with a pair of scissors.
They come in two voltage ratings, 5V and 12V. The 5V version uses less power while the 12V LED’s are brighter. We are going to use the 5V version because 5V is more widely available on flight controllers and PDB.
I’ve used these LED’s in some other projects and they gave me great results: TV ambilight project and DIY bike light project.
Other Tools and Hardware
Here is a list of stuff you need to setup LED’s on a mini quad:
- A flight controller that supports the use of RGB LEDs (has a pin labelled “LED”) – our recommendation for FC
- Double sided tape / Zip-ties / Clear heat shrink – our recommendation for tools
- Small gauge electrical wire, 28AWG – 30AWG should suffice
LED Connection and Installation
Make sure you understand where to connect the LED’s per your flight controllers wiring diagram and what voltage your LEDs will require.
It is a simple three wire connection to most flight controllers: Power (5V), Ground and Data (to LED pad).
WS2812 LED strips are directional, each LED has data-in and data-out connections (DI/DO or Din/Dout). DI takes LED signal from the FC, while the DO connects to the DI of the next LED if you want to add more. Currently Betaflight and Cleanflight can control up to 32 LEDs in total.
When installing the LEDs be sure to insulate any solder joints from the carbon fiber frame.
Ensure they are securely attached to the quadcopter and will not come loose due to vibrations or a crash. After all the LED’s are wired correctly in series, write down their wiring order and their locations. Now it is time to configure them in Betaflight.
Pro Tips
Overheating can damage these LEDs. Use lower temperature for soldering, and try not to leave your solder iron on the pads for too long.
You can just connect those LED straight to your flight controller. But if you can also test the LEDs beforehand with an Arduino board. (You probably want an external 5V BEC for the LEDs, in case they draw too much current than the Arduino can handle. Use the Arduino library NeoPixel for testing.
WS2812/WS2811 LED Current Draw
Make sure your flight controller or BEC can supply enough current to power the amount of LED’s you plan to use.
As tested, a single 5V WS2812 LED draw around 18mA in average. Note that the current draw changes with colour, blue uses more energy than red. But that’s pretty insignificant compared to what our motors can do. Here is the current draw for 3 LEDs.
Enabling LED Feature in Betaflight
ALWAYS REMOVE PROPELLERS whenever doing any configuration or bench testing BEFORE plugging in the battery!
Connect flight controller to Betaflight Configurator.
On the Configuration Tab in Betaflight, first enable the LED Strip feature by clicking the toggle switch under “Other Features” then click the “save and reboot” button.
If you already have the LED connected and the battery plugged in, this will illuminate the LEDs white by default. It will also enable the LED Strip tab on the left hand window. If you don’t see it, please turn on “Enable Expert Mode” in the top right.
Betaflight LED Setup: Wiring Order and Color Selection
Now on the LED Strip Tab in Betaflight, first we must setup the LED wiring order by clicking the “Wiring Order Mode” button.
This is where we tell Betaflight how the LED’s are ordered and arranged on the mini-quad.
Start with the very first LED coming from the flight controller and assign it to a location on the grid followed by the next LED in sequence and where it is located.
Pro Tips: It doesn’t matter where in the grid you drop the LED, all that matter is the ordering. The grid is only there to help you visualize the LED arrangement.
Betaflight starts numbering with 0 so when we get to the 4th LED the number is 3. Finish for every LED in the strip then deselect the Wiring Order Mode button.
Next we are assigning color to each LED.
Highlight the first LED (numbered 0) by clicking on it, select “Colors” from the “Functions” drop down menu then click the color you want to assign that LED in the color chart.
Notice that LED on the grid now has indicators telling us the color function is enabled and color Magenta has been selected.
Finish picking colors for each LEDs in the strip, any colors you like, and click save. Now all the LEDs will show the selected colors.
Now as soon as you power up your quad, all 4 LED’s will display magenta color. Let’s move on to a more complex example.
Worked Example
Here I have entered the first 4 LEDs.
Again, it doesn’t matter where on the grid, as long as you have room to enter all the LEDs and can make sense of where they relate to their position on the quadcopter.
Here I will place the rest of the LED’s in the grid, then deselect the Wiring Order Mode button. Notice that I have 6 separate strips, and the order represents how they are wired together in series.
Now we can start assigning functions to each individual LED. In this case we are just going to assign different colors for them.
Highlight the first LED (numbered 0) by clicking on it, select “Colors” from the “Functions” drop down menu.
Then click any color you want to assign that LED in the color chart.
Do the same thing for the next LED and so on until all the LEDs have been assigned a color.
Click the Save button and the LEDs on the quadcopter will switch from white, to the colors you’ve selected.
Betaflight LED Setup: Advanced Functions
The LED feature in Betaflight is pretty powerful, there are many functions that can be activated and overlaid for a completely customized LED display.
Color modifiers, Blinking, Larson scanner/Knightrider effects, warnings for battery, RSSI and more, even color coded VTX channels controlled through SmartAudio. The possibility is exciting :)
The throttle modifier will change the LED color depending on throttle position. The color selected will be shown at mid throttle, the previous selectable color will show at low throttle and the next selectable color at full stick.
To activate this, highlight the LED you want to use and click the Color Modifier for Throttle. This can also be changed from throttle to a different channel such as AUX switches for flight modes, rate modes etc.
Note the orange dot indicating Throttle Color Modifier.
Both rear arms set to change color according to throttle position. Once saved this can be tested through the transmitter without arming, simply slide the throttle up and down and see if you like the transition.
Turn indicators will flash corresponding LEDs when roll or pitch is applied. To do this, first we must select the orientation for the specific LED we want to use by selecting N, S, E, W or UP and DOWN.
Next click the “Indicator” switch. Do this for any LED you would like to blink when TX input is applied in that direction.
Now this LED will blink when left roll is applied, slow with small inputs and fast like a strobe when at full stick. This can also be tested now with the transmitter.
Arm State is another useful function. Highlight the LED you wish to use and select Arm State from the Functions drop down menu.
The Arm State function allows you to select two colors, one for when armed and one for when disarmed.
There are so many combinations that can be made here to get that custom look you’ve always wanted, start playing around with different settings and see what happens. Wether you would like to add some lights to help orientation, light up the entire night sky, or just add a touch of color for your race, LEDs are always cool. ;)
Here is a instructional video by Droneofprey.
34 comments
How to use led of speedybee master 5 V2 frame
My FC doesn’t have an LED data pad. Am I able to remap a TX pad to control the LED strip? I tried mapping led strip to the tx4 pin but nothing happened.
One quick question if I may… I have PandaRC Programmable RGB FPV Drone LED Lights Strip and my FC is Rush Blade F722 Digital (only one LED output pad). As per your picture here: https://oscarliang.com/wp-content/uploads/2018/06/mounting-ws2812-led-on-mini-quad-under-arm.jpg – I’ve noticed those LED strips inputs and output have all the wires connected, even GND and 5V to all outputs. I’ve heard that only signal/data wire needs to go in serial from the FC to the 1st LED strip’s input, and then from its output to the next LED strip in line, and then from that LED strip’s output to the next LED strip’s input, and so on… GND and 5V wires can be connected from the FC to each LED strip’s input only. Not sure what would be the best thing to do, I am just worried there will be a mess of wires if I have to connect all of them to all inputs and outputs on the LED strips. What is your valuable opinion what to do when there is only one LED output on the FC like on Rush Blade F722 Digital? Maybe to connect only one LED strip then, but then I can’t have all my quad’s arms lit, and I wanted every arm to have one LED strip attached to the bottom :( Here is my wiring diagram, am I correct with these connections? https://i.imgur.com/z76nZff.jpeg – Thank you so much in advance!
You wiring looks about right. But do you need to control every single LED individually? If not, then you can just split the LED_Strip pad to all 4 strips, and not having to route around with wires. In this case all 4 strips would be displaying the same thing.
Hi Oscar, and thank you so much for your quick reply. I am so sorry, I’ve lost you for a moment… I do have 4 LED strips, and each strip has 4 LEDs on it. I wanted to install them on my quad’s arms just like in the diagram I posted in my original message up there. No, I don’t need each LED to be controlled independently, I don’t even need each strip to be controlled independently. All I want is to have each arm with one LED strip attached to it (4 LED lights), and as far as I am concerned, what one LED strip with 4 lights does, all other 3 can do the same, I don’t care. When you said “…𝘵𝘩𝘦𝘯 𝘺𝘰𝘶 𝘤𝘢𝘯 𝘫𝘶𝘴𝘵 𝘴𝘱𝘭𝘪𝘵 𝘵𝘩𝘦 𝘓𝘌𝘋_𝘚𝘵𝘳𝘪𝘱 𝘱𝘢𝘥 𝘵𝘰 𝘢𝘭𝘭 4 𝘴𝘵𝘳𝘪𝘱𝘴…”, did you mean, I could connect all 4 LED strips to the same Rush Blade F722 Digital LED output pad? Basically like parallel? I was just concerned if that would be too much for power draw for the FC?
Yea, you can connect all 4 strips to the same LED output pad if it makes the wiring easier for you.
It doesn’t draw any more current from the FC, the LED output pad is just a signal, the LED’s get power from the 5V.
Amazing! Thank you so much Oscar! I’ve been asking this everywhere and not a single person explained it as clean as you did. Thank you a million! Rush Blade F722 Digital has BEC Output of 5V/5A 10V/3A, so that should be plenty for this simple configuration. I am totally OK with parallel, I actually want all 4 strips to do what 1 does. Instead of 16 addressable/programmable lights (4 lights on 4 strips), I will have 4 only (since each LED strip has 4 lights on it), and I am totally OK with that. If I want, I can use 4 different colors, I can have Larson effect on one and it will affect all 4. I want them all to be the same, so totally fine. Here is my diagram, please have a look if I got it right. Thank you so so much! You have no idea how much easier you make our FPV lives. Invaluable opinion and super polite and down to Earth person. Thank you! Link to my parallel diagram image: https://i.imgur.com/YuIWqiX.jpeg
Looks good to me!
SEII-FPV what software you use for draw diagram?
Can you have different setup/led layout on a switch i mean different profile that change with the active aux
Is there any way to configure the LEDs when using a control board or LED PDB? I haven’t seen anything on the net about utilizing a control board and still able to have the same customization as a single strand tethered together by a single data wire..
I’m wondering about the TinyLED PDB power board in particular.
So is there a way to just turn them on and off with an Aux channel? or change color from an independent aux switch?
Here’s how to do that:
Enable color modifier for all leds you want to be affected.
Select the aux channel you will be using. Let’s say you are using a 3 position switch on aux 4.
Set up your switch to control aux 4 in your radio.
Choose any color from the palette except the first or last color. This will be the color that is displayed when your aux channel is in the middle position.
Double click on the color to the before (to the left of) the color you selected and change the values with the sliders until you have the color you want. This will be the color when the aux switch is low.
Do the same for the color after the center color and this will be your aux high color.
If you want the leds off for one of the positions, just double click on the color and set all values to 0.
Hope this helps!
Greg, what if i want to use a momentary switch on my zorro to scroll through 4 colors for my tiny trainer (red, green, blue, white). i have the switch set up so is there a way to assign the color to a particular range on the aux channel? essentially, it’s a 4 position switch instead of a 3 so really there’s no “middle” position.
How do I wire multiple of these? I only have one led strip connector on my FC…
is there a way to turn on/off the LEDs completely via a Switch on my Transmitter ?
Can anyone help me with my crazy WS2812 LEDs? I have the Matek WS2812B programmable LED strip on my quad. It’s an Emax F3 Magnum Mini F.C. The LEDs work FINE if I have ANYTHING with 5 volts plugged into the USB port on the F.C. when I connect the battery, and then disconnect the USB. If I just plug the battery in, with nothing in the USB port, the strip will NOT light. But it works fine if I pull the USB plug out after the battery is plugged in. Weird?? Anyone have a clue?
Hi I would like to know if you have solved your problem with tez LED Matek since I have the same concerns as you? Thank you in advance see you soon
No, I haven’t. I have simply resorted to bringing a small USB battery bank, and a USB micro cord with me, and plugging it in before I connect the main battery, and then unplugging it. It’s a little extra work, but my lights function this way. ??
Hi, I will try to see about fixing it on my own, but i programmed all of my LED’s in beta flight to be solid color w/ directional lighting, and they worked for a bit, but one night i showed my friends what i was doing and i left without disconnecting from beta-flight. After coming back to fly the drone one strip (5 LED’s) wouldn’t properly follow what i programmed them to do, and they went wonky. Some were white, one light blue, another light pink, and the other side did exactly what i wanted them to do. After looking this up for a month i still cant find a fix or anyone else that has had this issue. I have the Eachine Wizard x220s that came pre-built out of box other than prop attachment. If anyone can help i would be grateful.
Hi,
For my flight stack F722 Mamba, there are 5LED pads. How do I go about programming them if I’ve soldered multiple LEDS to multiple LED pads? Currently BF config only changes colour of one LED pad and the rest are default red light
I’m not using strips, but each of my ESC’s has a factory RGB led attached. So far I haven’t gotten them working- do they use the same interface somehow?
The LED built into the ESC are configurable in BLHeliSuite32.
There is an option called LED: https://oscarliang.com/betaflight-blheli-32-esc/
Hey Oscar, love your blog! Is there a way to set up an aux switch to shut off the leds in betaflight? And what is the LedLow mode in betaflight?
I hooked these up on my f405 std( – to -, + to +, led to DI) configured it on INAV, save and rebooted, plugged in my lipo and no lights. What have I over looked?
Thanks!!
HI Oscar!!!
i have the wizard ts215 wich has 4 pin for led strips as you can saw at it’s manual
files.banggood.com/2018/04/TS215-MANUAL.pdf
In wich pin shold i wire my led strip? led in or led out?
Hey Oscar.
Is it possible to wire led strips in parallel?
I mean the same pads to two strips. Then I should have the same setups for both strips.
I asking about this because when I solder in this way one strip is working correctly and second changing colors like a mad. Do I need to do something in addition? Maybe I can’t split the signal for two strips?
Thanks
You should connect these LED in series only due to the nature of SPI digital signal controlling the colros.
For power yes, but the signal has to be in series if you want to program them all separately, otherwise you can end up with LED strips doing the same thing.
Thanks for the write up! Got my LEDs running in less than 10 mins after reading this.
To add to this, as I didn’t see it mentioned, is that you can CTRL-Click multiple LEDs to change their function all at once.
Maybe this wasn’t available before but it is on Betaflight Configurator v10.3.1.
My FC doesn’t have an LED data pad. Am I able to remap a TX pad to control the LED strip? I tried mapping led strip to the tx4 pin but nothing happened.
Hey Oscar, you can only change to all LED colors by AUX Position Switch, if you choose “Arm State” with AUX. Just put the Arm- Disarm color to the same color. No other funktion allows you to switch to all available colors :-( Please try it out :-) Greets, Gare
Thanks! Was looking through the comments to figure out exactly how to do this. The color mix seems to be largely random.
I love LED, I have to fly a lot at dust, Line of Sight, due to work, I have been struggling with getting them programmed. Though this should help. I have 2 H pattern Led sets, one at the from and one at the back and I colour the props to the light colour, it works really well for Orientation. I know a lot of people in FPV do not like LOS, but when you live in a city like Melbourne Australia, sometimes it is just about finding a safe spot and getting in the air.