public class BrickletNFC extends Device
Modifier and Type | Class and Description |
---|---|
class |
BrickletNFC.CardemuGetState |
static interface |
BrickletNFC.CardemuStateChangedListener
This listener is called if the cardemu state of the NFC Bricklet changes.
|
class |
BrickletNFC.P2PGetState |
class |
BrickletNFC.P2PReadNDEFLowLevel |
static interface |
BrickletNFC.P2PStateChangedListener
This listener is called if the P2P state of the NFC Bricklet changes.
|
class |
BrickletNFC.ReaderGetState |
class |
BrickletNFC.ReaderGetTagID |
class |
BrickletNFC.ReaderGetTagIDLowLevel |
class |
BrickletNFC.ReaderReadNDEFLowLevel |
class |
BrickletNFC.ReaderReadPageLowLevel |
static interface |
BrickletNFC.ReaderStateChangedListener
This listener is called if the reader state of the NFC Bricklet changes.
|
class |
BrickletNFC.SPITFPErrorCount |
Device.Identity
Constructor and Description |
---|
BrickletNFC(String uid,
IPConnection ipcon)
Creates an object with the unique device ID \c uid.
|
Modifier and Type | Method and Description |
---|---|
void |
addCardemuStateChangedListener(BrickletNFC.CardemuStateChangedListener listener)
Adds a CardemuStateChanged listener.
|
void |
addP2PStateChangedListener(BrickletNFC.P2PStateChangedListener listener)
Adds a P2PStateChanged listener.
|
void |
addReaderStateChangedListener(BrickletNFC.ReaderStateChangedListener listener)
Adds a ReaderStateChanged listener.
|
BrickletNFC.CardemuGetState |
cardemuGetState()
Returns the current cardemu state of the NFC Bricklet.
|
void |
cardemuStartDiscovery()
Starts the discovery process.
|
void |
cardemuStartTransfer(int transfer)
You can start the transfer of a NDEF message if the cardemu state is *CardemuDiscoveryReady*.
|
void |
cardemuWriteNDEF(int[] ndef)
Writes the NDEF message that is to be transferred to the NFC peer.
|
void |
cardemuWriteNDEFLowLevel(int ndefLength,
int ndefChunkOffset,
int[] ndefChunkData)
Writes the NDEF message that is to be transferred to the NFC peer.
|
int |
getBootloaderMode()
Returns the current bootloader mode, see
setBootloaderMode(int) . |
int |
getChipTemperature()
Returns the temperature as measured inside the microcontroller.
|
int |
getDetectionLEDConfig()
Returns the configuration as set by
setDetectionLEDConfig(int) |
Device.Identity |
getIdentity()
Returns the UID, the UID where the Bricklet is connected to,
the position, the hardware and firmware version as well as the
device identifier.
|
int |
getMaximumTimeout()
Returns the timeout as set by
setMaximumTimeout(int)
.. |
int |
getMode()
Returns the mode as set by
setMode(int) . |
BrickletNFC.SPITFPErrorCount |
getSPITFPErrorCount()
Returns the error count for the communication between Brick and Bricklet.
|
int |
getStatusLEDConfig()
Returns the configuration as set by
setStatusLEDConfig(int) |
BrickletNFC.P2PGetState |
p2pGetState()
Returns the current P2P state of the NFC Bricklet.
|
int[] |
p2pReadNDEF()
Returns the NDEF message that was written by a NFC peer in NFC P2P mode.
|
BrickletNFC.P2PReadNDEFLowLevel |
p2pReadNDEFLowLevel()
Returns the NDEF message that was written by a NFC peer in NFC P2P mode.
|
void |
p2pStartDiscovery()
Starts the discovery process.
|
void |
p2pStartTransfer(int transfer)
You can start the transfer of a NDEF message if the P2P state is *P2PDiscoveryReady*.
|
void |
p2pWriteNDEF(int[] ndef)
Writes the NDEF message that is to be transferred to the NFC peer.
|
void |
p2pWriteNDEFLowLevel(int ndefLength,
int ndefChunkOffset,
int[] ndefChunkData)
Writes the NDEF message that is to be transferred to the NFC peer.
|
void |
readerAuthenticateMifareClassicPage(int page,
int keyNumber,
int[] key)
Mifare Classic tags use authentication.
|
BrickletNFC.ReaderGetState |
readerGetState()
Returns the current reader state of the NFC Bricklet.
|
BrickletNFC.ReaderGetTagID |
readerGetTagID()
Returns the tag type and the tag ID.
|
BrickletNFC.ReaderGetTagIDLowLevel |
readerGetTagIDLowLevel()
Returns the tag type and the tag ID.
|
int[] |
readerReadNDEF()
Returns the NDEF data from an internal buffer.
|
BrickletNFC.ReaderReadNDEFLowLevel |
readerReadNDEFLowLevel()
Returns the NDEF data from an internal buffer.
|
int[] |
readerReadPage()
Returns the page data from an internal buffer.
|
BrickletNFC.ReaderReadPageLowLevel |
readerReadPageLowLevel()
Returns the page data from an internal buffer.
|
void |
readerRequestNDEF()
Reads NDEF formated data from a tag.
|
void |
readerRequestPage(int page,
int length)
Reads a maximum of 8192 bytes starting from the given page and stores them into a buffer.
|
void |
readerRequestTagID()
After you call
readerRequestTagID() the NFC Bricklet will try to read
the tag ID from the tag. |
void |
readerWriteNDEF(int[] ndef)
Writes NDEF formated data.
|
void |
readerWriteNDEFLowLevel(int ndefLength,
int ndefChunkOffset,
int[] ndefChunkData)
Writes NDEF formated data.
|
void |
readerWritePage(int page,
int[] data)
Writes a maximum of 8192 bytes starting from the given page.
|
void |
readerWritePageLowLevel(int page,
int dataLength,
int dataChunkOffset,
int[] dataChunkData)
Writes a maximum of 8192 bytes starting from the given page.
|
long |
readUID()
Returns the current UID as an integer.
|
void |
removeCardemuStateChangedListener(BrickletNFC.CardemuStateChangedListener listener)
Removes a CardemuStateChanged listener.
|
void |
removeP2PStateChangedListener(BrickletNFC.P2PStateChangedListener listener)
Removes a P2PStateChanged listener.
|
void |
removeReaderStateChangedListener(BrickletNFC.ReaderStateChangedListener listener)
Removes a ReaderStateChanged listener.
|
void |
reset()
Calling this function will reset the Bricklet.
|
int |
setBootloaderMode(int mode)
Sets the bootloader mode and returns the status after the requested
mode change was instigated.
|
void |
setDetectionLEDConfig(int config)
Sets the detection LED configuration.
|
void |
setMaximumTimeout(int timeout)
Sets the maximum timeout.
|
void |
setMode(int mode)
Sets the mode.
|
void |
setStatusLEDConfig(int config)
Sets the status LED configuration.
|
void |
setWriteFirmwarePointer(long pointer)
Sets the firmware pointer for
writeFirmware(int[]) . |
int |
writeFirmware(int[] data)
Writes 64 Bytes of firmware at the position as written by
setWriteFirmwarePointer(long) before. |
void |
writeUID(long uid)
Writes a new UID into flash.
|
getAPIVersion, getResponseExpected, setResponseExpected, setResponseExpectedAll
public static final int DEVICE_IDENTIFIER
public static final String DEVICE_DISPLAY_NAME
public static final byte FUNCTION_SET_MODE
public static final byte FUNCTION_GET_MODE
public static final byte FUNCTION_READER_REQUEST_TAG_ID
public static final byte FUNCTION_READER_GET_TAG_ID_LOW_LEVEL
public static final byte FUNCTION_READER_GET_STATE
public static final byte FUNCTION_READER_WRITE_NDEF_LOW_LEVEL
public static final byte FUNCTION_READER_REQUEST_NDEF
public static final byte FUNCTION_READER_READ_NDEF_LOW_LEVEL
public static final byte FUNCTION_READER_AUTHENTICATE_MIFARE_CLASSIC_PAGE
public static final byte FUNCTION_READER_WRITE_PAGE_LOW_LEVEL
public static final byte FUNCTION_READER_REQUEST_PAGE
public static final byte FUNCTION_READER_READ_PAGE_LOW_LEVEL
public static final byte FUNCTION_CARDEMU_GET_STATE
public static final byte FUNCTION_CARDEMU_START_DISCOVERY
public static final byte FUNCTION_CARDEMU_WRITE_NDEF_LOW_LEVEL
public static final byte FUNCTION_CARDEMU_START_TRANSFER
public static final byte FUNCTION_P2P_GET_STATE
public static final byte FUNCTION_P2P_START_DISCOVERY
public static final byte FUNCTION_P2P_WRITE_NDEF_LOW_LEVEL
public static final byte FUNCTION_P2P_START_TRANSFER
public static final byte FUNCTION_P2P_READ_NDEF_LOW_LEVEL
public static final byte FUNCTION_SET_DETECTION_LED_CONFIG
public static final byte FUNCTION_GET_DETECTION_LED_CONFIG
public static final byte FUNCTION_SET_MAXIMUM_TIMEOUT
public static final byte FUNCTION_GET_MAXIMUM_TIMEOUT
public static final byte FUNCTION_GET_SPITFP_ERROR_COUNT
public static final byte FUNCTION_SET_BOOTLOADER_MODE
public static final byte FUNCTION_GET_BOOTLOADER_MODE
public static final byte FUNCTION_SET_WRITE_FIRMWARE_POINTER
public static final byte FUNCTION_WRITE_FIRMWARE
public static final byte FUNCTION_SET_STATUS_LED_CONFIG
public static final byte FUNCTION_GET_STATUS_LED_CONFIG
public static final byte FUNCTION_GET_CHIP_TEMPERATURE
public static final byte FUNCTION_RESET
public static final byte FUNCTION_WRITE_UID
public static final byte FUNCTION_READ_UID
public static final byte FUNCTION_GET_IDENTITY
public static final int MODE_OFF
public static final int MODE_CARDEMU
public static final int MODE_P2P
public static final int MODE_READER
public static final int TAG_TYPE_MIFARE_CLASSIC
public static final int TAG_TYPE_TYPE1
public static final int TAG_TYPE_TYPE2
public static final int TAG_TYPE_TYPE3
public static final int TAG_TYPE_TYPE4
public static final int READER_STATE_INITIALIZATION
public static final int READER_STATE_IDLE
public static final int READER_STATE_ERROR
public static final int READER_STATE_REQUEST_TAG_ID
public static final int READER_STATE_REQUEST_TAG_ID_READY
public static final int READER_STATE_REQUEST_TAG_ID_ERROR
public static final int READER_STATE_AUTHENTICATE_MIFARE_CLASSIC_PAGE
public static final int READER_STATE_AUTHENTICATE_MIFARE_CLASSIC_PAGE_READY
public static final int READER_STATE_AUTHENTICATE_MIFARE_CLASSIC_PAGE_ERROR
public static final int READER_STATE_WRITE_PAGE
public static final int READER_STATE_WRITE_PAGE_READY
public static final int READER_STATE_WRITE_PAGE_ERROR
public static final int READER_STATE_REQUEST_PAGE
public static final int READER_STATE_REQUEST_PAGE_READY
public static final int READER_STATE_REQUEST_PAGE_ERROR
public static final int READER_STATE_WRITE_NDEF
public static final int READER_STATE_WRITE_NDEF_READY
public static final int READER_STATE_WRITE_NDEF_ERROR
public static final int READER_STATE_REQUEST_NDEF
public static final int READER_STATE_REQUEST_NDEF_READY
public static final int READER_STATE_REQUEST_NDEF_ERROR
public static final int KEY_A
public static final int KEY_B
public static final int READER_WRITE_TYPE4_CAPABILITY_CONTAINER
public static final int READER_WRITE_TYPE4_NDEF
public static final int READER_REQUEST_TYPE4_CAPABILITY_CONTAINER
public static final int READER_REQUEST_TYPE4_NDEF
public static final int CARDEMU_STATE_INITIALIZATION
public static final int CARDEMU_STATE_IDLE
public static final int CARDEMU_STATE_ERROR
public static final int CARDEMU_STATE_DISCOVER
public static final int CARDEMU_STATE_DISCOVER_READY
public static final int CARDEMU_STATE_DISCOVER_ERROR
public static final int CARDEMU_STATE_TRANSFER_NDEF
public static final int CARDEMU_STATE_TRANSFER_NDEF_READY
public static final int CARDEMU_STATE_TRANSFER_NDEF_ERROR
public static final int CARDEMU_TRANSFER_ABORT
public static final int CARDEMU_TRANSFER_WRITE
public static final int P2P_STATE_INITIALIZATION
public static final int P2P_STATE_IDLE
public static final int P2P_STATE_ERROR
public static final int P2P_STATE_DISCOVER
public static final int P2P_STATE_DISCOVER_READY
public static final int P2P_STATE_DISCOVER_ERROR
public static final int P2P_STATE_TRANSFER_NDEF
public static final int P2P_STATE_TRANSFER_NDEF_READY
public static final int P2P_STATE_TRANSFER_NDEF_ERROR
public static final int P2P_TRANSFER_ABORT
public static final int P2P_TRANSFER_WRITE
public static final int P2P_TRANSFER_READ
public static final int DETECTION_LED_CONFIG_OFF
public static final int DETECTION_LED_CONFIG_ON
public static final int DETECTION_LED_CONFIG_SHOW_HEARTBEAT
public static final int DETECTION_LED_CONFIG_SHOW_DETECTION
public static final int BOOTLOADER_MODE_BOOTLOADER
public static final int BOOTLOADER_MODE_FIRMWARE
public static final int BOOTLOADER_MODE_BOOTLOADER_WAIT_FOR_REBOOT
public static final int BOOTLOADER_MODE_FIRMWARE_WAIT_FOR_REBOOT
public static final int BOOTLOADER_MODE_FIRMWARE_WAIT_FOR_ERASE_AND_REBOOT
public static final int BOOTLOADER_STATUS_OK
public static final int BOOTLOADER_STATUS_INVALID_MODE
public static final int BOOTLOADER_STATUS_NO_CHANGE
public static final int BOOTLOADER_STATUS_ENTRY_FUNCTION_NOT_PRESENT
public static final int BOOTLOADER_STATUS_DEVICE_IDENTIFIER_INCORRECT
public static final int BOOTLOADER_STATUS_CRC_MISMATCH
public static final int STATUS_LED_CONFIG_OFF
public static final int STATUS_LED_CONFIG_ON
public static final int STATUS_LED_CONFIG_SHOW_HEARTBEAT
public static final int STATUS_LED_CONFIG_SHOW_STATUS
public BrickletNFC(String uid, IPConnection ipcon)
public void setMode(int mode) throws TinkerforgeException
TinkerforgeException
public int getMode() throws TinkerforgeException
setMode(int)
.TinkerforgeException
public void readerRequestTagID() throws TinkerforgeException
readerRequestTagID()
the NFC Bricklet will try to read
the tag ID from the tag. After this process is done the state will change.
You can either register the BrickletNFC.ReaderStateChangedListener
listener or you can poll
readerGetState()
to find out about the state change.
If the state changes to *ReaderRequestTagIDError* it means that either there was
no tag present or that the tag has an incompatible type. If the state
changes to *ReaderRequestTagIDReady* it means that a compatible tag was found
and that the tag ID has been saved. You can now read out the tag ID by
calling readerGetTagID()
.
If two tags are in the proximity of the NFC Bricklet, this
function will cycle through the tags. To select a specific tag you have
to call readerRequestTagID()
until the correct tag ID is found.
In case of any *ReaderError* state the selection is lost and you have to
start again by calling readerRequestTagID()
.TinkerforgeException
public BrickletNFC.ReaderGetTagIDLowLevel readerGetTagIDLowLevel() throws TinkerforgeException
readerRequestTagID()
.
To get the tag ID of a tag the approach is as follows:
1. Call readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see readerGetState()
or
BrickletNFC.ReaderStateChangedListener
listener)
3. Call readerGetTagID()
TinkerforgeException
public BrickletNFC.ReaderGetState readerGetState() throws TinkerforgeException
setMode(int)
.
The functions of this Bricklet can be called in the *ReaderIdle* state and all of
the *ReaderReady* and *ReaderError* states.
Example: If you call readerRequestPage(int, int)
, the state will change to
*ReaderRequestPage* until the reading of the page is finished. Then it will change
to either *ReaderRequestPageReady* if it worked or to *ReaderRequestPageError* if it
didn't. If the request worked you can get the page by calling readerReadPage()
.
The same approach is used analogously for the other API functions.TinkerforgeException
public void readerWriteNDEFLowLevel(int ndefLength, int ndefChunkOffset, int[] ndefChunkData) throws TinkerforgeException
readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see
readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check
if the expected tag was found, if it was not found got back to step 1
4. Call readerWriteNDEF(int[])
with the NDEF message that you want to write
5. Wait for state to change to *ReaderWriteNDEFReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)TinkerforgeException
public void readerRequestNDEF() throws TinkerforgeException
readerRequestTagID()
2. Wait for state to change to *RequestTagIDReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check if the
expected tag was found, if it was not found got back to step 1
4. Call readerRequestNDEF()
5. Wait for state to change to *ReaderRequestNDEFReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
6. Call readerReadNDEF()
to retrieve the NDEF message from the bufferTinkerforgeException
public BrickletNFC.ReaderReadNDEFLowLevel readerReadNDEFLowLevel() throws TinkerforgeException
readerRequestNDEF()
beforehand.TinkerforgeException
public void readerAuthenticateMifareClassicPage(int page, int keyNumber, int[] key) throws TinkerforgeException
readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check if the
expected tag was found, if it was not found got back to step 1
4. Call readerAuthenticateMifareClassicPage(int, int, int[])
with page and key for the page
5. Wait for state to change to *ReaderAuthenticatingMifareClassicPageReady* (see
readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
6. Call readerRequestPage(int, int)
or readerWritePage(int, int[])
to read/write page
The authentication will always work for one whole sector (4 pages).TinkerforgeException
public void readerWritePageLowLevel(int page, int dataLength, int dataChunkOffset, int[] dataChunkData) throws TinkerforgeException
readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see readerGetState()
or
BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check if the
expected tag was found, if it was not found got back to step 1
4. Call readerWritePage(int, int[])
with page number and data
5. Wait for state to change to *ReaderWritePageReady* (see readerGetState()
or
BrickletNFC.ReaderStateChangedListener
listener)
If you use a Mifare Classic tag you have to authenticate a page before you
can write to it. See readerAuthenticateMifareClassicPage(int, int, int[])
.
NFC Forum Type 4 tags are not organized into pages but different files. We currently
support two files: Capability Container file (CC) and NDEF file.
Choose CC by setting page to 3 or NDEF by setting page to 4.TinkerforgeException
public void readerRequestPage(int page, int length) throws TinkerforgeException
readerReadPage()
.
How many pages are read depends on the tag type. The page sizes are
as follows:
* Mifare Classic page size: 16 byte
* NFC Forum Type 1 page size: 8 byte
* NFC Forum Type 2 page size: 4 byte
* NFC Forum Type 3 page size: 16 byte
* NFC Forum Type 4: No pages, page = file selection (CC or NDEF, see below)
The general approach for reading a tag is as follows:
1. Call readerRequestTagID()
2. Wait for state to change to *RequestTagIDReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check if the
expected tag was found, if it was not found got back to step 1
4. Call readerRequestPage(int, int)
with page number
5. Wait for state to change to *ReaderRequestPageReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
6. Call readerReadPage()
to retrieve the page from the buffer
If you use a Mifare Classic tag you have to authenticate a page before you
can read it. See readerAuthenticateMifareClassicPage(int, int, int[])
.
NFC Forum Type 4 tags are not organized into pages but different files. We currently
support two files: Capability Container file (CC) and NDEF file.
Choose CC by setting page to 3 or NDEF by setting page to 4.TinkerforgeException
public BrickletNFC.ReaderReadPageLowLevel readerReadPageLowLevel() throws TinkerforgeException
readerRequestPage(int, int)
beforehand.TinkerforgeException
public BrickletNFC.CardemuGetState cardemuGetState() throws TinkerforgeException
setMode(int)
.
The functions of this Bricklet can be called in the *CardemuIdle* state and all of
the *CardemuReady* and *CardemuError* states.
Example: If you call cardemuStartDiscovery()
, the state will change to
*CardemuDiscover* until the discovery is finished. Then it will change
to either *CardemuDiscoverReady* if it worked or to *CardemuDiscoverError* if it
didn't.
The same approach is used analogously for the other API functions.TinkerforgeException
public void cardemuStartDiscovery() throws TinkerforgeException
cardemuWriteNDEF(int[])
and cardemuStartTransfer(int)
.TinkerforgeException
public void cardemuWriteNDEFLowLevel(int ndefLength, int ndefChunkOffset, int[] ndefChunkData) throws TinkerforgeException
TinkerforgeException
public void cardemuStartTransfer(int transfer) throws TinkerforgeException
cardemuWriteNDEF(int[])
first.
After you call this function the state will change to *CardemuTransferNDEF*. It will
change to *CardemuTransferNDEFReady* if the transfer was successful or
*CardemuTransferNDEFError* if it wasn't.TinkerforgeException
public BrickletNFC.P2PGetState p2pGetState() throws TinkerforgeException
setMode(int)
.
The functions of this Bricklet can be called in the *P2PIdle* state and all of
the *P2PReady* and *P2PError* states.
Example: If you call p2pStartDiscovery()
, the state will change to
*P2PDiscover* until the discovery is finished. Then it will change
to either P2PDiscoverReady* if it worked or to *P2PDiscoverError* if it
didn't.
The same approach is used analogously for the other API functions.TinkerforgeException
public void p2pStartDiscovery() throws TinkerforgeException
p2pStartTransfer(int)
.TinkerforgeException
public void p2pWriteNDEFLowLevel(int ndefLength, int ndefChunkOffset, int[] ndefChunkData) throws TinkerforgeException
TinkerforgeException
public void p2pStartTransfer(int transfer) throws TinkerforgeException
p2pWriteNDEF(int[])
first.
After you call this function the P2P state will change to *P2PTransferNDEF*. It will
change to *P2PTransferNDEFReady* if the transfer was successfull or
*P2PTransferNDEFError* if it wasn't.
If you started a write transfer you are now done. If you started a read transfer
you can now use p2pReadNDEF()
to read the NDEF message that was written
by the NFC peer.TinkerforgeException
public BrickletNFC.P2PReadNDEFLowLevel p2pReadNDEFLowLevel() throws TinkerforgeException
p2pStartTransfer(int)
with a
read transfer and the P2P state changed to *P2PTransferNDEFReady*.TinkerforgeException
public void setDetectionLEDConfig(int config) throws TinkerforgeException
TinkerforgeException
public int getDetectionLEDConfig() throws TinkerforgeException
setDetectionLEDConfig(int)
TinkerforgeException
public void setMaximumTimeout(int timeout) throws TinkerforgeException
readerRequestTagID()
and wait for the state
to change to either the error state or the ready state.
With the default configuration this takes 2-3 seconds. By setting the maximum timeout to
100ms you can reduce this time to ~150-200ms. For Type 2 this would also still work
with a 20ms timeout (a Type 2 tag answers usually within 10ms). A type 4 tag can take
up to 500ms in our tests.
If you need a fast response time to discover if a tag is present or not you can find
a good timeout value by trial and error for your specific tag.
By default we use a very conservative timeout, to be sure that any tag can always
answer in time.
.. versionadded:: 2.0.1$nbsp;(Plugin)TinkerforgeException
public int getMaximumTimeout() throws TinkerforgeException
setMaximumTimeout(int)
.. versionadded:: 2.0.1$nbsp;(Plugin)TinkerforgeException
public BrickletNFC.SPITFPErrorCount getSPITFPErrorCount() throws TinkerforgeException
TinkerforgeException
public int setBootloaderMode(int mode) throws TinkerforgeException
TinkerforgeException
public int getBootloaderMode() throws TinkerforgeException
setBootloaderMode(int)
.TinkerforgeException
public void setWriteFirmwarePointer(long pointer) throws TinkerforgeException
writeFirmware(int[])
. The pointer has
to be increased by chunks of size 64. The data is written to flash
every 4 chunks (which equals to one page of size 256).
This function is used by Brick Viewer during flashing. It should not be
necessary to call it in a normal user program.TinkerforgeException
public int writeFirmware(int[] data) throws TinkerforgeException
setWriteFirmwarePointer(long)
before. The firmware is written
to flash every 4 chunks.
You can only write firmware in bootloader mode.
This function is used by Brick Viewer during flashing. It should not be
necessary to call it in a normal user program.TinkerforgeException
public void setStatusLEDConfig(int config) throws TinkerforgeException
TinkerforgeException
public int getStatusLEDConfig() throws TinkerforgeException
setStatusLEDConfig(int)
TinkerforgeException
public int getChipTemperature() throws TinkerforgeException
TinkerforgeException
public void reset() throws TinkerforgeException
TinkerforgeException
public void writeUID(long uid) throws TinkerforgeException
TinkerforgeException
public long readUID() throws TinkerforgeException
TinkerforgeException
public Device.Identity getIdentity() throws TinkerforgeException
getIdentity
in class Device
TinkerforgeException
public BrickletNFC.ReaderGetTagID readerGetTagID() throws TinkerforgeException
readerRequestTagID()
.
To get the tag ID of a tag the approach is as follows:
1. Call readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see readerGetState()
or
BrickletNFC.ReaderStateChangedListener
listener)
3. Call readerGetTagID()
TinkerforgeException
public void readerWriteNDEF(int[] ndef) throws TinkerforgeException
readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see
readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check
if the expected tag was found, if it was not found got back to step 1
4. Call readerWriteNDEF(int[])
with the NDEF message that you want to write
5. Wait for state to change to *ReaderWriteNDEFReady* (see readerGetState()
or BrickletNFC.ReaderStateChangedListener
listener)TinkerforgeException
public int[] readerReadNDEF() throws TinkerforgeException
readerRequestNDEF()
beforehand.TinkerforgeException
public void readerWritePage(int page, int[] data) throws TinkerforgeException
readerRequestTagID()
2. Wait for state to change to *ReaderRequestTagIDReady* (see readerGetState()
or
BrickletNFC.ReaderStateChangedListener
listener)
3. If looking for a specific tag then call readerGetTagID()
and check if the
expected tag was found, if it was not found got back to step 1
4. Call readerWritePage(int, int[])
with page number and data
5. Wait for state to change to *ReaderWritePageReady* (see readerGetState()
or
BrickletNFC.ReaderStateChangedListener
listener)
If you use a Mifare Classic tag you have to authenticate a page before you
can write to it. See readerAuthenticateMifareClassicPage(int, int, int[])
.
NFC Forum Type 4 tags are not organized into pages but different files. We currently
support two files: Capability Container file (CC) and NDEF file.
Choose CC by setting page to 3 or NDEF by setting page to 4.TinkerforgeException
public int[] readerReadPage() throws TinkerforgeException
readerRequestPage(int, int)
beforehand.TinkerforgeException
public void cardemuWriteNDEF(int[] ndef) throws TinkerforgeException
TinkerforgeException
public void p2pWriteNDEF(int[] ndef) throws TinkerforgeException
TinkerforgeException
public int[] p2pReadNDEF() throws TinkerforgeException
p2pStartTransfer(int)
with a
read transfer and the P2P state changed to *P2PTransferNDEFReady*.TinkerforgeException
public void addReaderStateChangedListener(BrickletNFC.ReaderStateChangedListener listener)
public void removeReaderStateChangedListener(BrickletNFC.ReaderStateChangedListener listener)
public void addCardemuStateChangedListener(BrickletNFC.CardemuStateChangedListener listener)
public void removeCardemuStateChangedListener(BrickletNFC.CardemuStateChangedListener listener)
public void addP2PStateChangedListener(BrickletNFC.P2PStateChangedListener listener)
public void removeP2PStateChangedListener(BrickletNFC.P2PStateChangedListener listener)
Copyright © 2021 Tinkerforge GmbH. All rights reserved.