Page 1
Unitech RS804 Indy-embeddedapp User Manual Ver. 1.1.1...
Page 2
Revision History Date Version Remark 2020/08/06 0.9.0 First version for indy-embeddedapp ver. 0.9.0-0 2020/08/10 0.9.1 The description of the timer at P.17 is changed. 2020/09/02 1.0.0 Matching the Indy-embeddedapp ver.1.0.0-0 2020/09/14 1.0.1 Hint the steps of disable LLRP/WebAPI service. Introduce Smart Tuner in Configuration. 2020/12/25 1.1.0 Matching the indy-embeddedapp v1.3.0-0.
Page 6
5.4.1. Memory .......................52 5.4.2. Security .......................53 5.5. Back..........................54 About ............................55 Quit ..............................56 Scenarios............................58 8.1. Get an inventory ......................58 8.2. Access a tag in the inventory ..................62...
1.1.1. Hardware 1.1.1.1. RS804 First, you need an RS804 RFID reader that has already connected to an Ethernet, if you haven’t got one, please contact Unitech, we have a great team to support you. Fig. 1. RS804, UHF RFID reader...
As for Windows, we recommend you to use TeraTerm, which inherently supports the SSH and the UTF-8 coding, to emulate a terminal of RS804 by following steps. Enter the IP address of RS804 in the “Host” column, as shown in Fig. 3, then click “OK.” Here we use 192.168.118.46, for instance.
Page 9
Fig. 3. An example of “Host” in TeraTerm Enter the user name of RS804, i.e., “root”, in the “User name” column, as shown in Fig. 4, then click “OK.” Fig. 4. “User name” in TeraTerm The terminal is now ready for use, as shown in Fig. 5. You can also change the font...
Page 10
Fig. 5. Terminal in TeraTerm If you are using Putty, please make sure you set the “Remote character Set” to UTF-8 and check “Enable VT100 line drawing even UTF-8 mode” “ConfigurationWindowTranslation.” You could also turn on the OpenSSH feature of Win10, and then apply the SSH command in PowerShell, though.
1.2. Installation Copy the package of Indy-embeddedapp to “/home/ftp/upload/” of RS804 through the “upload” folder on the FTP server of RS804. Most file managers should have the FTP client feature, in which we use the Windows Explorer on Windows, as shown in Fig.
Fig. 8. The uninstallation of Indy-embeddedapp 1.4. Preparation To prevent the interference while Indy-embeddedapp is using the RFID module, we suggest you disable the LLRP/WebAPI service of RS804 with the following steps, as shown in Fig. 9. >> uci set RFID.@RFID[0].Server=NONE >> uci commit >>...
1.5. Execution To execute Indy-embeddedapp, all you need to do is type the following command in the terminal of RS804, as shown in Fig. 10. After that, the application will start to display as Fig. >> indy-embeddedapp Fig. 10. The command to execute Indy-embeddedapp...
1.6. Control It is very straightforward to control indy-embeddedapp with a keyboard, as you can see in Table 1. Table 1. Description of the control of Indy-embeddedapp Description Arrows Move the cursor, which is being standout, to the option you want. Enter Access the option, or enter a parameter into the option.
2. Menu Once you executed the app, the first screen you see is the “Menu,” as shown in Fig. 12. As the entrance of the application, Menu provides options to access all functions of this application and shows some very essential information. Fig.
Configure the radio module and application. ○ 2 Inventory Get an inventory of all tags nearby. ○ 3 Tag-operation Access a tag and do some operations. ○ 4 About Introduce you to Unitech. ○ 5 Quit Turn off the radio module and leave the application.
3. Configuration The “Configuration” provides you all the necessary options to set up the radio module and the application, as shown in Fig. 16. At the first execution of this application, Configuration would set the radio module and the application with the built-in default setting of this application.
3.1. General The “General” is a part of Configuration, and it has sixteen options to configure the module and application, as shown in the red dot line boxes in Fig. 17, as described in Table 3. ○ ○ ○ ○ ○...
Page 19
Table 3. Description of options of General of Configuration Index Name Description Hotkey ○ Inventory Go to the Inventory part of Configuration. ○ SmartTune Perform SmartTuner for proper parameters. ○ Load-default Set all configurations to its default setting. ○ Back Back to Menu.
15.63 30.21 TR calibration (us) 200.00 85.33 71.11 20.00 33.33 Divide ratio 8.00 21.33 21.33 8.00 21.33 TRExt T-R Modulation Miller-4 Miller-4 Miller-2 LF (kHz) Data-rate (kbps) 62.5 ※ All these settings are subject to the official document of RS804.
The option of Region allows you to select the regulatory region in its sub-options, which subjected to the model of RS804, as shown in Fig. 19, as described in Table 5. After you set this option, it automatically changes the frequency of channels and then enables them according to the regulation.
3.1.3. Channel For any kind of reason, you might sometimes want to fix on a particular channel instead of letting the module circularly switching around the available channels. This Channel option allows you to configure the specific channel you want to fix on, as shown in Fig. 20. In which the available channels are restricted by the regulatory region, as shown in the angle brackets and Table 5.
3.1.6. Detect-antennas The option of Detect-Ant helps you to figure out the connection of all antennas, as shown in Fig. 23. While detecting, this option enables all antennas and changes its text to dot-dot-dot to let you know that it is still processing, as shown in Fig. 24. After detected, this option revises your previous setting to fit the real status of antennas, as shown in Fig.
3.1.9. Inventory-cycles The option of Inventory-cycles allows you to globally configure the inventory cycles of all antennas, as shown in Fig. 28. As we mentioned in section 3.1.8, this option will also ignore the input zero, if the dwell-time is now zero. Fig.
3.2. Inventory The “Inventory” is a part of Configuration, and it has nine options to configure the tag inventory, as shown in the red dot line boxes in Fig. 30, as described in Table 6. ○ ○ ○ ○ ○ ○...
○ Toggle-Target Enable the toggle target mode of the tag inventory. ○ Tag-dead-time Set the duration to declare the disappeared tag as dead. ○ Anti-stall Enable to turn off the failed antenna automatically. 3.2.1. Tag-population The Tag-population option allows you to select the population of your tags in its sub-options, as shown in Fig.
3.2.4. Algorithm The Algorithm option allows you to select the algorithm of the tag inventory from its sub-options, “Fixed-Q” and “Dynamic-Q,” as shown in Fig. 34. Since the two algorithms have their own Q-value, the option remembers it separately and changes the parameter of the Q-value option to match it.
3.2.8. Tag-dead-time The option of Tag-dead-time allows you to decide the duration to declare a disappeared tag as dead, which is indicated by a [X] symbol in the inventory, as shown in Fig. 38. Where the minimum value of this option is suggested to be the dwell time of antennas times the amount of enabled antenna so that you won’t see tags turn dead at every time the module cycles its antennas.
Page 29
Fig. 40. SmartTune of Configuration After Smart-Tuner has tuned the proper settings, it provides three options for you to decide what to do with these settings, as shown in the red dot line boxes in Fig. 41, as described in Table 8.
Table 8. Description of options of SmartTune of Configuration Index Name Description Hotkey ○ Apply Apply the tuned settings. ○ Cancel Discard the tuned settings. ○ Detail Show the detail of tuned settings. 3.3.1. Apply The Smart-Tuner might change the setting of Profile, Channel, LBT, Power-level, Dwell-time, Inventory-cycles, Tag-population, Session, Algorithm, Q-value, and Toggle-Target, Tag-dead-time, which introduced in section 3.1 and 3.2.
3.3.4. Error If an error occurs while tuning, Smart-Tuner will suspend itself, then waiting for your decision, as described in the following sub-sections. 3.3.4.1. Mismatched profile The Smart-Tuner uses profile-5 as the profile of the maximum data rate. If the profile-5 is mismatched, Smart-Tuner will ask you to overwrite the current content of the profile-5 and then keep tuning, as shown in Fig.
Page 32
3.3.4.2. Antenna failure The Smart-Tuner will tell you the index of the failed antenna and then stop the entire tuning process, as shown in Fig. 45. You would have to check or disable the failed antenna using the four Enable-antenna options, as the description in section 3.1.5. Fig.
Fig. 46. An error occurred while tuning 3.4. Load-default The “Load-default” is a part of Configuration, which allows you to retrieve the default setting of all options in Configuration. Since this operation is unrecoverable, this application would ask you to confirm the operation as shown in Fig. 47. Fig.
4. Inventory The “Inventory,” as its name suggests, gives you an inventory of tags and provides you five options to the relative functions, as shown in Fig. 48, as described in...
Page 35
Table 9. In Fig. 48, you can see that Inventory is also telling you the information as the following description: The timer gives you the real execution time of the inventory, and there is only the Clear option that can reset the timer. The temperature gives you the heat of the radio module in Celsius.
Table 9. Description of options of Inventory Index Name Description Hotkey ○ Start Start the inventory. ○ Tag-operation Select a tag from the inventory then do some operations. ○ Clear Clear the inventory and reset the timer. ○ Export Export the inventory as a text file in “/home/ftp/rfid-data/.”...
4.1.1. Stop The Stop option tells the application to stop inventorying tags then wait for it, as shown in Fig. 50. Once Inventory stopped successfully, the screen returns to its main page and shows the average reading rate, as shown in Fig. 51. Fig.
Fig. 51. Stopped Inventory 4.1.2. Error If an error occurs while inventorying, Inventory will stop itself then tell you what is going on and what you can do, as the description in the following sub-sections. 4.1.2.1. Antenna failure There are two types of antenna failure: First, one of two or more antennas ceases to function. In this case, the application will tell you the index of the failed antenna and ask you to disable it, as shown in Fig.
Page 39
Fig. 52. An antenna is failed Fig. 53. All antennas are failed 4.1.2.2. Module overheat Once the temperature of the radio module is over its threshold, the application automatically forcefully suspends the inventory and gives you a notification, as shown in Fig. 54. Surely, you can start the inventory again with the Start option, but do ensure the temperature is cool enough.
Page 40
Fig. 54. The module is overheating 4.1.2.3. Others If any other error happens, the application will also stop the inventory, but give you only an error code without any further information, as shown in Fig. 55. Fig. 55. The module is encountering an error...
Fig. 56, and Fig. 57. If you enter a blank filename, the application will save the inventory with the default name, indyAppInventory.txt. By the way, the folder, “/home/ftp/rfid-data/”, on RS804 is easily accessible by the link, “ftp://<the IP of RS804>/rfid-data/”, to its FTP server, as shown in Fig. 58.
Fig. 58. The exported inventory on the FTP server of RS804 4.3. Clear The Clear option allows you to clear the inventory and reset the timer, as shown in Fig. 59. After you cleared the inventory, the screen will be like the first time you access Inventory, as shown in Fig.
4.4. Tag-operation The Tag-operation option allows you to choose a tag in the inventory, as shown in Fig. 60. As the previous mention, to select the desired tag, you can use Page-Up and Page-Down key to turn pages, use Arrow keys to switch options of tag, and then use Enter key to select the tag. After you selected the tag, the screen turns to the “Tag-operation”...
Page 44
Fig. 61. The “Tag-operation” of Indy-embeddedapp accessed from Inventory...
5. Tag-operation The “Tag-operation” provides you all the necessary options to operate a tag, as shown in Fig. 62. In which, the Log section under the bottom is the operation log that shows the status of every operation. And, this section clears itself every time you access Tag-operation. As the previous description in section 4.4, both Inventory and Menu can access Tag-operation.
Page 46
○ ○ ○ ○ ○ ○ ○ ○ ○ ○ ○ ○ ○ Fig. 63. Options of the “Access” part of Tag-operation Table 10 Description of options of Access of Tag-operation Index Name Description Hotkey ○ Lock Go to the Lock part of Tag-operation. ○...
5.1.1. Antenna-ID The Antenna-ID option allows you to set the desired antenna to operate a tag, which must within the range indicated by the angle brackets, as shown in Fig. 64. If this Tag-operation is accessed from Inventory, the default parameter of this option is the index of the most read antenna.
5.1.5. Offset The Offset option allows you to set the offset of the operating data in the memory bank in 2-bytes word, as shown in Fig. 68 and Fig. 69. Although the angle brackets indicate the range of the input is up to 65535 words, in fact, it also depends on the real size of the memory bank.
5.1.7. Data The Data option allows you to type in data to write or view data from a read, as shown in Fig. 72. And the maximum length of this Data option is also limited by the Length option, which is 32 words.
Page 50
5.1.8.2. Write The Write option allows you to write the data in the buffer of the Data option into the corresponding memory of the tag, as shown in Fig. 74. Fig. 75 shows the data that read back from the User bank, as you can see, the six words length data has correctly existed in the memory with two words offset.
Page 51
Fig. 75. Read back the data after the Write operation 5.1.8.3. Erase The Erase option allows you to do the erase operation to the part of the memory bank, as shown in Fig. 76. Fig. 77 shows the data that read back from the User bank, as you can see, the second to the fifth word of the memory, which is the eighth to twentieth character, is now correctly erase to zero.
Fig. 76. The Erase operation Fig. 77. Read back the data after the erase operation 5.2. Lock The “Lock” is a part of Tag-operation, and it has nine options to configure the operation and then secure the tag, as shown in the red dot line boxes in Fig. 78, as described in Table 11. ○...
Page 53
Fig. 78. Options of the “Lock” part of Tag-operation Table 11. Description of options of Lock of Tag-operation Index Name Description Hotkey ○ Access Go to the Access part of Tag-operation. ○ Kill Go to the Kill part of Tag-operation. ○...
5.2.1. Antenna-ID Please see section 0. 5.2.2. EPC Please see section 5.1.2. 5.2.3. Password Please see section 5.1.3. 5.2.4. Field The Field option allows you to select the field of the memory bank of the tag in its sub-options, as shown in Fig. 79. Fig.
5.2.6. Operation The Set option is the only operation in the Lock part of Tag-operation, which allows you to set the privilege to the field of the tag, as shown in Fig. 81. Fig. 81. The Lock operation...
5.3. Kill The “Kill” is a part of Tag-operation, and it has eight options to configure the operation and then kill the tag, as shown in the red dot line boxes in Fig. 82, as described in Table 12. ○ ○...
5.3.1. Antenna-ID Please see section 0. 5.3.2. EPC Please see section 5.1.2. 5.3.3. Password Please see section 5.1.3. 5.3.4. Kill-password The Kill-Password option allows you to enter the kill-password of the desired tag in a hex string with eight characters, as shown in Fig. 83. Fig.
Fig. 84. The Kill operation 5.4. Errors The two most common errors of Tag-operation are the memory and security issue that described in the following sub-sections. With no worries, the Log section would also show other errors as well. 5.4.1. Memory Like the descriptions in section 0 and 5.1.6, the size of the memory bank of a tag has its limitation.
Fig. 85. Memory location doesn’t exist 5.4.2. Security For instance, when the application attempts to write data to the TID bank whose privilege is “AlwaysUnaccessible,” the Log section returns the error message, “<ERROR> BACKSCATTER: 0x4 - Memory location is locked,” as shown in Fig. 86. Fig.
5.5. Back As we mentioned in section 4.4, both Inventory and Menu can access Tag-operation. Therefore, this Back option of Tag-operation returns you to where you came from, instead of returning you to Menu as all other Back options do.
6. About In “About,” this application introduces a little history of Unitech to you, as shown in Fig. 87, and gives you the necessary information to contact Unitech, as shown in Fig. 88. However, it is highly recommended to go to the website of Unitech, https://www.ute.com/, for further information.
Fig. 88. The information to contact Unitech 7. Quit The Quit option of Menu provides you a general way to close the application, as shown in Fig. 89. After you triggered the Quit option, the application would disable the user interface, turn off the radio module, close the module library, and shut down itself, sequentially.
Page 63
Fig. 89. The “Quit” of Indy-embeddedapp...
8. Scenarios In the following sections, we provide you two most common scenarios while using this application: get an inventory and access a tag of the inventory. 8.1. Get an inventory Start Indy-embeddedapp: Type the command below in the terminal, as shown in Fig.
Page 65
Enable antennas: Sequentially select the option ConfigurationGeneralDetect-Ant to enable all available antennas, as shown in Fig. 92. Then, “Back” to Menu. Fig. 92. Enable antennas Start the inventory: Sequenti ally select the option InventoryStart to start the inventory, as shown in Fig.
Page 66
Stop the inventory: Select the Stop option to stop the inventory once you got the tags you want, as shown in Fig. 94 and Fig. 95. Fig. 94. Stopping the inventory Fig. 95. Stopped the inventory...
Page 67
Fig. 96. Export the inventory Quit the application: “Back” from Inventory and then “Quit” the applic ation. Get the text file of inventory: Download the text file from the FTP server of RS804 with the following link: ftp://<the IP of RS804>/rfid-data/<filename>...
8.2. Access a tag in the inventory Do as the section 8.1.a to 8.1.0 does: The application should now have a screen as Fig. 97. Fig. 97. The Inventory Select a tag: Select the Tag-operation option and then use the Arrow key and Page keys to select the tag you want, as shown in Fig.
Page 69
Write the User bank: First, select the Access option, as shown in Fig. 99. Fig. 99. The Access option Second, sequentially set the option PasswordBankOffsetLength, as shown in Fig. 100, Fig. 101, Fig. 102, and Fig. 103, respectively. Fig. 100. Setting the Password Fig.
Page 70
Fig. 105. The Write option Read the User bank: Set Offset to zero and Length to 32, as shown in Fig. 106. Fig. 106. Set Offset and Length of the data to read Trigger the Read option to read the User bank of the tag, as shown in Fig. 107. Fig.
Need help?
Do you have a question about the RS804 and is the answer not in the manual?
Questions and answers