TSI Introduction

The TLSR8258F512 is Telink-developed Bluetooth LE + IEEE802.15.4 multi-standard wireless SoC solution with internal Flash and audio support, which combines the features and functions needed for all 2.4GHz IoT standards into a single SoC. It's completely RoHS-compliant and 100% lead(pb)-free.

The TLSR8258F512 integrates a power-balanced 32-bit MCU, BLE/802.15.4/2.4GHz Radio, 64KB(16k+8k+8k+32k)SRAM,512KB Flash, 14bit ADC with PGA, analog and digital microphone input, stereo audio output, 6-channel PWM(1-channel IR/IR FIFO/IR DMA FIFO), one quadrature decoder(QDEC),abundant and flexible GPIO interfaces, and nearly all the peripherals needed for IoT(Internet of Things) and HID(Human Interface Devices) application development(e.g. Bluetooth Low Energy and Zigbee/IEEE 802.15.4/RF4CE). The TLSR8258F512 also includes multi-stage power management design allowing ultra-low power operation and making it the ideal candidate for wearable and power-constraint applications.

With the high integration level of TLSR8258F512, few external components are needed to satisfy customers' ultra-low cost requirements.

This manual is mainly to help developer master functions of all modules quickly and develop the relative application based on these functions

Overview

The Telink-semi Software Interface(TSI) is a serials of application interface(API), which includes all functions this SoC support nearly. Besides, it also offer many examples to help developer have a better understanding of these functions. More details about these module will be descripted in the following page.

The TSI Components are:

Block Diagram of the Software

Coding Rules

The TSI uses the following essential coding rules and convetions:

  • Compliant with ISO C90 + GNU extensions.
  • Support 3 kinds of data type: 32-bit words,16-bit halfwords and 8-bit bytes.
  • Support Simple addressing mode:16-bit of instruction operation and 32-bit of data operation.
  • Support single instruction hardware multiplication operation.
  • Load/Store Structure:data processing by register not Storage unit

In addition, the TSI recommends the following conventions for identifiers:

  • reg__xxx<obj>__xxx<op> names to identify Core Registers, Periphreal Registers, and other Registers.
  • xxx<obj>__xxx<op>__xxx<rel> names to identify function names.
  • UPPERCASE names to identify macro definition and enum value.
  • tl_xxx names to identify variables in drivers based on Telink MCU.

The TSI is documented within the source files with:

  • commnets that use the C or C++ style.
  • Doxygen compliant function commnets that provide:
    • brief function overview.
    • detailed description of the function.
    • detailed parameter explanation.
    • detailed inforamation about return values.

Doxygen comment example:

Doxygen file result:

License

Copyright (c) 2018 Telink Semiconductor (Shanghai) Co., Ltd.

Permission is hereby granted for use on Telink products only, free of charge when used on Telink products, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

TSI Package

The TSI package contains the following:

File/Directory Content
TSI TSI Components
TestCase bin files of all Test Cases
Doc datasheet and this document

TSI Directory

The directory TSI contains the following sub-directories and files:

Directory Content
boot File "Cstartup.s"
drivers API of all modules
vendor demo of major modules
boot.link link file for complier
.cproject/.project project setting for IDE
config.h/drivers.h for demo usage
div_mod.S for Division operation

Revision History

TSI history releases is a history page.