$Header: /users/asspro/ihm/cvsroot/rfid/README,v 1.1.1.1 2003/03/13 10:47:02 loic Exp $

What is it ?
------------

The rfid library is a set of C functions to dialog with RFID devices.
RFID transponders are typically found in books. This is the small flat
thing the cashier clears or removes and that will ring bells if you
walk thru the doors without paying the bill. The doors are equiped
with RFID readers whose antenna will read RFID transponders.  The rfid
library is designed and tested to work with the Series 6000- HF-I RFID
Evaluation Kit.

How to test it ?
----------------

The rfid_commander(1) command lets you record a command line (such as
"xmms myfavoritesong.ogg") on a RFID transponder and will run it when
the tag is read by the RFID reader. Here is a simple example:

$ rfid_commander --add echo my message
$ rfid_commander --count 1 --run
my message

If something goes wrong, adding --verbose will help figuring out
the problem if the error messages are not self explanatory.

How to install it ?
-------------------

./configure

make all

make check

make install

Where is the documentation ?
----------------------------

rfid library documentation
    man rfid_commander
    man rfid
    man s6350

Generic RFDI documentation
    http://www.rfidwizards.com/

Series 6000- HF-I RFID Evaluation Kit (RI-K10-001A) product
    http://www.ti.com/tiris/docs/products/evalKits/RI-K10-001A-00.shtml

HF Reader System Series 6000 (S6350 Midrange Reader Module)
    http://www.ti.com/tiris/docs/manuals/refmanuals/RI-STU-TRDCrefGuide.pdf

How to link with rfid ?
-------------------------

Assuming you've installed rfid in the /usr/local directory use something 
similar to the following:

In the sources:
...
#include <rfid.h>
...

On the command line:

cc -I/usr/local/include/rfid -o prog prog.cc -L/usr/local/lib -lrfid

Where can I download it ?
-------------------------
The main distribution site is http://www.lri.fr/~dachary/rfid/

What is the license ?
---------------------
rfid is distributed under the GNU GPL, as found at 
http://www.gnu.org/licenses/gpl.txt. 

Copyright holder: _INRIA_
Author: Loic Dachary loic@gnu.org
