Skip to content

Latest commit

 

History

History
85 lines (68 loc) · 4.67 KB

README.md

File metadata and controls

85 lines (68 loc) · 4.67 KB

RFID_System

RFID based access control and monitoring system for Maker Nexus.

This repository contains hardware, software and test information related to the development of an access control system for Maker Nexus.

This is the production version for Maker Nexus. It was copied from https://github.com/TeamPracticalProjects/MN_ACL

This repository has been updated to support the change in CRM system from EZ Facility to Amilia SmartRec.
The overview document is supplemented with an addendum that describes the changes that have been made to this repository to support Amilia as the new Maker Nexus CRM system. See the document "RFID_Amilia_Addendum_to_Overview_Document" in the Documents folder.

This repository has also been updated to support MOD check-in, status display, and management. The overview document is supplemented with an addendum that describes the new MOD support functionality that has been added to this repository. See the document "RFID_MOD_Addendum_to_Overview_Document" in the Documents folder.

Each member is issued an RFID card that has been prepared to identify the member and to ensure that cards can be revoked and/or replaced. Membership information relevant to card issuance and to member check-in and permission to access certain equipment is supplied via real-time query of the Maker Nexus CRM system which uses Amilia SmartRec. The code to access Amilia via their REST API has been broken out into separate functions so that it can be replaced by any suitable database. Administrative utilities are also provided to facilitate recycling membership RFID cards and identifying the owner of misplaced RFID cards.

A "Facility Database", separate from Amilia, is included in this project. Amilia is the authoritative source for all membership status, payment and training information needed for access control decisions. The Facility Database provides membership access records for both a real-time status display and for off-line reporting on facility and equipment utilization.

This project uses a Particle Argon. The new Particle Photon 2 should be a plug-in replacement for the Argon, but has not been tested at this time.

The access control system is based upon Mifare Classic 1K (EV1) RFID cards that are written to/read from using a PN532-based MFC/RFID breakout board. The Adafruit PN532 library is used to supply the underlying communication support between the Particle device and the RFID card. Mifare Classic 1K cards have been chosen because they are inexpensive and widely available on the Internet. These cards are older technology and offer a moderate level of security. We have deemed them to be secure enough for this application. One sector of the card is chosen for this application and the sector encryption keys and block access control bits are changed to make the card data secure from casual inspection and from cloning. The remaining sectors of the card can be used for other applications, e.g. vending machine credits or special room access.

A detailed technical overview of this project is provided in Documents/RFID_ACS_Overview_Document.pdf.
This document has been amended with two addemdum documents, as indicated above. We strongly encourage you to read through these documents before deciding how this project might be applied to your unique access control and monitoring situation.

Files and Folders:

README.md:

This document.

Repository_Overview.pdf:

An overview of the structure and contents of this repository.

Terms_Of_Use_License_and_Disclaimer.pdf:

You MUST READ this document and AGREE TO its terms and conditions before you are authorized to use the material in this repository. This project is released under and open source, non-commercial license.

Documents (folder):

Project documentation, including the RFID_ACS_Overview_Document, Addendum documents, and build, install and usage documents.

Hardware (folder):

Design information (CAD files) and documentation for all of the hardware used in this project, including electronic design, printed circuit board design, and mechanical/packaging design and build information.

Software (folder):

Design information, documentation, source and executable code for all of the software in this project, including Particle (Argon) software, webhooks, PHP files, database schema and stored procedures, Android app source and executable files, and web/html files.

Test and Development (folder):

Legacy test code and test results for integrating RFID cards and EZ Facility API calls with Particle devices. The information in this folder is not necessary to build or install this project. However, it may be useful for developing extentions to the RFID capabilities of this project.