Project Files of Photodiode Library for Proteus: BPW34 Light Meter and Night Lamp

PHOTODIODE LIBRARY FOR PROTEUS - V1.0 (a real BPW34 whose die lights with the light it sees, 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/photodiode-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/photodiode-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 and LED 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
Photodiode-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPLED5MM.LIB                                  21.8 KB   a part the demo uses -> LIBRARY folder
|   |-- TEPPHOTODIODE.LIB                               9.9 KB   the library -> LIBRARY folder
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part the demo uses -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPLED5MM.DLL                                 289.5 KB   its model -> MODELS folder
|   |-- TEPPHOTODIODE.DLL                             281.5 KB   the model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.0 KB   its model -> MODELS folder
|-- Proteus Simulation/
|   |-- Light_Meter_Demo.hex                           13.7 KB   the demo firmware
|   |-- Photodiode-Light-Meter-ArduinoUnoV4.pdsprj     22.1 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPLED5MM.DLL                                 289.5 KB   copy of its model
|   |-- TEPPHOTODIODE.DLL                             281.5 KB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of its model
|-- Arduino Code/
|   |-- Light_Meter_Demo/Light_Meter_Demo.ino           1.6 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~11.2 KB   this file
Total: 4.02 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
The BPW34 photodiode, drawn at true scale: a clear block, 5.4 x 4.3 mm, with its silver die inside
and two legs 5 mm apart. It is a true analog part:
  * A silicon diode plus a current that follows the light: 70 nA for each lux, as on the real part.
  * Reverse biased, it works as a light meter, and the current follows the light in a straight line.
  * With no bias it makes its own voltage, like a tiny solar cell.
  * The die lights up with the light it sees at Run.
  * Click it at Run for its pop-up: chips to set the light, the current, 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.

ONE DEVICE (search "PHOTODIODE" in Pick Devices):
  PHOTODIODEBPW34TEP   "Photodiode V1.0" in TEPPHOTODIODE.LIB (category Optoelectronics >
  Photodiodes), prefix D, model TEPPHOTODIODE.DLL. Pins K and A.

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:
    Photodiode the state (DARK, MEASURING, SOLAR CELL, FORWARD BIASED), the part, how it works, and
    eight live values. The toolbar: Dark, Moon 10 lx, Dim 100 lx, Room 300 lx, Bright 1000 lx,
    Daylight.
    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 current followed the light in a straight line: 0.7 uA
    at 10 lux, 7 uA at 100, 21 uA at 300 and 70 uA at 1000 lux.
  * Dark: the sketch lit the lamp on D8. Bright again: it turned the lamp off.
  * Daylight, 5000 lux: 47k ran out of volts. The current stopped at 119 uA and the reading stuck at
    its limit, as the Check page warned.
  * The pop-up: Photodiode, 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" (TEPPHOTODIODE.LIB, TEPRESISTOR.LIB, TEPLED5MM.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 TEPPHOTODIODE.DLL, TEPRESISTOR.DLL, TEPLED5MM.DLL and TEPARDUINO.DLL from "Proteus Model
Files" to the MODELS folder (...\Proteus 8 Professional\MODELS).
4. Delete TEPPHOTODIODE.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "PHOTODIODE".

RUN THE DEMO
"Proteus Simulation\Photodiode-Light-Meter-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file
and the DLLs beside the project.
  ARD1:   Arduino UNO V4.0 running Light_Meter_Demo.hex, its serial monitor built in (window "TEP
  Arduino UNO - ARD1").
  D1, R1: the meter: +5V to the cathode, the anode to A0, and 47k to GND.
  D2, R2: a yellow LED on D8 through 220 ohm: the night lamp.
  1. Press Run. The monitor prints the light in lux.
  2. Click D1, and press the light chips. The reading follows.
  3. Press Dark: the lamp lights.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  +5V - K ; A - pin - 47k - GND
V = I x R, so a bigger resistor reads dimmer light, and a smaller one reads brighter light.
REAL HARDWARE:
 * In meter mode the cathode goes to the positive side.
 * Daylight can be thousands of lux: choose R for the brightest light you need to read.
 * For fast or very dim light, use an op-amp instead of a resistor.

THE DEMO SKETCH ON THE SERIAL MONITOR (Light_Meter_Demo V1.0, 9600 baud)
There are no commands. The sketch prints the light once a second, and reports the lamp.
EXPECTED MONITOR OUTPUT
  Photodiode light meter - The Engineering Projects

PROPERTIES (double-click the part > Edit Properties)
  Light at the start, lux        300
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 TEPPHOTODIODE.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
* The reading stops rising: the load resistor has taken the whole supply. Use a smaller one.
* It reads nothing: the part is the wrong way round.
* The pop-up does not open: click the part at Run (it stays closed until then).
* The part is not simulated: TEPPHOTODIODE.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/photodiode-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 (TEPPHOTODIODE.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\Light_Meter_Demo\Light_Meter_Demo.ino, select Arduino Uno and use Sketch > Export
Compiled Binary. Replace the simulation's .hex with the exported HEX. The sketch needs 4,994 bytes
of flash and 218 bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the diode law, the leakage, a photocurrent of 70 nA per lux, the open circuit voltage.
Not modelled: the spectrum of the light, the capacitance and speed of the junction, the dark
current's rise with temperature.

VERSION
TEP Photodiode library V1.0 (Nov 2026). Device PHOTODIODEBPW34TEP (TEPPHOTODIODE.LIB /
TEPPHOTODIODE.DLL). Demo sketch Light_Meter_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino
Library V4.0) with its built-in serial monitor.