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 |