Project Files of TCS34725 Sensor Library for Proteus V1.1 (RGB Colour Sensor + Arduino)

TCS34725 RGB COLOUR SENSOR LIBRARY FOR PROTEUS - V1.1
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/09/tcs34725-proteus-library.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/tcs34725-proteus-library
The demo uses our TEP Serial Monitor Advance (included) instead of Proteus's
Virtual Terminal - its own article:
  https://www.theengineeringprojects.com/2026/10/serial-monitor-advance-proteus-library.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
TCS34725-TEP-v1.1/
|-- Proteus Library Files/
|   |-- ArduinoV3TEP.IDX                          0.8 KB   its index -> LIBRARY folder
|   |-- ArduinoV3TEP.LIB                         95.6 KB   TEP Arduino UNO (demo) -> LIBRARY folder
|   |-- TEPSERIALMON.LIB                         11.1 KB   TEP Serial Monitor Advance -> LIBRARY folder
|   |-- TEPTCS34725.LIB                         156.4 KB   TCS34725 Simple + Advance (2 devices) -> LIBRARY
|-- Proteus Model Files/
|   |-- TEPSERIALMON.DLL                        978.0 KB   Serial Monitor model -> MODELS folder
|   |-- TEPTCS34725.DLL                         537.0 KB   the TEP I2C sensor model -> MODELS
|-- Proteus Simulation/
|   |-- TCS34725_Demo.hex                        36.6 KB   both UNOs (the demo sketch v1.1)
|   |-- TCS34725-ArduinoUnoV3.pdsprj             39.6 KB   demo: UNO 1 + TCS34725 Simple, UNO 2 + Advance
|   |-- TEPSERIALMON.DLL                        978.0 KB   copy of the monitor model
|   |-- TEPTCS34725.DLL                         537.0 KB   copy of the model so the demo runs as is
|-- Arduino Code/
|   |-- TCS34725_Demo/TCS34725_Demo.ino           5.0 KB   sketch (source of the .hex)
|   |-- libraries/Adafruit_TCS34725/             41.9 KB   Adafruit TCS34725 1.4.4, BSD, 10 files
|   |-- libraries/Adafruit_BusIO/                77.0 KB   Adafruit BusIO 1.17.4, MIT, 24 files
|-- README.txt                                  ~25.7 KB   this file
Total: 3.44 MB (unzipped). The C++ source code of the model is not included.

WHAT IS IT?
A simulation model of the ams (TAOS) TCS34725 RGB + clear light sensor on the
common blue breakout with its white LED, for Proteus 8. Your Arduino talks to it
over I2C exactly as to the real chip (address 0x29) and the popular Adafruit
TCS34725 library runs unmodified: begin, getRawData, getRawDataOneShot,
getRGB, setIntegrationTime, setGain, setInterrupt, clearInterrupt,
setIntLimits, write8 / read16. The model has the TCS34725's register map: the
command byte protocol (repeated byte, auto-increment, the clear-interrupt
special function), ENABLE (power, RGBC, wait, interrupt), the integration time
(2.4 ms steps, 2.4 .. 614.4 ms) with its saturation (1024 counts per step, at
most 65535), the four gains (1 / 4 / 16 / 60x), the wait time (x12 with WLONG),
data valid, the clear-channel interrupt with its thresholds and persistence,
and the paired word reads. You set the object's colour (red, green, blue), how
bright it is lit and whether the board's white LED is on - with sliders,
presets (RED .. BLACK, LED ON/OFF) or a click on the colour palette.
The part looks like the blue TCS34725 breakout: the two mounting holes, the
big white LED in the centre with the sensor and its colour filters beside it,
the 662K regulator, the transistors and the board print. Above the board sits
an animated colour view: the board seen from the side, the white LED lighting
the object below it in its colour, the light coming back to the sensor, and four
bars with the red, green, blue and clear counts your sketch read (to the
saturation level) and the colour's name by the demo's rule. On the board: a red
PWR LED, a blue I2C LED that flashes for every I2C transaction to this sensor
and an amber INT LED that lights while the INT pin is active - TEP additions -
and the live I2C address (0x29).

TWO DEVICES IN ONE LIBRARY (search "TCS34725" in Pick Devices):
  TCS34725 Simple   device TCS34725TEP    "TCS34725 RGB Color Sensor - Simple"
                    On-Sheet Panel: a control panel on the schematic next to the
                    board - nine presets, the colour palette with the preview of
                    v1.0 (click or drag it), the four sliders of v1.0 (RED, GREEN,
                    BLUE, BRIGHTNESS) and what your sketch READ over I2C (decoded
                    by the model: "SKETCH READ: R 5000 G 1255 B 0 C 6255"), the
                    colour's name, the integration time, gain and saturation your
                    sketch chose. The red X in the panel's header closes it, the
                    PANEL button on the board opens it again. Your v1.0 designs
                    keep working with this device (with the v1.0 palette).
  TCS34725 Advance  device TCS34725ADVTEP "TCS34725 RGB Color Sensor - Advance"
                    Pop-Up Panel: only the board on the schematic; at Run a TEP
                    pop-up window opens - the same look as the TEP Serial Monitor
                    (move it by its header, resize it, minimise it). The tabs
                    Sensor and Test sit in the header; the gear and ? icons open
                    Settings and Help; the palette icon switches the theme:
                      Sensor    the live colour view with the palette (click it),
                                the presets, a click-slider with - / + for every
                                input, the last reading as big tiles, and what the
                                Arduino read over I2C (the counts, the name, the
                                integration time, gain, the interrupt, the I2C
                                address and the measured SCL clock)
                      Test      four tools measured on the model with your sketch:
                                I2C check, Timing, Step response, Colour test (see
                                THE TEST TOOLS below)
                      Settings  theme (TEP Dark / Light), text size, open at Run,
                                window size - remembered for your Windows user
                      Help      Help & Support like the TEP Serial Monitor: report a
                                bug, suggest a feature, article, user guide,
                                updates, donate, website, forum; Copy diagnostics
                                (the inputs, what was read, the registers, the last
                                transactions, the test results) for a bug report
                    The OPEN PANEL button on the board opens the window again
                    after you close it.
Both devices use the same model (TEPTCS34725.DLL) and the same properties.

NEW IN V1.1
* Two devices: TCS34725 Simple (panel on the sheet with the palette, close /
  open) and TCS34725 Advance (pop-up window with the live colour view, four test
  tools, settings and help) - see above.
* Board: the blue TCS34725 breakout's look (two holes, the white LED, the sensor
  with its filters, the regulator) with an animated colour view above it (the
  LED lighting the object, the returning light, the R / G / B / C bars and the
  colour's name), PWR / I2C / INT LEDs (a TEP addition), the live I2C address, a
  PANEL / OPEN PANEL button and a SIMPLE / ADVANCE badge.
* Model - the board's white LED (a new property, LED): on (the default) gives
  exactly the v1.0 counts; off leaves the object in the ambient light only
  (model: 25 % of the light).
* Model - counters for the test tools (every integration with its time); the
  RGBC model, timing, saturation and interrupt of v1.0 are unchanged.
* Model - the command byte protocol decoded in an I2C transaction log ("write
  ENABLE = 03", "read CDATAL -> 6255", the clear-interrupt special function)
  and the measured SCL clock.
* The demo: ONE project with two UNOs - UNO 1 with TCS34725 Simple, UNO 2 with
  TCS34725 Advance - each with the TEP Serial Monitor Advance instead of the
  Virtual Terminal (U3 = UNO 1, U4 = UNO 2, quick buttons) and an LED on A0.
* The demo sketch (v1.1) keeps every v1.0 line and adds: a red detector on the
  LED (on while "RED dominant"), the saturation level that follows the
  integration time, and the Serial Monitor commands HELP, STATUS, GAIN, TIME,
  HEX ON / OFF. It prints nothing periodically except the readings.
* Version 1.1 everywhere; the C++ source code is no longer included (and
  neither is the Arduino AVR core archive - its GitHub link is below).

TEST STATUS
v1.1: verified in Proteus 8.5 on 8 Oct 2026 (the demo run from this package's
Proteus Simulation folder):
  * start-up: "R:5000 G:1255 B:0 C:6255 | RED dominant"; WHITE: "R:5000 G:5000
    B:5000 C:15000 | NEUTRAL"; GREEN: "R:0 G:5000 B:0 C:5000 | GREEN dominant";
  * the four tools on U2: I2C check (ID 44, ATIME EB = 50.4 ms, 0 NACKs, SCL
    86 kHz); Timing (60 integrations every 50.40 ms, 9 reads every 354.3 ms, data
    age 24.5 / 30.4 ms); Colour test (8 / 8, hue error 0.0 deg);
  * a v1.0 design (the v1.0 release demo with this DLL): the v1.0 palette panel,
    "R:5000 G:1255 B:0 C:6255 | RED dominant".
After that run (PC-tested, to be re-checked in Proteus): the sheet panel's text is
plain ASCII (a middle dot showed as odd characters in Proteus), the LED input shows
ON / OFF, every register has its own row, the Test pages fill the window. Later the
same day (PC-tested too): the Step response waits until the readings sit at the
start value before step 1.
PC tests (8 Oct 2026, this package's DLL / LIB / sketch):
  2785 automatic checks on a PC, 0 failed, plus the v1.0 test, unchanged and
  passing with the v1.1 model (TCS34725: original Adafruit driver over bit-level
  I2C; RGB/clear, brightness, four gains, integration, saturation, paired/burst
  reads, read-only registers, one-shot, sleep, wait and interrupt
  persistence/clear. Palette primaries pass); 8 chip checks for v1.1
  (integration and wait timing (WEN, WLONG), the integration counters, gain and
  saturation, the 614 ms saturation, the interrupt persistence); 66 on the
  complete Proteus model (the LIB (pins, properties, both devices), power, the
  PWR / I2C / INT LEDs, the panel with its palette, red X / PANEL, OPEN PANEL,
  the pop-up pages and links, the RGBC words decoded and named, gain and
  saturation, the integration time, the white LED, the clear interrupt, the
  presets, the pop-up palette, the v1.0 palette, the four tools, a design with
  the v1.0 symbol); 23 with the real v1.1 demo sketch and the unmodified driver
  library on two UNOs (every v1.0 output line (the v1.0 Proteus check step by
  step), the red-detector LED, every Serial Monitor command, the Timing / Step
  response / Colour test tools with the real sketch); 2688 on the rendered
  boards and pop-up windows (every page fits in TEP Dark and Light, at Large
  text and 150 % DPI; every tool's hint lines and every header state fit).
v1.0 (29 Sep 2026): the v1.0 demo was opened, run and checked in Proteus 8.5:
  R:5000 G:1255 B:0 C:6255 at the start, the palette (green R:20 G:5000 B:20
  C:5039), white at 50 % 5000 / 5000 / 5000 / 15000 NEUTRAL, blue to 0 MIXED
  color, brightness 0 DARK, white at 100 % C:21504 SATURATED; the v1.0 tests
  (the original Adafruit library over the bit-level I2C slave) still pass with
  the v1.1 model.

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" (TEPTCS34725.LIB with both
   devices, TEPSERIALMON.LIB and the TEP Arduino UNO V3 library ArduinoV3TEP.LIB
   / .IDX used by the demo) to the LIBRARY folder of Proteus, for example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (on some PCs: C:\ProgramData\Labcenter Electronics\Proteus 8 Professional\
   LIBRARY - use the folder that already holds Proteus's own .LIB files).
3. Copy TEPTCS34725.DLL and TEPSERIALMON.DLL from "Proteus Model Files" to the
   MODELS folder (...\Proteus 8 Professional\MODELS).
4. Updating from v1.0: replace TEPTCS34725.LIB and TEPTCS34725.DLL, and
   delete TEPTCS34725.IDX if there is one in the LIBRARY folder. A v1.0 design
   keeps its v1.0 symbol: it runs with the new model and shows the v1.0 panel
   with its palette (without the v1.1 board parts and the red X) - re-pick the
   part to get the v1.1 symbol.
5. Start Proteus. In Pick Devices (P) search "TCS34725": you get the Simple and
   the Advance device (category Sensors > Color, as in v1.0).
The model DLL is the TEP I2C sensor family model: TEPMPU6050.DLL, TEPBMP280.DLL,
TEPMAX30102.DLL, TEPVL53L0X.DLL, TEPSHT31.DLL and TEPTCS34725.DLL are identical
files under the v1.0 names, so every v1.0 design finds its model.

RUN THE DEMO
"Proteus Simulation\TCS34725-ArduinoUnoV3.pdsprj" - keep TCS34725_Demo.hex and
the two DLLs beside the project.
  UNO 1 (ARD1): TCS34725 Simple (U1), Serial Monitor U3.
  UNO 2 (ARD2): TCS34725 Advance (U2), Serial Monitor U4.
  Both UNOs run TCS34725_Demo.hex. An LED (D1 / D2) with 220 ohm on A0 of each
  UNO: the red detector.
  1. Press Run. Both monitor windows open (9600 baud) and so does U2's pop-up.
     U3 and U4 show "TEP TCS34725 - click the color palette or drag RGB /
     brightness.", "50.4 ms integration, 4x gain. RGBC values are raw ADC
     counts." and "TEP TCS34725 Demo v1.1 - type HELP in the Serial Monitor",
     then about 3 times a second:
       R:5000 G:1255 B:0 C:6255 | RED dominant
     LED D1 is on (red). The blue I2C LED flashes with every read.
  2. U1: click the palette (green: "GREEN dominant"), WHITE ("R:5000 G:5000
     B:5000 C:15000 | NEUTRAL"), drag BRIGHTNESS to 100 % with WHITE: "C:21504 |
     SATURATED - reduce brightness or gain"; BRIGHTNESS 0: "DARK". LED ON/OFF:
     with the white LED off the counts drop to a quarter. Close the panel with
     its red X and open it with PANEL.
  3. U3 / U4 quick buttons: STATUS, GAIN 16 (4x the counts - the red saturates
     the clear channel), TIME 154 (153.6 ms: 3x the counts, saturation 65535),
     HELP. Type GAIN 4, TIME 50, HEX ON ("Hex: #FF4000") ...
  4. U2 (Advance): the Sensor page shows the same inputs and what the sketch
     read; the Test page has the four tools (below).
  5. Close U2's window and open it again with OPEN PANEL on the board.
Closed a monitor window? Click OPEN MONITOR on the monitor part.

WIRING (as in the v1.0 demo)
VIN -> supply, GND -> GND, SCL -> A5, SDA -> A4; INT not connected (it is
optional: active low, it drives the INT LED and can go to D2 for
attachInterrupt).
In the sketch: Adafruit_TCS34725 sensor(TCS34725_INTEGRATIONTIME_50MS,
TCS34725_GAIN_4X);  sensor.begin();  Serial 9600.
Serial Monitor RXD <- Arduino D1 (TX), Serial Monitor TXD -> Arduino D0 (RX),
Serial Monitor GND -> ground. RXD2 is not needed: I2C has no serial line to
watch. The red-detector LED + 220 ohm from A0 to GND.
Pin order in Proteus: VIN GND SCL SDA INT (v1.0; the real breakout has seven
pins LED INT SDA SCL 3V3 GND VIN - the white LED is the LED property here).
REAL HARDWARE:
 * Supply: the breakout has a 3.3 V regulator (662K) and level shifting - feed
   VIN with 3.3 V or 5 V.
 * I2C pull-ups: on the board, so A4 / A5 need nothing else. Address 0x29,
   fixed.
 * The white LED: its LED pin left open = LED on; tie it to GND to switch it
   off, or to INT so that setInterrupt(true) switches it off (Adafruit's trick).
 * The counts depend on the light, the distance (a few mm) and the surface;
   calibrate with a white and a black card. Shield the sensor from room light.
   The model gives exact, noise-free counts with a simple colour model (no
   spectral response).

THE TEST TOOLS (TCS34725 Advance, Test tab) - what they really measure
Every tool runs on the live model with your sketch: it changes the sensor's
inputs (and restores them) and watches the I2C reads your Arduino really makes -
it never talks to your Arduino. Each tool shows one "Good for:" line and one
line on how it measures.
  I2C check       Good for: checking that the TCS34725 answers and what your
                  sketch really wrote into it. The registers read live and
                  decoded (ID 0x44, ENABLE: PON / AEN / WEN / AIEN - marked when
                  the sensor is not running -, ATIME as cycles, ms and the
                  saturation, CONTROL gain, WTIME / WLONG, PERS, the interrupt
                  thresholds, STATUS, the four channels - marked when the clear
                  channel saturates), transactions, bytes, NACKs, the measured
                  SCL clock and the last transactions decoded (repeats folded).
                  With the demo: "write ATIME = EB", "write CONTROL = 01",
                  "read CDATAL -> 6255", "read BDATAL -> 0".
  Timing          Good for: seeing how often new data exists and whether your
                  sketch reads it in time. Records for 1, 3 or 10 s every
                  integration and every reading (the B word completes one): the
                  output period, the integration time, the sketch's read period,
                  the data age at each read, reads of the same result twice,
                  with the formula (ATIME cycles x 2.4 ms + the wait). With the
                  demo: a 50.4 ms integration every 50.4 ms; the sketch reads
                  about every 352 ms (its delay(300) + the 51 ms the Adafruit
                  library waits after each read).
  Step response   Good for: seeing how quickly a change reaches your sketch -
                  integration and read period together. Steps the brightness
                  (25 -> 75 %), the red (255 -> 0) or the blue (0 -> 255) 1, 3
                  or 5 times (1.5 s each) and plots the value your sketch's
                  counts stand for; per step: the first reading that shows it
                  (10 %), 90 % and settled (2 %). With the demo: the next
                  reading (within about 360 ms).
  Colour test     Good for: checking your colour names on known colours - and
                  finding the gain / time that does not saturate. Shows red,
                  orange, yellow, green, cyan, blue, purple and white (1.6 s
                  each), computes the hue from the R / G / B counts your sketch
                  read and names the colour by the demo's rule (one channel 1.2x
                  the others = dominant; within 12 % = NEUTRAL). With the demo:
                  8 / 8 within 3 degrees (the model is exact); with GAIN 16 the
                  bright colours come out SATURATED.

THE DEMO SKETCH ON THE SERIAL MONITOR (TCS34725_Demo v1.1)
  HELP                    the command list
  STATUS                  integration time, gain, saturation, hex output
  GAIN 1|4|16|60          the analog gain
  TIME ms                 integration time 2.4 .. 614 ms (2.4 ms steps)
  HEX ON | OFF            also print the colour as #RRGGBB (scaled to the
                          strongest channel)
Monitor quick buttons in the demo: STATUS, GAIN 16, TIME 154, HELP.
Every line the sketch prints has at most 80 characters (it fits the Serial Monitor's
Simple interface); longer answers are split, the second line indented.

EXPECTED MONITOR OUTPUT (U3 and U4)
  TEP TCS34725 - click the color palette or drag RGB / brightness.
  50.4 ms integration, 4x gain. RGBC values are raw ADC counts.
  TEP TCS34725 Demo v1.1 - type HELP in the Serial Monitor
  R:5000 G:1255 B:0 C:6255 | RED dominant
After WHITE on the panel:
  R:5000 G:5000 B:5000 C:15000 | NEUTRAL
After GAIN 16:
  Gain: 16x
  R:20000 G:5020 B:0 C:21504 | SATURATED - reduce brightness or gain
After STATUS:
  Status: integration 50.4 ms (ATIME 0xEB), gain 4x
    saturation 21504 counts, hex OFF

PROPERTIES (double-click the sensor > Edit Properties; the same on Simple and
Advance - the v1.0 properties and one new)
  RED, GREEN, BLUE  the object's colour, 0 .. 255 (default 255, 64, 0)
  BRIGHTNESS        how strongly the object is lit, 0 .. 100 % (default 50)
  LED               v1.1: the board's white LED, 1 = on (default, = v1.0),
                    0 = off (the ambient light only)
The panel style is chosen by the device (Simple / Advance), not by a property.
The Advance window settings (theme, text size, open at Run, size) are on its
Settings page. The demo's Serial Monitors: BAUD 9600, THEME TEPDARK, AUTOOPEN
YES, QUICK1-4 as above (see the Serial Monitor's article for all its
properties).

LINKS.INI (OPTIONAL)
The Help page cards of the Advance device open web pages. To point them
somewhere else without a new DLL, put a text file named links.ini next to
TEPTCS34725.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
* "TCS34725 not found. Check VIN, GND, A4/SDA and A5/SCL.": check VIN / GND (the
  PWR LED must be lit and the board shows "I2C 0x29"), SDA -> A4, SCL -> A5.
* "SATURATED - reduce brightness or gain": the clear channel reached the
  saturation (1024 counts per 2.4 ms step, at most 65535) - lower the gain,
  shorten the integration time or the light.
* Everything reads "DARK": BRIGHTNESS is 0, or the object is black.
* The counts are a quarter of what you expect: the LED property is 0 (LED
  ON/OFF preset).
* The readings come slowly: the Adafruit library waits one integration time
  after every getRawData() (700 ms at TIME 614).
* The part is not simulated / no panel: TEPTCS34725.DLL is missing from MODELS
  and from the project folder. No monitor window: TEPSERIALMON.DLL is missing,
  or click OPEN MONITOR on the monitor part.
* Advance: the pop-up does not appear - click OPEN PANEL on the board, use
  Proteus's Debug menu, or turn "Open the panel at Run" on its Settings page
  back on.
* Simple: the red X does not close the panel / the board looks like v1.0 - the
  design still holds the v1.0 symbol; replace TEPTCS34725.LIB, delete
  TEPTCS34725.IDX and re-pick the part.
* Your own sketch uses SoftwareSerial to receive: Proteus 8.5 cannot receive
  with SoftwareSerial (pin-change interrupts are not simulated) - use the
  hardware Serial (as the demo does) or AltSoftSerial.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot, the Serial Monitor text, the
simulation log and (Advance) the Copy diagnostics text:
  https://www.theengineeringprojects.com/forum/category/tcs34725-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 TCS34725 model (TEPTCS34725.DLL), the symbols and artwork and the TEP
  Serial Monitor Advance (TEPSERIALMON.LIB / .DLL) are made by The Engineering
  Projects. The model is an independent implementation written from the
  TCS34725 datasheet (registers, timing, interrupt); it contains no ams code.
  The light-to-counts relation and the LED-off light are model values. The
  models use only standard Windows libraries; no Visual C++ redistributable is
  needed.
* TEP Arduino UNO V3 library (ArduinoV3TEP.LIB / .IDX): The Engineering
  Projects, https://www.theengineeringprojects.com/2023/10/arduino-library-for-proteus-v30.html
* Adafruit TCS34725 Arduino library 1.4.4 by Adafruit Industries, shipped
  unmodified in Arduino Code\libraries\Adafruit_TCS34725: BSD licence, see
  Arduino Code\libraries\Adafruit_TCS34725\license.txt -
  https://github.com/adafruit/Adafruit_TCS34725
* Adafruit BusIO 1.17.4 by Adafruit Industries, shipped unmodified in Arduino
  Code\libraries\Adafruit_BusIO: MIT licence, see
  Arduino Code\libraries\Adafruit_BusIO\LICENSE - https://github.com/adafruit/Adafruit_BusIO
* Arduino AVR core 1.8.6 (with its Wire and SPI libraries): the .hex file is
  built from the demo sketch, the Adafruit libraries and the Arduino AVR core,
  which includes LGPL-licensed code. Its source co
…