Bluetooth LE-BG24

This topic describes the basics of the chip platform used in TuyaOS development. For more information, visit Tuya Developer Forum.

Hardware environment

Datasheet

• Method 1: After integrating the Bluetooth Sub-Device Development Framework, you can get the datasheet and reference manual in the vendor\bg24_ble\documents\ path.
• Method 2: Visit the official website of Silicon Labs and get the latest information in the Documentation Center.

Development board

• Tuya BS24-U Module Datasheet

• Tuya BS24-U-IPEX Module Datasheet

• The following figure shows BS24-U-EVB:

  

• The following figure shows the development board from the chip vendor:

  

Peripherals

Peripherals and corresponding GPIOs

GPIO

The SDK defaults to using the EFR32BG24A020IM40 chip model. All peripheral descriptions below are based on this chip. To change to a 48-pin package, define BOARD_GPIO_MAX to 48 in the app_config.h file.

To operate a specific I/O in TuyaOS, you need to specify its pin number in the input parameter. For the BG24 series chip platform, the table below shows the mapping between GPIO numbers and physical I/O pins:

QFN40

QFN48

PWM

By default, there are five PWM channels, occupying three channels of Timer0 and two of Timer1. Both Timer0 and Timer1 are 32-bit timers.

UART

The system defaults to using two UART groups, with UART0 mapped to USART0 and UART1 mapped to EUSART0. The EUSART (only two groups available) can be multiplexed as SPI, UART, or card reader interfaces. Here, only its UART functionality is utilized.

SPI

ADC

The chip supports 16 input channels, each of which can be configured as positive input (posInput) and negative input (negInput) modes. By default, negInput is connected to ground (GND, suitable for single-ended sampling). All I/Os of PAx, PBx, PCx, and PDx can be mapped to the input ports of IADC. They can be configured as single-channel sampling or multi-channel auto-scanning sampling mode.

By default, the SDK only supports one ADC to optimize resource usage. For additional channels, you can configure them by yourself.

I2C

Key control

PB04:

• Press the key to wake up the device.
• Press and hold the key for three seconds to factory reset the device.

Power LED

PA08: Used for power-on time detection. It is set to high level after entering the main function.

Power consumption description

• Broadcasting at 100 ms intervals results in approximately 2.5 mA typical power consumption.

• Low-power broadcasting at 100 ms intervals consumes approximately 320 μA in EM2 mode.

• By default, 1-second interval broadcasting consumes approximately 35 μA.

• Without broadcasting, the EM2 power consumption is approximately 3.2 μA.

Software environment

• Make sure the make command line tool has been installed in the environment, or search and install make, configure the environment variables, and compile again.

• The SDK includes the pre-packaged Commander CLI tool (for flashing and log output), located at vendor/bg24_ble/toolchain/software/commander.

• The toolchain is integrated into the SDK, so you do not need to download the toolchain again.

Flashing environment

1. Flash and erase: Click in the order shown below to perform the flash and erase operations.

   

2. Logging system (RTT): Click in the order shown below to view the software running log and get debugging information.

   

Bluetooth LE-BG24 SDK

• Flash memory allocation

  The allocated application region is 352 KB, with approximately 270 KB actually utilized.

  

• SDK configuration

  For more information on setting up the onboard GPIOs, be sure to refer to the documentation.

• Flash memory allocation configuration

  For flash memory allocation settings, refer to the document bg24_flash.md located at vendor/bg24_ble/documents.