IT. Expert System.

All Implemented Interfaces:

TagTechnology, Closeable, AutoCloseable

public final class NfcF
extends Object

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static String	EXTRA_PMM
  static String	EXTRA_SC

  • Fields inherited from interface android.nfc.tech.TagTechnology

    ISO_DEP, MIFARE_CLASSIC, MIFARE_ULTRALIGHT, NDEF, NDEF_FORMATABLE, NFC_A, NFC_B, NFC_BARCODE, NFC_F, NFC_V

• Constructor Summary

  Constructors

  Constructor and Description
  NfcF(Tag tag)

• Method Summary

  Methods

  Modifier and Type	Method and Description
  void	close() Disable I/O operations to the tag from this TagTechnology object, and release resources.
  void	connect() Enable I/O operations to the tag from this TagTechnology object.
  static NfcF	get(Tag tag) Get an instance of NfcF for the given tag.
  byte[]	getManufacturer() Return the Manufacturer bytes from tag discovery.
  int	getMaxTransceiveLength() Return the maximum number of bytes that can be sent with transceive(byte[]).
  byte[]	getSystemCode() Return the System Code bytes from tag discovery.
  Tag	getTag() Get the Tag object backing this TagTechnology object.
  int	getTimeout() Get the current transceive(byte[]) timeout in milliseconds.
  boolean	isConnected() Helper to indicate if I/O operations should be possible.
  void	reconnect() Re-connect to the Tag associated with this connection.
  void	setTimeout(int timeout) Set the transceive(byte[]) timeout in milliseconds.
  byte[]	transceive(byte[] data) Send raw NFC-F commands to the tag and receive the response.

  • Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Field Detail

  • EXTRA_SC

    public static final String EXTRA_SC

    See Also:

    Constant Field Values

  • EXTRA_PMM

    public static final String EXTRA_PMM

    See Also:

    Constant Field Values

• Constructor Detail

  • NfcF

    public NfcF(Tag tag)
         throws RemoteException

    Throws:

    RemoteException

• Method Detail

  • get

    public static NfcF get(Tag tag)

    Get an instance of NfcF for the given tag.

    Returns null if NfcF was not enumerated in Tag.getTechList(). This indicates the tag does not support NFC-F.

    Does not cause any RF activity and does not block.

    Parameters:

    tag - an NFC-F compatible tag

    Returns:

    NFC-F object

  • getSystemCode

    public byte[] getSystemCode()

    Return the System Code bytes from tag discovery.

    Does not cause any RF activity and does not block.

    Returns:

    System Code bytes

  • getManufacturer

    public byte[] getManufacturer()

    Return the Manufacturer bytes from tag discovery.

    Does not cause any RF activity and does not block.

    Returns:

    Manufacturer bytes

  • transceive

    public byte[] transceive(byte[] data)
                      throws IOException

    Send raw NFC-F commands to the tag and receive the response.

    Applications must not append the SoD (length) or EoD (CRC) to the payload, it will be automatically calculated.

    Use getMaxTransceiveLength() to retrieve the maximum amount 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 android.Manifest.permission#NFC permission.

    Parameters:

    data - bytes to send

    Returns:

    bytes received in response

    Throws:

    TagLostException - if the tag leaves the field

    IOException - if there is an I/O failure, or this operation is canceled

  • getMaxTransceiveLength

    public int getMaxTransceiveLength()

    Return the maximum number of bytes that can be sent with transceive(byte[]).

    Returns:

    the maximum number of bytes that can be sent with transceive(byte[]).

  • setTimeout

    public void setTimeout(int timeout)

    Set the transceive(byte[]) timeout in milliseconds.

    The timeout only applies to transceive(byte[]) on this object, 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 android.Manifest.permission#NFC permission.

    Parameters:

    timeout - timeout value in milliseconds

  • getTimeout

    public int getTimeout()

    Get the current transceive(byte[]) timeout in milliseconds.

    Requires the android.Manifest.permission#NFC permission.

    Returns:

    timeout value in milliseconds

  • getTag

    public Tag getTag()

    Description copied from interface: TagTechnology
    Get the Tag object backing this TagTechnology object.

    Specified by:

    getTag in interface TagTechnology

    Returns:

    the Tag backing this TagTechnology object.

  • isConnected

    public boolean isConnected()

    Description copied from interface: TagTechnology
    Helper to indicate if I/O operations should be possible.

    Returns true if TagTechnology.connect() has completed, and TagTechnology.close() has not been called, and the Tag is not known to be out of range.

    Does not cause RF activity, and does not block.

    Specified by:

    isConnected in interface TagTechnology

    Returns:

    true if I/O operations should be possible

  • connect

    public void connect()
                 throws IOException

    Description copied from interface: TagTechnology
    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 TagTechnology.close() from another thread.

    Only one TagTechnology object can be connected to a Tag at a time.

    Applications must call TagTechnology.close() when I/O operations are complete.

    Requires the android.Manifest.permission#NFC permission.

    Specified by:

    connect in interface TagTechnology

    Throws:

    IOException - if there is an I/O failure, or connect is canceled

    See Also:

    TagTechnology.close()

  • reconnect

    public void reconnect()
                   throws IOException

    Description copied from interface: TagTechnology
    Re-connect to the Tag associated with this connection. Reconnecting to a tag can be used to reset the state of the tag itself.

    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 TagTechnology.close() from another thread.

    Requires the android.Manifest.permission#NFC permission.

    Specified by:

    reconnect in interface TagTechnology

    Throws:

    IOException - if there is an I/O failure, or connect is canceled

    See Also:

    TagTechnology.connect(), TagTechnology.close()

  • close

    public void close()
               throws IOException

    Description copied from interface: TagTechnology
    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 android.Manifest.permission#NFC permission.

    Specified by:

    close in interface TagTechnology

    Specified by:

    close in interface Closeable

    Specified by:

    close in interface AutoCloseable

    Throws:

    IOException

    See Also:

    TagTechnology.connect()