Notes on my experiences playing with RFID smartcards and RFIDIOt on OSX (10.8, 10.9)
RFIDIOt
I’m using an OMNIKEY 5321 USB, now made by HID. I have a couple of RFID cards to play with including an old Javacard bought from Adam Laurie.
OS-X supplies a bunch of PC/SC infrastructure to get going – however I’d strongly recommend downloading the driver from HID: http://www.hidglobal.com/drivers/20384.
There are READMEs displayed in the installer – they are surprisingly detailed about what the installer actually installs. Read them.
Once the driver is installed, you can test that everything is working – so plug in the reader. The pcsc daemon should run automatically; check by typing:
|
1 |
ps ax |grep pcscd |grep -v grep |
So now you can run a test: place a card on the reader and run:
|
1 |
pcsctest |
You should see something like this:
|
1 2 3 4 5 6 7 8 9 |
MUSCLE PC/SC Lite Test Program Testing SCardEstablishContext : Command successful. Testing SCardGetStatusChange Please insert a working reader : Command successful. Testing SCardListReaders : Command successful. Reader 01: OMNIKEY CardMan 5x21 00 00 Reader 02: OMNIKEY CardMan 5x21 00 01 Enter the reader number : |
The 5321 has two readers, a regular smartcard reader and a contactless reader. From what I can tell, “Reader 01” is for regular smartcards and “Reader 02” is RFID. If you only see the entry for regular contact cards, you are probably suffering from this issue – to fix this all you need to do is install the drivers from Omnikey. The installer patches the installed card driver bundle so that it will use the correct driver.
So type “2”. You should see details about the card like:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
Waiting for card insertion : Command successful. Testing SCardConnect : Command successful. Testing SCardStatus : Command successful. Current Reader Name : OMNIKEY CardMan 5x21 00 01 Current Reader State : 0x34 Current Reader Protocol : 0x1 Current Reader ATR Size : 20 (0x14) Current Reader ATR Value : 3B XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX Testing SCardDisconnect : Command successful. Testing SCardReleaseContext : Command successful. Testing SCardEstablishContext : Command successful. Testing SCardGetStatusChange Please insert a working reader : Command successful. Testing SCardListReaders : Command successful. Reader 01: OMNIKEY CardMan 5x21 00 00 Reader 02: OMNIKEY CardMan 5x21 00 01 |
Congratulations – you have a working reader!
Install RFIDIOt from http://rfidiot.org/documentation.html. Read the documentation carefully.
I needed to install pyscard. The installer installed the libraries against Python 2.6 and on my machine the default python version is 2.7. Consequently, every time I tried to run any RFIDIOt tool I got the dreaded “*** Warning – no pyscard installed or pcscd not running”. Copying the modules into /Library/Python/2.7/site-packages from /Library/Python/2.6/site-packages did the trick.
I also needed to install PIL (actually Pillow) and pyasn1. These were simply a case of running:
|
1 2 |
sudo easy_install pyasn1 sudo pip install Pillow |
gpshell and GlobalPlatform
gpshell is a tool for interacting with smart cards using globalplatform. First you need the globalplatform library. I managed to get it to compile with:
|
1 2 3 |
./configure PCSCLITE_CFLAGS=-I/Applications/Xcode45-DP1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.8.sdk/System/Library/Frameworks/PCSC.framework/Versions/A/Headers/ --prefix=/opt/local/ make sudo make install |
The /opt/local prefix is because I wanted it to nestle in with my MacPorts stuff. Next I built gppcscconnectionplugin using:
|
1 2 3 |
./configure PCSCLITE_CFLAGS=-I/Applications/Xcode45-DP1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.8.sdk/System/Library/Frameworks/PCSC.framework/Versions/A/Headers/ --prefix=/opt/local/ GLOBALPLATFORM_CFLAGS=-I/opt/local/include/globalplatform make sudo make install |
And then gpshell would build with:
|
1 2 3 |
./configure PCSCLITE_CFLAGS=-I/Applications/Xcode45-DP1.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.8.sdk/System/Library/Frameworks/PCSC.framework/Versions/A/Headers/ --prefix=/opt/local/ GLOBALPLATFORM_CFLAGS=-I/opt/local/include/globalplatform make sudo make install |
Feedback welcome