BLE-BG24

本文介绍 TuyaOS 开发过程中芯片平台相关的基本信息，更多关于 TuyaOS 的信息，请参考 TuyaOS 开发者论坛。

硬件环境

芯片手册

• 获取方式一：接入蓝牙子设备开发框架后，在vendor\bg24_ble\documents\ 路径下，获取 Datasheet 以及 Reference manual。
• 获取方式二：访问芯科官网，并在 文档中心 获取最新资料。

开发板

• 涂鸦 BS24-U 规格书

• 涂鸦 BS24-U-IPEX 模组规格书

• BS24-U-EVB 如下图所示：

  

• 原厂开发板如下图所示：

  

硬件外设

外设与对应 GPIO 描述

GPIO

SDK 默认使用的芯片型号为 EFR32BG24A020IM40，以下外设均按照该芯片进行描述。如需更换为 48 引脚封装的芯片型号，请在 app_config.h 文件中将 BOARD_GPIO_MAX 定义为 48。

在 TuyaOS 中，操作指定的 I/O（Input/Output）时，需要使用对应的 I/O 序号作为入参。对于 BG24 系列芯片平台，GPIO 序号与实际 I/O 引脚的对应关系如下表所示：

QFN40

GPIO 编号	端口引脚	GPIO 编号	端口引脚
TUYA_GPIO_NUM_1	PC00	TUYA_GPIO_NUM_2	PC01
TUYA_GPIO_NUM_3	PC02	TUYA_GPIO_NUM_4	PC03
TUYA_GPIO_NUM_5	PC04	TUYA_GPIO_NUM_6	PC05
TUYA_GPIO_NUM_7	PC06	TUYA_GPIO_NUM_8	PC07
TUYA_GPIO_NUM_16	PB04	TUYA_GPIO_NUM_17	PB03
TUYA_GPIO_NUM_18	PB02	TUYA_GPIO_NUM_19	PB01
TUYA_GPIO_NUM_20	PB00	TUYA_GPIO_NUM_21	PA00
TUYA_GPIO_NUM_24	PA03	TUYA_GPIO_NUM_25	PA04
TUYA_GPIO_NUM_26	PA05	TUYA_GPIO_NUM_27	PA06
TUYA_GPIO_NUM_28	PA07	TUYA_GPIO_NUM_29	PA08
TUYA_GPIO_NUM_37	PD03	TUYA_GPIO_NUM_38	PD02
TUYA_GPIO_NUM_39	PD01	TUYA_GPIO_NUM_40	PD00

QFN48

GPIO 编号	端口引脚	GPIO 编号	端口引脚
TUYA_GPIO_NUM_1	PC00	TUYA_GPIO_NUM_2	PC01
TUYA_GPIO_NUM_3	PC02	TUYA_GPIO_NUM_4	PC03
TUYA_GPIO_NUM_5	PC04	TUYA_GPIO_NUM_6	PC05
TUYA_GPIO_NUM_7	PC06	TUYA_GPIO_NUM_8	PC07
TUYA_GPIO_NUM_9	PC08	TUYA_GPIO_NUM_10	PC09
TUYA_GPIO_NUM_18	PB05	TUYA_GPIO_NUM_19	PB04
TUYA_GPIO_NUM_20	PB03	TUYA_GPIO_NUM_21	PB02
TUYA_GPIO_NUM_22	PB01	TUYA_GPIO_NUM_23	PB00
TUYA_GPIO_NUM_26	PA00	TUYA_GPIO_NUM_27	PA01
TUYA_GPIO_NUM_28	PA02	TUYA_GPIO_NUM_29	PA03
TUYA_GPIO_NUM_30	PA04	TUYA_GPIO_NUM_31	PA05
TUYA_GPIO_NUM_32	PA06	TUYA_GPIO_NUM_33	PA07
TUYA_GPIO_NUM_34	PA08	TUYA_GPIO_NUM_35	PA09
TUYA_GPIO_NUM_43	PD05	TUYA_GPIO_NUM_44	PD04
TUYA_GPIO_NUM_45	PD03	TUYA_GPIO_NUM_46	PD02
TUYA_GPIO_NUM_47	PD01	TUYA_GPIO_NUM_48	PD00

PWM

默认存在 5 路 PWM（占用 Timer0 三个通道以及 Timer1 两个通道，其中 Timer0、Timer1 均为 32 Bit 定时器）。

通道	端口引脚
0	PC01
1	PC02
2	PA04
3	PA05
4	PA06

UART

默认使用两组串口，且串口 0 对应 USART0，串口 1 对应 EUSART0。由于 EUSART（只存在两组）可复用为 SPI、UART 或读卡器等，这里只占用 UART 功能。

UART	功能	端口引脚	备注
UART0	TX	PD03	授权、测试
UART0	RX	PD02	-
UART1	TX	PA00	Demo 未使用
UART1	RX	PB00	-

SPI

SPI	功能	端口引脚
SPI0	CS	PC00
SPI0	CLK	PC03
SPI0	SDI	PA00
SPI0	SDO	PB00

ADC

该芯片支持 16 个输入通道，每个通道均可配置为正输入（posInput）与负输入（negInput）模式。默认情况下 negInput 接地（GND，适用于单端采样）。PAx、PBx、PCx 和 PDx 所有 IO 均可映射至 IADC 的输入端口，支持配置为单通道采样或多通道自动扫描采样模式。

考虑到资源占用，SDK 默认仅支持一组 ADC，需要其他通道请自行配置。

通道	引脚
0	PB02

IIC

IIC	功能	端口引脚
IIC0	SCL	PB01
IIC0	SDA	PB02

按键

PB04：

• 短按唤醒设备。
• 长按 3s，本地恢复出厂设置。

Power Led

PA08：用于上电时间检测，进入 main 函数后置为高电平。

功耗描述

• 100ms 广播，常规功耗为 2.5 mA 左右。

• 100ms 低功耗广播，EM2 功耗约为 320 μA。

• 默认 1s 带广播，功耗约为 35 μA 左右。

• 默认不带广播，EM2 功耗约为 3.2 μA 左右。

软件环境

• 确保环境内已安装 make 命令行工具，或通过搜索平台安装 make，配置环境变量后再次编译。

• SDK 内已打包 commander 命令行工具（可烧录以及日志打印），存放位置：vendor\bg24_ble\toolchain\software\commander。

• SDK 内已集成工具链，无需二次下载工具链。

烧录环境指引

1. 烧录与擦除：按照图片所示的顺序，点击进行烧录与擦除的操作。

   

2. 日志系统（RTT）：按照图片所示的顺序，点击查看软件运行日志，获取调试信息。

   

BLE-BG24 SDK 说明

• Flash 占用情况

  分配的应用区为 352K，其中实际占用 270K 左右。

  

• SDK 配置说明

  关于板载 GPIO 的设定，请务必参考文档中的说明。

• Flash 分配配置

  关于 Flash 分配配置，请参考文档 bg24_flash.md：vendor\bg24_ble\documents。