RFID Face Attendance System

// Diagram restored: external modules remain on the separate DevKitC; camera GPIO mapping is unchanged.
#include <Arduino.h>
#include <WiFi.h>
#include <HTTPClient.h>
#include "config.h"
#if CAMERA_NODE
#include "esp_camera.h"
#include <WebServer.h>
// Freenove ESP32S3_EYE ribbon mapping; reset and power-down are not GPIO-controlled.
WebServer web(80);
bool ready=false;
void setup(){
 Serial.begin(115200);
 camera_config_t c={};
 c.ledc_channel=LEDC_CHANNEL_0;c.ledc_timer=LEDC_TIMER_0;
 c.pin_d0=11;c.pin_d1=9;c.pin_d2=8;c.pin_d3=10;c.pin_d4=12;c.pin_d5=18;c.pin_d6=17;c.pin_d7=16;
 c.pin_xclk=15;c.pin_pclk=13;c.pin_vsync=6;c.pin_href=7;
 c.pin_sccb_sda=4;c.pin_sccb_scl=5;c.pin_pwdn=-1;c.pin_reset=-1;
 c.xclk_freq_hz=10000000;c.pixel_format=PIXFORMAT_JPEG;c.frame_size=FRAMESIZE_VGA;
 c.jpeg_quality=10;c.fb_count=1;c.fb_location=CAMERA_FB_IN_PSRAM;c.grab_mode=CAMERA_GRAB_WHEN_EMPTY;
 ready=psramFound() && esp_camera_init(&c)==ESP_OK;
 if(ready){auto s=esp_camera_sensor_get();s->set_hmirror(s,1);s->set_vflip(s,0);s->set_brightness(s,1);s->set_saturation(s,0);s->set_ae_level(s,-3);}
 else Serial.println("Camera failed: check ribbon, OV5640 support and PSRAM");
 WiFi.begin(WIFI_SSID,WIFI_PASSWORD);
 const char* headers[]={"X-Key"};web.collectHeaders(headers,1);
 web.on("/capture",HTTP_GET,[]{
  if(String(API_KEY).startsWith("CHANGE_ME") || web.header("X-Key")!=API_KEY){web.send(403);return;}
  if(!ready){web.send(503);return;}
  // Discard old buffered frame so this photograph belongs to the current request.
  auto old=esp_camera_fb_get();if(old)esp_camera_fb_return(old);
  auto f=esp_camera_fb_get();if(!f){web.send(503);return;}
  web.sendHeader("Cache-Control","no-store");web.setContentLength(f->len);web.send(200,"image/jpeg","");
  auto client=web.client();size_t sent=0;unsigned long start=millis();
  while(sent<f->len && client.connected() && millis()-start<5000){size_t n=client.write(f->buf+sent,min((size_t)1460,f->len-sent));if(!n)break;sent+=n;}
  esp_camera_fb_return(f);
 });web.begin();
}
void loop(){web.handleClient();static bool shown=false;if(WiFi.status()==WL_CONNECTED&&!shown){Serial.println(WiFi.localIP());shown=true;}delay(2);}
#else
#include <SPI.h>
#include <Wire.h>
#include <MFRC522.h>
#include <RTClib.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
// Confirmed terminal wiring: SPI 12/13/11; RC522 CS10/RST14; TFT CS15/DC16/RST17.
// GPIO15 is software-controlled chip select, not a hardware SPI signal.
MFRC522 rfid(10,14);RTC_DS3231 rtc;Adafruit_ST7735 tft(15,16,17);
bool clockOK=false,readerOK=false;String lastText;uint32_t lastScan=0;
void show(String text,int led=0){
 digitalWrite(4,led==4);digitalWrite(5,led==5);digitalWrite(6,led==6);
 if(lastText==text)return;lastText=text;tft.fillScreen(ST77XX_BLACK);tft.setCursor(0,8);tft.setTextColor(ST77XX_WHITE);tft.setTextSize(1);tft.println(text);Serial.println(text);
}
String post(const char* path,const String& body){
 if(WiFi.status()!=WL_CONNECTED)return "";
 HTTPClient http;http.begin(String(SERVER_URL)+path);http.setTimeout(12000);http.addHeader("X-Key",API_KEY);http.addHeader("Content-Type","text/plain");
 int status=http.POST(body);String result=status==200?http.getString():"";http.end();result.trim();return result;
}
void result(String text,int led){show(text,led);bool ok=led==4;digitalWrite(7,HIGH);delay(ok?120:400);digitalWrite(7,LOW);delay(2200);}
void setup(){
 Serial.begin(115200);for(int p:{4,5,6,7,10,15}){pinMode(p,OUTPUT);digitalWrite(p,(p==10||p==15)?HIGH:LOW);}
 SPI.begin(12,13,11);tft.initR(INITR_BLACKTAB);tft.setRotation(1);
 Wire.begin(8,9);clockOK=rtc.begin();
 // Keep the display deselected while starting the other device on this bus.
 digitalWrite(15,HIGH);
 for(int attempt=0;attempt<3 && !readerOK;attempt++){
  rfid.PCD_Init();delay(100);
  byte v=rfid.PCD_ReadRegister(MFRC522::VersionReg);
  Serial.printf("RC522 startup attempt %d: VersionReg=0x%02X (CS10 RST14 SCK12 MISO13 MOSI11)\n",attempt+1,v);
  readerOK=v!=0 && v!=255;
  if(!readerOK)delay(200);
 }
 WiFi.begin(WIFI_SSID,WIFI_PASSWORD);show("Connecting Wi-Fi",5);
}
void loop(){
 if(String(WIFI_SSID)=="CHANGE_ME" || String(API_KEY).startsWith("CHANGE_ME")){show("Set include/config.h\nbefore Deploy",5);delay(100);return;}
 if(WiFi.status()!=WL_CONNECTED){show("Wi-Fi disconnected\nNo attendance saved",5);delay(100);return;}
 if(!clockOK){show("RTC module missing\nCheck wiring",6);delay(200);return;}
 if(!readerOK){show("RFID reader missing\nCheck 3.3V / wiring",6);delay(200);return;}
 static uint32_t syncAt=0;
 if(clockOK && (!syncAt || millis()-syncAt>3600000UL)){
  String epoch=post("/time","");unsigned long n=strtoul(epoch.c_str(),nullptr,10);
  if(n>1700000000UL){rtc.adjust(DateTime(n));syncAt=millis();}
 }
 if(rtc.lostPower() || !syncAt){show("Time sync unavailable\nCheck server / key",5);delay(200);return;}
 show("Scan student card");
 if(millis()-lastScan<3000 || !rfid.PICC_IsNewCardPresent())return;
 if(!rfid.PICC_ReadCardSerial()){lastScan=millis();result("Card read failed\nTry again",6);return;}
 String uid;for(byte i=0;i<rfid.uid.size;i++){if(rfid.uid.uidByte[i]<16)uid+='0';uid+=String(rfid.uid.uidByte[i],HEX);}uid.toUpperCase();
 rfid.PICC_HaltA();rfid.PCD_StopCrypto1();lastScan=millis();Serial.println("Card UID: "+uid);
 show("Card read successfully\nChecking registration...",4);String session=post("/card",uid);
 if(!session.startsWith("SESSION:")){result(session=="DENIED"?"Card not registered":"Server unavailable",session=="DENIED"?6:5);return;}
 show("Card accepted\nLook at camera\nHold still...",4);delay(1800);
 String reply=post("/verify",session.substring(8)+"\n"+String(rtc.now().unixtime()));
 if(reply=="ACCEPT" || reply=="DUPLICATE")result(reply=="ACCEPT"?"Face matched\nAttendance recorded":"Face matched\nAlready recorded",4);
 else if(reply=="REJECT")result("Face not matched",6);
 else if(reply=="CAMERA_ERROR")result("Camera module error\nCheck camera / ribbon",6);
 else result("Server/connection error\nNot recorded",5);
}
#endif