Pre-filters Configuration

Applicable Devices : RFD40, RFD90, RFD8500 (RFD8500: up to 4 pre-filters; RFD40 and RFD90: up to 32)

Overview

Retrieves and configures the pre-filters of an active RFID reader, which are applied before inventory operations, using srfidGetPreFilters and srfidSetPreFilters.

Details

Pre-filters are same as the select command of C1G2 specification. The SDK supports pre-filters configuration of a particular active RFID reader. When pre-filters are configured, they could be applied prior to inventory operations.

Following parameters could be configured for each pre-filter:

  • Target (Session S0, Session S1, Session S2, Session S3, Select Flag)
  • Action
  • Memory bank (epc, tid, user)
  • Mask start position (in words): indicates start position from beginning of memory bank from where match pattern is checked
  • Match pattern (hexadecimal)
  • Match length (in bits): how many bits of the match pattern are compared. The mask start position is in words, the match length is in bits. For example, the 24 hexadecimal characters of an EPC are 96 bits.

Get Pre-filters

Configured pre-filters could be retrieved from a particular active RFID reader via srfidGetPreFilters API function. The getPrefilterConfig method retrieves the pre-filters and logs the settings of each one.


-(void)getPrefilterConfig{
    /* allocate object for storage of pre filters */
    NSMutableArray *prefilters = [[NSMutableArray alloc] init];
    /* an object for storage of error response received from RFID reader */
    NSString *error_response = nil;
    /* retrieve pre-filters */
    SRFID_RESULT result = [apiInstance srfidGetPreFilters:readerID aPreFilters:&prefilters aStatusMessage:&error_response];
    if (SRFID_RESULT_SUCCESS == result)
    {
        /* pre-filters received */
        NSLog(@"Number of pre-filters: %lu\n", (unsigned long)[prefilters count]);

        for (srfidPreFilter *filter in prefilters)
        {
            NSLog(@"Match pattern: %@\n", [filter getMatchPattern]);
            NSLog(@"Mask start position: %d words\n", [filter getMaskStartPos]);

            SRFID_SELECTACTION action = [filter getAction];
            switch (action) {
                case SRFID_SELECTACTION_INV_A2BB2A_NOT_INV_A__OR__NEG_SL_NOT_ASRT_SL:
                    NSLog(@"Action: INV A2BB2A NOT INV A OR NEG SL NOT ASRT SL\n");
                    break;
                case SRFID_SELECTACTION_INV_A__OR__ASRT_SL:
                    NSLog(@"Action: INV A OR ASRT SL\n");
                    break;
                case SRFID_SELECTACTION_INV_A_NOT_INV_B__OR__ASRT_SL_NOT_DSRT_SL:
                    NSLog(@"Action: INV A NOT INV B OR ASRT SL NOT DSRT SL\n");
                    break;
                case SRFID_SELECTACTION_INV_B__OR__DSRT_SL:
                    NSLog(@"Action: INV B OR DSRT SL\n");
                    break;
                case SRFID_SELECTACTION_INV_B_NOT_INV_A__OR__DSRT_SL_NOT_ASRT_SL:
                    NSLog(@"Action: INV B NOT INV A OR DSRT SL NOT ASRT SL\n");
                    break;
                case SRFID_SELECTACTION_NOT_INV_A2BB2A__OR__NOT_NEG_SL:
                    NSLog(@"Action: NOT INV A2BB2A OR NOT NEG SL\n");
                    break;
                case SRFID_SELECTACTION_NOT_INV_A__OR__NOT_ASRT_SL:
                    NSLog(@"Action: NOT INV A OR NOT ASRT SL\n");
                    break;
                case SRFID_SELECTACTION_NOT_INV_B__OR__NOT_DSRT_SL:
                    NSLog(@"Action: NOT INV B OR NOT DSRT SL\n");
                    break;
            }

            SRFID_SELECTTARGET target = [filter getTarget];
            switch (target) {
                case SRFID_SELECTTARGET_S0:
                    NSLog(@"Target: Session S0\n");
                    break;
                case SRFID_SELECTTARGET_S1:
                    NSLog(@"Target: Session S1\n");
                    break;
                case SRFID_SELECTTARGET_S2:
                    NSLog(@"Target: Session S2\n");
                    break;
                case SRFID_SELECTTARGET_S3:
                    NSLog(@"Target: Session S3\n");
                    break;
                case SRFID_SELECTTARGET_SL:
                    NSLog(@"Target: Select Flag\n");
                    break;
            }

            SRFID_MEMORYBANK bank = [filter getMemoryBank];
            switch (bank) {
                case SRFID_MEMORYBANK_EPC:
                    NSLog(@"Memory Bank: EPC\n");
                    break;
                case SRFID_MEMORYBANK_RESV:
                    NSLog(@"Memory Bank: RESV\n");
                    break;
                case SRFID_MEMORYBANK_TID:
                    NSLog(@"Memory Bank: TID\n");
                    break;
                case SRFID_MEMORYBANK_USER:
                    NSLog(@"Memory Bank: USER\n");
                    break;
                case SRFID_MEMORYBANK_NONE:
                    NSLog(@"MEMORY BANK NONE\n");
                    break;
                case SRFID_MEMORYBANK_ACCESS:
                    NSLog(@"MEMORY BANK ACCESS\n");
                    break;
                case SRFID_MEMORYBANK_KILL:
                    NSLog(@"MEMORY BANK KILL\n");
                    break;
                case SRFID_MEMORYBANK_ALL:
                    NSLog(@"MEMORY BANK ALL\n");
                    break;
            }
        }
    }
    else {
        NSLog(@"Failed to receive pre-filters\n");
    }
}

Set Pre-filters

The srfidSetPreFilters API function is used to configure a new set of pre-filters. The setPrefilterConfig method creates one pre-filter and sets it, which replaces all pre-filters that were set before.


-(void)setPrefilterConfig{
    /* allocate object for storage of pre filters */
    NSMutableArray *prefilters = [[NSMutableArray alloc] init];
    /* an object for storage of error response received from RFID reader */
    NSString *error_response = nil;

    /* create one pre-filter */
    srfidPreFilter *filter = [[srfidPreFilter alloc] init];
    [filter setMatchPattern:@"E28011B0A506007D3DD17A34"];
    [filter setMatchLength:96];
    [filter setMaskStartPos:2];
    [filter setMemoryBank:SRFID_MEMORYBANK_EPC];
    [filter setAction:SRFID_SELECTACTION_INV_A__OR__ASRT_SL];
    [filter setTarget:SRFID_SELECTTARGET_SL];

    [prefilters addObject:filter];

    /* set pre-filters */
    SRFID_RESULT result = [apiInstance srfidSetPreFilters:readerID aPreFilters:prefilters aStatusMessage:&error_response];
    if (SRFID_RESULT_SUCCESS == result) {
        /* pre-filters have been set */
        NSLog(@"Pre-filters has been set\n");
    }
    else if (SRFID_RESULT_RESPONSE_ERROR == result) {
        NSLog(@"Error response from RFID reader: %@\n", error_response);
    }
    else {
        NSLog(@"Failed to set pre-filters\n");
    }
}