BLE-TLSR825x

本文仅介绍 TuyaOS 开发过程中针对 TLSR825x 系列芯片平台相关的基本信息。有关 TuyaOS 的更多信息，请访问 TuyaOS 开发者论坛。

硬件环境

芯片介绍

您可以访问《Telink 官方文档》获取 TLSR825x 系列芯片文档。

开发板

• 核心板：搭载涂鸦 BTU 模组。

  

• 底板：

  

外设

GPIO

TuyaOS 中，操作指定的 I/O（Input/Output）要使用 I/O 序号作为入参进行操作。对于 TLSR825x 系列芯片平台，GPIO 序号与实际的 I/O 对应列表参考下表：

序号	GPIO	序号	GPIO	序号	GPIO	序号	GPIO	序号	GPIO
0	PA0	8	PB0	16	PC0	24	PD0	32	PE0
1	PA1	9	PB1	17	PC1	25	PD1	33	PE1
2	PA2	10	PB2	18	PC2	26	PD2	34	PE2
3	PA3	11	PB3	19	PC3	27	PD3	35	PE3
4	PA4	12	PB4	20	PC4	28	PD4	-	-
5	PA5	13	PB5	21	PC5	29	PD5	-	-
6	PA6	14	PB6	22	PC6	30	PD6	-	-
7	PA7	15	PB7	23	PC7	31	PD7	-	-

UART

该系列芯片平台同时只支持 1 个串口 UART0。TuyaOS 中默认使用下表中的引脚。如果要使用其他引脚作为 UART，请参考《Telink》TLSR825x 系列芯片文档 自行配置。

UART	功能	引脚
UART0	TX	PB1
UART0	RX	PB7

SPI

该系列芯片平台有两组 SPI 接口可使用，同时只能使用其中一组。TuyaOS 中 SPI 初始化，默认使用 SPI1。

SPI	功能	引脚
SPI1	CS	PD6
SPI1	CLK	PA4
SPI1	SDI	PA3
SPI1	SDO	PA2
SPI2	CS	PD2
SPI2	CLK	PD7
SPI2	SDI	PB6
SPI2	SDO	PB7

I2C

该系列芯片平台有 4 组 I2C 接口可使用，同时只能使用其中一组。TuyaOS 中 I2C 初始化，默认使用 I2C0。

IIC	功能	引脚
IIC0	SCL	PC3
IIC0	SDA	PC2
IIC1	SCL	PC0
IIC1	SDA	PC1
IIC2	SCL	PB6
IIC2	SDA	PD7
IIC3	SCL	PA3
IIC3	SDA	PA4

PWM

该系列芯片平台最多支持 6 路 PWM 输出，PWM 初始化后默认的引脚如下表所示。如果需要修改 PWM 通道所映射的 GPIO 引脚，则需要调用 tkl_pwm_mapping_to_gpio 重新映射 GPIO 为 PWM 功能。

通道	引脚
0	PC2
1	PC3
2	PD4
3	PD2
4	PB4
5	PB5

ADC

该系列芯片平台总共支持 10 个引脚的 ADC 复用功能，详情请参考下表。

通道	引脚
0	PB0
1	PB1
2	PB2
3	PB3
4	PB4
5	PB5
6	PB6
7	PB7
8	PC4
9	PC5

烧录固件

连线方式

烧录器的 SWM 引脚接模组 SWS 引脚。

固件说明

对于 TLSR825x 系列芯片平台，生产固件与 OTA（Over-the-air）固件都为同一个 .bin 格式的固件。

烧录方式一

您可以将固件上传至 涂鸦 IoT 开发平台，使用涂鸦烧录授权工具。详情请参考 云模组。

烧录方式二

使用 Telink 官方烧录和调试工具（BDT，Burning and Debugging Tool）进行烧录。详情请参考 Telink 官方指导 Burning and Debugging Tools for all Series。

平台特性

开启扫描

1. 在文件 apps\tuyaos_demo_ble_peripheral\IoTOSconfig 中的最下方新增配置项：

   config ENABLE_SCAN
       bool "ENABLE_SCAN"
       default y
   

2. 添加之后在工程中，右键单击目录，选择 Config Project 使修改生效：

   

3. 如果需要提升芯片主频以提高扫描后的数据解析速度，则可以在 IoTSconfig 中再增加一个配置项：

   config CLOCK_SYS_CLOCK_HZ
       int "CLOCK_SYS_CLOCK_HZ"
       default 48000000
   

   然后重复上述第二步的生效操作。

修改后，主频改成了 48M。TLSR825X 系列芯片仅支持的主频为：16M、24M、48M，如果使用不支持的主频则会产生不可预期的问题。

存储

• Flash：512KB

• RAM：48KB（Retention: 32K）

  下图为 TLSR825x 系列芯片平台的 Flash 示意：

  

TLSR825x 系列芯片平台低功耗蓝牙的 SDK 采用双备份升级方案，固件分为两片区域。

• 第一片区域为 0x00000 - 0x2B000。(因为芯片内部原因，要预留 4K 的空间不使用)
• 第二片区域为 0x40000 – 0x6B000。(因为芯片内部原因，要预留 4K 的空间不使用)

在上电时，bootloader 会根据两个代码区的有效性来决定运行哪一个区域的固件，如果两个区域都是有效的，则运行第一个区域的代码。

留给用户区的区域为：

• 0x2C000 - 0x40000
• 0x71000 - 0x74000
• 0x78000 – 0x80000

低功耗

低功耗蓝牙设备的低功耗分 Suspend Sleep 和 Deep Sleep 两个挡位，Deep Sleep 的功耗比 Suspend Sleep 的功耗更低。

• 如果需要保证 I/O 输出能力，则只能进入 Suspend Sleep。
• 如果只需要保持输入能力，则 Suspend Sleep 和 Deep Sleep 都可以。

TuyaOS 中，低功耗模式管理分为自动控制和手动控制两种：

• 自动控制：只要您调用了 tkl_cpu_allow_sleep，MCU 就可以在完成蓝牙逻辑后进入休眠状态。
• 手动控制：如果您有其他应用逻辑需要处理，则可以通过调用 tkl_board_pm_suspend 或 tkl_board_pm_working 这两个接口实现对功耗的管理。

因为 MCU 大部分时间处于低功耗状态，所以 16M 和 48M 的 MCU 主频整体功耗的影响并不大。相对而言，48M 主频的功耗更低。

• 16M 主频 1000ms 广播间隔：

  

• 48M 主频 1000ms 广播间隔：