Project Files of Raspberry Pi 5 Fingerprint Attendance System - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 Fingerprint Attendance System - 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-fingerprint-attendance-system-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
    R307 fingerprint sensor:
      https://www.theengineeringprojects.com/2026/10/fingerprint-sensor-library-for-proteus-v1-0.html
    I2C LCD 20x4:
      https://www.theengineeringprojects.com/2026/10/i2c-lcd-20x4-library-for-proteus-v1-0.html
    5mm LED:
      https://www.theengineeringprojects.com/2026/11/5mm-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-Fingerprint-Attendance-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPFINGER.LIB                                 264.2 KB   a part of the project -> LIBRARY folder
|   |-- TEPI2CLCD20X4.LIB                             205.4 KB   a part of the project -> LIBRARY folder
|   |-- TEPLAPTOP.LIB                                  39.5 KB   a part of the project -> LIBRARY folder
|   |-- TEPLED5MM.LIB                                  21.8 KB   a part of the project -> LIBRARY folder
|   |-- TEPMOBILE.LIB                                  13.1 KB   a part of the project -> LIBRARY folder
|   |-- TEPRESISTOR.LIB                               306.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPRPI5.LIB                                    60.5 KB   a part of the project -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPFINGER.DLL                                 321.5 KB   a model -> MODELS folder
|   |-- TEPLCD.DLL                                    409.0 KB   a model -> MODELS folder
|   |-- TEPLED5MM.DLL                                 289.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPRESISTOR.DLL                               311.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/
|   |-- attendance.py                                  15.1 KB   the program PI1 runs
|   |-- Pi-5-Fingerprint-Attendance.pdsprj             45.3 KB   the project simulation
|   |-- TEPFINGER.DLL                                 321.5 KB   copy of the model
|   |-- TEPLCD.DLL                                    409.0 KB   copy of the model
|   |-- TEPLED5MM.DLL                                 289.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|-- Python Code/
|   |-- attendance.py                                  15.1 KB   the program (the same file)
|-- README.txt                                        ~10.2 KB   this file
Total: 28.01 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  An attendance register you can run in Proteus: a Raspberry Pi 5 reads fingerprints, marks each person IN and later
  OUT, greets them on an LCD, enrols new people from a web page and shows the register to any laptop or phone.
    * R307 / AS608 optical fingerprint sensor (FINGERADVTEP, U1): 5V and 3V3 (the touch sensing) from the Pi's header,
      its TXD to the Pi's RXD (GPIO15), its RXD from the Pi's TXD (GPIO14) - /dev/serial0 at 57600 baud - and TOUCH on
      GPIO23 (HIGH while a finger lies on the glass). ENROLLED=1:A 2:B 3:C: fingers A, B, C are stored as IDs 1, 2, 3.
    * I2C LCD 20x4 (I2CLCD20X4BLUEADVTEP, LCD1, PCF8574 backpack at 0x27) on I2C1 (SDA GPIO2, SCL GPIO3), 5 V.
    * LEDs (LED5MMGREENTEP / LED5MMREDTEP / LED5MMBLUETEP) on GPIO24 / GPIO25 / GPIO12 through 220 ohm: marked / not
      registered or a poor image / enrolling.
    * RASPBERRY PI 5 (PI1) runs attendance.py on Ethernet at 192.168.1.51; the register is on port 8000.
    * Laptop WiFi Monitor (PC1) and Mobile WiFi Monitor (MOB1) open http://192.168.1.51:8000/.
  The people (at the top of attendance.py): ID 1 Ayesha Khan, ID 2 Bilal Ahmed, ID 3 Sana Malik; to enrol next:
  Usman Ali, Hina Raza. A registered finger marks IN, the same finger later marks OUT; the same person again within
  10 s is ignored. The program speaks the sensor's own packet protocol (EF 01, the address, the identifier, the
  length, the content, the checksum): VfyPwd, TempleteNum, GenImg, Img2Tz, Search, RegModel and Store.
  Its pages:
    /            the register: everyone's status with the IN and OUT times, the next person to enrol, the events
    /enroll      enrol the next person on the list: the finger placed twice, stored at the next free ID
    /csv         the register as a CSV file
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (simulation times):
    * 0.6 s: "sensor found - 3 templates stored" (VfyPwd and TempleteNum answered 0x00).
    * Finger A: "Ayesha Khan IN at 14:24:36 (ID 1, score 124)" at 11.8 s; Search answered page 1, score 0x7C.
    * Finger C: "Sana Malik IN (ID 3, score 224)" at 18.2 s; C again at once: "again within 10 s - ignored" at 21.7 s.
    * Finger E: "a finger that is not registered" at 25.8 s (Search 0x09), the red LED.
    * PARTIAL + finger B: "a poor image (code 0x07)" at 32.7 s.
    * ENROLL on the laptop: "enrolling Usman Ali as ID 4" at 37.8 s; finger D twice; "Usman Ali enrolled as ID 4 - 4
      templates in the sensor" at 44.5 s; D: "Usman Ali IN (ID 4, score 234)" at 50.7 s.
    * Finger A again: "Ayesha Khan OUT at 14:25:18 (ID 1, score 95)" at 54.0 s; the register: 2 of 4 present.
    * The sensor: 30 packets each way, 7 searches, 5 found, 1 enrolment, no framing or checksum errors.
  64 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, FINGERADVTEP or I2CLCD20X4BLUEADVTEP to
     check that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-Fingerprint-Attendance.pdsprj". Keep attendance.py and the DLL files beside it.
  2. Press Play. The LCD shows "Place your finger"; the terminal prints "sensor found - 3 templates stored".
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. In the fingerprint sensor's pop-up (U1) click finger card A: "Welcome, Ayesha Khan - IN". Click the card again to
     lift the finger. Try C, then E (not registered), and PARTIAL with B (a poor image).
  5. Press ENROLL on the page and place finger D twice (lift it in between): Usman Ali is stored as ID 4.
  Your own program: edit attendance.py beside the project (the names at the top) and press Play.

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5          PROGRAM=attendance.py, ETHERNET=IN (192.168.1.51)
  U1 FINGERADVTEP             ENROLLED=1:A 2:B 3:C (security level 3, 57600 baud, 1000 templates: unchanged)
  LCD1 I2CLCD20X4BLUEADVTEP   (no changes: address 0x27)
  PC1, MOB1                   HOMEPAGE=http://192.168.1.51:8000/

TROUBLESHOOTING
  * "NO SENSOR": the sensor's TXD must go to the Pi's RXD (GPIO15) and its RXD to the Pi's TXD (GPIO14); 57600 baud.
  * Nothing happens when a finger is placed: TOUCH is not on GPIO23, or the sensor's 3V3 pin has no supply.
  * "NOT REGISTERED" for everyone: the ENROLLED property is empty (every run starts again from the properties).
  * "POOR IMAGE": the quality in the pop-up is PARTIAL or SMUDGED - set it to GOOD.
  * The LCD stays blank: SDA / SCL swapped, or the LCD is not at 0x27.
  * 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; R307 (Hangzhou Grow Technology) and AS608 are names of their makers. This project is
    not made or endorsed by them. The names in the program are made up for the example.

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