Adds nfc-emulate-forum-tag2 man page
This commit is contained in:
parent
310d7eba07
commit
6e7fdb1c80
2 changed files with 65 additions and 11 deletions
52
examples/nfc-emulate-forum-tag2.1
Normal file
52
examples/nfc-emulate-forum-tag2.1
Normal file
|
@ -0,0 +1,52 @@
|
||||||
|
.Dd September 19, 2012
|
||||||
|
.Dt NFC-EMULATE-FORUM-TAG2 1 URM
|
||||||
|
.Sh NAME
|
||||||
|
.Nm nfc-emulate-forum-tag2
|
||||||
|
.Nd NFC Forum tag type 2 emulation command line demonstration tool
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.Nm
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
.Nm
|
||||||
|
is a demonstration tool that emulates a NFC-Forum Tag Type 2 with NDEF content.
|
||||||
|
.Pp
|
||||||
|
Some devices compliant with NFC-Forum Tag Type 2 can be used with this example,
|
||||||
|
in read mode only.
|
||||||
|
.Sh IMPORTANT
|
||||||
|
This example has been developed using PN533 USB hardware as target and Google
|
||||||
|
Nexus S phone as initiator.
|
||||||
|
.Pp
|
||||||
|
This is know to NOT work with Nokia 6212 Classic and could fail with several
|
||||||
|
NFC Forum compliant devices due to the following reasons:
|
||||||
|
.Pp
|
||||||
|
- The emulated target has only a 4-byte UID while most devices assume a
|
||||||
|
Tag Type 2 has always a 7-byte UID (as a real Mifare Ultralight tag);
|
||||||
|
.Pp
|
||||||
|
- The chip is emulating an ISO/IEC 14443-3 tag, without any hardware helper.
|
||||||
|
If the initiator have too strict timeouts for software-based emulation
|
||||||
|
(which is usually the case), this example will fail.
|
||||||
|
This is not a bug and we can't do anything using this hardware (PN531/PN533).
|
||||||
|
.Pp
|
||||||
|
ACR122 devices (like touchatag, etc.) can be used by this example, but if
|
||||||
|
something goes wrong, you will have to unplug/replug your device.
|
||||||
|
This is not a
|
||||||
|
.Em libnfc's
|
||||||
|
bug, this problem is due to ACR122's internal MCU in front of NFC chip (PN532).
|
||||||
|
.Sh BUGS
|
||||||
|
Please report any bugs on the
|
||||||
|
.Em libnfc
|
||||||
|
issue tracker at:
|
||||||
|
.Em http://code.google.com/p/libnfc/issues
|
||||||
|
.Sh LICENCE
|
||||||
|
.Em libnfc
|
||||||
|
is licensed under the GNU Lesser General Public License (LGPL), version 3.
|
||||||
|
.Em libnfc-utils
|
||||||
|
and
|
||||||
|
.Em libnfc-examples
|
||||||
|
are covered by the BSD 2-Clause license.
|
||||||
|
.Sh AUTHORS
|
||||||
|
.An Roel Verdult Aq roel@libnfc.org
|
||||||
|
.An Romain Tartière Aq romain@libnfc.org
|
||||||
|
.An Romuald Conty Aq romuald@libnfc.org
|
||||||
|
.Pp
|
||||||
|
This manual page was written by Romuald Conty.
|
||||||
|
It is licensed under the terms of the GNU GPL (version 2 or later).
|
|
@ -29,19 +29,21 @@
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @file nfc-emulate-forum-tag2.c
|
* @file nfc-emulate-forum-tag2.c
|
||||||
* @brief Emulates a NFC Forum Tag Type 2 with a NDEF message
|
* @brief Emulates a NFC-Forum Tag Type 2 with a NDEF message
|
||||||
* This example allow to emulate an NFC Forum Tag Type 2 that contains a read-only NDEF message.
|
* This example allow to emulate an NFC-Forum Tag Type 2 that contains
|
||||||
|
* a read-only NDEF message.
|
||||||
*
|
*
|
||||||
* It have been developed using PN533 USB hardware as target and Google Nexus S phone as initiator.
|
* This example has been developed using PN533 USB hardware as target and
|
||||||
|
* Google Nexus S phone as initiator.
|
||||||
*
|
*
|
||||||
* This is know to NOT work with Nokia 6212 Classic and could not work with
|
* This is know to NOT work with Nokia 6212 Classic and could fail with
|
||||||
* several NFC Forum compliant devices due to these reasons:
|
* several NFC Forum compliant devices due to the following reasons:
|
||||||
* - The emulated target only have a 4 bytes UID where 7 bytes UID (as a real
|
* - The emulated target has only a 4-byte UID while most devices assume a Tag
|
||||||
* Mifare Ultralight tag) are usually attempted;
|
* Type 2 has always a 7-byte UID (as a real Mifare Ultralight tag);
|
||||||
* - The chip is emulating a ISO/IEC 14443-3 tag, without any hardware helper.
|
* - The chip is emulating an ISO/IEC 14443-3 tag, without any hardware helper.
|
||||||
* If the initiator have too short timeouts for software-based emulation
|
* If the initiator has too strict timeouts for software-based emulation
|
||||||
* (which is usually the case), this example will failed, this is not a bug
|
* (which is usually the case), this example will fail. This is not a bug
|
||||||
* and we can't do anything using this kind of hardware (PN531/PN533).
|
* and we can't do anything using this hardware (PN531/PN533).
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/*
|
/*
|
||||||
|
|
Loading…
Reference in a new issue