Initialization

Functions
RFID_STATUS WINAPI	RFID_ConnectW (RFID_HANDLE32 *pReaderHandle, WCHAR *pHostName, UINT32 port, UINT32 timeoutMilliseconds, LPCONNECTION_INFO lpConnectionInfo)
	This function establishes an LLRP connection to an RFID reader and returns a handle on successful connection. More...
RFID_STATUS WINAPI	RFID_ConnectA (RFID_HANDLE32 *pReaderHandle, CHAR *pHostName, UINT32 port, UINT32 timeoutMilliseconds, LPCONNECTION_INFO lpConnectionInfo)
RFID_STATUS WINAPI	RFID_Reconnect (RFID_HANDLE32 readerHandle)
	This function reconnects to the reader if a previous connection had been lost. More...
RFID_STATUS WINAPI	RFID_AcceptConnection (RFID_HANDLE32 *pReaderHandle, SOCKET_HANDLE readerSocket, LPSERVER_INFO lpServerInfo, LPVOID rsvd)
	This function accepts an LLRP connection from an RFID reader running in server mode and returns a handle. More...

Detailed Description

Function Documentation

RFID_ConnectW()

RFID_STATUS WINAPI RFID_ConnectW	(	RFID_HANDLE32 *	pReaderHandle,
		WCHAR *	pHostName,
		UINT32	port,
		UINT32	timeoutMilliseconds,
		LPCONNECTION_INFO	lpConnectionInfo
	)

This function establishes an LLRP connection to an RFID reader and returns a handle on successful connection.

Parameters

[in]	pReaderHandle	Pointer to Handle to the RFID device.
[in]	pHostName	String containing the reader's host name. Can be NULL for device-based readers like MC, where the Dll connects to local-host.
[in]	port	Port number, if specified as zero (0), the default port 5084 will be used.
[in]	timeoutMilliseconds	Time out for the response from the Reader, if specified zero(0), the default time out 5000 (5sec) will be used. The lowest possible value could be 2sec. This value also translates to keep-alive timeout. If the connection to the reader was inactive (no keep-alive message from the Reader) for a time greater than 10 times the timeout, DISCONNECTION_EVENT will be triggered to the application, if the application has registered for the same.
[in]	lpConnectionInfo	Information regarding the connection with the reader.

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_COMM_OPEN_ERROR Unable to open connection with reader
• RFID_COMM_CONNECTION_ALREADY_EXISTS Another Connection exists
• RFID_COMM_RESOLVE_ERROR Unable to resolve IP or Host Name

Remarks

None

See also

RFID_Disconnect

Remarks

Example:

RFID_HANDLE32 readerHandle;
RFID_STATUS rfidStatus = RFID_API_SUCCESS;
READER_ID readerId;
VERSION_INFO versionInfo;
 
if(RFID_API_SUCCESS == RFID_Connect(&readerHandle, TEXT("157.235.207.190"), 0, 0, 0))
{
       // Set trace level
       rfidStatus = RFID_SetTraceLevel(readerHandle, TRACE_LEVEL_ALL);
       // Get DLL Version
       RFID_GetDllVersionInfo(&versionInfo);
       printf("\n Dll Verison: %S", versionInfo.dllVersion);
       
       // Do something - Configurations, Capabilities, Inventory, Access
       rfidStatus = RFID_Disconnect(readerHandle);
}

RFID_ConnectA()

RFID_STATUS WINAPI RFID_ConnectA	(	RFID_HANDLE32 *	pReaderHandle,
		CHAR *	pHostName,
		UINT32	port,
		UINT32	timeoutMilliseconds,
		LPCONNECTION_INFO	lpConnectionInfo
	)

RFID_Reconnect()

RFID_STATUS WINAPI RFID_Reconnect

(

RFID_HANDLE32

readerHandle

)

This function reconnects to the reader if a previous connection had been lost.

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_COMM_OPEN_ERROR Unable to open connection with reader
• RFID_COMM_CONNECTION_ALREADY_EXISTS Another Connection exists
• RFID_COMM_RESOLVE_ERROR Unable to resolve IP or Host Name
• RFID_RECONNECT_FAILED Unable to Reconnect to reader. The Reader state might have changed. Attempt Connect API instead of Reconnect API.

Remarks

None

See also

RFID_Disconnect

Remarks

None.

RFID_AcceptConnection()

RFID_STATUS WINAPI RFID_AcceptConnection	(	RFID_HANDLE32 *	pReaderHandle,
		SOCKET_HANDLE	readerSocket,
		LPSERVER_INFO	lpServerInfo,
		LPVOID	rsvd
	)

This function accepts an LLRP connection from an RFID reader running in server mode and returns a handle.

Parameters

[out]	pReaderHandle	Pointer to Handle to the RFID device.
[in]	readerSocket	Socket Handle to the reader initiated connection
[in]	lpServerInfo	Pointer to ServerInfo parameters(timeout and version info)
[in]	rsvd	Reserved for future use

Returns

If the function succeeds, the return value is RFID_API_SUCCESS If the function fails, the return value is RFID_INVALID_SOCKET an unconnected socket handle is passed RFID_API_PARAM_OUT_OF_RANGE timeout passed is less than 2 seconds(However, zero corresponds to a valid timeout- default LLRP timeout) RFID_API_PARAM_ERROR the version info passed is RFID_VERSION_5_0;

Remarks

This API accepts the socket handle of the reader connection and returns a readerhandle for this connection whose disconnection and command timeouts are configured from the timeout parameter of the serverInfo structure

See also

RFID_Connect, RFID_Disconnect, RFID_Reconnect

Remarks

Example:

RFID_HANDLE32 readerHandle;
SERVER_INFO serverInfo;
serverInfo.timeoutMilliseconds = 2000;
serverInfo.version = RFID_API3_5_1;
RFID_STATUS rfidStatus = RFID_API_SUCCESS;
READER_CAPS readerCaps;
SOCKET  listeningSocket, acceptedSocket;
 
// Initialize Winsock.
WSADATA wsaData;
int iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
 
// Create a SOCKET for listening for incoming connection requests.
listeningSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
if (listeningSocket == INVALID_SOCKET)
{
    WSACleanup();
    return;
}
sockaddr_in service;
service.sin_family = AF_INET;
service.sin_addr.s_addr = INADDR_ANY;
service.sin_port = htons(5084);
if (bind(listeningSocket, (SOCKADDR*) &service, sizeof(service)) == SOCKET_ERROR)
{
    closesocket(listeningSocket);
    return ;
}
// Connect from a reader to the local IP address at the same LLRP port.The Socket Connection is accepted here and
// passed to RFID_AcceptConnection to get the ReaderHandle
//
if (listen(listeningSocket, 2) == SOCKET_ERROR)
   return;
acceptedSocket = accept(listeningSocket, NULL, NULL);
 
if(RFID_API_SUCCESS == RFID_AcceptConnection(&readerHandle, acceptedSocket, &serverInfo, NULL))
{
     // Set trace level
     rfidStatus = RFID_SetTraceLevel(readerHandle, TRACE_LEVEL_ALL);
     // Do something - Configurations, Capabilities, Inventory, Access
     rfidStatus = RFID_GetReaderCaps(readerHandle, &readerCaps);
     printf(" The model name of connected reader is %S", readerCaps.modelName);
     rfidStatus = RFID_Disconnect(readerHandle);
}