Project Files of Raspberry Pi 5 Gas Leak and Fire Alarm - Proteus Simulation

===============================================================================================================
  Raspberry Pi 5 Gas Leak and Fire Alarm - 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-gas-leak-fire-alarm-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
    MQ-2 gas sensor:
      https://www.theengineeringprojects.com/2026/10/gas-sensor-library-for-proteus-v2-0.html
    Flame sensor:
      https://www.theengineeringprojects.com/2026/10/flame-sensor-library-for-proteus-v2-0.html
    ADS1115 16-bit ADC:
      https://www.theengineeringprojects.com/2026/10/ads1115-adc-library-for-proteus-v1-0.html
    4-pin PC fan:
      https://www.theengineeringprojects.com/2026/11/4-pin-pc-fan-library-for-proteus-v1-0.html
    Active buzzer:
      https://www.theengineeringprojects.com/2026/11/active-buzzer-library-for-proteus.html
    BC547B transistor (small transistors):
      https://www.theengineeringprojects.com/2026/11/small-transistors-library-for-proteus.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-Gas-Leak-Fire-Alarm-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPADS1115.LIB                                 66.3 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
|   |-- TEPFLAME.LIB                                  213.2 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
|   |-- TEPMQ2.LIB                                    122.3 KB   a part of the project -> LIBRARY folder
|   |-- TEPPCFAN.LIB                                   24.8 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/
|   |-- TEPADS1115.DLL                                326.0 KB   a model -> MODELS folder
|   |-- TEPBJT.DLL                                    292.0 KB   a model -> MODELS folder
|   |-- TEPBUZZER.DLL                                 276.0 KB   a model -> MODELS folder
|   |-- TEPFLAME.DLL                                  389.5 KB   a model -> MODELS folder
|   |-- TEPLED5MM.DLL                                 289.5 KB   a model -> MODELS folder
|   |-- TEPMQ2.DLL                                    414.5 KB   a model -> MODELS folder
|   |-- TEPNET.DLL                                     2.89 MB   a model -> MODELS folder
|   |-- TEPPCFAN.DLL                                  303.5 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/
|   |-- gas_fire_alarm.py                              11.8 KB   the program PI1 runs
|   |-- Pi-5-Gas-Leak-Fire-Alarm.pdsprj                45.3 KB   the project simulation
|   |-- TEPADS1115.DLL                                326.0 KB   copy of the model
|   |-- TEPBJT.DLL                                    292.0 KB   copy of the model
|   |-- TEPBUZZER.DLL                                 276.0 KB   copy of the model
|   |-- TEPFLAME.DLL                                  389.5 KB   copy of the model
|   |-- TEPLED5MM.DLL                                 289.5 KB   copy of the model
|   |-- TEPMQ2.DLL                                    414.5 KB   copy of the model
|   |-- TEPNET.DLL                                     2.89 MB   copy of the model
|   |-- TEPPCFAN.DLL                                  303.5 KB   copy of the model
|   |-- TEPRESISTOR.DLL                               311.0 KB   copy of the model
|-- Python Code/
|   |-- gas_fire_alarm.py                              11.8 KB   the program (the same file)
|-- README.txt                                        ~11.6 KB   this file
Total: 30.47 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
  A complete IoT safety project you can run in Proteus: a Raspberry Pi 5 watches for a gas leak and for a flame,
  sounds the alarm, runs an exhaust fan and shows everything on a web page for a laptop or a phone.
    * MQ-2 gas sensor (MQ2ADVTEP, U1) on +5V. Its analog output A0 goes through a 10k / 20k divider (R1 / R2: the ADC
      sees 2/3 of it, 5 V becomes 3.33 V) into the ADS1115's A0.
    * ADS1115 16-bit ADC (ADS1115ADVTEP, U2) on +3.3V, I2C1 (SDA GPIO2, SCL GPIO3), address 0x48 (ADDR to ground).
      The Pi 5 has no analog inputs; the ADS1115 gives it four, 125 uV a step on the +-4.096 V range.
    * Flame sensor (FLAMEADVTEP, U3) on +3.3V: A0 into the ADS1115's A1. The program compares the infrared strength
      itself - a flame from 50 %, gone below 35 % (hysteresis) - so the module's D0 is not used.
    * 4-pin PC fan (PCFAN4PINTEP, FAN1) on +12V: PWM on GPIO18 (LOW = its minimum speed, HIGH = full speed), TACH on
      GPIO23, held high by the Pi's own pull-up (lgpio SET_PULL_UP) - never pull it up to 12 V. Two pulses a turn.
    * Active buzzer (BUZZERACTIVETEP, BZ1) on +5V, switched on its low side by a BC547B transistor (BC547BTEP, Q1)
      whose base takes GPIO27 through 1k (R4). R3 (1k) across the buzzer keeps the collector at 5 V while the buzzer
      is silent (an active buzzer draws almost nothing below its 2 V start).
    * Green LED on GPIO24 (all clear), red LED on GPIO22 (alarm), each through 220 ohm (R5 / R6).
    * RASPBERRY PI 5 (PI1) runs gas_fire_alarm.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 program waits 20 s for the MQ-2's heater, calibrates it in clean air (R0 = Rs / 9.83), gives a 0.5 s self-test
  beep, then turns its output
  into ppm with the MQ-2's LPG curve (ppm = 574.25 x (Rs / R0) ^ -2.222). The states:
    ALL CLEAR    green LED, the fan slow
    GAS WARNING  500 ppm or more: the red LED blinks, the fan at full speed
    GAS ALARM    2000 ppm or more (about 10 % of LPG's lower explosive limit): the buzzer beeps, red LED, fan full
    FIRE         a flame: the buzzer sounds without a break, red LED, the fan slowed (air feeds a fire)
  and it reports the fan STOPPED when the tach gives no pulses for 3 s. Its pages:
    /            the dashboard: the state, the gas, the flame, the fan and the events (newest first)
    /silence     silence the buzzer for 60 s (the alarm stays on the page and the red LED)
    /purge       the fan at full speed by hand, on / off
    /test        a 3 s test of the buzzer, the red LED and the fan
    /data        everything as JSON

TEST STATUS
  Tested in Proteus 8 Professional on Windows 11, the run that made the tutorial's screenshots:
    * The ADS1115 found at 0x48 (config register 0x8583); eth0 and the server up within 2 s of simulation. The MQ-2's
      output fell from 1.12 V (5 s) to 0.45 V (20 s) while it warmed up; at 21.8 s it was calibrated in clean air:
      Rs 10.16 kohm, R0 1.03 kohm. The 0.5 s self-test beep, then ALL CLEAR: 4 ppm, the fan at 300 rpm.
    * LPG at 1000 ppm (MQ-2 pop-up): GAS WARNING at 34.3 s (535 ppm), 930 ppm at 40 s; the fan from 300 to 1470 rpm.
    * 5000 ppm: GAS ALARM at 43.8 s (2164 ppm), 4630 ppm at 50 s (MQ-2 3.56 V); the buzzer beeping, the red LED on.
    * SILENCE from the phone at 49.6 s: the buzzer quiet for 60 s, the page still "GAS ALARM (buzzer silenced)".
    * Clean air: GAS WARNING at 59.5 s (1998 ppm), ALL CLEAR at 73.5 s.
    * A candle (flame pop-up): FIRE at 78.5 s (IR 70 %); the buzzer steady, the fan slowed to 390 rpm. No flame: ALL
      CLEAR at 85.3 s.
    * The fan blocked (fan pop-up): FAN STOPPED at 93.0 s (0 rpm, no tach pulses); free again: turning at 99.0 s.
  102 s of simulation took about 9 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, MQ2ADVTEP or PCFAN4PINTEP to check that
     the parts are there.

RUN THE SIMULATION
  1. Open "Proteus Simulation\Pi-5-Gas-Leak-Fire-Alarm.pdsprj". Keep gas_fire_alarm.py and the DLL files beside it.
  2. Press Play. The Pi's terminal runs gas_fire_alarm.py; the green LED blinks while the MQ-2 warms up (20 s), then
     stays on: ALL CLEAR.
  3. Open the Laptop WiFi Monitor (PC1) or the Mobile WiFi Monitor (MOB1) and press Go.
  4. Click the MQ-2 for its pop-up: LPG (with the leak at 1000) gives a GAS WARNING, 5000 a GAS ALARM; Clean air
     clears it. In the flame sensor's pop-up, Candle gives FIRE and None puts it out.
  5. On the page: SILENCE quiets the buzzer for 60 s, PURGE FAN runs the fan at full speed, TEST checks the outputs.
     In the fan's pop-up, Blocked stops the fan: the page says STOPPED. Press Refresh to update the page.

PROPERTIES USED IN THIS PROJECT
  PI1 RASPBERRY PI 5   PROGRAM=gas_fire_alarm.py, ETHERNET=IN (192.168.1.51)
  U1 MQ2ADVTEP         GAS=CLEAN, PPM=1000, WARMUP=REAL, WARMUPTIME=20 (s)
  U3 FLAMEADVTEP       SOURCE=NONE, DISTANCE=30 (cm)
  U2, FAN1, BZ1, Q1    (no changes)
  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.
  * "ADS1115 at 0x48" does not appear or the program stops at the start: the ADS1115's SDA / SCL are swapped, or ADDR
    is not on ground.
  * The gas reads high right after Play: that is the MQ-2's heater warming up; the program waits 20 s before it
    calibrates. Calibrate in clean air: gas at the calibration makes every reading too low.
  * The fan's rpm stays 0: TACH has no pull-up (the program asks for the Pi's), or the fan has no 12 V (its pop-up
    says NO 12 V).
  * The flame alarm trips in sunlight: sunlight is full of infrared; raise FLAME_ON in the program.

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; MQ-2 and ADS1115 are names of their owners. This project is not made or endorsed by them.
  * A simulation is not a safety device: a real gas or fire alarm must be a certified product.

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