Project Files of Raspberry Pi 5 Earthquake Detector - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 Earthquake Detector - 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-earthquake-detector-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
    ADXL345 accelerometer:
      https://www.theengineeringprojects.com/2026/10/adxl345-accelerometer-library-for-proteus-v1-0.html
    I2C LCD 16x2:
      https://www.theengineeringprojects.com/2026/10/i2c-lcd-16x2-library-for-proteus-v1-0.html
    RGB LED:
      https://www.theengineeringprojects.com/2026/11/rgb-led-library-for-proteus.html
    Active buzzer:
      https://www.theengineeringprojects.com/2026/11/active-buzzer-library-for-proteus.html
    BC547 transistor (Small Transistors):
      https://www.theengineeringprojects.com/2026/11/small-transistors-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-Earthquake-Detector-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPADXL345.LIB                                 64.7 KB   a part of the project -> LIBRARY folder
|   |-- TEPBJT.LIB                                     18.6 KB   a part of the project -> LIBRARY folder
|   |-- TEPBUZZER.LIB                                   9.9 KB   a part of the project -> LIBRARY folder
|   |-- TEPI2CLCD16X2.LIB                             181.4 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
|   |-- 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/
|   |-- TEPADXL345.DLL                                348.0 KB   a model -> MODELS folder
|   |-- TEPBJT.DLL                                    292.0 KB   a model -> MODELS folder
|   |-- TEPBUZZER.DLL                                 276.0 KB   a model -> MODELS folder
|   |-- TEPLCD.DLL                                    409.0 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   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/
|   |-- Pi-5-Earthquake-Detector.pdsprj                38.0 KB   the project simulation
|   |-- quake_monitor.py                               14.1 KB   the program PI1 runs
|   |-- TEPADXL345.DLL                                348.0 KB   copy of the model
|   |-- TEPBJT.DLL                                    292.0 KB   copy of the model
|   |-- TEPBUZZER.DLL                                 276.0 KB   copy of the model
|   |-- TEPLCD.DLL                                    409.0 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|   |-- TEPRGB.DLL                                    287.0 KB   copy of the model
|-- Python Code/
|   |-- quake_monitor.py                               14.1 KB   the program (the same file)
|-- README.txt                                        ~10.4 KB   this file
Total: 28.96 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A seismic alarm you can run in Proteus: a Raspberry Pi 5 reads an accelerometer fixed to a floor or a wall, tells an
  earthquake from a single knock, rates the shaking on an intensity scale, warns when the building tilts or the sensor
  falls, and shows everything on an LCD, an RGB LED, a buzzer and a web page.
    * ADXL345 accelerometer (ADXL345ADVTEP, U1): VCC and CS on the Pi's 3V3 (CS HIGH = I2C), SDO to GND (address 0x53),
      SDA GPIO2, SCL GPIO3. Full resolution, +-16 g, 100 samples a second; its own tap and free-fall detectors.
    * I2C LCD 16x2 (I2CLCD16X2BLUEADVTEP, LCD1, PCF8574 at 0x27) on the same bus, 5 V.
    * RGB LED, common cathode (LEDRGBCCTEP, D1): R GPIO17 through R1 100 ohm, G GPIO27 through R2 47, B GPIO22
      through R3 47 - green quiet, yellow tilt, red earthquake, blue levelling.
    * Active buzzer (BUZZERACTIVETEP, BZ1) on the 5 V rail, switched by Q1 BC547 (BC547BTEP; base through R5 1k from
      GPIO23); R4 1k across the buzzer.
    * RASPBERRY PI 5 (PI1) runs quake_monitor.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 quake_monitor.py):
    * the Pi reads the three axes 25 times a second; gravity is followed slowly, the rest is the shaking;
    * an earthquake = 5 samples (0.2 s) of shaking above 0.05 g within one second; a single knock is shorter (the
      chip's tap detector reports it as a knock); the earthquake is over after 2 s without shaking, then rated on the
      USGS ShakeMap scale (peak acceleration to Modified Mercalli intensity);
    * a tilt of 10 degrees or more from the level for 2 s = TILT (a beep every 2 s); a free fall is reported.
  Its pages:
    /            the dashboard: the state, the shaking now, the tilt, the axes, the last earthquake, the events
    /zero        level again: the sensor's present position becomes "no tilt"
    /silence     the buzzer off for the present alarm
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots (simulation times):
    * Start: "ADXL345 DEVID 0xE5"; "levelled: X +0.00 g, Y +0.00 g, Z +1.00 g" at 0.5 s; QUIET, green.
    * TAP: "a knock (the chip's tap detector) - a single knock is not an earthquake" at 11.5 s.
    * SHAKE: "EARTHQUAKE! shaking 1.39 g" at 14.4 s (red, the buzzer); "the earthquake is over: peak 2.31 g (231 % g),
      intensity X+ - extreme, 1.8 s of shaking" at 18.2 s.
    * PITCH +15 (X +0.26 g, Z +0.97 g): no earthquake; "TILT 15.0 degrees" at 25.5 s (yellow, a beep every 2 s).
    * SILENCE from the phone at 30.4 s; ZERO from the laptop: levelled at the slope at 33.5 s, the tilt 0.1 degrees.
    * FREE FALL: "FREE FALL - the sensor is falling" at 37.8 s; the landing counted only as a knock at 38.0 s.
    * The ADXL345: 2,119 reads, no NACK.
  An earlier version followed gravity slowly and read the sudden 15-degree tilt as an earthquake; the program now
  also asks for the shaking to swing back and forth (REVERSALS).
  43 s of simulation took about 3 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, ADXL345ADVTEP or BUZZERACTIVETEP to check
     that the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-Earthquake-Detector.pdsprj". Keep quake_monitor.py and the DLL files beside it.
  2. Press Play. The program levels the sensor (blue), then the LED turns green and the LCD says QUIET.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go. Press Refresh to update it.
  4. In the ADXL345's pop-up (U1) press TAP (a knock: ignored), then SHAKE (an earthquake: red, the buzzer), then
     PITCH +15 (TILT after 2 s). SILENCE on the page stops the buzzer; ZERO makes the new position level.
  Your own program: edit quake_monitor.py beside the project (the thresholds at the top) and press Play.

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5          PROGRAM=quake_monitor.py, ETHERNET=IN (192.168.1.51)
  U1 ADXL345ADVTEP            (no changes: flat, pitch 0, roll 0)
  LCD1 I2CLCD16X2BLUEADVTEP   (no changes: address 0x27)
  PC1, MOB1                   HOMEPAGE=http://192.168.1.51:8000/

TROUBLESHOOTING
  * "DEVID 0x00": the ADXL345 does not answer - SDA / SCL swapped, CS not HIGH (CS LOW = SPI mode), or SDO not at GND.
  * TILT at once after starting: the sensor was moving while the program levelled it - press ZERO with it still.
  * Every knock is an earthquake: QUAKE_N too small, or QUAKE_G below the floor's own vibration.
  * The buzzer stays silent: BUZZ is not on GPIO23, or R4 (1k across the buzzer) is missing.
  * 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; ADXL345 is a name of Analog Devices. This project is not made or endorsed by them. A hobby detector is
    not an official earthquake warning system.

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