README.md

NFCAttendanceLogger

Our project report, written in English, is available at: PDF Project Report.

Objective

Use NFC card reader to manage student class attendance.

Description

This was a university project. The purpose was to build a project with a Raspberry Pi. At my engineering university we used student cards to get inside the school and pay for things.

Back then attendance was taken by having students sign a piece of paper. It was easy for students to cheat the system by signing for friends which would first force the teacher to lose precious time counting all students and eventually calling every student by name.

To prevent students from cheating and time being wasted, my idea was to simply monitor student attendance by having students scan their student cards at the beginning and eventually the end of the class to indicate that they had attended.

Implementation

My friend (Thomas Zellner) and I used a Raspberry Pi 2 and a USB NFC u122c card reader to read and store the unique student key on the card.

Database

We set up a SQL database on the PI to store the necessary information. We set up four tables: ATTENDANCE, CLASS, TIMETABLE and USER. (see Fig 1.)

Fig 1. - SQL Tables

We instantiated a USER table with four users and their respective UIDs on their badges. (see Fig 2.)

Fig 2. - User Table

We created a simple TIMETABLE table. In this case, student 11 has classes: 3,4,5 and 6. (see Fig 3.)

Fig 3. - Timetable Table

We also set up some fake classes, in a CLASS table, with a name, date, start time and end time. (see Fig 4.)

Fig 4. - Classes Table

Students that attended class are logged in the ATTENDANCE table with their id and the class id they attended. (see Fig 5.)

Fig 5. - Attendance Table

Code

Our code is relatively simple and the process is straight forward.

• import libraries and stuff
• launch database
• wait for a scanned student card
• read scanned card
  • extract the UID using Regular Expressions from the scan
  • check the database
  • manage exceptions:
    • UID not in database -> add student
    • no current class
    • class hasn't started or class has already ended

Demo

Following are two screenshots of our demo.

Fig 6. - Adding a user

Fig 7. - Recording attendance

Challenges

1. The hardest challenge was simply getting the NFC card reader to work. It took a lot of trial and error, online search and grit.

2. The second challenge was extracting the UID using regular expressions.

3. Finally, we had to put in place the whole system and code to ensure that we could properly set up and run the demo. We worked on this up to the last minute.