Package apple.corenfc.protocol

Interface NFCISO15693Tag

  • All Superinterfaces:
    NFCNDEFTag, NFCTag, NSCoding, NSCopying, NSSecureCoding
    public interface NFCISO15693Tag
extends NFCTag, NFCNDEFTag
    [@protocol] NFCISO15693Tag A @link NFCISO15693ReaderSession @link/ or @link NFCTagReaderSession @link/ reader session returns an instance conforming to this protocol when an ISO15693 tag is detected. Unless it is specified all block completion handlers are dispatched on the reader session work queue that is associated with the tag. Your process requires to include the "com.apple.developer.nfc.readersession.formats" entitlement to receive this tag object from the @link NFCReaderSessionDelegate @link/ delegate. [@link] NFCReaderErrorSecurityViolation @link/ will be returned from the @link NFCTagReaderSessionDelegate @link/ invalidation method if the required entitlement is missing when session is started. Tag must be in the connected state for NFCNDEFTag protocol properties and methods to work correctly. Each data frame send out by the reader may not exceed 256 bytes total.

    • Method Detail

      • customCommandWithRequestFlagCustomCommandCodeCustomRequestParametersCompletionHandler

        void customCommandWithRequestFlagCustomCommandCodeCustomRequestParametersCompletionHandler​(byte flags,
                                                                                           long customCommandCode,
                                                                                           NSData customRequestParameters,
                                                                                           NFCISO15693Tag.Block_customCommandWithRequestFlagCustomCommandCodeCustomRequestParametersCompletionHandler completionHandler)
        customCommandWithRequestFlag:customCommandCode:customRequestParameters:completionHandler: Custom command (0xA0 to 0xDF command code) as defined in ISO15693-3 specification. IC manufacturer code from the tag is automatically inserted after the command byte before appending the custom request parameters in forming the packet.
        Parameters:
        flags - Request flags.
        customCommandCode - Custom command code defined by the IC manufacturer. Valid range is 0xA0 to 0xDF inclusively.
        customRequestParameters - Custom request parameters defined by the command.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. The custom reponse parameters are returned on success.

      • extendedLockBlockWithRequestFlagsBlockNumberCompletionHandler

        void extendedLockBlockWithRequestFlagsBlockNumberCompletionHandler​(byte flags,
                                                                   long blockNumber,
                                                                   NFCISO15693Tag.Block_extendedLockBlockWithRequestFlagsBlockNumberCompletionHandler completionHandler)
        extendedLockBlockWithRequestFlags:blockNumber:completionHandler: Extende lock single block command (0x32 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockNumber - 2 bytes block number, valid range from 0 to 65535 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • extendedReadMultipleBlocksWithRequestFlagsBlockRangeCompletionHandler

        void extendedReadMultipleBlocksWithRequestFlagsBlockRangeCompletionHandler​(byte flags,
                                                                           NSRange blockRange,
                                                                           NFCISO15693Tag.Block_extendedReadMultipleBlocksWithRequestFlagsBlockRangeCompletionHandler completionHandler)
        extendedReadMultipleBlocksWithRequestFlags:blockRange:completionHandler: Extended read multiple block command (0x33 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 65535 inclusively. Valid length is 1 to 65536 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully read data blocks will be returned from NSData object. If Option flag in the request flags is set, then first byte of each returned data blocks will contain the associated block security status.

      • extendedReadSingleBlockWithRequestFlagsBlockNumberCompletionHandler

        void extendedReadSingleBlockWithRequestFlagsBlockNumberCompletionHandler​(byte flags,
                                                                         long blockNumber,
                                                                         NFCISO15693Tag.Block_extendedReadSingleBlockWithRequestFlagsBlockNumberCompletionHandler completionHandler)
        extendedReadSingleBlockWithRequestFlags:blockNumber:completionHandler: Extended read single block command (0x30 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockNumber - 2 bytes block number, valid range from 0 to 65535 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. If Option flag in the request flags is set, then first byte of the returned data block will contain the associated block security status.

      • extendedWriteSingleBlockWithRequestFlagsBlockNumberDataBlockCompletionHandler

        void extendedWriteSingleBlockWithRequestFlagsBlockNumberDataBlockCompletionHandler​(byte flags,
                                                                                   long blockNumber,
                                                                                   NSData dataBlock,
                                                                                   NFCISO15693Tag.Block_extendedWriteSingleBlockWithRequestFlagsBlockNumberDataBlockCompletionHandler completionHandler)
        extendedWriteSingleBlockWithRequestFlags:blockNumber:dataBlock:completionHandler: Extended write single block command (0x31 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockNumber - 2 bytes block number, valid range from 0 to 65535 inclusively.
        dataBlock - A single block of data.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • getMultipleBlockSecurityStatusWithRequestFlagBlockRangeCompletionHandler

        void getMultipleBlockSecurityStatusWithRequestFlagBlockRangeCompletionHandler​(byte flags,
                                                                              NSRange blockRange,
                                                                              NFCISO15693Tag.Block_getMultipleBlockSecurityStatusWithRequestFlagBlockRangeCompletionHandler completionHandler)
        getMultipleBlockSecurityStatusWithRequestFlag:blockRange:completionHandler: Get multiple block security status command (0x2C command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 255 inclusively. Valid length is 1 to 256 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. The 8 bits security status of the requested blocks are returned in NSArray; the array will be empty when error occurs.

      • getSystemInfoWithRequestFlagCompletionHandler

        void getSystemInfoWithRequestFlagCompletionHandler​(byte flags,
                                                   NFCISO15693Tag.Block_getSystemInfoWithRequestFlagCompletionHandler completionHandler)
        getSystemInfoWithRequestFlag:completionHandler: Use the replacement -getSystemInfoAndUIDWithRequestFlag:completionHandler:.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Value of -1 will be returned from dsfid, afi, blockSize, blockCount, or icReference if tag response does not contain the information. blockSize returns the actual block size in bytes ranged from 1 to 32. blockCount returns the actual number of blocks ranged from 1 to 256 blocks.

      • icManufacturerCode

        long icManufacturerCode()
        The IC manufacturer code (bits 56 – 49) in UID according to ISO/IEC 7816-6:2004.

      • icSerialNumber

        NSData icSerialNumber()
        The IC serial number (bits 48 – 1) in UID assigned by the manufacturer. Data is in Big Endian byte order.

      • identifier

        NSData identifier()
        The 64 bit hardware UID of the tag. Data is in Big Endian byte order.

      • lockAFIWithRequestFlagCompletionHandler

        void lockAFIWithRequestFlagCompletionHandler​(byte flags,
                                             NFCISO15693Tag.Block_lockAFIWithRequestFlagCompletionHandler completionHandler)
        lockAFIWithRequestFlag:completionHandler: Lock AFI command (0x28 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • lockBlockWithRequestFlagsBlockNumberCompletionHandler

        void lockBlockWithRequestFlagsBlockNumberCompletionHandler​(byte flags,
                                                           byte blockNumber,
                                                           NFCISO15693Tag.Block_lockBlockWithRequestFlagsBlockNumberCompletionHandler completionHandler)
        lockBlockWithRequestFlags:blockNumber:completionHandler: Lock block command (0x22 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockNumber - Block number. Blocks are numbered from 0 to 255 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully read data blocks will be returned from NSData object.

      • lockDFSIDWithRequestFlagCompletionHandler

        void lockDFSIDWithRequestFlagCompletionHandler​(byte flags,
                                               NFCISO15693Tag.Block_lockDFSIDWithRequestFlagCompletionHandler completionHandler)
        lockDFSIDWithRequestFlag:completionHandler: Use the replacement -lockDSFIDWithRequestFlag:completionHandler:.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • readMultipleBlocksWithConfigurationCompletionHandler

        void readMultipleBlocksWithConfigurationCompletionHandler​(NFCISO15693ReadMultipleBlocksConfiguration readConfiguration,
                                                          NFCISO15693Tag.Block_readMultipleBlocksWithConfigurationCompletionHandler completionHandler)
        readMultipleBlocksWithConfiguration:completionHandler: Performs read operation using Read Multiple Blocks command (0x23 command code) as defined in ISO15693-3 specification. Multiple Read Multiple Blocks commands will be sent if necessary to complete the operation.
        Parameters:
        readConfiguration - Configuration For the Read Multiple Blocks command.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully read data blocks will be returned from NSData object. All blocks are concatenated into the NSData object.

      • readMultipleBlocksWithRequestFlagsBlockRangeCompletionHandler

        void readMultipleBlocksWithRequestFlagsBlockRangeCompletionHandler​(byte flags,
                                                                   NSRange blockRange,
                                                                   NFCISO15693Tag.Block_readMultipleBlocksWithRequestFlagsBlockRangeCompletionHandler completionHandler)
        readMultipleBlocksWithRequestFlags:blockRange:completionHandler: Read multiple blocks command (0x23 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 255 inclusively. Valid length is 1 to 256 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully read data blocks will be returned from NSArray of NSData object. If Option flag in the request flags is set, then first byte of each returned data block will contain the associated block security status. Each data block element would have identical size.

      • readSingleBlockWithRequestFlagsBlockNumberCompletionHandler

        void readSingleBlockWithRequestFlagsBlockNumberCompletionHandler​(byte flags,
                                                                 byte blockNumber,
                                                                 NFCISO15693Tag.Block_readSingleBlockWithRequestFlagsBlockNumberCompletionHandler completionHandler)
        readSingleBlockWithRequestFlags:blockNumber:completionHandler: Read single block command (0x20 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockNumber - Block number. Blocks are numbered from 0 to 255 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully read data blocks will be returned from NSData object. If Option flag in the request flags is set, then first byte of data block will contain the associated block security status.

      • resetToReadyWithRequestFlagsCompletionHandler

        void resetToReadyWithRequestFlagsCompletionHandler​(byte flags,
                                                   NFCISO15693Tag.Block_resetToReadyWithRequestFlagsCompletionHandler completionHandler)
        resetToReadyWithRequestFlags:completionHandler: Reset To Ready command (0x26 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • selectWithRequestFlagsCompletionHandler

        void selectWithRequestFlagsCompletionHandler​(byte flags,
                                             NFCISO15693Tag.Block_selectWithRequestFlagsCompletionHandler completionHandler)
        selectWithRequestFlags:completionHandler: Select command (0x25 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • sendCustomCommandWithConfigurationCompletionHandler

        void sendCustomCommandWithConfigurationCompletionHandler​(NFCISO15693CustomCommandConfiguration commandConfiguration,
                                                         NFCISO15693Tag.Block_sendCustomCommandWithConfigurationCompletionHandler completionHandler)
        sendCustomCommandWithConfiguration:completionHandler: Send a manufacturer dependent custom command using command code range from 0xA0 to 0xDF. Refer to ISO15693-3 specification for details.
        Parameters:
        commandConfiguration - Configuration for the Manufacturer Custom Command.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • stayQuietWithCompletionHandler

        void stayQuietWithCompletionHandler​(NFCISO15693Tag.Block_stayQuietWithCompletionHandler completionHandler)
        stayQuietWithCompletionHandler: Stay quiet command (0x02 command code) as defined in ISO15693-3 specification.
        Parameters:
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • writeAFIWithRequestFlagAfiCompletionHandler

        void writeAFIWithRequestFlagAfiCompletionHandler​(byte flags,
                                                 byte afi,
                                                 NFCISO15693Tag.Block_writeAFIWithRequestFlagAfiCompletionHandler completionHandler)
        writeAFIWithRequestFlag:afi:completionHandler: Write AFI command (0x27 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        afi - Application Family Identifier.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • writeDSFIDWithRequestFlagDsfidCompletionHandler

        void writeDSFIDWithRequestFlagDsfidCompletionHandler​(byte flags,
                                                     byte dsfid,
                                                     NFCISO15693Tag.Block_writeDSFIDWithRequestFlagDsfidCompletionHandler completionHandler)
        writeDSFIDWithRequestFlag:dsfid:completionHandler: Write DSFID command (0x29 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        dsfid - Data Storage Format Identifier.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • writeMultipleBlocksWithRequestFlagsBlockRangeDataBlocksCompletionHandler

        void writeMultipleBlocksWithRequestFlagsBlockRangeDataBlocksCompletionHandler​(byte flags,
                                                                              NSRange blockRange,
                                                                              NSArray<? extends NSData> dataBlocks,
                                                                              NFCISO15693Tag.Block_writeMultipleBlocksWithRequestFlagsBlockRangeDataBlocksCompletionHandler completionHandler)
        writeMultipleBlocksWithRequestFlags:blockRange:dataBlocks:completionHandler: Write multiple blocks command (0x24 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 255 inclusively. Valid length is 1 to 256 inclusively.
        dataBlocks - Blocks of data represent in NSArray of NSData. The number of blocks shall match the length value of the blockRange parameter. Each block element should have identical size and should match the physical block size of the tag.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • writeSingleBlockWithRequestFlagsBlockNumberDataBlockCompletionHandler

        void writeSingleBlockWithRequestFlagsBlockNumberDataBlockCompletionHandler​(byte flags,
                                                                           byte blockNumber,
                                                                           NSData dataBlock,
                                                                           NFCISO15693Tag.Block_writeSingleBlockWithRequestFlagsBlockNumberDataBlockCompletionHandler completionHandler)
        writeSingleBlockWithRequestFlags:blockNumber:dataBlock:completionHandler: Write single block command (0x21 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockNumber - Block number. Blocks are numbered from 0 to 255 inclusively.
        dataBlock - A single block of data.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • authenticateWithRequestFlagsCryptoSuiteIdentifierMessageCompletionHandler

        void authenticateWithRequestFlagsCryptoSuiteIdentifierMessageCompletionHandler​(byte flags,
                                                                               long cryptoSuiteIdentifier,
                                                                               NSData message,
                                                                               NFCISO15693Tag.Block_authenticateWithRequestFlagsCryptoSuiteIdentifierMessageCompletionHandler completionHandler)
        authenticateWithRequestFlags:cryptoSuiteIdentifier:message:completionHandler: Authenticate command (0x35 command code) as defined in ISO15693-3 specification. Please note that in-process reply is returned to the caller without any processing.
        Parameters:
        flags - Request flags.
        cryptoSuiteIdentifier - 8 bits Crypto Suite Indicator as defined in ISO/IEC 29167 specification.
        message - Content of the Authenticate command as dictated by the Crypto Suite Indicator.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully command response will be return as NSData object excluding the 8 bits response flag.

      • challengeWithRequestFlagsCryptoSuiteIdentifierMessageCompletionHandler

        void challengeWithRequestFlagsCryptoSuiteIdentifierMessageCompletionHandler​(byte flags,
                                                                            long cryptoSuiteIdentifier,
                                                                            NSData message,
                                                                            NFCISO15693Tag.Block_challengeWithRequestFlagsCryptoSuiteIdentifierMessageCompletionHandler completionHandler)
        challengeWithRequestFlags:message:completionHandler: Challenge command (0x39 command code) as defined in ISO15693-3 specification.
        Parameters:
        flags - Request flags.
        cryptoSuiteIdentifier - 8 bits Crypto Suite Indicator as defined in ISO/IEC 29167 specification.
        message - Content of the Key Update command as dictated by the Crypto Suite Indicator used in Authenticate.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • extendedFastReadMultipleBlocksWithRequestFlagBlockRangeCompletionHandler

        void extendedFastReadMultipleBlocksWithRequestFlagBlockRangeCompletionHandler​(byte flags,
                                                                              NSRange blockRange,
                                                                              NFCISO15693Tag.Block_extendedFastReadMultipleBlocksWithRequestFlagBlockRangeCompletionHandler completionHandler)
        extendedFastReadMultipleBlocksWithRequestFlag:blockRange:completionHandler: Fast read multiple blocks command (0x3D command code) as defined in ISO15693-3 specification.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds.

      • extendedGetMultipleBlockSecurityStatusWithRequestFlagBlockRangeCompletionHandler

        void extendedGetMultipleBlockSecurityStatusWithRequestFlagBlockRangeCompletionHandler​(byte flags,
                                                                                      NSRange blockRange,
                                                                                      NFCISO15693Tag.Block_extendedGetMultipleBlockSecurityStatusWithRequestFlagBlockRangeCompletionHandler completionHandler)
        extendedGetMultipleBlockSecurityStatusWithRequestFlag:blockRange:completionHandler: Get multiple block security status command (0x3C command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 255 inclusively. Valid length is 1 to 256 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. The 8 bits security status of the requested blocks are returned in NSArray; the array will be empty when error occurs.

      • extendedWriteMultipleBlocksWithRequestFlagsBlockRangeDataBlocksCompletionHandler

        void extendedWriteMultipleBlocksWithRequestFlagsBlockRangeDataBlocksCompletionHandler​(byte flags,
                                                                                      NSRange blockRange,
                                                                                      NSArray<? extends NSData> dataBlocks,
                                                                                      NFCISO15693Tag.Block_extendedWriteMultipleBlocksWithRequestFlagsBlockRangeDataBlocksCompletionHandler completionHandler)
        extendedWriteMultipleBlocksWithRequestFlags:blockRange:dataBlocks:completionHandler: Extended write multiple block command (0x34 command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 65535 inclusively. Valid length is 1 to 65536 inclusively.
        dataBlocks - Blocks of data represented in NSArray of NSData. The number of blocks shall match the length value of the blockRange parameter. Each block element should have identical size and should match the physical block size of the tag.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • fastReadMultipleBlocksWithRequestFlagBlockRangeCompletionHandler

        void fastReadMultipleBlocksWithRequestFlagBlockRangeCompletionHandler​(byte flags,
                                                                      NSRange blockRange,
                                                                      NFCISO15693Tag.Block_fastReadMultipleBlocksWithRequestFlagBlockRangeCompletionHandler completionHandler)
        fastReadMultipleBlocksWithRequestFlag:blockRange:completionHandler: Fast read multiple blocks command (0x2D command code) as defined in ISO15693-3 specification.
        Parameters:
        flags - Request flags.
        blockRange - The range of blocks. Valid start index range is 0 to 255 inclusively. Valid length is 1 to 256 inclusively.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds.

      • getSystemInfoAndUIDWithRequestFlagCompletionHandler

        void getSystemInfoAndUIDWithRequestFlagCompletionHandler​(byte flags,
                                                         NFCISO15693Tag.Block_getSystemInfoAndUIDWithRequestFlagCompletionHandler completionHandler)
        getSystemInfoAndUIDWithRequestFlag:completionHandler: Get system information command (0x2B command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Value of -1 will be returned from dsfid, afi, blockSize, blockCount, or icReference, and a nil UID value if tag response does not contain the information. blockSize returns the actual block size in bytes ranged from 1 to 32. blockCount returns the actual number of blocks ranged from 1 to 256 blocks. 64bits UID value in little endian byte order from the response packet is returned.

      • keyUpdateWithRequestFlagsKeyIdentifierMessageCompletionHandler

        void keyUpdateWithRequestFlagsKeyIdentifierMessageCompletionHandler​(byte flags,
                                                                    long keyIdentifier,
                                                                    NSData message,
                                                                    NFCISO15693Tag.Block_keyUpdateWithRequestFlagsKeyIdentifierMessageCompletionHandler completionHandler)
        keyUpdateWithRequestFlags:message:completionHandler: Key update command (0x36 command code) as defined in ISO15693-3 specification. Please note that in-process reply is returned to the caller without any processing.
        Parameters:
        flags - Request flags.
        keyIdentifier - 8 bits key identifier
        message - Content of the Key Update command as dictated by the Crypto Suite Indicator used in Authenticate.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully command response will be return as NSData object excluding the 8 bits response flag.

      • lockDSFIDWithRequestFlagCompletionHandler

        void lockDSFIDWithRequestFlagCompletionHandler​(byte flags,
                                               NFCISO15693Tag.Block_lockDSFIDWithRequestFlagCompletionHandler completionHandler)
        lockDSFIDWithRequestFlag:completionHandler: Lock DSFID command (0x2A command code) as defined in ISO15693-3 specification. Address flag is automatically enforced by default and the tag's UID is sent with the command; setting RequestFlagSelect to flags will disable the Address flag.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification.

      • readBufferWithRequestFlagsCompletionHandler

        void readBufferWithRequestFlagsCompletionHandler​(byte flags,
                                                 NFCISO15693Tag.Block_readBufferWithRequestFlagsCompletionHandler completionHandler)
        readBufferWithRequestFlags:completionHandler: Read buffer command (0x3A command code) as defined in ISO15693-3 specification.
        Parameters:
        flags - Request flags.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds. A @link NFCErrorDomain @link/ error is returned when there is a communication issue with the tag. A @link NFCISO15693TagResponseErrorKey @link/ in NSError userInfo dictionary is returned when the tag responded to the command with an error, and the error code value is defined in ISO15693-3 specification. Successfully command response will be return as NSData object excluding the 8 bits response flag.

      • sendRequestWithFlagCommandCodeDataCompletionHandler

        void sendRequestWithFlagCommandCodeDataCompletionHandler​(long flags,
                                                         long commandCode,
                                                         NSData data,
                                                         NFCISO15693Tag.Block_sendRequestWithFlagCommandCodeDataCompletionHandler completionHandler)
        sendRequestWithFlag:commandCode:parameters:data:completionHandler: Send a command according to the ISO15693-3 specification. The request data frame is concatenation of 8 bits request flag, 8 bits command code, and optional data. Total length of the data frame cannot exceed 256 bytes. The 8 bits response flag and the data are returned in the completion handler.
        Parameters:
        flags - Request flags.
        commandCode - 8 bits command code.
        data - Data follows after the command code.
        completionHandler - Completion handler called when the operation is completed. error is nil if operation succeeds.