With my new toy Raspberry pi I've done several testing projects from
instructables, adafruit etc. But after a while it became boring and I've started looking for something actually useful for me. My previous playground was my new phone several weeks ago which came with new feature NFC reading. Thought and thought together gave me idea for attendance system for our small (family) company using NFC tags. The additional kick was my interest in those systems before, but discovering the cheapest are for around $750 I decided it is too much for such small company as 6 employees.
As I don't have any experience with "mature" attendance systems, I've decided only to implement basic features. These consist of logging incoming people, outcoming people, start and end of a break and deleting last inserted action (in case of mistype during logging).
All these actions are logged into local MySQL database from where I can display it and manipulate with my front-end application. Because the SD card is not such safe data medium, especially when loosing power unexpectedly, I'm uploading all data daily to my local server, where I keep backup in case of corruption of the SD card.
During normal operation of the logging station, display shows current date and time and calls for action selection. When you choose appropriate action on the keyboard, display shows selected action and calls for attaching the TAG to the reader. Also the LED under display also turns on.
When the TAG is read, the LED turns off and beep signal comes out the speaker. For a brief moment display shows action and name of the owner of the card. Then everything returns to the default state waiting for another entrance.

For foot notice, this whole project including source codes is licensed under Beer-ware licence as follows:
Jakub Dvorak wrote this file. As long as you retain this notice you can do whatever you want with this stuff. If we meet some day, and you think this stuff is worth it, you can buy me a beer in return.

Step 1: Materials list

Everything you need for this project can be bought on E-Bay or in many Chinese e-shops like dealextreme etc.
For this project you'll need following items:
  1. Raspberry Pi model B
  2. 16x2 display
  3. Mifare RFID Reader
  4. USB numeric keypad
  5. LED diode holder
  6. Red LED diode
  7. Active 3V buzzer
  8. Small breadboard and various F-F and M-F jumper cables
  9. Box
  10. Various screws and/or glue gun, LED resistor, display 10k potentiometer

I recommend Raspberry Pi model B, because of the integrated LAN and two USB ports. That way you can use either LAN+USB keyboard or USB keyboard and USB WiFi dongle.

You can use any display, but I used HD44780 (the same display as found on adafruit), because it has well documented usage and uses only few pins from Raspberry.

I've chosen 13.56 MHz RFID reader and tags, because I've already got few tags with this technology from my experimenting with my cellphone. I've also found good How To (http://fuenteabierta.teubi.co/2013/07/utilizando-el-lector-nfc-rc522-en-la.html) and with a little help of Google translator modified given source to my needs.

Any numeric keypad can be used. Those with high buttons might be better due to thickness of the box. For installation just remove any extra buttons with small knife or screwdriver.

LED and LED holder are pure extra which are not needed for the device to be operational, but are good as extra indicator of actions.

The same is with the buzzer. I felt such a device should have it's own voice for letting people know it is working.

Breadboard and jumpers are for interconnection between each device because several pins (3.3V, GND,...) are used for more than one part. You can of course use soldered board, but I wanted to be able to replace each part easily and just glued it together with glue gun.

You'll also need few screws and/or glue gun for attaching all the pieces together. For LED you'll need small resistor. For my red LED I've used 68 ohm one which should limit current to around 19 mA. Depending on your LED you can calculate value for the resistor for example on this address. Maximum GPIO current is discussed on several forums but I wouldn't go over 20mA. Potentiometer is for contrast adjustment of the display.
<p>Your instructable showed me exactly what I needed to know about connecting an RFID-reader to a Raspberry Pi! I really like your instructable...</p>
<p>This Instructable is incomplete. A lot of steps are not mentioned by the author.</p>
<p>When I'm trying to install setup.py of SPI-Py folder, it shows an error as: command 'gcc' failed with exit status 1..</p><p>Help me to solve this. Please!!</p>
<p>To fix the GCC error you need to run this command first: sudo apt-get install python-dev</p>
<p>Hey! I've got a question for the wiring part of the RFID RC522. I have connected everything to the right pins (Got raspberry pi 2) but no led lights on the rc522 turn on and the chip gets hot as hell. Do you know how I can solve this? Many thanks for your help!</p>
<p>Hi.. i had connect the RPi_rev2(pins40) with RFID-RC522 module...there are a few error during run the attendance.py..the errors as the attachment ...</p>
<p>hi i love ur project it is similar to my project can u share idea wit me wasimahmed9415@gmail.com thank you</p>
<p>Hi, it seams that the beeper module is not supplied on the github page</p><p>File &quot;/home/pi/src/attendance/attendance.py&quot;, line 23, in &lt;module&gt;<br> import beeper<br>ImportError: No module named beeper</p><p>after commenting this out the only thing i get is something like this</p><p>attendance.py:178: RuntimeWarning: No channels have been set up yet - nothing to clean up! Try cleaning up at the end of your program instead!<br> GPIO.cleanup()<br>29.10.2014 06:44:43<br>29.10.2014 06:44:44<br>29.10.2014 06:44:45<br>29.10.2014 06:44:46<br>29.10.2014 06:44:47<br>29.10.2014 06:44:48<br>29.10.2014 06:44:49</p><p>But no readings, i can confirm that when i use the </p><p>MFRC522-python-master/Read.py i get readings so my connections are ok..</p><p>please help</p>
<p>The GPIO.cleanup() isn't successfully clearing the channels. I'll see what I can do.</p>
<p>Also I must mention; use the terminal command 'ps aux | grep python' and close running python processes. Compiling the script over and over can throw off your channels, you gotta kill processes before. </p>
<p>hi there, as you go through the code you see the following</p><p>if(actions==(specified action))</p><p>this actually are unprintable ascii characters and ttys, where 49 is called upon pressing 1 key on the numpad,50 on 2 ,51 on 3 and so on</p><p>so the terimnal is showing the timing's as you have stated above, you actually need to press 7 on the numpad in order to read the uid from the rfid reader which corresponds to 55 in unprintable ascii, i believe the author chose this way of accepting choices in order to run the code at boot(this is what i think may be something else, not sure). you can inbox me if need further information regarding this</p>
<p>sirion ,were you ever able to figure this out?</p>
<p>No, never had an reply to this problem... </p>
<p>So has anyone got this thing working. I looked through the Code, and there are a lot of instructions missing. An enitre module is no-where to be found...</p>
<p>Hi Everyone, i have a project at home where i can control my lights and water features etc via relays which can be controlled over the internet but i have now ordered and received a 2 in 1 RFID Reader &amp; Keypad &quot;Image Below&quot; that id like to use as a gate entry that either you can enter a certain code or use the RFID to enter which will turn off a relay, when the relay is turned off the magnetic lock will release and then after a few seconds the relay powers on again and locks.</p><p>CAN ANYBODY HELP !!!</p><p>I have a 2 in 1 RFID &amp; Keypad, the sticker that shows what the wires are but it isnt very clear and i dont know where to wire them to. (Which pins on the Rasp Pi) I understand the Red And black are to go to a 12v power supply.</p><p>Also i have seen so many people using different code, but does anyone have any that would help me at all?</p><p>The wire picture isnt that clear but it shows:</p><p>Colour:Details:</p><p>BlackGND</p><p>RedVCC +12V</p><p>WhiteD1 / TX / 4R -</p><p>YellowBUZZER</p><p>BlueLED</p><p>GreenD0 / RX / 4R +</p><p>Grey26 /34</p><p>I have a Raspberry PI Model B running raspian, i have the following pins available:</p><p>1,3,4,5,8,9,10,14,17,19,20,21,23,24,25</p><p>Look forward to hearing from you Callum</p>
<p>This is great! Exactly what I have been looking for! Thanks so much. Im going to be getting my NFC reader from hong kong soon. I got it for &pound;2.50 so its going to be fun. Thanks.</p>
<p>Did you ever get this going?</p>
<p>In the header of attendance.py there's a &quot;import beeper&quot;, but there's no standard library like this and no file is included. Can you help me? </p>
<p>Did you ever get this working? Im having the same issue. This &quot;instructable&quot; is missing a bunch of the steps... The author may as well should have never published it...... </p>
<p>how to create a mysql database and import it to Raspberry Pi?</p>
<p>Im getting ImportError: No module named MySQLdb when trying to run attendance.py. I have set up a database with mysql and i can even see it with phpmyadmin.</p>
<p>You have to install MySQLdb lib on your RPi before you can run it. :) </p>
<p>Hi, </p><p>I am having the same issue as Sirion, and also I am having import issues in &lt;module&gt; for the onScreen and NFC imports. </p><p>Just wondering if you could give any help</p>
<p>hmm.. when running attendance.py</p><p>File &quot;/home/pi/RPi.GPIO-0.5.7/attendance/MFRC522.py&quot;, line 11, in &lt;module&gt;</p><p>import spi</p><p>ImportError: No module named spi</p><p>install RPi.GPIO-0.5.7.tar.gz</p>
<p>Other skill with PNEV512R :</p><p>http://domotique-info.fr/2014/08/passerelle-domotique-nfc/</p>
<p>Quotation Required of Tags Attendance system.</p>
Good idea! I am just starting to noodle around with NFC, nice project, and thank you for sharing.

About This Instructable


128 favorites


More by Yim: Attendance system using Raspberry Pi and NFC Tag reader
Add instructable to: