TMR_Reader encapsulates a connection to a ThingMagic RFID reader device and provides an interface to perform RFID operations such as reading tags and writing tag IDs.
Reads can be done on demand, with the TMR_read() function, or continuously in the background with the TMR_startReading() function. Background reads notify registered listeners of tags that are read.
Operations which take an argument for a tag to operate on may optionally be passed a NULL argument. This lets the reader choose what tag to use, but may not work if multiple tags are present. This use is recommended only when exactly one tag is known to be in range.
| TMR_Status TMR_addAuthReqListener | ( | struct TMR_Reader * | reader, |
| TMR_AuthReqListenerBlock * | block | ||
| ) |
Add a listener to the list of functions that will be called for each background tag read.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
| TMR_Status TMR_addReadExceptionListener | ( | struct TMR_Reader * | reader, |
| TMR_ReadExceptionListenerBlock * | block | ||
| ) |
Add a listener to the list of functions that will be called for each error that occurs during background tag reading.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
Definition at line 493 of file tm_reader_async.c.
| TMR_Status TMR_addReadListener | ( | struct TMR_Reader * | reader, |
| TMR_ReadListenerBlock * | block | ||
| ) |
Add a listener to the list of functions that will be called for each background tag read.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
Definition at line 1245 of file tm_reader_async.c.
| TMR_Status TMR_addStatsListener | ( | struct TMR_Reader * | reader, |
| TMR_StatsListenerBlock * | block | ||
| ) |
Add a listener to the list of functions that will be called for each background status response.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
Definition at line 1358 of file tm_reader_async.c.
| TMR_Status TMR_addStatusListener | ( | struct TMR_Reader * | reader, |
| TMR_StatusListenerBlock * | block | ||
| ) |
Add a listener to the list of functions that will be called for each background status response.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
| TMR_Status TMR_addTransportListener | ( | TMR_Reader * | reader, |
| TMR_TransportListenerBlock * | block | ||
| ) |
Add a listener to the list of functions that will be called for each message sent to or recieved from the reader.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
Definition at line 730 of file tm_reader.c.
| TMR_Status TMR_connect | ( | struct TMR_Reader * | reader | ) |
Establishes the connection to the reader at the URI specified in the TMR_create() call. The existence of a reader at the address is verified and the reader is brought into a state appropriate for performing RF operations.
| reader | The reader to connect |
Connecting to existing reader should succeed.
Connecting to nonexisting reader should fail.
| TMR_Status TMR_create | ( | TMR_Reader * | reader, |
| const char * | deviceUri | ||
| ) |
The TMR_Reader struct being initialized should be preallocated by the user. No memory is allocated during the initialization process, and the reader is not contacted at this point.
| reader | The TMR_Reader structure to initialize |
| deviceUri | an identifier for the reader to connect to, with a URI syntax. The scheme can be eapi for the embedded module protocol, rql for the request query language, or tmr to guess. The remainder of the URI identifies the stream that the protocol will be spoken over, either a local host serial port device or a TCP network port. Example URIs are:
|
Call with valid URI should not fail.
Call with invalid URI should fail.
Definition at line 122 of file tm_reader.c.
| TMR_Status TMR_create_alloc | ( | TMR_Reader ** | readerPointer, |
| const char * | deviceUri | ||
| ) |
This function is a version of TMR_create() that dynamically allocates the TMR_Reader structure and stores the pointer in *reader.
| [out] | readerPointer | Pointer to the TMR_Reader* in which to place the pointer to the newly allocated reader structure. @ |
| deviceUri | As described in TMR_create(). |
Call with valid URI should not fail.
Call with invalid URI should fail.
Multiple calls with different URIs should return distinct objects.
Definition at line 111 of file tm_reader.c.
| TMR_Status TMR_destroy | ( | TMR_Reader * | reader | ) |
Closes the connection to the reader and releases any resources that have been consumed by the reader structure.
| reader | The reader to shut down. |
Destroying existing connected reader should succed.
Destroying existing unconnected reader should succeed.
Destroying already-destroyed reader should fail.
Destroying reader allocated by TMR_create_alloc() should free the allocated memory.
| TMR_Status TMR_executeTagOp | ( | struct TMR_Reader * | reader, |
| TMR_TagOp * | tagop, | ||
| TMR_TagFilter * | filter, | ||
| TMR_uint8List * | data | ||
| ) |
This method provides the direct execution of TagOp commands Reader operates on the first tag found, with applicable tag filtering Reader stops and the call returns immediately after finding one tag and operating on it, unless the command timeout expires first The operation is performed on the antenna specified in /reader/tagop/antenna parameter /reader/tagop/protocol specifies the protocol to be used
| reader | The reader being operated on | |
| tagop | Pointer to the TMR_TagOp which needs to be executed | |
| filter | Tag Filter to be used | |
| [out] | data | Data returned as a result of tag operation |
| TMR_Status TMR_firmwareLoad | ( | TMR_Reader * | reader, |
| void * | cookie, | ||
| TMR_FirmwareDataProvider | provider | ||
| ) |
The TMR_firmwareLoad() method attempts to install firmware on the reader, then restart and reinitialize.
| reader | The reader to operate on |
| cookie | Value to pass to the callback function. |
| provider | Callback function to provide firmware data. |
| TMR_Status TMR_getNextTag | ( | TMR_Reader * | reader, |
| TMR_TagReadData * | tagData | ||
| ) |
Fetches the next tag from the last TMR_read() operation.
| reader | The reader being operated on | |
| [out] | tagData | The TMR_TagReadData structure to fill. |
Call should fail before a read() call.
Call should fail after a read() call that set *tagCount to zero.
Call should fill in a tag after a read() call that set *tagCount to a nonzero value.
Call should succeed exactly as many times as specified by *tagCount.
| TMR_Status TMR_gpiGet | ( | TMR_Reader * | reader, |
| uint8_t * | count, | ||
| TMR_GpioPin | state[] | ||
| ) |
Get the state of all GPI pins.
| reader | The reader to operate on. | |
| [in] | count | Pointer to the allocated length of the state array. |
| [out] | count | Pointer to the number of entries in the state array. |
| [out] | state | Array of reader pins and the state to set them to. |
| TMR_Status TMR_gpoSet | ( | TMR_Reader * | reader, |
| uint8_t | count, | ||
| const TMR_GpioPin | state[] | ||
| ) |
Set the state of some GPO pins.
| reader | The reader to operate on. |
| count | The length of the state array. |
| state | Array of reader pins and the state to set them to. |
| TMR_Status TMR_hasMoreTags | ( | TMR_Reader * | reader | ) |
| TMR_SUCCESS | if there are more tags to be retrieved from the most recent TMR_read() operation. |
| TMR_ERROR_NO_TAGS | if no more tags are available for retrieval. |
| Other | TMR_ERRORs when appropriate. |
| reader | The reader being operated on |
Call should return false before a read() call.
Call should return false after a read() call that set *tagCount to zero.
Call should return true after a read() call that set *tagCount to a nonzero value.
Call should return true through exactly as many getNextTag() calls as specified by *tagCount.
| TMR_Status TMR_loadConfig | ( | struct TMR_Reader * | reader, |
| char * | filePath | ||
| ) |
This funcution loads the reader configuration parameters from file and applies to module.
| reader | The reader to operate on. |
| filePath | load reader configurations from filepath. |
Definition at line 2378 of file tmr_loadsave_configuration.c.
| TMR_Status TMR_paramGet | ( | struct TMR_Reader * | reader, |
| TMR_Param | key, | ||
| void * | value | ||
| ) |
Get the value of a reader parameter.
| reader | The reader to operate on. | |
| key | The string identifying the parameter. | |
| [out] | value | Pointer to the parameter value. For list types (including TMR_String), the caller must allocate the pointed-to space and set the size of the allocated space in the max field, and the function will write into that space and set the actual length of the data. If the list or string is larger than will fit in the pointed-to space, the length will be larger than the allocated space - be careful iterating over the results if there is a chance of not passing in a large enough structure. |
Call should fail if key is an invalid parameter name.
Call should fail if key is valid but unsupported by connected reader.
Call should succeed if key matches parameter name, independent of case.
Definition at line 690 of file tm_reader.c.
| TMR_Param TMR_paramID | ( | const char * | name | ) |
Return the TMR_Param ID corresponding to a string name. Only present if TMR_ENABLE_PARAM_STRINGS is set.
| name | the parameter |
| TMR_Status TMR_paramList | ( | struct TMR_Reader * | reader, |
| TMR_Param * | keys, | ||
| uint32_t * | len | ||
| ) |
Get a list of the parameters available
Supported Parameters:
| reader | The reader to operate on. | |
| [out] | keys | Pointer to the list of parameters. The caller must allocate space for the parameters. |
| [in] | len | Pointer to the allocated length of the space pointed to by keys. |
| [out] | len | Pointer to the number of parameters supported by the reader, which may be larger or smaller than the provided array. If it is larger than the provided array, the list is truncated. |
Get a list of the parameters available pointer of reader object pointer of TMR_Param pointer to uint32_t
Definition at line 3566 of file tm_reader.c.
| const char* TMR_paramName | ( | TMR_Param | key | ) |
Return the string name corresponding to a TMR_Param value. Only present if TMR_ENABLE_PARAM_STRINGS is set.
| key | The parameter ID. |
| TMR_Status TMR_paramSet | ( | struct TMR_Reader * | reader, |
| TMR_Param | key, | ||
| const void * | value | ||
| ) |
Set the value of a reader parameter.
| reader | The reader to operate on. |
| key | The string identifying the parameter. |
| value | The new value to use for the parameter. The caller may not alter the value after passing it to this function. |
Call should fail if key is an invalid parameter name.
Call should fail if key is valid but unsupported by connected reader.
Call should succeed if key matches parameter name, independent of case.
Definition at line 656 of file tm_reader.c.
| TMR_Status TMR_read | ( | TMR_Reader * | reader, |
| uint32_t | timeoutMs, | ||
| int32_t * | tagCount | ||
| ) |
Search for tags for a fixed duration. Once this returns, the tags are retrieved by calling TMR_getNextTag() until TMR_hasMoreTags() returns false.
| reader | The reader being operated on | |
| timeoutMs | The number of milliseconds to search for tags | |
| [out] | tagCount | The number of tags read, or -1 if the number is unknown. If NULL, no value will be stored. |
Call should fail if reader is not connected.
If call is successful as per TMR_Error, *tagCount should be modified and contain a positive value.
| TMR_Status TMR_readIntoArray | ( | struct TMR_Reader * | reader, |
| uint32_t | timeoutMs, | ||
| int32_t * | tagCount, | ||
| TMR_TagReadData * | result[] | ||
| ) |
Wrapper routine that searches for tags, allocates space for the results, and returns the results in a single array.
| reader | The reader being operated on | |
| timeoutMs | The number of milliseconds to search for tags | |
| [out] | tagCount | The number of tags found and the size of the allocated array. |
| [out] | result | The array of tag read data. |
Call should fail if reader is not connected.
If call is successful as per TMR_Error, *tagCount should be modified and contain a positive value, and *result should be modified and contain the corresponding number of tag read values.
Out param "result" should be freed after using it.
Definition at line 471 of file tm_reader.c.
| TMR_Status TMR_readTagMemBytes | ( | TMR_Reader * | reader, |
| TMR_TagFilter * | target, | ||
| uint32_t | bank, | ||
| uint32_t | byteAddress, | ||
| uint16_t | byteCount, | ||
| uint8_t | data[] | ||
| ) |
Read 8-bit bytes from the memory bank of a tag.
| reader | The reader being operated on. | |
| target | The tag to read from, or NULL. | |
| bank | The tag memory bank to read from. | |
| byteAddress | The byte address to start reading at. | |
| byteCount | The number of bytes to read | |
| [out] | data | The read data. |
| TMR_Status TMR_readTagMemWords | ( | TMR_Reader * | reader, |
| TMR_TagFilter * | target, | ||
| uint32_t | bank, | ||
| uint32_t | wordAddress, | ||
| uint16_t | wordCount, | ||
| uint16_t | data[] | ||
| ) |
Read 16-bit words from the memory bank of a tag.
| reader | The reader being operated on. | |
| target | The tag to read from, or NULL. | |
| bank | The tag memory bank to read from. | |
| wordAddress | The word address to start reading at. | |
| wordCount | The number of words to read | |
| [out] | data | The read data. |
| TMR_Status TMR_reboot | ( | struct TMR_Reader * | reader | ) |
Reboot the reader
| reader | The reader to operate on. |
| TMR_Status TMR_removeReadExceptionListener | ( | struct TMR_Reader * | reader, |
| TMR_ReadExceptionListenerBlock * | block | ||
| ) |
Remove a listener from the list of functions that will be called for each error that occurs during background tag reading.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
| TMR_Status TMR_removeReadListener | ( | struct TMR_Reader * | reader, |
| TMR_ReadListenerBlock * | block | ||
| ) |
Remove a listener from the list of functions that will be called for each background tag read.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
| TMR_Status TMR_removeStatsListener | ( | struct TMR_Reader * | reader, |
| TMR_StatsListenerBlock * | block | ||
| ) |
Remove a listener from the list of functions that will be called for each background status response.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
| TMR_Status TMR_removeStatusListener | ( | struct TMR_Reader * | reader, |
| TMR_StatusListenerBlock * | block | ||
| ) |
Remove a listener from the list of functions that will be called for each background status response.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
| TMR_Status TMR_removeTransportListener | ( | TMR_Reader * | reader, |
| TMR_TransportListenerBlock * | block | ||
| ) |
Remove a listener from the list of functions that will be called for each message sent to or recieved from the reader.
| reader | The reader to operate on. |
| block | A structure containing a pointer to the listener function and a user-supplied cookie value to pass to the function when called. |
Definition at line 741 of file tm_reader.c.
| TMR_Status TMR_saveConfig | ( | struct TMR_Reader * | reader, |
| char * | filePath | ||
| ) |
This funcution saves the current reader configuration parameters and its values to a file.
| reader | The reader to operate on. |
| filePath | save reader configurations from filepath. |
Definition at line 2324 of file tmr_loadsave_configuration.c.
| TMR_Status TMR_setSerialTransport | ( | char * | scheme, |
| TMR_TransportNativeInit | nativeInit | ||
| ) |
Stores the transport init function againest the provided scheme.
| scheme | the transport schme name. |
| nativeInit | reference to the init function. |
Currently set serial transport is only supported for serial readers only.
Definition at line 349 of file tm_reader.c.
| TMR_Status TMR_startReading | ( | struct TMR_Reader * | reader | ) |
Start reading tags in the background. The tags found will be passed to the registered read listeners, and any errors that occur during reading will be passed to the registered exception listeners. Reading will continue until stopReading() is called. The read listeners will be called from a background thread.
| reader | The reader to operate on. |
Definition at line 59 of file tm_reader_async.c.
| TMR_Status TMR_STATS_init | ( | TMR_Reader_StatsValues * | stats | ) |
This funcution will initialize the TMR_StatValues structure with the default values
Initialize a TMR_StatValues structure with the default vales
| stats | Pointer to the TMR_StatValues structure to initialize. |
Definition at line 1181 of file tm_reader.c.
| TMR_Status TMR_stopReading | ( | struct TMR_Reader * | reader | ) |
Stop reading tags in the background. This function will wait until the reader has stopped.
| reader | The reader to operate on. |
Definition at line 331 of file tm_reader_async.c.
| const char* TMR_strerr | ( | TMR_Reader * | reader, |
| TMR_Status | status | ||
| ) |
This function will convert the error codes into proper error messages.
| reader | The reader which resulted in error |
| status | The status code which is to be converted |