Project Files of Raspberry Pi 5 PID Temperature Control - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 PID Temperature Control - 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-pid-temperature-control-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
    Temperature Control Lab shield:
      https://www.theengineeringprojects.com/2026/11/pid-temperature-control-lab-library-for-proteus.html
    MCP3008 ADC:
      https://www.theengineeringprojects.com/2026/11/mcp3008-8-channel-adc-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-PID-Temperature-Lab-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPLAPTOP.LIB                                  39.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPMCP3008.LIB                                 14.3 KB   a part of the project -> LIBRARY folder
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPRPI5.LIB                                    60.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPTEMPLAB.LIB                                 20.8 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPMCP3008.DLL                                298.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPTEMPLAB.DLL                                304.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/
|   |-- Pi-5-PID-Temperature-Lab.pdsprj                29.9 KB   the project simulation
|   |-- pid_lab.py                                     13.0 KB   the program PI1 runs
|   |-- TEPMCP3008.DLL                                298.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPTEMPLAB.DLL                                304.0 KB   copy of the model
|-- Python Code/
|   |-- pid_lab.py                                     13.0 KB   the program (the same file)
|-- README.txt                                         ~9.8 KB   this file
Total: 25.82 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A complete IoT control project you can run in Proteus: a Raspberry Pi 5 runs a PID temperature controller in
  Python on our Temperature Control Lab shield and serves a live dashboard to a laptop and a phone.
    * Temperature Control Lab shield (TEMPLABSHIELDTEP): two transistor heaters, a TMP36 on each, a HOT LED.
      Heater 1 (Q1) on GPIO18, heater 2 (Q2) on GPIO19 (PWM at 100 Hz), the HOT LED on GPIO17, 5V from the Pi.
    * MCP3008 10-bit ADC (MCP3008TEP) on SPI0: CLK GPIO11, DIN GPIO10 (MOSI), DOUT GPIO9 (MISO), CS GPIO8 (CE0).
      CH0 reads T1, CH1 reads T2. VDD and VREF on +3.3V (the Pi's 3.3 V pin, pin 1).
    * RASPBERRY PI 5 (PI1) runs pid_lab.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 controller: a PID (P on the error, I with anti-windup, D on the filtered measurement) tuned by the IMC
  rules from the lab's step response (K 0.92 C/%, tau 175 s, dead time 15.6 s; Park et al. 2020) for a 30 s
  closed loop: Kc 5.26 %/C, Ti 182.8 s, Td 7.47 s. It holds T1 at the setpoint; heater 2 is a disturbance.
  The pages:
    /                       the dashboard: status, links, setpoint, T1, T2, the heaters, the PID terms, the trend
    /trend.bmp              the last 15 lab minutes of T1, T2, the setpoint and heater 1, drawn by the Pi
    /sp/35 /sp/45 /sp/55    a new setpoint
    /on /off                the PID on or off
    /q2/0 /q2/50 /q2/100    heater 2 (the disturbance)
    /data                   all the readings as JSON
  The shield's SPEED property is 20: the lab runs twenty times faster than the simulation clock, so a
  20-minute experiment takes one simulated minute. The program counts the lab's time (LAB_SPEED = 20 in
  pid_lab.py; set it to 1 on a real kit).

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (times in lab seconds):
    * eth0 up and the server on http://192.168.1.51:8000/ at 1.3 s of simulation; the pages served to both monitors.
    * The MCP3008 at VDD = VREF = 3.300 V, SPI at 1.00 MHz (its limit at 3.3 V: 1.94 MHz), 40 conversions a second.
    * Setpoint 40 C from 22.8 C: 36.4 C at 61 s, 39.9 C at 122 s, settled (within 0.5 C for 60 s) at 156 s, overshoot
      0.2 C; heater 1 then about 20 %.
    * Setpoint 55 C from the phone at 339 s: settled at 505 s, overshoot 0.1 C; heater 1 about 38 %.
    * Heater 2 at 100 % from the laptop at 581 s: T1 rose to 56.3 C at most while the PID cut heater 1 from 38 % to
      23 %; T2 passed 60 C at 756 s (HOT, the LED on) and reached 68.6 C; T1 back at 55.7 C by 1023 s.
    * Heater 2 off from the phone at 1024 s: T2 under 58 C at 1092 s (the LED off).
  1,200 lab seconds (60 s of simulation) took about five 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, TEMPLABSHIELDTEP or MCP3008TEP to
     check that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-PID-Temperature-Lab.pdsprj". Keep pid_lab.py and the DLL files beside it.
  2. Press Play. The Pi's terminal opens and runs pid_lab.py; it prints the dashboard address and a line every
     60 lab seconds. The PID starts at once with the setpoint 40 C.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh on the
     page to update it.
  4. Try SP 55 C (a setpoint step), then Q2 100 % (a disturbance: heater 2 warms T1 through the board), then
     Q2 0 %. Watch the trend picture and the PID terms.
  5. Click the shield or the MCP3008 during the simulation for their pop-ups (the heaters as a thermal camera
     sees them, a live step-test fit; the ADC's last SPI transfer bit by bit).

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5   PROGRAM=pid_lab.py, ETHERNET=IN (192.168.1.51)
  U1 TEMPLABSHIELDTEP  SPEED=20 (twenty lab seconds each simulated second)
  U2 MCP3008TEP        (no properties)
  PC1, MOB1            HOMEPAGE=http://192.168.1.51:8000/

TROUBLESHOOTING
  * The terminal says "No module named" or the board does not start Python: the TEPPi folder is not in MODELS
    (step 3 of INSTALLATION) or an older TEPPi is there - replace it with the one in this zip.
  * T1 and T2 read far too low (about two thirds): VREF is not 3.3 V. Keep the +3.3V terminals on VDD and VREF.
  * The page says "Loading the picture...": the trend picture comes after the page; wait a moment.
  * The temperatures change very slowly: SPEED is 1; the lab's time constant is about three minutes. Set
    SPEED back to 20, or LAB_SPEED in the program to the same value.
  * HOT on the page and the shield's LED on: T1 or T2 is at 60 C or more; it goes off again under 58 C.

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, TMP36 and MCP3008 are names
    of their owners; this project is not made or endorsed by them.

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