Project Files of Raspberry Pi 5 Home Security System - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 Home Security 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-home-security-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
    HC-SR501 PIR motion sensor:
      https://www.theengineeringprojects.com/2026/10/pir-sensor-library-for-proteus-v4-0.html
    RCWL-0516 microwave radar:
  https://www.theengineeringprojects.com/2026/10/rcwl-0516-microwave-radar-sensor-library-for-proteus-v1-0.html
    DFPlayer Mini MP3 module:
      https://www.theengineeringprojects.com/2026/10/dfplayer-mini-library-for-proteus-v1-0.html
    Membrane keypad 4x4:
      https://www.theengineeringprojects.com/2026/10/membrane-keypad-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-Home-Security-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPDFPLAYER.LIB                                82.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPHCSR501.LIB                                391.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPKEYPAD.LIB                                 162.5 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
|   |-- TEPRCWL0516.LIB                                78.4 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/
|   |-- TEPDFPLAYER.DLL                               298.0 KB   a model -> MODELS folder
|   |-- TEPHCSR501.DLL                                400.0 KB   a model -> MODELS folder
|   |-- TEPKEYPAD.DLL                                 300.5 KB   a model -> MODELS folder
|   |-- TEPLED5MM.DLL                                 289.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPRCWL0516.DLL                               304.0 KB   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/
|   |-- home_security.py                               11.7 KB   the program PI1 runs
|   |-- Pi-5-Home-Security.pdsprj                      46.8 KB   the project simulation
|   |-- TEPDFPLAYER.DLL                               298.0 KB   copy of the model
|   |-- TEPHCSR501.DLL                                400.0 KB   copy of the model
|   |-- TEPKEYPAD.DLL                                 300.5 KB   copy of the model
|   |-- TEPLED5MM.DLL                                 289.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPRCWL0516.DLL                               304.0 KB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|-- Python Code/
|   |-- home_security.py                               11.7 KB   the program (the same file)
|-- README.txt                                        ~10.4 KB   this file
Total: 29.36 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A complete home alarm you can run in Proteus: a Raspberry Pi 5 watches two zones, is armed and disarmed with a PIN
  on a keypad or from a web page, speaks through an MP3 module and sounds a siren when someone breaks in.
    * HC-SR501 PIR motion sensor (HCSR501ADVTEP, U1) on the Pi's 5V pin: the living room, an instant zone; OUT
      (3.3 V) on GPIO17.
    * RCWL-0516 microwave radar (RCWL0516ADVTEP, U2) on 5V: the hallway at the front door, the entry zone; OUT on
      GPIO27 (3V3 and CDS open). DISTANCE=0: nobody in front at the start.
    * DFPlayer Mini MP3 module (DFPLAYERADVTEP, U3) on 5V: its RX from GPIO14 TXD, its TX to GPIO15 RXD
      (/dev/serial0, 9600 baud), BUSY on GPIO22. Its DEMO card: 01/004 GOODBYE when arming, 0002 CHIME during
      the entry delay, 01/002 WELCOME HOME when disarmed, 02/001 ALARM (the siren) over and over during an alarm.
    * 4x4 membrane keypad (KEYPAD4X4ADVTEP, U4): rows R1 - R4 on GPIO5, 6, 13, 19 (inputs with pull-ups), columns
      C1 - C4 on GPIO12, 16, 20, 21 (one at a time LOW), about 12 scans a second.
    * Red LED on GPIO23 (armed; blinking during a delay, fast during an alarm) and green LED on GPIO24 (disarmed),
      each through 220 ohm.
    * RASPBERRY PI 5 (PI1) runs home_security.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 PIN is 1234: type it, then # - to arm when disarmed, to disarm in any other state; * clears it; three wrong
  PINs sound the alarm. Arming starts a 10 s exit delay; the hallway while armed starts a 10 s entry delay (the PIN
  in time disarms, else the alarm); the living room while armed is an alarm at once. Its pages:
    /            the dashboard: the state (and the seconds left in a delay), the zones, the siren, the events
    /arm         arm the system (the exit delay starts)
    /disarm      disarm the system
    /data        everything as JSON (never the PIN)

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (simulation times):
    * 1.6 s: DISARMED, the green LED on; the server up; the DFPlayer at volume 25.
    * The keypad 1234 #: "ARMING from the keypad - 10 s to leave (GOODBYE)" at 9.1 s; ARMED at 19.2 s.
    * The radar, a person at 3 m: "hallway motion while armed - ENTRY DELAY" at 20.8 s, the chime every 2 s; the PIN
      1234 #: "DISARMED from the keypad (was ENTRY DELAY) - WELCOME HOME" at 25.9 s.
    * ARM from the laptop at 30.4 s; ARMED at 40.5 s.
    * The PIR, Walk in: "ALARM! living room motion while armed - the siren is on" at 42.2 s; the ALARM track
      (02/001) on the DFPlayer, the red LED blinking fast.
    * 1111 #: "wrong PIN on the keypad (1 of 3)" at 50.4 s; 1234 #: "DISARMED from the keypad (was ALARM)" at 53.4 s.
    * The GOODBYE frame on the UART: 7E FF 06 0F 00 01 04 FE E7 EF (folder 01, file 004).
  59 s of simulation took about 12 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, HCSR501ADVTEP or DFPLAYERADVTEP to check
     that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-Home-Security.pdsprj". Keep home_security.py and the DLL files beside it.
  2. Press Play. The system starts DISARMED: the green LED is on.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. In the keypad's pop-up (U4) click 1 2 3 4 #: GOODBYE, and after 10 s the system is ARMED.
  5. In the radar's pop-up (U2) press 3 m: the entry delay; type 1 2 3 4 # within 10 s. Or in the PIR's pop-up
     (U1) press Walk in while armed: the ALARM and the siren. NOBODY / Walk out take the people away.
  Your own program: edit home_security.py beside the project (PIN_CODE, EXIT_S, ENTRY_S at the top) and press Play.

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5   PROGRAM=home_security.py, ETHERNET=IN (192.168.1.51)
  U1 HCSR501ADVTEP     (no changes: TIME 5 s, the H jumper, warm-up skipped)
  U2 RCWL0516ADVTEP    DISTANCE=0 (nobody at the start)
  U3 DFPLAYERADVTEP    (no changes: CARD=DEMO)
  U4 KEYPAD4X4ADVTEP   (no changes: BOUNCE 3 ms, PRESS 150 ms)
  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.
  * A zone always shows MOTION: someone is still in front of the sensor in its pop-up (NOBODY / Walk out).
  * No key works: the rows and the columns are swapped, or the rows have no pull-ups.
  * The DFPlayer stays silent: its RX is not on GPIO14 TXD, or its card was pulled out (click the card).
  * The siren never stops: type 1 2 3 4 #, or press DISARM on the page.

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; HC-SR501, RCWL-0516 and DFPlayer Mini are names of their makers. This project is not made or endorsed by
    them.

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