Perform Access in Sequence

Applicable Devices : RFD40, RFD90, RFD8500

Overview

Runs several access operations, one after the other, on the tags selected by access criteria, using srfidPerformAccessInSequence.

Details

Perform Access in Sequence runs several access operations, one after the other, on the tags selected by access criteria. The helper methods below build the srfidAccessParameters object for each operation.

Create Access Params for Write


-(srfidAccessParameters*)setAccessParamsForWrite:(SRFID_ACCESSOPERATIONCODE)opCode memoryBank:(SRFID_MEMORYBANK)memoryBank offset:(int)offset
 password:(int)password doBlockWrite:(BOOL)doBlockWrite dataToWrite:(NSString*)dataToWrite {

    srfidAccessParameters *accessParams = [[srfidAccessParameters alloc] init];
    accessParams.accessOperationCode = opCode;
    accessParams.memoryBank = memoryBank;
    accessParams.offset = offset;
    accessParams.password = password;
    accessParams.doBlockWrite = doBlockWrite;
    accessParams.dataToWrite = dataToWrite;
    return accessParams;

}

Create Access Params for Lock


-(srfidAccessParameters*)setAccessParamsForLock:(SRFID_ACCESSOPERATIONCODE)opCode memoryBank:(SRFID_MEMORYBANK)memoryBank password:(int)password accPermission:(SRFID_ACCESSPERMISSION)accPermission
{
    srfidAccessParameters *accessParams = [[srfidAccessParameters alloc] init];
    accessParams.accessOperationCode = opCode;
    accessParams.memoryBank = memoryBank;
    accessParams.password = password;
    accessParams.accessPermissions = accPermission;
    return accessParams;
}

Create Access Params for Read


-(srfidAccessParameters*)setAccessParamsForRead:(SRFID_ACCESSOPERATIONCODE)opCode
memoryBank:(SRFID_MEMORYBANK)memoryBank offset:(int)offset length:(int)length password:(int)password {

    srfidAccessParameters *accessParams = [[srfidAccessParameters alloc] init];
    accessParams.accessOperationCode = opCode;
    accessParams.memoryBank = memoryBank;
    accessParams.offset = offset;
    accessParams.length = length;
    accessParams.password = password;
    return accessParams;
}

Perform Access in Sequence

The accessSequence method sets up the access criteria and parameters and starts the sequence with srfidPerformAccessInSequence.

The call only arms the reader. The sequence runs while the start trigger is active, for example the hand-held trigger, and keeps running until it is stopped with srfidAccessSequenceStop or by the stop trigger. Starting a sequence while another is armed fails with the message "Operation In Progress-Command Not Allowed". The result of each operation is delivered in srfidEventReadNotify:, not returned by the call.

The write operation changes the tag. The example writes the tag's own EPC at word 2, so the EPC stays the same. Use a tag you can afford to change if you write any other data. Put an operation that can fail, such as reading the USER memory bank of a tag without user memory, last: the operations after a failed operation do not report a result.


-(void)accessSequence{

    // initialize access criteria
    srfidAccessCriteria *accessCriteria = [[srfidAccessCriteria alloc] init];
    // setup tag filter 1
    srfidTagFilter *tagFilter1 = [[srfidTagFilter alloc] init];
    [tagFilter1 setFilterMaskBank:SRFID_MEMORYBANK_EPC];
    [tagFilter1 setFilterData:@"E2806894000040065071E164"];
    [tagFilter1 setFilterDoMatch:YES];
    [tagFilter1 setFilterMask:@"FFFFFFFF"];
    [tagFilter1 setFilterMaskStartPos:2];
    [tagFilter1 setFilterMatchLength:2];
    [accessCriteria setTagFilter1:tagFilter1];

    NSMutableArray *accessParamsArray = [[NSMutableArray alloc]init];
    [accessParamsArray addObject:[self setAccessParamsForRead:SRFID_ACCESSOPERATIONCODE_READ memoryBank:SRFID_MEMORYBANK_EPC offset:0 length:8 password:0]];
    [accessParamsArray addObject:[self setAccessParamsForRead:SRFID_ACCESSOPERATIONCODE_READ memoryBank:SRFID_MEMORYBANK_TID offset:0 length:2 password:0]];
    [accessParamsArray addObject:[self setAccessParamsForRead:SRFID_ACCESSOPERATIONCODE_READ memoryBank:SRFID_MEMORYBANK_RESV offset:0 length:4 password:0]];
    /* write the tag's own EPC back at word 2 (the EPC starts at word 2), so the tag keeps its EPC */
    [accessParamsArray addObject:[self setAccessParamsForWrite:SRFID_ACCESSOPERATIONCODE_WRITE memoryBank:SRFID_MEMORYBANK_EPC offset:2 password:0 doBlockWrite:NO dataToWrite:@"E2806894000040065071E164"]];
    /* read the USER memory bank last: on a tag without user memory this read fails */
    [accessParamsArray addObject:[self setAccessParamsForRead:SRFID_ACCESSOPERATIONCODE_READ memoryBank:SRFID_MEMORYBANK_USER offset:0 length:0 password:0]];

    SRFID_RESULT result;
    result = [apiInstance srfidPerformAccessInSequence:self->readerID aAccessCriteria:accessCriteria aAccessParameters:accessParamsArray aStatusMessage:nil];
    NSLog(@"Result Perform Access In Sequence %u",result);

}