|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| cmake/ | H | 03-May-2022 | - | 1,346 | 1,147 |
| contrib/ | H | 03-May-2022 | - | 4,873 | 3,934 |
| examples/ | H | 03-May-2022 | - | 5,412 | 4,019 |
| include/ | H | 03-May-2022 | - | 1,731 | 1,193 |
| libnfc/ | H | 03-May-2022 | - | 17,865 | 12,456 |
| m4/ | H | 24-Feb-2014 | - | 8,940 | 8,049 |
| test/ | H | 03-May-2022 | - | 1,626 | 1,310 |
| utils/ | H | 03-May-2022 | - | 5,371 | 3,947 |
| AUTHORS | H A D | 24-Feb-2014 | 900 | 24 | 23 |
| COPYING | H A D | 24-Feb-2014 | 7.5 KiB | 166 | 128 |
| ChangeLog | H A D | 24-Feb-2014 | 34.7 KiB | 725 | 601 |
| Doxyfile | H A D | 24-Feb-2014 | 62.7 KiB | 1,535 | 1,103 |
| Doxyfile.in | H A D | 24-Feb-2014 | 62.9 KiB | 1,535 | 1,103 |
| INSTALL | H A D | 02-Apr-2012 | 15.4 KiB | 371 | 288 |
| Makefile.am | H A D | 24-Feb-2014 | 1.5 KiB | 52 | 39 |
| Makefile.in | H A D | 03-May-2022 | 27.7 KiB | 870 | 771 |
| NEWS | H A D | 24-Feb-2014 | 14.9 KiB | 374 | 306 |
| README | H A D | 24-Feb-2014 | 5 KiB | 167 | 119 |
| aclocal.m4 | H A D | 24-Feb-2014 | 49.8 KiB | 1,476 | 1,331 |
| ar-lib | H A D | 02-Apr-2012 | 5.5 KiB | 266 | 205 |
| config.guess | H A D | 30-Mar-2012 | 43.8 KiB | 1,531 | 1,321 |
| config.h.in | H A D | 24-Feb-2014 | 5.4 KiB | 198 | 136 |
| config.sub | H A D | 30-Mar-2012 | 34.6 KiB | 1,774 | 1,631 |
| configure | H A D | 24-Feb-2014 | 480.2 KiB | 16,517 | 13,867 |
| configure.ac | H A D | 24-Feb-2014 | 5.7 KiB | 204 | 162 |
| depcomp | H A D | 02-Apr-2012 | 19.9 KiB | 689 | 448 |
| install-sh | H A D | 02-Apr-2012 | 13.7 KiB | 528 | 351 |
| libnfc.conf.sample | H A D | 24-Feb-2014 | 958 | 21 | 17 |
| libnfc.pc.in | H A D | 24-Feb-2014 | 247 | 12 | 10 |
| ltmain.sh | H A D | 12-Nov-2011 | 277 KiB | 9,662 | 7,310 |
| missing | H A D | 02-Apr-2012 | 10.1 KiB | 332 | 243 |
README
1*-
2* Free/Libre Near Field Communication (NFC) library
3*
4* Libnfc historical contributors:
5* Copyright (C) 2009 Roel Verdult
6* Copyright (C) 2009-2013 Romuald Conty
7* Copyright (C) 2010-2012 Romain Tartière
8* Copyright (C) 2010-2013 Philippe Teuwen
9* Copyright (C) 2012-2013 Ludovic Rousseau
10* Additional contributors:
11* See AUTHORS file
12-*
13
14General Information
15===================
16
17libnfc is a library which allows userspace application access to NFC devices.
18
19The official web site is:
20 http://www.nfc-tools.org/
21
22The official forum site is:
23 http://www.libnfc.org/community/
24
25The official development site is:
26 http://libnfc.googlecode.com/
27
28Important note: this file covers POSIX systems, for Windows please read README-Windows.txt
29
30Requirements
31============
32
33Some NFC drivers depend on third party software:
34
35* pn53x_usb & acr122_usb:
36
37 - libusb-0.1 http://libusb.sf.net
38
39* acr122_pcsc:
40
41 - pcsc-lite http://pcsclite.alioth.debian.org/
42
43The regression test suite depends on the cutter framework:
44http://cutter.sf.net
45
46Installation
47============
48
49See the file 'INSTALL' for configure, build and install details.
50
51Additionnally, you may need to grant permissions to your user to drive your device.
52Under GNU/Linux systems, if you use udev, you could use the provided udev rules.
53 e.g. under Debian, Ubuntu, etc.
54 sudo cp contrib/udev/42-pn53x.rules /lib/udev/rules.d/
55
56Under FreeBSD, if you use devd, there is also a rules file: contrib/devd/pn53x.conf.
57
58How to report bugs
59==================
60
61To report a bug, visit http://code.google.com/p/libnfc/issues/list and fill
62out a bug report form.
63
64If you have questions, remarks, we encourage you to post this in the developers
65community:
66http://www.libnfc.org/community
67
68Please make sure to include:
69
70* The version of libnfc
71
72* Information about your system. For instance:
73
74 - What operating system and version
75 - For Linux, what version of the C library
76
77 And anything else you think is relevant.
78
79* A trace with debug activated.
80
81 Reproduce the bug with debug, e.g. if it was:
82 $ nfc-list -v
83 run it as:
84 $ LIBNFC_LOG_LEVEL=3 nfc-list -v
85
86* How to reproduce the bug.
87
88 Please include a short test program that exhibits the behavior.
89 As a last resort, you can also provide a pointer to a larger piece
90 of software that can be downloaded.
91
92* If the bug was a crash, the exact text that was printed out
93 when the crash occured.
94
95* Further information such as stack traces may be useful, but
96 is not necessary.
97
98Patches
99=======
100
101Patches can be posted to http://code.google.com/p/libnfc/issues/list or
102can be sent directly to libnfc's developers:
103http://nfc-tools.org/index.php?title=Contact
104
105If the patch fixes a bug, it is usually a good idea to include
106all the information described in "How to Report Bugs".
107
108Building
109========
110
111It should be as simple as running these two commands:
112
113./configure
114make
115
116Troubleshooting
117===============
118
119Touchatag/ACR122:
120-----------------
121If your Touchatag or ACR122 device fails being detected by libnfc, make sure
122that PCSC-lite daemon (pcscd) is installed and is running.
123
124If your Touchatag or ACR122 device fails being detected by PCSC-lite daemon
125(pcsc_scan doesn't see anything) then try removing the bogus firmware detection
126of libccid: edit libccid_Info.plist configuration file (usually
127/etc/libccid_Info.plist) and locate "<key>ifdDriverOptions</key>", turn
128"<string>0x0000</string>" value into 0x0004 to allow bogus devices and restart
129pcscd daemon.
130
131ACR122:
132-------
133Using an ACR122 device with libnfc and without tag (e.g. to use NFCIP modes or
134card emulation) needs yet another PCSC-lite tweak: You need to allow usage of
135CCID Exchange command. To do this, edit libccid_Info.plist configuration file
136(usually /etc/libccid_Info.plist) and locate "<key>ifdDriverOptions</key>",
137turn "<string>0x0000</string>" value into 0x0001 to allow CCID exchange or
1380x0005 to allow CCID exchange and bogus devices (cf previous remark) and
139restart pcscd daemon.
140
141Warning: if you use ACS CCID drivers (acsccid), configuration file is located
142in something like: /usr/lib/pcsc/drivers/ifd-acsccid.bundle/Contents/Info.plist
143
144SCL3711:
145--------
146Libnfc cannot be used concurrently with the PCSC proprietary driver of SCL3711.
147Two possible solutions:
148* Either you don't install SCL3711 driver at all
149* Or you stop the PCSC daemon when you want to use libnfc-based tools
150
151PN533 USB device on Linux >= 3.1:
152---------------------------------
153Since Linux kernel version 3.1, two kernel-modules must not be loaded in order
154to use libnfc : "nfc" and "pn533".
155To prevent kernel from loading automatically these modules, you can blacklist
156them in a modprobe conf file. This file is provided within libnfc archive:
157 sudo cp contrib/linux/blacklist-libnfc.conf /etc/modprobe.d/blacklist-libnfc.conf
158
159Proprietary Notes
160=================
161
162FeliCa is s registered trademark of the Sony Corporation.
163MIFARE is a trademark of NXP Semiconductors.
164Jewel Topaz is a trademark of Innovision Research & Technology.
165All other trademarks are the property of their respective owners.
166
167