Note: ALL OSOYOO Products for Arduino are Third Party Board which is fully compatitable with Arduino


Buy from US Buy from UK Buy from DE Buy from IT Buy from FR Buy from ES ここでご購入を!


  1. Introduction
  2. Preparations
  3. About the RGB LED
  4. Connection
  5. Code Program
  6. Running Result


The RGB color model is an additive color model in which red, green and blue light are added together in various ways to reproduce a broad array of colors. The name of the model comes from the initials of the three additive primary colors, red, green and blue. In this lesson, we will show how to use a RGB (Red Green Blue) LED with an OSOYOO Basic Board.






How do RGB LEDs work?

At first glance, RGB (Red, Green, Blue) LEDs look just like regular LEDs, however, inside the usual LED package, there are actually three LEDs, one red, one green and yes, one blue. By controlling the brightness of each of the individual LEDs you can mix pretty much any color you want.

Two types of RGB LEDs

There are common anode RGB LEDs and common cathode RGB LEDs. See figure below:

As you can see, the 3 LEDs can share the cathode or the anode. This results in an RGB LED that has 4 pins, one for each LED, and one common cathode or one common anode.

The 4 pins which can be distinguished by their length. The longest one is the ground (-) or voltage (+) depending if it is a common cathode or common anode LED, respectively.

The common anode RGB LED is the most popular type. We also use it here.

Note: If you are using a common ANODE LED instead of common CATHODE, connect the long pin to +5V instead of ground

How to create different colors?

The reason that you can mix any color you like by varying the quantities of red, green and blue light is that your eye has three types of light receptor in it (red, green and blue). Your eye and brain process the amounts of red, green and blue and convert it into a color of the spectrum.

In a way, by using the three LEDs we are playing a trick on the eye. This same idea is used in TVs, where the LCD has red, green and blue color dots next to each other making up each pixel.

You can create one of those three colors – red, green or blue – by activating just one LED.

For example, if you want to produce blue, you activate the blue LED and turn off the other two.

If we set the brightness of all three LEDs to be the same, then the overall color of the light will be white. If we turn off the blue LED, so that just the red and green LEDs are the same brightness, then the light will appear yellow.

We can control the brightness of each of the red, green and blue parts of the LED separately, making it possible to mix any color we like.

Black is not so much a color as an absense of light. So the closest we can come to black with our LED is to turn off all three colors.

Pulse-width Modulation(PWM)

The brightness of an LED is proportional to the current going through it, but it would be rather difficult to use a microcontroller to accurately control the current flowing through an LED. Fortunately, human vision has a nice phenomenon called persistence of vision. Persistence of vision is the phenomenon where an image that is seen for only a fraction of a second will continue to be “seen” by your brain even after the original image has vanished or moved. This this the same principle behind film and television, where a rapidly changing image tricks your brain into seeing continuous motion. By turning our LED on and off rapidly, we can trick the brain into seeing an “average” value of brightness based on the duty cycle of the driving PWM signal.

Pulse-width modulation (PWM) is the practice of modulating the duty cycle of a signal, used in this application to control the average power sent to each LED. In the following figure, we show three different duty cycles, first with 50% duty cycle, then 10% and 90% duty cycle. During the 10% duty cycle, the signal is at the logic high level for only a brief time each cycle, but with 90% duty cycle, most of the signal’s period is spent at logic high level. If the frequency of the signal is fast enough, then there will be no visible flicker, and the LED’s brightness will be proportional to the signal’s duty cycle.


RGB stands for the red, green, and blue color channels and is an industry color standard. RGB displays various new colors by changing the three channels and superimposing them, which, according to statistics, can create 16,777,216 different colors. If you say the color displayed doesn’t completely match a natural color, then it almost certainly cannot be differentiated with the naked eyes.

Each of the three color channels of red, green, and blue has 255 stages of brightness. When the three primary colors are all 0, “LED light” is the darkest, that is, it turns off. When the three primary colors are all 255, “LED light” is the brightest. When superimposing the light emitted by the three primary colors, the colors will be mixed. However, the brightness is equal to the sum of all brightness, and the more you mix, the brighter the LED is. This process is known as additive mixing.


First, please plug Osoyoo Magic I/O shield into OSOYOO Basic Board:

Then connect the RGB module to the RGB port of the Magic I/O shield with a 4-pin PNP cable as below:

Code Program

After above operations are completed, connect the OSOYOO Basic Board to your computer using the USB cable. The green power LED (labelled PWR) should go on.

Open the Arduino IDE and choose corresponding board type and port type for you project. Then load up the following sketch onto your OSOYOO Basic Board.

Or you can directly download from here.

const int redPin = 11; // R connected to digital pin 11  
const int greenPin = 12; // G to digital pin 10  
const int bluePin = 13; // B connected to digital pin 9  
void setup() { 
pinMode(redPin, OUTPUT); // set the redPin to be an output  
pinMode(greenPin, OUTPUT); // set the greenPin to be an output  
pinMode(bluePin, OUTPUT); // set the bluePin to be an output  
void loop() // run over and over again  
// Basic colors:  
color(255, 0, 0); // turn the RGB LED red  
color(0,255, 0); // turn the RGB LED green  
color(0, 0, 255); // turn the RGB LED blue  
// Example blended colors:  
color(255,0,252); // turn the RGB LED red  
color(237,109,0); // turn the RGB LED orange  
color(255,215,0); // turn the RGB LED yellow  
color(34,139,34); // turn the RGB LED green  
color(0,112,255); // turn the RGB LED blue  
color(0,46,90); // turn the RGB LED indigo  
color(128,0,128); // turn the RGB LED purple  
void color (unsigned char red, unsigned char green, unsigned char blue) 
// the color generating function  
 analogWrite(redPin, red); 
analogWrite(greenPin, green); 
analogWrite(bluePin, blue); 

Running Result

A few seconds after the upload finishes, you should see the RGB LED flash circularly red, green, and blue first, then red, orange, yellow, green, blue, indigo, and purple.