Trespass Warning and Access Threat System (TWATS)

A motion-detection security alarm system built for ESP8266/ESP32 microcontrollers. This system detects motion, provides audible warnings, and sends push notifications when suspicious activity is detected.

Features

Motion detection with PIR sensor
Escalating alert levels (warning tone, extended warning, full alarm)
Push notifications via Pushover service
Web interface for remote control
Arming/disarming functionality
Configurable alarm durations

Hardware Requirements

ESP8266 or ESP32 development board
PIR motion sensor
Piezo buzzer
Breadboard and jumper wires
Micro USB cable for power and programming

Wiring

PIR Sensor: Connect to pin D7
Piezo Buzzer: Connect to pin D2
Both sensors need to be connected to VCC (3.3V) and GND

Software Setup

Prerequisites

Arduino IDE installed
ESP8266 board support installed in Arduino IDE
Required libraries:
- ESP8266WiFi (or ESP32WiFi if using ESP32)
- ESP8266WebServer (or WebServer if using ESP32)
- ESP8266HTTPClient (or HTTPClient if using ESP32)

Installation

Clone or download this repository
Create a secrets.h file in the src folder (see below)
Open the Alarm.ino file in Arduino IDE
Select the correct board and port
Upload the sketch to your ESP8266/ESP32

Setting Up secrets.h

You need to create a secrets.h file containing your WiFi credentials and Pushover API keys. This file is not included in the repository for security reasons.

Create a new file named secrets.h in the src folder with the following content:

#ifndef SECRETS_H
#define SECRETS_H

#define WIFI_SSID "YourWiFiName"
#define WIFI_PASSWORD "YourWiFiPassword"
#define PUSHOVER_USER_KEY "YourPushoverUserKey"
#define PUSHOVER_API_TOKEN "YourPushoverAPIToken"

#endif

Replace the placeholder values with your actual credentials:

YourWiFiName: Your WiFi network name
YourWiFiPassword: Your WiFi password
YourPushoverUserKey: Your Pushover user key (obtained from Pushover account)
YourPushoverAPIToken: Your Pushover API token (create an application at Pushover)

Pushover Setup

Create an account at Pushover
After logging in, you'll find your User Key in the dashboard
Create a new application to get an API token
Add these values to your secrets.h file

Usage

Power on the device
Connect to the device's web interface using its IP address (shown in Serial Monitor during startup)
Use the web interface to:
- Arm/disarm the system
- Trigger a full alarm manually
- Check system status and motion detection count

When armed, the system will:

Sound a short warning tone when motion is first detected
Trigger an extended warning if multiple motions are detected in a short period
Send push notifications for significant events

Troubleshooting

If notifications aren't working, verify your Pushover credentials and internet connection
If the motion sensor is too sensitive, try adjusting the sensor's sensitivity knob or the detection thresholds in the code
Check the Serial Monitor (9600 baud) for debugging information

License

This project is available for hackerspace members and contributors.

Security Note

The secrets.h file contains sensitive information. Never commit this file to public repositories or share it in public forums.

RootAccessHackerspace/security-twats

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages