The Bluetooth Service Pack is composed of the following four files:
- BTS file (TIInit_11.8.32.bts)
- ILI file (TIInit_11.8.32.ili)
- XML (TIInit_11.8.32.xml)
- Release Notes Document
- License Agreement
Note the version in the file name is unique for combination of hardware and firmware, but is not updated per release. Version information is updated within the file.
Please start by reading the license agreement and release notes. The service pack files are described below.
- BTS file
- What is a BTS file?
- BTS is an abbreviation for Bluetooth script. The BTS file is a binary file that contains commands and actions for Texas Instruments Bluetooth devices.
HCI communication is a two-way street. For each HCI command sent from the host to a Bluetooth device, the Bluetooth device responds with an HCI event. In order to simplify the format and procedures required to successfully execute these HCI commands, the BTS format is used. The BTS file consists of mandatory initialization scripts and additional platform-dependent, optional commands that are primarily used in the Bluetooth device initialization.
BTS files are distributed under Texas Instruments license. See the accompanying license file for more details.
- BTS functionality.
- The primary usage of the BTS is to trigger the initialization sequence after the Bluetooth device powers up. The initialization script must be executed after every device power-up. BTS initialization scripts contain a section of memory write commands (written code to RAM) that perform as a software patch to fix potential ROM issues of the Bluetooth device. Although this is not the primary purpose of the BTS format, it can also be used in any scenario to load HCI commands to the Bluetooth device. BTS files may also be used for platform-related commands such as to enable deep-sleep mechanism, changing UART baud rate, audio configurations, etc.
Note the BTS file is device specific and will only operate on the WL18xx devices listed below. The latest Bluetooth service pack for a CC256x device can be found in the following link: [https://www.ti.com/tool/CC256XB-BT-SP].
- BTS version number
- The BTS version is kept in ascii format in the BTS file header. It can be read using the HCITester or the Bluetooth ScriptPad applications (part of TI Wireless Tools) or with any hex/ascii editor. Look for the string “Version : TI_P2.xxx”
- The BTS version number is an internal one and is different from the Service Pack version.
- The following table maps between service packs version numbers and BTS version numbers:
SP Version BTS version
Installation and usage
- The BTS file should be copied to the target platform under the following directory: /lib/firmware/. Once the script is copied, the Bluetooth stack will automatically download the script upon Bluetooth power up. For more details on the initialization sequence please refer to the wiki pages below
- ILI file
- The ILI file decodes Bluetooth firmware logger message in a readable format. It is used by the logger tool (see TI Wireless Tools
- XML file
- The XML file describes the vendor specific commands and events, and their parameters. It is used by the HCI Tester application (see TI Wireless Tools) to display the BTS in a user friendly manner.