Thinkify TF7 UHF RFID 915 MHz Module User Manual The TR 200 Desktop RFID Reader
Thinkify LLC UHF RFID 915 MHz Module The TR 200 Desktop RFID Reader
UserManual.wiki
>
Thinkify
>
TF7 User Manual
Manual
Navigation menu
Upload a User Manual
Namespaces
Wiki Guide
HTML
PDF
Info
Views
User Manual
Discussion / Help
Navigation
![Thinkify Reader Protocol OverviewThinkify Reader Protocol OverviewHere we give an overview of the Thinkify Reader Protocol message structure and provide a high-level summary of the major command groups available to the user. The Thinkify Reader Protocol (TRP) is a human-readable ASCII protocol that allows users and applications to set parameters for RF control, tag list acquisition, tag programming, and digital I/O behavior. TRP may also be used to acquire data from the reader and be notified of tag readevents, I/O events, and reader status. TRP is used across all Thinkify reader products and supported hardware interfaces including; RS232, USB, and Ethernet.Command StructureThe Thinkify Reader Protocol uses a Command-Response model. Communication is initiated bythe Host, and the Reader responds with an acknowledgment or data.Users may interact with the reader from a terminal program or their own software using the Thinkify APIs. All that is required is that they send strings to the device over an active connection, and terminate messages correctly. Replies are sent back, often on multiple lines, terminated by a “READY>” prompt.Host CommandsHost commands to the Reader are ASCII strings terminated with a Carriage Return. Line feed characters are ignored by the reader and may be sent without effect. The Reader does not echo commands back to the Host.Valid command messages are composed of numeric characters in the range of 0-9 (0x30 - 0x39), ASCII characters in the range of a..Z (0x41 - 0x7A), and the carriage return character (0x0D). The general format of a Host-to-Reader message is:<COMMAND>[<SUBCOMMAND>[<PARAM1>][<...>][<PARAMn>]]<CR>(here [ ] denotes an element that may be optional)<COMMAND> – Typically a single character. <SUBCOMMAND> – Typically a single character.<PARAMs> – Vary in length and depend on the command being sent. There areno spaces between parameters, if multiple parameters are sent as The TR-65 RFID READER DCN-TF-010045-A14](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-14.png)
![Command Structurepart of a message.<CR> – The Carriage Return character (0x0D).Upon receipt of a carriage return, the Reader will attempt to parse the command message and,if it is properly formatted, execute the command.Reader RepliesThe reply the Reader makes to Host commands are also ASCII strings. Replies may either be a single line or a multi-line reply, depending on the Command. Each line of a reply is terminated with a Carriage Return + Line Feed character pair, CRLF (0x0D,0x0A).When the reader has finished sending all data back to the host in response to the command, it will end the sequence with a “READY>” prompt, indicating that it is prepared to process another message. Generally, after sending a Command, the Host should not send a new command until it sees the "READY>" message.The general format of a Reader-to-Host message is:[STARTMSG<CRLF>]<Line1><CRLF><Line2><CRLF>…<Linen><CRLF>[STOPMSG<CRLF>]<CRLF>READY>(here [ ] denotes an element that may be optional)[STARTMSG] – Indicates the beginning of command processing. Not sent on every command, but is when inventories are performed.<Lines> – Data sent back in response to the command.[STOPMSG] – Indicates command processing is finished. Not sent on every command, but is when where inventories are performed.READY> – Indicates that the reader is ready to accept another command.Special Case: Inventory RepliesWhen the Reader performs a T or Tn command that is setup for infinite repeat, it streams line data until it sees a character from the host. It then terminates the message with the STOPMSG and READY> prompt.The TR-65 RFID READER DCN-TF-010045-A15](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-15.png)
![Command StructureREADY><CRLF>4. Tn Command:The Tn (T1, T2, ...T6) commands repeatedly perform inventories until interrupted by the Host. During this time the Reader streams tag data until a character is received from the Host. The reader then stops the Inventory sequence and terminates the reply.Host:T6<CR>Reader:STARTINVENTORY<CRLF>TAG=3000100000000000000000003582 911750 07 8 9 Q E468<CRLF>TAG=3000100000000000000000003557 911750 04 8 9 I E471<CRLF>TAG=3000100000000000000000003583 911750 06 8 9 Q E47C<CRLF>TAG=3000100000000000000000003557 911750 02 8 9 I E486<CRLF>TAG=3000100000000000000000003557 911750 06 8 9 I E493<CRLF>TAG=3000100000000000000000003568 911750 02 8 9 Q E49D<CRLF>TAG=3000100000000000000000003557 911750 07 9 A I E4A9<CRLF>TAG=3000BBAA99887766554433221100 911750 02 9 A Q E4B4<CRLF>TAG=3000100000000000000000003556 911750 07 7 0 I E4C3<CRLF>TAG=3000100000000000000000003557 911750 00 7 0 Q E4D3<CRLF>TAG=3000100000000000000000003557 911750 05 7 0 Q E4DD<CRLF>TAG=3000100000000000000000003569 911750 06 7 0 I E4ED<CRLF>TAG=3000100000000000000000003583 911750 04 7 0 I E4F5<CRLF>TAG=3000100000000000000000003560 911750 02 7 0 Q E4FD<CRLF>TAG=3000100000000000000000003557 911750 00 7 0 Q E506<CRLF>(Character, such as <SPACE> received from the Host) TAG=3000100000000000000000003569 911750 07 7 1 I E511<CRLF>TAG=3000100000000000000000003557 911750 01 7 1 Q E51C<CRLF>STOPINVENTORY=0x0011 0x00C6<CRLF><CRLF>READY><CRLF>Command GroupsCommands are grouped into four major areas, and described in the following sections.1. Tag [I, K, M, T, X] (for working with RFID tags)2. GPIO & Triggering [G] (for interacting with the reader's GPIO port)3. System [S, V] ( version #, etc.)The TR-65 RFID READER DCN-TF-010045-A17](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-17.png)
!["G" – GPIO Settings"G" – GPIO Settings<G>[<SUBCMD>[<PARAMS>]]The G command and sub-commands are used to control the GPIO port. These may be used toset/retrieve GPIO pin settings or to set the reader up for triggered reading. Using the GT command, the reader may be configured to read tags in any of the supported inventory modes for either a fixed time after an edge transition or while a pin is held in a particular state.Sub-CommandsSubCommandDescription LegalValues forSETGReports current state of input and output lines. -G0 Write Output Port 0 (no Get) 0..1G1 Write Output Port 1 (no Get) 0..1GT Triggering setup for Autonomous ReadingGT<port><active>[<type><action><time>]<port> 0/1 trigger on INPUT0/1<action> 0/1 = disable/enable trigger if <action>=1, then include:<type> 0=posEdge, 1=negEdge,2=posLevel, 3=negLevel<action> 0=T3, 1=T4, 2=T5, 3=T6, 4=T<time> if pos/negEdge only; range is 0x01 to 0xFF in .1sec units (.1 to 25.5 sec)See Description“G” Command ExamplesGet Current I/O StatesREADY>gGPINPUT0=1GPINPUT1=0GPOUTPUT0=0GPOUTPUT1=0Turn Output Port 0 OnREADY>g01GPOUTPUT0=1Get Trigger SettingsREADY>gtTRIGGERTYPE=DISABLEDConfigure Edge Trigger w/Timer// Enable Trigger on INPUT1 (11)// On a positive edge (0)// Perform a T inventory (4)// Read for 1 seconds (0a x .1sec)READY>gt11040aTRIGGERTYPE=POSEDGE PORT1TRIGGERACTION=T 0AThe TR-65 RFID READER DCN-TF-010045-A19](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-19.png)
!["G" – GPIO SettingsTurn the Trigger OffREADY>gt00TRIGGERTYPE=DISABLED“I” – Inventory ControlI[<SUBCMD>[<PARAMS>]]The I command and sub-commands are used to set and get the parameters that control the flow of the Gen2 anti-collision algorithm. Modifications to the default parameters may be helpful in cases where there are a large number of tags in the field or when it is desirable to increase the number of redundant reads for a given tag.Sub-CommandsSub Command DescriptionLegal Valuesfor SETIDisplay all of the Inventory Control settings. -IB When performing a write operation as part of an inventory sequence, a read operation is usually performed before the write. Issue:IB0 to send the read before the write. IB1 to block sending of the read before the write In Blockwrite operations, you may choose to issue a ReqRN command before the Blockwrite. (Needed for NXP G2iL+ block write)Issue:IB2 to turn OFF send REQRN before the BLOCKWRITE.IB3 to turn ON send REQRN before the BLOCKWRITE-IR Reset inventory parameters to values. -II Inner Loop CountEach INNERLOOP runs a tag acquisition STATEMACHINE.0..FFIL Gen2 SEL FlagValue used in QUERY for the SEL field. See G2 spec. Usually set to 0.0..3IO Outer Loop CountNumber of FULL INVENTORY ITERATIONS (one iteration is a SELECT groupand a INNER LOOP group)0..FFIP Outer Loop Pause TimeTime in msec to delay after each outer loop before starting another inventory cycle. (Allows duty cycling for low power applications.) This is a DECIMAL quantity ranging from 0 to 99999 msec.0..99999 (Decimal)The TR-65 RFID READER DCN-TF-010045-A20](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-20.png)
!["K" – Kill, Lock, Access Descriptors"K" – Kill, Lock, Access DescriptorsK[<SUBCMD>[<PARAMS>]]The K family of commands are used to control lock kill and access command behavior. The K commands allow the user to get/set passwords used in kill, lock and access operation and specify lock type for the lock commands.The Kill, Lock and Access commands are described in detail in the EPC Global C1G2 specification: uhf c1g2_standard- version 1.2.0.pdfLockingLocking is one of the more complex activities performed under the Gen2 protocol. As mentioned above, tag memory is divided into different regions or “Banks”. Tag memory may be“locked” where it can only be changed using an access password, or “perma-locked” where it cannot ever be changed again. (Other options, like “perma-unlock” are also available). EPC, TID and User memory are always readable under standard Gen2 – even when those regions are locked. In contrast, Reserved memory, where the Kill and Access passwords are stored, can only be read with the correct access password after that section has been locked. To lock or unlock a tag, first one must have a tag programmed with a non-zero access password written into the correct region of Reserved memory. Then, a Lock command may be issued with a data field representing which region(s) of memory to lock and what type of lock to use (regular or “perma” lock). The data field is a mask, where bits represent memory locations and lock types. (more below).The following options are available for locking: •Read Unlocked – there is unrestricted access to read from this memory •Read Locked – the memory cannot be accessed for reading without using a password •Write Locked – the memory cannot be accessed for writing without using a password •Read Permanently Unlocked – there is unrestricted access to read from this memory and this memory can never be locked •Write Permanently Unlocked – this memory cannot be accessed for writing without a password and this memory can never be locked The TR-65 RFID READER DCN-TF-010045-A22](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-22.png)
![“M" – MASK / SELECT control“M" – MASK / SELECT controlM[<SUBCMD>[<PARAMS>]]As mentioned in the introductory sections, an inventory may begin with the issuance of one or more Gen2 SELECT commands to determine which tags participate in the inventory round.When the Select loop runs (see the IW command) each pass through the loop can issue up to four (4) independent Select commands. The parameters associated with these Select commands are stored in the reader's list of Masks.When the Select is sent, the ACTIVE flag of each of the four masks is examined in order from 0 to 3. If ACTIVE == 1, the MASK is used as part of the Select command.By default, MASK0 is active (ACTIVE FLAG 1) with an ACTION of 0 (all tags to A state) and a LEN of 0×00 (this means “select all tags”). See the G2 specification, table 6.19, for the eight different possible ACTIONS.http://www.epcglobalinc.org/standards/uhfc1g2/uhfc1g2_1_2_0-standard-20080511.pdfBy default, MASK1, MASK2, MASK3 are set to INACTIVE (ACTIVE FLAG == 0).Sub-CommandsSub CommandDescriptionMReport the mask descriptors for all four masks.M<#> Report the mask descriptor for just mask <#>, where <#>=0..3.M<#><...> Set the descriptor for mask <#>, where <#>=0..3. When setting the Mask, the format is:M<#><PARAMS>Where <PARAMS> includes the following :<ACTIVE><TTYPE><ACTION><MEMBANK><LEN><EBVBANK><MASKBYTES><ACTIVE>0=inactive, 1=active<TTYPE>0=use the current Session (see the IS command) 1=use SL 100 flag<ACTION>0-7, usually use 0. See the table, below, for a summary of the eight actions, or the EPCglobal G2 Spec, table 6.20, for more details.The TR-65 RFID READER DCN-TF-010045-A27](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-27.png)
!["T" – Initiate INVENTORY"T" – Initiate INVENTORYTT<MODE>[<LOOPCOUNT>]Attempt to read tags using the current settings.The “T” commandThe T command performs a full dual-nestedloop sequence of: SELECT / QUERY / ACK /REQRN / ACK / XREAD / XWRITE, reportingtags as they are found, performing XDATAoperations, and attempting to force foundtags into the opposite A/B state. All aspectsof this command are controlled by thereader's global inventory control parameters(see the “I” command), and the X datadescriptor parameters (see the “X”command).The parameters of the SELECT sequence sentin each OUTERLOOP are fully controllablethrough the mask commands (see the “M”command). Inclusion, exclusion, choice ofA→B, B→A, etc. are all under user control.The global parameters OUTERLOOP,INNERLOOP, SELECTLOOP, and Q can beover-ridden at the command line entry of thecommand, all other parameters are setglobally through the I and X seriescommands. The T command will start at therequested Q value, but it will adjust Qdepending on whether there are not enough tag responses (Q will be adjusted down) or too many response collisions (Q will be adjusted up).If an OUTERLOOP value is set to 0xFF, then the T command will loop constantly until a character is received on the interface port. The same thing will occur on a T(n) with a loop value of 0xFF (equivalent to no loop value given).The TR-65 RFID READER DCN-TF-010045-A30The ISO-18000-6-C (Gen2) protocol specifies a set of low-level commands that can be used to read and write RFID tags. In practice, much of the detail surrounding how this is done is not important to the enduser of an RFID system – you just care if the reader reports all the tags and that the data you want to write to them gets written correctly. That said, some knowledge of what's going on can be used to optimize a system to improve read performance, programming reliability and efficiency. What you want to optimize depends on what you are trying to do with the RFID tags.In some cases, you want to read a small number of tags very quickly and get lots of repeated reads of the same tag. An example of this might be an application where you are using an RFID tag on a runner to determine when he/she crosses the finish line of a race. The extra reads here are useful for determining the best “crossing time” for the runner.In another case, you care less about the number of redundant reads and more about the number of unique reads you get. An example might be a tool tracking application where you are trying to read all the tagged items within a cabinet and don't want to miss any tags. To handle these and other cases, you can issue a T command in conjunction with the M, I and X commands to fine-tune what is being reported from the tag field and how the reader interacts with the tag population it sees.](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-30.png)
!["T" – Initiate INVENTORYT<n> sub-commands perform the same inventory action as the odd-numbered sub-commands that precede them, except more information is provided in the tag report besides just “Tag=<epc>”:TAG=<epc> <freq> <slot> <Imag> <Qmag> <I/Qdecoded> <timestamp>In all of the T<n> commands, sending the command alone causes the command to execute repeatedly, until a character is received over the interface port. If the T<n> command is followed by an optional one-byte <LOOPCOUNT> parameter, the command executes in a loop the number of times specified by <LOOPCOUNT>. Note that providing a <LOOPCOUNT> value of 0xFF is the same as providing no value - a continuous loop occurs until a character is received on the interface port.SubCommandDescription SpecialFeaturesT1 T1[<LOOPCOUNT>]Sends a QUERY/QUERYREP/ACK sequence.Number of QUERYREPs is determined by the global Q value.No SELECT is sent, so no masking occurs, even with masks active.No SELECTNo XDATAT2 T2[<LOOPCOUNT>]Same as T1, but each tag reports the RF frequency it was acquired on.No SELECT is sent, so no masking occurs, even with masks active.No XDATA processing occurs, even with XDATA DESCRIPTORs active.No SELECTNo XDATAT3 T3[<LOOPCOUNT>]Sends a SELECT/QUERY/QUERYREP/ACK sequence.Number of QUERYREPs is determined by the global Q value.No XDATA processing occurs, even with XDATA DESCRIPTORs active.No XDATAT4 T4[<LOOPCOUNT>]Same as T3, but each tag reports the RF frequency it was acquired on.No XDATA processing occurs, even with XDATA DESCRIPTORs active.No XDATAT5 T5[<LOOPCOUNT>]Same as T3, but XDATA processing occurs for each tag found.This adds REQRN/READ and/or WRITE commands.-T6 T6[<LOOPCOUNT>]Same as T5, but each tag reports the RF frequency it was acquired on.-“T” and “T<n>” Command ExamplesBasic “Get Tags”READY>tSTARTINVENTORYThe TR-65 RFID READER DCN-TF-010045-A32](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-32.png)
!["X" – eXtra Data Read and Write Descriptor Control"X" – eXtra Data Read and Write Descriptor ControlX[<R|W>[<PARAMS>]]Anytime an EPC code is acquired from a tag, an opportunity exists to either read additional data from the tag, or write data to it. These options are controlled by XDATA descriptors managed by the X commands.The TR-65 reader maintains four (4) XDATA read descriptors and four (4) XDATA write descriptors that may be individually configured to perform read/write operations.By default all XDATA descriptors are disabled. When a tag's EPC is decoded, each of the XDATA descriptors are checked for an ACTIVE status, which causes a read/write at the specified location to be performed. Inside an inventory mode which supports XDATA (currently T, T5, and T6) the operations will be performed right after the read of the EPC data, and the data appears on the line of output immediately following the EPC data in the tag stream.Flags<PARAMS> may contain some or all of the following:<#> – Descriptor number<ACTIVE> – Descriptor enabled<MEMBANK> – Tag memory bank for the operation<LEN> – Length (in words) of data to be read/written<EBV> – EBV pointer into memory for the start of the operation<DATA> – The bytes of data to be written.Sub-CommandsSub Command Description Legal Valuesfor SETXR Report all XDATA read descriptors. -XRR Reset all XDATA read descriptors. -XR<#> Report a given XDATA read descriptor. 0..3XR<#><ACTIVE> Set the <ACTIVE> flag for XDATA read descriptor <#>. 0..1XR<#><ACTIVE><...> Configures XDATA read descriptor <#> to perform a read at the specified location and length.XR<#><ACTIVE><MEMBANK><LEN><EBV> <ACTIVE> 0=inactive, 1=active <MEMBANK> 0..3See DescriptionThe TR-65 RFID READER DCN-TF-010045-A35](https://usermanual.wiki/Thinkify/TF7/User-Guide-2407897-Page-35.png)
