83 lines
4.1 KiB
Markdown
83 lines
4.1 KiB
Markdown
# NFC University Gate Access System 🎓🚗
|
|
|
|
System kontroli dostępu do bramy lub drzwi na uczelni, wykorzystujący **Elektroniczną Legitymację Studencką (ELS)** oraz komunikację online z bazą danych MySQL.
|
|
|
|
## 📝 Opis projektu
|
|
Projekt umożliwia autoryzację wjazdu na teren uczelni za pomocą standardowych legitymacji studenckich (standard NFC/RFID 13.56MHz). System nie przechowuje listy uprawnionych osób lokalnie na urządzeniu, lecz każdorazowo odpytuje serwer bazy danych, co pozwala na natychmiastowe nadawanie lub odbieranie uprawnień.
|
|
|
|
## ✨ Funkcje systemu
|
|
|
|
* **Autoryzacja Online:** Weryfikacja kart ELS w czasie rzeczywistym poprzez API PHP i bazę danych MySQL.
|
|
* **Tryb Hybrydowy (Offline Cache):** System zapamiętuje 10 ostatnio autoryzowanych kart w pamięci nieulotnej (NVS). Brama otworzy się nawet w przypadku awarii sieci WiFi lub serwera.
|
|
* **Zarządzanie Czasowe:** Możliwość blokowania dostępu po wygaśnięciu ważności legitymacji bezpośrednio w bazie danych.
|
|
* **Bezpieczeństwo (API Key):** Każde zapytanie z ESP32 do serwera jest autoryzowane unikalnym kluczem, co zapobiega nieautoryzowanym próbom otwarcia bramy.
|
|
* **Zapis Logów:** Serwer automatycznie rejestruje datę i godzinę każdego użycia karty (pole `last_entry` w bazie).
|
|
* **Niskie Opóźnienie:** Dzięki optymalizacji kodu, czas od zbliżenia karty do reakcji przekaźnika wynosi zazwyczaj poniżej 500ms.
|
|
|
|
|
|
## 🏗 Architektura systemu
|
|
1. **ESP32**: Odczytuje unikalny numer (UID) karty zbliżeniowej.
|
|
2. **API (PHP)**: Skrypt pośredniczący, który odbiera UID od ESP32 i komunikuje się z bazą danych.
|
|
3. **Baza Danych (MySQL)**: Przechowuje informacje o studentach, ich numerach UID oraz ważności uprawnień.
|
|
4. **Przekaźnik**: Fizycznie zwiera styki w sterowniku bramy po otrzymaniu pozytywnej weryfikacji.
|
|
|
|
## 🛠 Wymagania sprzętowe
|
|
- **Mikrokontroler**: ESP32 (lub ESP8266 z poprawkami w kodzie).
|
|
- **Czytnik NFC**: MFRC522 (RC522) lub PN532.
|
|
- **Moduł przekaźnika**: 1-kanałowy (Low/High level trigger).
|
|
- **Zasilanie**: 5V/12V (zależnie od sterownika bramy).
|
|
- **Pozostałe**: Diody LED (status), rezystory, przewody połączeniowe.
|
|
|
|
## 💻 Struktura bazy danych
|
|
Wykonaj poniższe zapytanie SQL, aby przygotować bazę danych:
|
|
|
|
```sql
|
|
CREATE TABLE students (
|
|
id INT AUTO_INCREMENT PRIMARY KEY,
|
|
card_uid VARCHAR(20) UNIQUE NOT NULL,
|
|
full_name VARCHAR(100),
|
|
student_id_number VARCHAR(15),
|
|
is_active BOOLEAN DEFAULT 1,
|
|
expiry_date DATE,
|
|
last_entry TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
|
);
|
|
```
|
|
## 🚀 Instalacja i Konfiguracja
|
|
1. Serwer (Backend)
|
|
Skopiuj pliki z folderu /server na swój hosting/serwer.
|
|
Skonfiguruj połączenie z bazą danych w pliku db_config.php.
|
|
Dodaj testowy rekord (UID swojej legitymacji) do tabeli students.
|
|
2. Urządzenie (Firmware)
|
|
Otwórz projekt w Arduino IDE lub PlatformIO.
|
|
Zainstaluj biblioteki: MFRC522 oraz HTTPClient.
|
|
W pliku głównym uzupełnij dane:
|
|
SSID i Password Twojej sieci WiFi.
|
|
API_URL (adres do Twojego skryptu PHP).
|
|
Wgraj program na ESP32.
|
|
|
|
## 🔌 Schemat połączeń (Pinout)
|
|
|
|
Poniższa tabela przedstawia połączenie czytnika RFID-RC522 z mikrokontrolerem ESP32:
|
|
|
|
| Moduł RC522 | ESP32 (GPIO) | Opis |
|
|
|:---:|:---:|:---|
|
|
| **VCC** | 3.3V | Zasilanie (UWAGA: Nie podłączać pod 5V!) |
|
|
| **RST** | GPIO 22 | Reset |
|
|
| **GND** | GND | Masa |
|
|
| **MISO** | GPIO 19 | Master In Slave Out (SPI) |
|
|
| **MOSI** | GPIO 23 | Master Out Slave In (SPI) |
|
|
| **SCK** | GPIO 18 | Serial Clock (SPI) |
|
|
| **SDA (SS)**| GPIO 5 | Chip Select (SPI) |
|
|
|
|
**Elementy dodatkowe:**
|
|
* **Przekaźnik (Relay):** Sygnał sterujący podłączony do **GPIO 2**.
|
|
* **Dioda LED (Opcjonalnie):** GPIO 4 (sygnalizacja otwarcia).
|
|
|
|
|
|
## 🔒 Bezpieczeństwo
|
|
HTTPS: Zaleca się hostowanie skryptu API na serwerze z certyfikatem SSL.
|
|
API KEY: Warto dodać nagłówek autoryzacji w zapytaniach HTTP, aby uniemożliwić ręczne wywoływanie skryptu z przeglądarki.
|
|
Fail-safe: System w przypadku braku połączenia z siecią pozostaje w trybie zamkniętym.
|
|
|
|
## 📄 Licencja
|
|
Projekt udostępniony na licencji MIT. Możesz go dowolnie modyfikować na potrzeby własnych projektów edukacyjnych. |