Project Files of Raspberry Pi 5 Air Quality Monitor - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 Air Quality Monitor - Proteus Simulation Project V1.0
  The Engineering Projects - www.TheEngineeringProjects.com
===============================================================================================================

IMPORTANT LINKS
  The project tutorial (circuit, code, simulation results):
    https://www.theengineeringprojects.com/2026/11/raspberry-pi-5-air-quality-monitor-proteus-simulation.html
  The libraries this project is built from (each post has its own full download and tutorial):
    Raspberry Pi 5 board:
      https://www.theengineeringprojects.com/2026/10/raspberry-pi-5-library-for-proteus.html
    PMS5003 particle sensor:
      https://www.theengineeringprojects.com/2026/10/pms5003-particle-sensor-library-for-proteus-v1-0.html
    CCS811 air quality sensor (eCO2 / TVOC):
      https://www.theengineeringprojects.com/2026/10/ccs811-air-quality-sensor-library-for-proteus-v1-0.html
    DS3231 real-time clock:
      https://www.theengineeringprojects.com/2026/10/ds3231-rtc-module-library-for-proteus-v1-0.html
    RGB LED:
      https://www.theengineeringprojects.com/2026/11/rgb-led-library-for-proteus.html
    Resistor:
      https://www.theengineeringprojects.com/2026/11/resistor-library-for-proteus.html
    Laptop WiFi Monitor:
      https://www.theengineeringprojects.com/2026/10/laptop-wifi-monitor-library-for-proteus.html
    Mobile WiFi Monitor:
      https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
  Support our free work: https://www.theengineeringprojects.com/donate

FILE STRUCTURE
Pi-5-Air-Quality-Monitor-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPCCS811.LIB                                  58.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPDS3231.LIB                                  68.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPLAPTOP.LIB                                  39.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPPMS5003.LIB                                 71.0 KB   a part of the project -> LIBRARY folder
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPRGB.LIB                                     13.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPRPI5.LIB                                    60.5 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPCCS811.DLL                                 330.5 KB   a model -> MODELS folder
|   |-- TEPDS3231.DLL                                 321.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPPMS5003.DLL                                297.5 KB   a model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.0 KB   a model -> MODELS folder
|   |-- TEPRGB.DLL                                    287.0 KB   a model -> MODELS folder
|   |-- TEPPi/python/                                 17.54 MB   Python 3.11 embeddable -> MODELS\TEPPi (33 files)
|   |-- TEPPi/runtime/                                 1.11 MB   TEP Pi runtime, gpiozero -> MODELS\TEPPi (87 files)
|-- Proteus Simulation/
|   |-- air_quality.py                                 14.3 KB   the program PI1 runs
|   |-- Pi-5-Air-Quality-Monitor.pdsprj                37.6 KB   the project simulation
|   |-- TEPCCS811.DLL                                 330.5 KB   copy of the model
|   |-- TEPDS3231.DLL                                 321.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPPMS5003.DLL                                297.5 KB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|   |-- TEPRGB.DLL                                    287.0 KB   copy of the model
|-- Python Code/
|   |-- air_quality.py                                 14.3 KB   the program (the same file)
|-- README.txt                                        ~10.7 KB   this file
Total: 28.15 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A complete IoT air quality monitor you can run in Proteus: a Raspberry Pi 5 measures the particles and the gases in
  a room, works out the US Air Quality Index, dates every reading with a real-time clock and shows how healthy the
  air is on an RGB light and on a web page for a laptop or a phone.
    * PMS5003 laser particle sensor (PMS5003ADVTEP, U1) on the Pi's 5V pin: its TX to GPIO15 RXD (pin 10), its RX
      from GPIO14 TXD (pin 8), 9600 baud; SET and RESET open (normal, active mode). A frame every 2.3 s with PM1.0,
      PM2.5 and PM10; stable 30 s after power-up.
    * CCS811 gas sensor (CCS811ADVTEP, U2) on the Pi's 3V3 pin, I2C1 (SDA GPIO2, SCL GPIO3), 0x5A (ADD to GND),
      WAK to GND (always awake): eCO2 in ppm and TVOC in ppb, a result every second. RUNIN=20: the run-in is 20 s
      in the simulation instead of the datasheet's 20 minutes.
    * DS3231 real-time clock (DS3231ADVTEP, U3) on 3V3 and the same bus, 0x68: the time of every reading and event
      (TIME=2026-11-12 10:05:00) and its temperature, which the program passes to the CCS811 (ENV_DATA).
    * RGB LED, common cathode (LEDRGBCCTEP, D1): red from GPIO17 through R1 100 ohm, green from GPIO27 through R2
      47 ohm, blue from GPIO22 through R3 47 ohm. White = warming up, green = good, yellow = moderate,
      red = unhealthy, purple = very unhealthy or hazardous.
    * RASPBERRY PI 5 (PI1) runs air_quality.py on Ethernet at 192.168.1.51; the dashboard is on port 8000.
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open http://192.168.1.51:8000/.
  The program averages PM2.5 and PM10 over 30 s and turns them into the US EPA AQI (the 2024 breakpoints; the
  higher of the two). The light shows the worst of three levels: the AQI (50 / 100 / 200), eCO2 (800 / 1500 ppm)
  and TVOC (220 / 660 ppb). Every 10 s a row goes into the log. Its pages:
    /            the dashboard: the AQI and the light, PM2.5 / PM10 / PM1.0, eCO2, TVOC, the DS3231's time and
                 temperature, the peaks with their times, the events (newest first)
    /log.csv     a reading every 10 s with its DS3231 time (the last 60), CSV for a spreadsheet
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (the DS3231's times):
    * 10:05:00 the program started: DS3231 at 0x68, 25.00 C, the light WHITE while the sensors warm up; the server
      up within 2 s. 10:05:30 ready: the light GREEN, AQI 21 GOOD (PM2.5 6 ug/m3), eCO2 442 ppm, TVOC 6 ppb.
    * COOKING on the PMS5003: YELLOW at 10:05:59 (AQI 54), RED at 10:06:03 (AQI 138), PURPLE at 10:06:20 (AQI 208);
      the readings peaked at PM2.5 208 ug/m3 (10:06:06), the AQI at 230 (10:06:30).
    * PURIFIER: RED at 10:06:39 (AQI 197), YELLOW at 10:07:14 (AQI 90), GREEN at 10:07:41 (AQI 47).
    * PAINT on the CCS811: YELLOW at 10:07:47 (eCO2 881 ppm), RED at 10:07:49 (eCO2 1863 ppm); the peaks eCO2
      3338 ppm and TVOC 441 ppb at 10:08:01, while the real CO2 of the PAINT air is 600 ppm (eCO2 follows the VOCs).
    * VENTILATE: YELLOW at 10:08:25 (eCO2 1361 ppm), GREEN at 10:08:45 (eCO2 788 ppm, TVOC 58 ppb).
    * LOG on the laptop: the CSV rows, one every 10 s, with the DS3231's date and time.
  234 s of simulation took about 17 minutes on our PC with all the captures.

INSTALLATION
  1. Close Proteus. Extract the WHOLE zip file, for example to your Desktop.
  2. Copy the files from "Proteus Library Files" into the LIBRARY folder of Proteus, for example
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
  3. Copy everything in "Proteus Model Files" - the DLL files AND the TEPPi folder - into the MODELS folder
     (next to LIBRARY). TEPPi holds the Python 3.11 that the Raspberry Pi board runs and our TEP Pi runtime.
  4. Start Proteus. Press P in the schematic and search for RASPBERRY PI 5, PMS5003ADVTEP or CCS811ADVTEP to
     check that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-Air-Quality-Monitor.pdsprj". Keep air_quality.py and the DLL files beside it.
  2. Press Play. The Pi's terminal runs air_quality.py; the light is white for 30 s while the sensors warm up,
     then green for the clean air.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update.
  4. In the PMS5003's pop-up (U1) press COOKING: smoke from a pan - the light turns red, then purple. PURIFIER
     cleans the air again. CITY, HAZE, SMOKE and DUST set other air.
  5. In the CCS811's pop-up (U2) press PAINT (VOCs), MEETING (a stuffy room) or BREATH, then VENTILATE.
  6. LOG on the page shows the CSV log; the DS3231's pop-up (U3) shows its registers and its time.

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5   PROGRAM=air_quality.py, ETHERNET=IN (192.168.1.51)
  U1 PMS5003ADVTEP     (no changes: CLEAN air, PM2.5 5 ug/m3)
  U2 CCS811ADVTEP      RUNIN=20 (s; FRESH air: TVOC 5 ppb, CO2 420 ppm)
  U3 DS3231ADVTEP      TIME=2026-11-12 10:05:00
  D1 LEDRGBCCTEP       (no changes); R1 100 ohm, R2 / R3 47 ohm
  PC1, MOB1            HOMEPAGE=http://192.168.1.51:8000/

TROUBLESHOOTING
  * The terminal cannot start Python: the TEPPi folder is not in MODELS (step 3 of INSTALLATION), or an older one.
  * The particle readings stay at 0: the PMS5003's TX is not on GPIO15 RXD, or its VCC is not on 5V.
  * "CCS811 not found": SDA / SCL swapped, ADD high (the chip is then at 0x5B) or WAK not LOW.
  * eCO2 stays at 400 ppm and TVOC at 0: the CCS811 is still in its run-in (RUNIN).
  * The light stays dark: the LED's cathode C is not on ground, or R / G / B are not on GPIO17 / 27 / 22.

LICENCES
  * The project, the program, the parts (LIB files) and the models (DLL files) are made by The Engineering
    Projects and are free for learning and for your own projects. The models use only standard Windows libraries.
    The C++ source code of the models is not included; the source code is not included for any model.
  * TEPPi\python is the Python 3.11 Windows embeddable package (Python Software Foundation License); TEPPi\runtime
    holds our TEP Pi runtime with gpiozero and colorzero (BSD licences) - their licence files are inside the folders.
  * Proteus is a product of Labcenter Electronics and is not included. Raspberry Pi is a trademark of Raspberry Pi
    Ltd; PMS5003 (Plantower), CCS811 (ScioSense) and DS3231 (Analog Devices) are names of their owners. This
    project is not made or endorsed by them.

VERSION
  V1.0 - the first release of the project.
===============================================================================================================