Locationing

Functions
RFID_STATUS WINAPI	RFID_PerformTagLocationing (RFID_HANDLE32 readerHandle, UINT8 *pTagID, UINT32 tagIDLength, LPANTENNA_INFO lpAntennaInfo, LPVOID rsvd, LPVOID rsvd1)
	This function performs the Tag locationing operation. More...
RFID_STATUS WINAPI	RFID_StopTagLocationing (RFID_HANDLE32 readerHandle)
	This function stops the Tag Locationing operation. More...

Detailed Description

Function Documentation

RFID_PerformTagLocationing()

RFID_STATUS WINAPI RFID_PerformTagLocationing	(	RFID_HANDLE32	readerHandle,
		UINT8 *	pTagID,
		UINT32	tagIDLength,
		LPANTENNA_INFO	lpAntennaInfo,
		LPVOID	rsvd,
		LPVOID	rsvd1
	)

This function performs the Tag locationing operation.

Parameters

[in]	readerHandle	Handle to the RFID device.
[in]	pTagID	Tag locationing operation will be performed on Tag with mentioned TagID.
[in]	tagIDLength	Tag Length.
[in]	lpAntennaInfo	Antenna List on which the Tag locationing operation is to be performed.
[in]	rsvd	Reserved for future use.
[in]	rsvd1	Reserved for future use.

Returns

If the function succeeds the return value is RFID_API_SUCCESS. If the function fails the return value is one of the following:

• RFID_API_INVALID_HANDLE Handle provided is invalid
• RFID_API_PARAM_ERROR Invalid parameter given
• RFID_API_PARAM_OUT_OF_RANGE Parameter out of range [Antenna ID/GPI]
• RFID_INVENTORY_IN_PROGRESS Inventory in progress, cannot perform requested operation
• RFID_ACCESS_IN_PROGRESS Access Operation in progress, cannot perform requested operation
• RFID_TAG_LOCATING_IN_PROGRESS Tag Locating in progress, cannot perform requested operation
• RFID_NXP_EAS_SCAN_IN_PROGRESS NXP EAS SCAN in progress, cannot perform requested operation

Remarks

Locationing information of the tag reported as a result of RFID_PerformTagLocationing can be obtained using RFID_GetReadTag. The application can wait on the event registered for TAG_READ_EVENT before calling RFID_GetReadTag or RFID_GetEventData.

See also

RFID_StopTagLocationing

Remarks

Example:

RFID_HANDLE32 readerHandle;
RFID_STATUS rfidStatus = RFID_API_SUCCESS;
 
if(RFID_API_SUCCESS == RFID_Connect(&readerHandle, NULL, 0, 0, NULL))
{
     READER_CAPS readerCaps;
     // Get the Reader Capability
     rfidStatus = RFID_GetReaderCaps(readerHandle, &readerCaps);
     if(readerCaps.tagLocationingSupported)
     {
         ANTENNA_INFO antennaInfoForTagLocationing;
         LPTAG_DATA pTagData = NULL;
         
         pTagData = RFID_AllocateTag(readerHandle);
         // Give the EPC-id of the tag which you have in Field of View
         //FD02-FDFD-FDFD-FDFD-FDFD-237D
         UINT8 specificTag[12] = {0xFD, 0x02, 0xFD, 0xFD, 0xFD, 0xFD, 0xFD, 0xFD, 0xFD, 0xFD, 0X23, 0X7D};
         UINT32 specificTagIdLength = 12;
         UINT16 antennaList[1] = {1};
         antennaInfoForTagLocationing.pAntennaList = antennaList;
         antennaInfoForTagLocationing.pAntennaOpList = NULL;
         antennaInfoForTagLocationing.length = 1;
         
         // Start performing the Tag locationing operation
         rfidStatus = RFID_PerformTagLocationing(readerHandle, specificTag, specificTagIdLength,
         &antennaInfoForTagLocationing, NULL, NULL);
         if(RFID_API_SUCCESS == rfidStatus)
         {   
             Sleep(10000);
             RFID_StopTagLocationing(readerHandle);
             // Application can ideally wait on the TAG_READ_EVENT before calling RFID_GetReadTag
             while(RFID_API_SUCCESS == RFID_GetReadTag(readerHandle, pTagData))
             {
                if(pTagData->lpLocation != NULL)
                {
                    // Tag locatioin info is available now.
                    printf("\n relative distance = %d", pTagData->lpLocation->relativeDistance);
                }
             }
         }
         RFID_DeallocateTag(readerHandle, pTagData);
     }
     else
     {
         printf("Tag Locationing not supported");
     }
     rfidStatus = RFID_Disconnect(readerHandle);
}

RFID_StopTagLocationing()

RFID_STATUS WINAPI RFID_StopTagLocationing

(

RFID_HANDLE32

readerHandle

)

This function stops the Tag Locationing operation.

Parameters

[in]

readerHandle

Handle to the RFID device.

Returns

If the function succeeds the return value is RFID_API_SUCCESS. If the function fails the return value is one of the following:

• RFID_API_INVALID_HANDLE Handle provided is invalid
• RFID_NO_TAG_LOCATING_IN_PROGRESS There is no Tag locationing operation in progress

Remarks

See also

RFID_PerformTagLocationing

Remarks

Example: See