Project Files of Raspberry Pi 5 Temperature Screening Gate - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 Contactless Temperature Screening Gate - 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-temperature-screening-gate-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
    MLX90614 IR thermometer (GY-906):
      https://www.theengineeringprojects.com/2026/10/mlx90614-ir-thermometer-library-for-proteus-v1-0.html
    TM1638 LED and KEY board:
      https://www.theengineeringprojects.com/2026/10/tm1638-led-key-library-for-proteus-v1-0.html
    MG996R servo motor:
      https://www.theengineeringprojects.com/2026/10/mg996r-servo-motor-library-for-proteus-v1-0.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-Screening-Gate-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPLAPTOP.LIB                                  39.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPMG996R.LIB                                  24.8 KB   a part of the project -> LIBRARY folder
|   |-- TEPMLX90614.LIB                                55.2 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
|   |-- TEPTM1638.LIB                                 147.0 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPMG996R.DLL                                 295.0 KB   a model -> MODELS folder
|   |-- TEPMLX90614.DLL                               338.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPTM1638.DLL                                 289.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-Screening-Gate.pdsprj                     35.8 KB   the project simulation
|   |-- screening_gate.py                              17.9 KB   the program PI1 runs
|   |-- TEPMG996R.DLL                                 295.0 KB   copy of the model
|   |-- TEPMLX90614.DLL                               338.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPTM1638.DLL                                 289.0 KB   copy of the model
|-- Python Code/
|   |-- screening_gate.py                              17.9 KB   the program (the same file)
|-- README.txt                                        ~10.9 KB   this file
Total: 26.65 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A contactless temperature screening station for a door that you can run in Proteus: a Raspberry Pi 5 reads an
  infra-red thermometer pointed at each person's forehead, shows the temperature and the verdict on a TM1638 display
  board, and opens a servo gate arm only for a normal temperature. A web page shows every screening.
    * MLX90614 IR thermometer, GY-906 module (MLX90614ADVTEP, U1) on 3V3, I2C1 (SDA GPIO2, SCL GPIO3), SMBus address
      0x5A: RAM 0x06 the room (the sensor itself), 0x07 the object, kelvin x 50; every word is checked with its PEC
      (CRC-8, x^8 + x^2 + x + 1). At start the program writes the emissivity of skin, 0.98 (EEPROM 0x24 = 0xFAE0).
      The scene at the start: a 34 C forehead (OBJECT=34, MATERIAL=0.98) 50 cm away (DISTANCE=50) = nobody.
    * TM1638 LED and KEY board (TM1638ADVTEP, TM1) on 3V3: STB GPIO17, CLK GPIO27, DIO GPIO22, driven bit by bit
      (LSB first, DIO taken on the rising CLK edge; 0x40, 0xC0 + 16 bytes, 0x8F; keys with 0x42, DIO turned round).
      Eight digits (the reading and the verdict), eight LEDs, keys S1 the counts, S2 / S3 the threshold -/+ 0.1 C,
      S8 the guard opens the gate.
    * MG996R servo (MG996RSERVOTEP, SERVO1): V+ on the 5 V rail, SIG on GPIO18 - the gate arm, 0 deg closed (544 us),
      90 deg open (1472 us), lgpio's servo pulses at 50 Hz.
    * RASPBERRY PI 5 (PI1) runs screening_gate.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 rules (at the top of screening_gate.py):
    * the object less than 1.5 C above the room = nobody (READY); a little warmer but under 32 C = too far
      (CLOSEr on the display); 32 - 40 C = a forehead (SCAN); above 40 C = not a forehead (HOt);
    * five readings 0.2 s apart are averaged; the body temperature = the forehead + 2.6 C (a fixed offset);
    * under 38.0 C (100.4 F) = PASS, the gate opens for 4 s; 38.0 C or more = HIGH, the gate stays shut and the
      eight LEDs flash until a guard opens it (S8 or OPEN GATE) or the person walks on;
    * after a verdict, nobody is screened until the sensor sees the room again (the person has walked on).
  Its pages:
    /            the dashboard: the state, the gate, the threshold, the counts, the last screenings, the events
    /open        the guard opens the gate for 4 s
    /reset       the counts back to 0
    /down /up    the threshold -/+ 0.1 C (37.0 - 39.0 C)
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (the program's times):
    * Start: the emissivity written 1.00 -> 0.98 (erased, then 0xFAE0); the room 24.99 C, the object 25.0 C: READY.
    * 5 cm: "STEP CLOSER - 27.33 C at the sensor" at 14.0 s (the forehead fills a quarter of the 10 cm spot).
    * 2 cm: scanning at 17.6 s; "PASS - 36.6 C (97.9 F; the forehead 33.96 C)" at 18.5 s; the servo at 90.2 deg
      (1472 us); the gate closed at 22.5 s; the person walked on at 27.1 s.
    * A 36 C forehead at 2 cm: "HIGH - 38.6 C (101.5 F; the forehead 36.00 C)" at 31.0 s, the gate shut, the LEDs
      flashing; OPEN GATE on the laptop at 40.7 s: the gate open, 38.6 OPEn on the display, closed at 44.7 s.
    * S1: P 1 b 1 (one passed, one stopped); S3: the threshold 38.1 C at 47.9 s; THRESHOLD -0.1 on the phone: 38.0 C
      at 49.9 s.
    * A 70 C cup at 2 cm: "not a forehead - 70.03 C (a hot object)" at 52.8 s; ROOM 25 C: READY at 55.6 s.
    * The MLX90614: 1196 reads and 2 writes, 0 PEC errors, 0 NACKs.
  61 s of simulation took about 5 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, MLX90614ADVTEP or TM1638ADVTEP to check
     that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-Screening-Gate.pdsprj". Keep screening_gate.py and the DLL files beside it.
  2. Press Play. The display shows rEAdY (the forehead is 50 cm away: the sensor sees the room).
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. In the MLX90614's pop-up (U1) pick 5 cm (CLOSEr), then 2 cm: a scan, PASS, the gate opens for 4 s. Pick 50 cm,
     press OBJECT +1 twice (36 C) and pick 2 cm: HIGH. Try OPEN GATE, the keys S1 / S3 / S8 and TEA 70 C.
  Your own program: edit screening_gate.py beside the project (the rules at the top) and press Play.

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5          PROGRAM=screening_gate.py, ETHERNET=IN (192.168.1.51)
  U1 MLX90614ADVTEP           OBJECT=34, MATERIAL=0.98, DISTANCE=50, AMBIENT=25 (a forehead, not yet at the sensor)
  TM1 TM1638ADVTEP            (no changes)
  SERVO1 MG996RSERVOTEP       (no changes: PULSE_MIN 544, PULSE_MAX 2400)
  PC1, MOB1                   HOMEPAGE=http://192.168.1.51:8000/

TROUBLESHOOTING
  * The display stays dark or shows rubbish: STB, CLK and DIO swapped, or the bits sent MSB first.
  * The keys never react: DIO stays an output during the key read, or it has no pull-up.
  * The MLX90614 does not answer at 0x5A: check VIN, GND, SDA, SCL; a read needs a repeated start, not a STOP.
  * Every reading about 0.5 C low: the emissivity is still 1.00 - let the program write 0.98.
  * Always CLOSEr: the forehead is too far for the sensor's 90 degree field of view (within 2.5 cm fills it).
  * The terminal cannot start Python: the TEPPi folder is not in MODELS (step 3 of INSTALLATION), or an older one.

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; MLX90614 is a product of Melexis. This project is not made or endorsed by them. It is a learning project,
    not a medical device: real screening needs a certified thermometer and a person to check anyone it stops.

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