java.lang.Object | |
↳ | android.nfc.tech.IsoDep |
Provides access to ISO-DEP (ISO 14443-4) properties and I/O operations on a
Tag
.
Acquire an
IsoDep
object using
get(Tag)
.
The primary ISO-DEP I/O operation is
transceive(byte[])
. Applications must
implement their own protocol stack on top of
transceive(byte[])
.
Tags that enumerate the
IsoDep
technology in
getTechList()
will also enumerate
NfcA
or
NfcB
(since IsoDep builds on top of either of these).
Note:
Methods that perform I/O operations
require the
NFC
permission.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
Disable I/O operations to the tag from this
TagTechnology
object, and release resources.
|
||||||||||
|
Enable I/O operations to the tag from this
TagTechnology
object.
|
||||||||||
|
Get an instance of
IsoDep
for the given tag.
|
||||||||||
|
Return the higher layer response bytes for
NfcB
tags.
|
||||||||||
|
Return the ISO-DEP historical bytes for
NfcA
tags.
|
||||||||||
|
Return the maximum number of bytes that can be sent with
transceive(byte[])
.
|
||||||||||
|
Get the
Tag
object backing this
TagTechnology
object.
|
||||||||||
|
Get the current timeout for
transceive(byte[])
in milliseconds.
|
||||||||||
|
Helper to indicate if I/O operations should be possible.
|
||||||||||
|
Standard APDUs have a 1-byte length field, allowing a maximum of 255 payload bytes, which results in a maximum APDU length of 261 bytes. |
||||||||||
|
Set the timeout of
transceive(byte[])
in milliseconds.
|
||||||||||
|
Send raw ISO-DEP data to the tag and receive the response.
|
[Expand]
Inherited Methods
|
|||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
|||||||||||
From interface
android.nfc.tech.TagTechnology
|
|||||||||||
From interface
java.io.Closeable
|
|||||||||||
From interface
java.lang.AutoCloseable
|
Disable I/O operations to the tag from this
TagTechnology
object, and release resources.
Also causes all blocked I/O operations on other thread to be canceled and
return with
IOException
.
Requires the
NFC
permission.
IOException |
---|
Enable I/O operations to the tag from this
TagTechnology
object.
May cause RF activity and may block. Must not be called
from the main application thread. A blocked call will be canceled with
IOException
by calling
close()
from another thread.
Only one
TagTechnology
object can be connected to a
Tag
at a time.
Applications must call
close()
when I/O operations are complete.
Requires the
NFC
permission.
IOException |
---|
Get an instance of
IsoDep
for the given tag.
Does not cause any RF activity and does not block.
Returns null if
IsoDep
was not enumerated in
getTechList()
.
This indicates the tag does not support ISO-DEP.
tag | an ISO-DEP compatible tag |
---|
Return the higher layer response bytes for
NfcB
tags.
Does not cause any RF activity and does not block.
The higher layer response bytes can be used to help identify a tag.
They are present only on
IsoDep
tags that are based on
NfcB
RF technology. If this tag is not
NfcB
then null is returned.
In ISO 14443-4 terminology, the higher layer bytes are a subset of the ATTRIB response.
NfcB
tag
Return the ISO-DEP historical bytes for
NfcA
tags.
Does not cause any RF activity and does not block.
The historical bytes can be used to help identify a tag. They are present
only on
IsoDep
tags that are based on
NfcA
RF technology.
If this tag is not
NfcA
then null is returned.
In ISO 14443-4 terminology, the historical bytes are a subset of the RATS response.
NfcA
tag
Return the maximum number of bytes that can be sent with
transceive(byte[])
.
transceive(byte[])
.
Get the
Tag
object backing this
TagTechnology
object.
Tag
backing this
TagTechnology
object.
Get the current timeout for
transceive(byte[])
in milliseconds.
Requires the
NFC
permission.
Standard APDUs have a 1-byte length field, allowing a maximum of 255 payload bytes, which results in a maximum APDU length of 261 bytes.
Extended length APDUs have a 3-byte length field, allowing 65535 payload bytes.
Some NFC adapters, like the one used in the Nexus S and the Galaxy Nexus do not support extended length APDUs. They are expected to be well-supported in the future though. Use this method to check for extended length APDU support.
Set the timeout of
transceive(byte[])
in milliseconds.
The timeout only applies to ISO-DEP
transceive(byte[])
, and is
reset to a default value when
close()
is called.
Setting a longer timeout may be useful when performing transactions that require a long processing time on the tag such as key generation.
Requires the
NFC
permission.
timeout | timeout value in milliseconds |
---|
Send raw ISO-DEP data to the tag and receive the response.
Applications must only send the INF payload, and not the start of frame and
end of frame indicators. Applications do not need to fragment the payload, it
will be automatically fragmented and defragmented by
transceive(byte[])
if
it exceeds FSD/FSC limits.
Use
getMaxTransceiveLength()
to retrieve the maximum number of bytes
that can be sent with
transceive(byte[])
.
This is an I/O operation and will block until complete. It must
not be called from the main application thread. A blocked call will be canceled with
IOException
if
close()
is called from another thread.
Requires the
NFC
permission.
data | command bytes to send, must not be null |
---|
if the tag leaves the field | |
IOException | if there is an I/O failure, or this operation is canceled |