RFID Schlusselkasten - WIP

RFID Schlüsselkasten für die Fachschaft Informatik der Uni Tübingen

Basierend auf:

• NodeMCU-esp8266 (v.2)
• RFID-RC522
• 4-Digit 7 Segment Display (TM1637)
• ULN2003APG Steppercontroller

Done

NodeMCU-esp8266

• Wifi-Anbindung
• HTTPS-GET der erlaubten Studierendenausweise über API mit Überprüfung des SSL-Zertifikats
• Auslesen der Studierendenausweise über RFID-RC522
• Erkennung Tür offen/geschlossen
• Steppersteuerung
• 4 Digit (7 Segment)-Display für Status-Codes
• Fallbacks

Server / Client

• API (PHP)
• API Dokumentation (siehe API/README.md)
• Client zum Hinzufügen / Löschen von Nutzern (Python3)

Todo

• USV (UPS) Interne Powerbank (aufgegeben auf Grund von Platzmangel)
• Speicherung der erlaubten UID auf SPIFFS / SD-Card
• regelmäßiges Fetchen der erlaubten UIDs
• Loggen von Aktionen

Setup

Server

• api.php & api_constants.php in public_html Ordner kopieren
• user.csv erstellen
• in api_constants.php Pfad und Apikey anpassen.
• ggf.: Nutzer manuell hinzufügen

  12bb4f00;MaxMuster
  bb420975;ErikaMuster
  89e370ae;JaneDoe
  

Client

• api_constants.py im Ordner client erstellen:

format for the api_constants.py file: API_URL = API_KEY = HEADER = {"Content-type": "application/x-www-form-urlencoded", "Accept": "text/plain"}

• Skript starten und Nutzer hinzufügen

NodeMCU

• ChangeMe Daten in sketch.ino anpassen und hochladen
• Hardware zusammenlöten, Verbauen, Fertig

Verkabelung

Die Verkabelung ist wie folgt:

Status-Code

Der Schlüsselkasten zeigt permanent einen Status-Code an. Diese haben folgende bedeutungen.

• 1XXX Bootup
  • 11XX Wifi
    • Connecting 11nn <1140 (nn gibt die Anzahl der Verbindungsversuche an)
  • 12XX Fetching
    • 12nn <1220 (nn gibt Anzahl der HTTPS-Verbindungsversuche an)
    • 1250 Header Erhalten
    • 1260 UIDs auslesen
• 2XXX Activ
  • 2000 Bootup fertig, warte auf erste Aktion
  • 2001 Auf Karte wartend
  • 2002 Karte gelesen
  • 2003 Warten bis Kasten geschlossen
• 3XXX Control
  • 3001 Karte erlaubt
  • 3002 Karte nicht erlaubt
  • 3003 Öffnen des Schlosses
  • 3004 Schließen des Schlosses
• 4XXX Error
  • (4000 Died in boot)
  • 4001 Died while connecting with Wifi
  • 4002 Died while fetching
  • (4003 Died in Main Loop)
• 5XXX Reboot
• Text
  • Ok Alles ok, warte auf Karte
  • OPEN Schlüsselkasten kann geöffnet werden
  • D-R Debug Rechts (30 Schritte nach rechts)
  • D-L Debug Links (30 Schritte nach links)

License

Schlüsselkasten for the Computer-Science Student Union of the Univertity of Tuebingen
Copyright (C) 2019  Jules Kreuer / not-a-feature
  
  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.
  
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See LICENSE for more details.