2128 Bluetooth^® UHF RFID Reader Downloads

To maximise the battery life of TSL® Readers, the recommendations included in this document should be observed by both customers and distributors/resellers of TSL® products.

To connect a TSL^® Reader to a desktop PC via a USB connection, the necessary Virtual COM Port (VCP) drivers must be downloaded from http://www.ftdichip.com/Drivers/VCP.htm. On that page you can select the appropriate 'setup executable' for your operating system, which will install the drivers for you.

This document provides a comparison of the two available modes of operation (SPP and HID) using Bluetooth^® Wireless Technology.

User Guide for the 2128 Bluetooth^® UHF RFID Reader

The TSL Firmware Loader is used to ensure that your TSL UHF RFID Reader has fully up-to-date firmware. The initial release supports the 2128 Reader, with additional Reader support arriving in future updates.

This document provides details of how to rapidly locate hard to find tagged items using TSL’s tag-finding Apps such as 'RFID Tag Finder' (available for Android™ and Windows Phone) or the Find-a-Tag feature in 'RFID Explorer for iOS'.

A quick guide to help you get started with the 2128 Bluetooth^® UHF RFID Reader. For more in-depth information, please refer to the 2128 User Guide.

User Guide for UHF Smart Wedge ASCII 2 .NET for Windows Desktop.

UHF Smart Wedge ASCII 2 is a solution that converts UHF transponder reads and barcode scans from TSL^® ASCII Protocol UHF readers into keyboard presses. This enables UHF and barcode data to be scanned into legacy applications without any changes to the application.

The document describes the process of updating firmware to a TSL ASCII Protocol Reader.

RFID Web Wedge is designed to insert RFID (or bar-code) data into Web Applications

Version 1.27 Fix for 2173 Bluetooth reset after download

Updated to support the ASCII protocol v2.4.
The install is now digitally signed.

UHF Smart Wedge ASCII 2 is a solution that converts UHF transponder reads and barcode scans from TSL^® ASCII Protocol UHF readers into keyboard presses. This enables UHF and barcode data to be scanned into legacy applications without any changes to the application.

v1.20 fixes a number of issues including reading from user memory

The User Guide can be downloaded here.

Added and updated many new Response Field Headers and Commands.

Added –e option to the .bt command

Starting with Android 12 (API31), there is a requirement for many App permissions to be obtained from the user at run-time. By following the advice provided in this document, owners of the latest Android devices can continue to enjoy using your RFID App with their TSL^® RFID Reader. 

To maximise the battery life of TSL® Readers, the recommendations included in this document should be observed by both customers and distributors/resellers of TSL® products.

TSL® Readers can be operated in Bluetooth® SPP mode where the Reader is controlled by a custom written application or in HID mode, where the Reader behaves like a Bluetooth® Keyboard. This document details how to switch between these modes.

The TSL^® range of Bluetooth^® Readers are able to appear to host devices as an HID keyboard. In this mode the data read by the reader is sent to the host as if it were typed on the host’s keyboard.  This document describes the Bluetooth^® HID mode in more detail.

This document details Log file and Autorun file commands/responses that can be used with TSL®  Readers with a micro-SD card installed.

The new generation of TSL® readers (2128, 2128P and the 2166) support the new FindTag Command (.ft) which
makes tag-finding easier to understand and implement, allowing the reader to do most of the work.

This document recaps the behaviour and operation of UHF transponders with respect to selecting, reading and writing, and provides some examples of how to achieve this with the TSL ASCII 2 Protocol.

It is often necessary to change the existing EPC of a tag to a new value to support either standards-based or custom encoding formats. This document provides examples of how to modify the EPC identifier using the TSL RFID Explorer App.

It is often necessary to change the existing EPC of a tag to a new value to support either standards-based or custom encoding formats. This document provides examples of how to modify the EPC identifier using the TSL ASCII 2 protocol.

Information on enabling Bluetooth^® Auto-Reconnect Mode on iOS Devices.

This Windows application connects to a TSL® RFID Reader (via a USB connection) in order to generate diagnostic information that can be emailed to our Support team. The Virtual COM Port driver must be installed in order for this application to function correctly.

V1.7 - Improved Bluetooth® and RFID tests. Please uninstall previous version before installing this one.

V1.4 - Further Bluetooth® and barcode engine tests added.

HID keyboard mapping file for French Belgian (BE) keyboard layout

HID keyboard mapping file for German (GR) keyboard layout

HID keyboard mapping file for French (FR) keyboard layout

v1.00 First release
v1.01 Fixed mapping for < >

HID keyboard mapping file for United Kingdom (UK) keyboard layout

HID keyboard mapping file for United States (US) keyboard layout

(NB This is the default layout and not normally required)

v1.5.4

Improved some minor bugs

v1.5.3

Added/modified regions: Chile, Colombia
Extended addressing for Read Command
Other minor bug fixes

v1.5.0

Added .iv -at on|off to alert-by-tag (rather than end-of-round)
Added HID mode substrings
Added AF: antenna-firmware to .vr response
New reader bootloader scheme (2128 uses BL3)

v1.4.0

New Singapore regulatory region "sga" (same as old "sg")
Old Singapore regulatory region "sg" region uses lower power (500mW)
Attached terminal can now charge even if reader battery has started flat
Other minor bug fixes

v1.3.9

Added Power Handle battery serial number reports
Added missing QT: header for .rd -qm3

v1.3.8

Fixed issue with HID codes
iAP Bundle ID can now be cleared if required
Added support for unattended updates (app support required)
FindTag (.ft) command now an option on Switch Action (.sa)
Added HID substring support
Added Regulatory Region Brunei (BN)
Modified Regulatory Region Indonsia (ID)

Other minor bug fixes

v1.3.5

Added support for 2102 PowerHandle
Optimised internal tag reports to improve performance
Added optional Phase and Channel reports
Added new FindTag (.ft) command
Added optional Inventory Duplicate Removal (Not IH21. Also needs hardware modification)
Added HID language support
Added Regulatory Region Albania (DZ)
Added support for 2129 Antenna

Other minor bug fixes

The document describes the process of updating firmware to a TSL ASCII Protocol Reader.

Version 3.8.3

• BugFix: SGTIN-96 Indicator digit now displayed in the confirmation message (encoding has always been correct)

Version 3.8.2

• Android: Updated to target Android 10 SDK (API 29)

Version 1.3.3

• Restored the Data Matrix Mirror option - displays 'Cannot be changed' when it is not supported
• Added support for 212P & 2128L
• Improved 2173 images.

v1.3.1

• Added option for Inverse 1D barcode setting
• Removed obsolete Data Matrix Mirrored setting
• Added support for new readers 2173 & 2166
• UI improvements
• Minor bug-fixes

v1.2.0

• For ePop-Loq and USB OTG connected Readers:
  • the Reader will automatically connect when attached
  • the Option screen now includes controls to switch between SPP and HID modes.
•  
• The Reader clock can now be reset to the current time from the Options screen.
• The Options page now provides the ability to change the mode of the ePop-Loq connector on compatible Readers.
• The Select Reader screen list now provides images of available Readers.

Version 2.11.2

• Fixes output power issues with 2128L/IH21L Readers

Version 2.11.1

• UWP: Switching back to the Inventory tab is now quicker.
• BugFix: ASCII encoded Target Tag EPCs with trailing spaces are now better aligned in the EPC Filter screen.
• Other minor bug fixes

Version 2.11.0

• Updated for Android 11.
• Saved Inventory files have a new save location, to comply with Android 11 access restrictions.
• Read/Write page now displays data read from tags as ASCII, when valid.
• Improved the camera permissions handling.
• BugFixes:
•   Terminal Host Barcode scanner is no longer disabled after one scan!
•   Support for built-in barcode scanners in newer Honeywell Terminals.
• Other minor fixes.

v1.5.0

This release is about connecting!

• Support for ePop-Loq readers - snap your ePop-Loq cased terminal onto the TSL Reader and you are ready to go!
  For Bluetooth connections, turn the TSL Reader on and :
• tap the phone/terminal on the Reader's NFC logo or
• scan the TSL Reader's QR code using the dedicated scanner built-in to the Honeywell/Zebra/Datalogic terminal
• Finally, RFID Tag Finder can now be configured using an Intent - see Help for details.

This release introduces an observable connection stateChangedEvent on the AsciiCommander, as replacement for the existing LocalBroadcastManager (which is a deprecated Android API).

The LocalBroadcastManager support remains in this release to allow developers time to transition to the new approach.

The Inventory project has been updated to demonstrate the new connection stateChanged events

This release also addresses an issue that caused barcodes to be truncated when they contained line terminators 0x0D or 0x0A.

The Rfid.AsciiProtocol JavaDocs have also been updated to provide searchable content.

This release provides compatibility with the Google 2022 API requirements for Android (API Level 31).

The sample project in the SDK release has been updated to use the Tsl.AsciiProtocol v1.6.0 NuGet package – which is required when targeting API level 31+.

When Android 12+ or later is targeted, the following permissions must be both declared in the AndroidManifest.xml and obtained at runtime:

• Manifest.Permission.BluetoothConnect
• Manifest.Permission.BluetoothScan

Until these runtime permissions are obtained from the user, no Bluetooth® devices will be available.

We provide an example of how to obtain these permissions in the Sample.Connections.Forms.Android sample project.

The v1.6.0 release of the TSL iOS SDK is here! With a new FindTag Sample project (implemented in Swift/SwiftUI) and an updated framework supporting ASCII Protocol 2.5, this release is a significant upgrade to our iOS SDK.

New commands include:
TSLFindTagCommand (for series 21xx Readers) - controls the Reader's tag finder operation
TSLBlockPermalockTransponderCommand - to allow tags to be block permalocked
TSLAutorunCommand - allows the SD-Card's 'auto.txt' file to be read, written or deleted.

The latest TSLAsciiCommands framework is now available in the new XCFramework format for Xcode 12 users. We have also audited the API to improve type-safety in Swift apps.

Finally, the included documentation has been completely overhauled and now provides a fresh, modern look, an updated 'Getting Started' section, improved enum type documentation and both ObjC and Swift interfaces for all commands.

*The v1.6.1 update provides XCFramework ObjC project compatibility and minor documentation updates.

The Developer Resources Pack contains images of our readers, for use in applications developed to support our readers.   

Terms of Use
The images in this bundle and the rights pertaining to them, including copyright and ownership, are the sole and exclusive property of Technology Solutions (UK) Ltd 2020.  The images in this bundle are only provided for use in Mobile or Desktop applications that connect to the TSL Reader depicted in the image. No other use is authorised.

The v1.2 release of the TSL cross-platform, Xamarin SDK (for PCL-based projects) is now available. This release uses the Tsl.AsciiProtocol PCL library v1.3.6 (available via NuGet) which contains many new features including:

• Full support for ASCII Protocol 2.5 - including the new FindTagCommand to simplify the implementation of tag finding.
• USB support for UWP-based projects
• A new connection mechanism (AsciiTransportsManager) while retaining ReaderConnectionManager to maintain full backwards compatibility with existing projects.
• Sequencing of synchronously executed ExecuteCommand() calls to eliminate cross thread "Command is already executing" exceptions
• New Bluetooth pairing support via the BluetoothSecurity class
• HostBarcodeHandler a helper class to initiate a barcode scan on the terminal from reader trigger for supported terminals

The Sample Projects, in this release, have all been updated to demonstrate USB support for UWP Apps and fix minor bugs. The new, cross-platform, .NET Standard SDK will be released shortly and we recommend that it is used for all new projects.