.gitignore | ||
brmdoor_adduser.py | ||
brmdoor_authenticator.py | ||
brmdoor_nfc.config.sample | ||
brmdoor_nfc.cpp | ||
brmdoor_nfc.h | ||
brmdoor_nfc.i | ||
brmdoor_nfc_daemon.py | ||
create_authenticator_db.py | ||
Doxyfile | ||
Makefile | ||
README.md | ||
test_nfc.py | ||
test_uids_db.sqlite | ||
unlocker.py |
Brmdoor via libnfc
This is an access-control system implementation via contactless ISO 14443A cards and a PN53x-based reader. So you basically swipe your card, and if it's in database, the door unlocks.
It's primarily intended for Raspberry Pi, but can work for other plaforms that can work with libnfc (including common x86 systems).
Aims
People have made few implementations that kind of work 1, 2, but are messy - either due to limitations of hardware or plagued by having to simulate backward compatbility errors.
So we need and have:
- clean, documented C++ code and swig wrapper interfacing libnfc directly
- clean, documented Python code
- documentation (doxygen)
- sqlite support - no need to recompile for access control list change, just edit the sqlite database
- extensibility
Building
You need just to run make
. Additional dependencies:
- SWIG
- WiringPi2 pythonic binding (for switching lock on Raspberry)
Howto
-
Create the database
python create_authenticator_db.py authenthicator_db.sqlite
-
Copy sample config file, edit your pins, DB file location, timeouts
cp brmdoor_nfc.config.sample brmdoor.config
-
Add some users
-
either authenthication by UID, e.g.:
brmdoor_adduser.py -c brmdoor.config -a uid 34795FCC SomeUserName
-
authenthication by Yubikey's HMAC-SHA1 programmed on slot 2
brmdoor_adduser.py -c brmdoor.config -a hmac 40795FCCAB0701 SomeUserName 000102030405060708090a0b0c0d0e0f31323334
Finally, run the daemon:
python brmdoor_nfc_daemon.py brmdoor.config