Project Files of RGB LED Library for Proteus: Real Colour Mixing on Your Sheet

RGB LED LIBRARY FOR PROTEUS - V1.0 (a real four-legged 5 mm RGB LED that mixes any colour, with a pop-up)
Designed by The Engineering Projects
www.TheEngineeringProjects.com

IMPORTANT LINKS
Article (read it first - pictures, step by step, every feature explained):
  https://www.theengineeringprojects.com/2026/11/rgb-led-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/rgb-led-proteus-library
The demo runs on our Arduino UNO V4.0 (included) - working LEDs, RESET and a
built-in serial monitor, no Virtual Terminal to wire - its own article:
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
The demo's resistors are our own parts too (included):
  https://www.theengineeringprojects.com/2026/11/resistor-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
RGB-LED-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part the demo uses -> LIBRARY folder
|   |-- TEPRGB.LIB                                     13.9 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.0 KB   its model -> MODELS folder
|   |-- TEPRGB.DLL                                    287.0 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- RGB_Mixer_Demo.hex                             16.3 KB   the demo firmware
|   |-- RGB-LED-Colour-Mixer-ArduinoUnoV4.pdsprj       21.8 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of its model
|   |-- TEPRGB.DLL                                    287.0 KB   copy of the model
|-- Arduino Code/
|   |-- RGB_Mixer_Demo/RGB_Mixer_Demo.ino               3.0 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~11.5 KB   this file
Total: 3.46 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
The 5 mm RGB LED, drawn at true scale: a milky dome with three dies inside, on four legs. It is a
true analog part:
  * Three real diodes, each with its own forward voltage: about 2 V for red and 3 V for green and
    blue.
  * PWM on each pin sets that colour's brightness, and the three mix into one colour in the dome, on
    the sheet.
  * Two devices: common cathode and common anode.
  * Too much current burns out a die by itself, so the colour goes wrong. Fit a new part from the
    pop-up, or press Stop and Run.
  * Click it at Run for its pop-up: the colour it makes, the three channels, the live values,
    graphs, an event log and a check page.
The body is drawn as on the real part and to true scale against our Arduino.
The TEP signature and the pop-up are TEP additions.

TWO DEVICES (search "LEDRGB" in Pick Devices):
  LEDRGBCCTEP   "RGB LED Common Cathode V1.0"
  LEDRGBCATEP   "RGB LED Common Anode V1.0"
Both are in TEPRGB.LIB (category Optoelectronics > LEDs), prefix D, model TEPRGB.DLL. Pins R, C (the
common, the longest leg), G and B.

THE POP-UP
Click the part at Run. It stays closed until then (you can turn "Open the panel at Run" on in its
Settings page). Tabs:
    RGB LED    the state, the colour it makes, the three channels, and eight live values. The
    toolbar: New part.
    Graphs     the live values over the last 2, 6 or 15 s. Live / Freeze.
    Event log  every change and warning; filters All / Changes / Warnings, Pause, Clear
    Check      what the part is doing and what to look at, each with a verdict (green = fine, amber
    = check, red = wrong)
    Settings   theme, text size, open at Run, window size
    Help       report a bug, suggest a feature, article, updates, donate, forum; Copy diagnostics
    for a bug report

TEST STATUS
V1.0: verified in Proteus 8.5 on 31 Oct 2026 (the demo project as shipped: an A4 sheet, an Arduino UNO V4.0).
What the runs showed (the model's own numbers and the sketch's monitor):
  * The project loads and starts cleanly. The sketch faded round the wheel, and the dome on the
    sheet followed the mix.
  * Red alone: 17.9 mA through R1. Yellow: red 17.9 mA and green 17.1 mA. Cyan: green 17.1 mA and
    blue 16.3 mA. White: all three, 51 mA in all.
  * 255 128 0 gave orange: the green channel fell to 8.3 mA on average, under PWM.
  * The pop-up: RGB LED, Graphs, Event log, Check - all four pages followed the run.

INSTALLATION (about 2 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" (TEPRGB.LIB, TEPRESISTOR.LIB and our Arduino library
V4.0, ArduinoV4TEP.LIB, with the ARDUINO UNO V4.0 used by the demo) to the LIBRARY folder of
Proteus, for example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (use the folder that already holds Proteus's own .LIB files).
3. Copy TEPRGB.DLL, TEPRESISTOR.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the MODELS
folder (...\Proteus 8 Professional\MODELS).
4. Delete TEPRGB.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "LEDRGB".

RUN THE DEMO
"Proteus Simulation\RGB-LED-Colour-Mixer-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file and
the DLLs beside the project.
  ARD1:   Arduino UNO V4.0 running RGB_Mixer_Demo.hex, its serial monitor built in (window "TEP
  Arduino UNO - ARD1").
  D1:     an RGB LED, common cathode to GND.
  R1:     150 ohm from D9 to R. R2, R3: 100 ohm from D10 to G and from D11 to B.
  1. Press Run. The LED fades round the colour wheel.
  2. Type a colour in the monitor: red, yellow, cyan, white, off.
  3. Type three numbers, 255 128 0, for any colour. Type wheel to fade again.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  pin - resistor - R, G or B ; C - GND (common cathode)
Each colour needs its own resistor. Red needs more ohms, because its forward voltage is lower.
REAL HARDWARE:
 * Use one resistor for each colour, not one on the common leg, or the colours steal current from
   each other.
 * On a common anode part, C goes to +5V, and a LOW pin lights the colour.
 * The three dies are not equally bright, so white may need trimming.

THE DEMO SKETCH ON THE SERIAL MONITOR (RGB_Mixer_Demo V1.0, 9600 baud)
  red green blue yellow cyan magenta white off    one of the named colours
  255 128 0                                       red, green and blue, 0 to 255
  wheel                                           fade round the wheel again
EXPECTED MONITOR OUTPUT
  RGB LED colour mixer - The Engineering Projects
  Try: red, yellow, white, off, wheel, or 255 128 0

PROPERTIES (double-click the part > Edit Properties)
  Red forward voltage at 20 mA, V     2.0
  Green forward voltage at 20 mA, V   3.0
  Blue forward voltage at 20 mA, V    3.1
  Maximum current per colour, mA      30
Every run starts again from the properties.

LINKS.INI (OPTIONAL)
The Help page cards of the pop-up open web pages. To point them somewhere else without a new DLL,
put a text file named links.ini next to TEPRGB.DLL with lines KEY=URL, for example:
  ARTICLE=https://www.theengineeringprojects.com/...
Keys: WEBSITE, FORUM, BUG_REPORT, FEATURE_REQUEST, ARTICLE, USER_GUIDE,
UPDATE_CHECK, DONATE. Only http:// and https:// links are used; lines starting
with # are comments.

TROUBLESHOOTING
* One colour is missing: that die has burnt out, or its pin is not PWM.
* It looks the wrong colour: check which pin goes to which leg.
* BURNT OUT: too much current. Add more ohms, then New part.
* The pop-up does not open: click the part at Run (it stays closed until then).
* The part is not simulated: TEPRGB.DLL is missing from MODELS and from the project folder. No UNO /
  no monitor window: TEPARDUINO.DLL is missing, or click the UNO's USB port.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot, the Serial Monitor text, the
simulation log and the pop-up's Copy diagnostics text:
  https://www.theengineeringprojects.com/forum/category/rgb-led-proteus-library

SUPPORT US
This library is free. If it saves you time, please support our work:
  https://www.theengineeringprojects.com/donate

WEBSITE
  https://www.theengineeringprojects.com/

LICENCES AND THIRD-PARTY NOTES
* The model (TEPRGB.DLL), the symbols and artwork, the other parts of ours in the demo and the
  Arduino Library V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, with its built-in TEP Serial Monitor
  Advance) are made by The Engineering Projects. The models use only standard Windows libraries; no
  Visual C++ redistributable is needed.
  The C++ source code is not included.
* Arduino UNO V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, our Arduino Library V4.0 - its
  microcontroller is Proteus's own AVR model): The Engineering Projects,
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
* The .hex file is built from the demo sketch and the Arduino AVR core 1.8.6, which includes
  LGPL-licensed code; its source code is available at
  https://github.com/arduino/ArduinoCore-avr/tree/1.8.6
* Proteus is a product of Labcenter Electronics and is not included. Arduino is a trademark of Arduino SA.
  This library is not made or endorsed by Arduino or Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied; Arduino IDE is not needed to run the demo. To edit the sketch, open
Arduino Code\RGB_Mixer_Demo\RGB_Mixer_Demo.ino, select Arduino Uno and use Sketch > Export Compiled
Binary. Replace the simulation's .hex with the exported HEX. The sketch needs 5,944 bytes of flash
and 284 bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: three diodes with their own forward voltages, the glow through the eye's lag, mixing into
one colour, heating and burning out one die at a time.
Not modelled: the different light output of the three dies, the viewing angle.

VERSION
TEP RGB LED library V1.0 (Nov 2026). Devices LEDRGBCCTEP, LEDRGBCATEP (TEPRGB.LIB / TEPRGB.DLL).
Demo sketch RGB_Mixer_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino Library V4.0) with its
built-in serial monitor.