Project Files of Raspberry Pi Pico 2 Library for Proteus: MAX30102 Oximeter

RASPBERRY PI PICO 2 LIBRARY FOR PROTEUS - V1.0 (YOUR RP2350 SKETCH, A W5500 FOR THE NETWORK, A PULSE OXIMETER)
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/10/raspberry-pi-pico-2-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/raspberry-pi-pico-2-proteus-library
The demo's parts are our libraries (included) - their articles:
  MAX30102:   https://www.theengineeringprojects.com/2026/09/max30102-proteus-library.html
  SSD1306:    https://www.theengineeringprojects.com/2026/10/oled-ssd1306-library-for-proteus-v1-0.html
  W5500:      https://www.theengineeringprojects.com/2026/10/w5500-ethernet-module-library-for-proteus.html
  Laptop and phone:
    https://www.theengineeringprojects.com/2026/10/laptop-wifi-monitor-library-for-proteus.html
    https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
The Pico 2 with Wi-Fi (the same pins):
  https://www.theengineeringprojects.com/2026/10/raspberry-pi-pico-2-w-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
Raspberry-Pi-Pico-2-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPLAPTOP.LIB                                    39.5 KB   the laptop (demo), to LIBRARY
|   |-- TEPMAX30102.LIB                                  44.2 KB   the MAX30102 (demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                    13.1 KB   the phone (demo), to LIBRARY
|   |-- TEPOLED12864.LIB                                112.4 KB   the SSD1306 OLED (demo), to LIBRARY
|   |-- TEPPICO2.LIB                                     30.2 KB   the Raspberry Pi Pico 2, to LIBRARY
|   |-- TEPW5500MOD.LIB                                  22.8 KB   the W5500 module (demo), to LIBRARY
|-- Proteus Model Files/
|   |-- TEPMAX30102.DLL                                 537.0 KB   the MAX30102, to MODELS
|   |-- TEPNET.DLL                                       2.47 MB   the board + monitors + network, to MODELS
|   |-- TEPOLED.DLL                                     323.0 KB   the SSD1306 OLED, to MODELS
|-- Arduino Code/
|   |-- Pico2_Pulse_Oximeter/Pico2_Pulse_Oximeter.ino    11.6 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/                731.7 KB   the Arduino IDE add-on 1.28.0 (169 files)
|-- Proteus Simulation/
|   |-- Pico2_Pulse_Oximeter.hex                        105.4 KB   the demo sketch (U1)
|   |-- Pico2-Pulse-Oximeter.pdsprj                      28.5 KB   the demo: a pulse oximeter
|   |-- TEPMAX30102.DLL                                 537.0 KB   copy of the model
|   |-- TEPNET.DLL                                       2.47 MB   copy of the model
|   |-- TEPOLED.DLL                                     323.0 KB   copy of the model
|-- README.txt                                          ~13.8 KB   this file
Total: 7.74 MB (unzipped). The source code of the models is not included.

WHAT IS IT?
Proteus 8 has no Raspberry Pi RP2350 model, so this is NOT a real RP2350. It is the Raspberry Pi Pico 2 - the 51 x 21
mm board with its 2 x 20 castellated pins, the RP2350, the flash chip, the 12 MHz crystal, micro-USB, BOOTSEL, the green
LED on GP25 and the 3-pin DEBUG connector - that runs YOUR Pico 2 Arduino sketch in Proteus:
  * You write a normal Pico 2 sketch for the arduino-pico core (Earle Philhower's "Raspberry Pi Pico/RP2040/RP2350"
    board package): GP0 .. GP22 and GP26 .. GP28 as pins 0 .. 28, A0 .. A2, LED_BUILTIN (25), BOOTSEL,
    analogReadTemp(), Serial, Serial1, Wire, SPI - and compile it in the Arduino IDE with our board package "TEP Boards
    for Proteus" 1.28.0 (in Arduino Code - see INSTALLATION).
  * Inside the board, Proteus's own ATmega2560 model runs the compiled sketch at 16 MHz; our model (TEPNET.DLL) wraps
    it: the Pico's pins, 3.3 V logic, GP26 .. GP28 (0 .. 1023 for 0 .. 3.3 V), the LED on GP25, BOOTSEL, RUN and the
    built-in serial monitor on the USB (Serial).
  * The Pico 2 has no radio. For a network, put a W5500 Ethernet module on SPI0 and use the Ethernet library, as the
    demo does (WIZnet sells the same pair as one board, the W5500-EVB-Pico2); it joins our virtual router TEP-WiFi with
    the Laptop and Mobile WiFi Monitors.
TEP additions: a red PWR LED (the real board has none), the micro-USB opens the serial monitor. There is no panel: the
board has no Wi-Fi.
Limits (say them before you start): 16 MHz, 8 KB of RAM (the real RP2350: 150 MHz, 520 KB), int is 16 bits (the real
board: 32 bits - use long for big numbers), no second core, no PIO, no RISC-V cores, no MicroPython. See MODEL SCOPE
AND LIMITS.

ONE DEVICE (search "PICO 2" in Pick Devices):
  RASPBERRY PI PICO 2  "Raspberry Pi Pico 2" V1.0 (Microprocessor ICs > Raspberry Pi Boards), prefix U, model
  TEPNET.DLL. The serial monitor (115200 baud) has Monitor, Plotter and Board tabs (the Board tab: PWR and the LED, the
  RUN and BOOTSEL keys, every pin). Like every TEP window it has no Windows title bar.
The same TEPNET.DLL also runs our other sketch boards, the W5500 module and the Laptop / Mobile WiFi Monitors; it
replaces any older TEPNET.DLL (keep only this newest one in MODELS).

TEST STATUS
V1.0: verified in Proteus 8.5 on 26 Oct 2026 with the demo project as shipped. What the Proteus run showed:
* Pico2-Pulse-Oximeter: the monitor printed "MAX30102 ready, OLED ready", "W5500: 192.168.1.95, link ON", ">> OK" and
  "Pulse 72.3 BPM  SpO2 98.0 %  OK" (the MAX30102 set to 72 BPM and 98 %); PWR on, the LED on GP25 flashing with the
  beats; the OLED: the pulse, the SpO2 and the waveform.
* The laptop (192.168.1.21) opened http://192.168.1.95/json and the phone (192.168.1.41) http://192.168.1.95/
  (HTTP 200).
* LOW SPO2 on the MAX30102's pop-up: ">> LOW SpO2", "Pulse 80.0 BPM  SpO2 85.0 %  LOW SpO2"; RUN 150: ">> HIGH PULSE",
  "Pulse 150.0 BPM  SpO2 95.0 %"; FINGER OFF: ">> NO FINGER"; REST 60 and FINGER ON: "Pulse 60.0 BPM  SpO2 98.0 %  OK".
* About 44 s of simulation in 229 s, with the three pop-ups, the monitor and both tools open; no errors.

INSTALLATION (about 3 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" 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). TEPPICO2.LIB is the Pico 2; the
   others are the demo's parts: TEPMAX30102.LIB, TEPOLED12864.LIB, TEPW5500MOD.LIB, TEPLAPTOP.LIB and TEPMOBILE.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPMAX30102.DLL, TEPOLED.DLL) to the MODELS folder (...\Proteus
   8 Professional\MODELS) - replace an older TEPNET.DLL (this one is the first that knows the Pico 2).
4. Delete TEPPICO2.IDX from the LIBRARY folder if it is there.
5. The Arduino IDE (only to compile your own sketches - the demo has its HEX file): copy the folder
   "Arduino Code\TEP Boards for Proteus\hardware" into your sketchbook folder (normally Documents\Arduino), so that
   Documents\Arduino\hardware\tep\avr\boards.txt exists (replace an older copy); restart the IDE. The Arduino AVR Boards
   platform must be installed (it comes with IDE 1.8.x; in IDE 2.x install "Arduino AVR Boards" from the Boards Manager
   once). Tools > Board > TEP Boards for Proteus > Raspberry Pi Pico 2 (TEP Proteus). The demo also needs SparkFun
   MAX3010x, Adafruit SSD1306, Adafruit GFX, Adafruit BusIO and Ethernet (Library Manager).
6. Start Proteus. In Pick Devices (P) search "PICO 2".

RUN THE DEMO
Keep the .hex file and the DLLs beside the project in "Proteus Simulation".
Pico2-Pulse-Oximeter.pdsprj - U1 the Pico 2 (Pico2_Pulse_Oximeter.hex) is a finger pulse oximeter: U3 = the MAX30102
(I2C address 0x57) and OLED1 = the 0.96" SSD1306 OLED (0x3C) on I2C (SDA GP4, SCL GP5); U2 = the W5500 Ethernet module
on SPI0 (MISO GP16, CS GP17, SCK GP18, MOSI GP19; the fixed address 192.168.1.95). PC1 the Laptop WiFi Monitor opens
http://192.168.1.95/json and MOB1 the Mobile WiFi Monitor http://192.168.1.95/. The MAX30102 and the OLED are the
Advance versions: each opens its pop-up window at Run, as the W5500 does.
The MAX30102 shines red and infrared light through the finger and gives 25 samples a second of each (100 Hz averaged by
4). Every 100 samples (4 s) the sketch estimates the pulse from the infrared waveform (the beats between the first and
the last crossing of its middle) and the SpO2 from the red / infrared ratio (Maxim's approximation). The green LED on
GP25 flashes with every beat; the OLED shows the pulse, the SpO2, the state and the last 2.5 s of the waveform. States:
NO FINGER, MEASURING, OK, LOW SpO2 (below 94 %), HIGH PULSE (above 120 BPM), LOW PULSE (below 50 BPM).
Press Run. After 4 s the monitor prints "Pulse 72.3 BPM  SpO2 98.0 %  OK". On the MAX30102's pop-up click LOW SPO2:
LOW SpO2; RUN 150: HIGH PULSE; FINGER OFF: NO FINGER; REST 60 and FINGER ON: OK at 60 BPM. REFRESH on the phone and Go
on the laptop show the new values.
The modules' supplies: in the demo the VCC of the MAX30102, the OLED and the W5500 go to Proteus' power rail (power
terminals) - their models read the supply as a digital level, which the board's 3V3 (an analog source) does not give
them; on a real board they sit on the Pico's 3V3 (the W5500 module on 3.3 V too). Closed the monitor? Click the board's
micro-USB. The monitor (115200) takes STATUS, LED <mA> (the sensor's LED current) and HELP.
This is an educational demo, not a medical device: a real oximeter needs a calibrated sensor and a proper algorithm.

THE PINS (the label on the board, what it can do in the simulation)
  GP0 / GP1          Serial1 TX / RX (UART0, as in arduino-pico), GPIO, interrupt
  GP2 .. GP22        GPIO, interrupt, analogWrite (PWM on any GP pin, as on the RP2350)
  GP4 / GP5          also Wire SDA / SCL (I2C0)
  GP16 .. GP19       also SPI MISO / CS / SCK / MOSI (SPI0)
  GP26 .. GP28       A0 .. A2: analogRead 0 .. 1023 for 0 .. 3.3 V; also GPIO
  LED_BUILTIN        the green LED on GP25 (inside the board, as on the real Pico 2)
  3V3 / VBUS         3.3 V (the board's logic) and 5 V (the USB's)
  GND / AGND, RUN    ground; RUN is the reset (LOW holds the board in reset)
  VSYS, 3V3_EN, VREF drawn, not modelled
Serial is the USB (the board's monitor), not GP0 / GP1. The pins are 3.3 V logic.

PROPERTIES (double-click the board > Edit Properties)
  PROGRAM   the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with Raspberry Pi Pico 2 (TEP Proteus))
  MONITOR   YES = the built-in serial monitor on the USB (Serial);  BAUD  its speed (115200, or AUTO)
  AUTOOPEN  YES = the monitor window opens at Run (the demo: YES)
One Pico 2 per design (its USB serial and LED lines are hidden pins, and Proteus joins hidden pins of the same name
across parts).

TROUBLESHOOTING
* Nothing happens at Run: the HEX was not built with TEP Boards for Proteus - select Raspberry Pi Pico 2 (TEP Proteus)
  and export the binary again.
* "MAX30102 NOT FOUND" / "OLED NOT FOUND": SDA on GP4, SCL on GP5; the module's VCC needs a digital supply (the power
  terminal, as in the demo).
* "No W5500 found" or "link OFF": SCS on GP17, SCLK GP18, MOSI GP19, MISO GP16; the module's CABLE property is IN.
* The pulse stays "---": no finger (FINGER OFF on the pop-up) or the LED current is too low (LED 12 in the monitor).
* An integer goes wrong above 32767: int is 16 bits on the hidden AVR - use long.
* The page shows old values: tap REFRESH (the monitors do not reload by themselves).

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot and the Serial Monitor text:
  https://www.theengineeringprojects.com/forum/category/raspberry-pi-pico-2-proteus-library

LICENCES AND THIRD-PARTY NOTES
* The board model and the network (TEPNET.DLL, which also runs the W5500 module), the symbols and artwork (TEPPICO2.LIB,
  TEPW5500MOD.LIB, TEPLAPTOP.LIB, TEPMOBILE.LIB) and the sensor and display models (TEPMAX30102 .LIB / .DLL,
  TEPOLED12864.LIB / TEPOLED.DLL) are made by The Engineering Projects. The board's processor is Proteus's own
  ATmega2560 model. The source code of the models is not included.
* TEP Boards for Proteus (Arduino Code): its core, the variants and the EEPROM, SPI and Wire libraries are modified
  copies of the Arduino AVR core 1.8.6 - GNU Lesser General Public License 2.1 (LGPL 2.1, the text:
  LICENSE-LGPL-2.1.txt); its other libraries and our core files are MIT (LICENSE-MIT.txt).
* The demo sketch uses SparkFun MAX3010x (MIT), Adafruit SSD1306, GFX and BusIO (BSD / MIT) and Ethernet (Arduino, LGPL)
  - install them in the Arduino IDE (Library Manager) to compile it; the .hex is included.
* Proteus is a product of Labcenter Electronics and is not included. Raspberry Pi, Pico and RP2350 are trademarks of
  Raspberry Pi Ltd, W5500 of WIZnet. This library is not made or endorsed by them or by Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied. Install TEP Boards for Proteus (INSTALLATION step 5) and the libraries, open Arduino
Code\Pico2_Pulse_Oximeter, select Raspberry Pi Pico 2 (TEP Proteus) and use Sketch > Export Compiled Binary. For a real
Pico 2 install Earle Philhower's "Raspberry Pi Pico/RP2040/RP2350" package, select "Raspberry Pi Pico 2" and upload -
the same sketch (with the W5500 on SPI0, as in the demo).

MODEL SCOPE AND LIMITS
Modelled: the Pico 2's header pins on a hidden ATmega2560 (Proteus's AVR model, 16 MHz, 3.3 V); digital I/O, analogRead
(GP26 .. GP28), PWM and attachInterrupt on any pin through the board model; BOOTSEL, the LED on GP25, analogReadTemp,
RUN; Serial (the USB monitor), Serial1 on GP0 / GP1, Wire on GP4 / GP5 and SPI on GP16 .. GP19 (the AVR's hardware);
Ethernet through a TEP W5500 module or Ethernet shield.
Not modelled: the RP2350 itself (two Cortex-M33 or Hazard3 cores at 150 MHz, 520 KB of RAM, PIO, its security features),
the flash chip, the DEBUG connector (drawn), GP23 / GP24 / GP29 (the board's own signals), VSYS / 3V3_EN / ADC_VREF. The
simulation runs below real time.

VERSION
TEP Raspberry Pi Pico 2 library V1.0 (Oct 2026). Device RASPBERRY PI PICO 2 (TEPPICO2.LIB / TEPNET.DLL), TEP Boards for
Proteus 1.28.0 (adds the Pico 2). Demo sketch Pico2_Pulse_Oximeter V1.0. Demo parts: MAX30102 and OLED SSD1306 (the
Advance versions), W5500 ETHERNET MODULE, LAPTOP WIFI MONITOR and MOBILE WIFI MONITOR.