BLE File Transfer Example

Source code path: example/ble/file_transfer

Supported Platforms

All platforms

Overview

This example demonstrates how to implement a GAP peripheral role on this platform to receive files sent from a mobile device.

Example Usage

The Finsh commands for this example can be displayed by entering diss help to show command usage.
When operating as a peripheral device, it will start advertising on boot with the name format: SIFLI_APP-xx-xx-xx-xx-xx-xx, where xx represents the device’s Bluetooth address. You can connect using a mobile BLE app.
The sifli ble serial transport protocol can be used to send files from the mobile device to the target device, supporting one or multiple files in a single transfer.

Hardware Requirements

Before running this example, you need to prepare:

A development board supported by this example (Supported Platforms).
A mobile device.

menuconfig Configuration

Enable Bluetooth(BLUETOOTH):
- Path: Sifli middleware → Bluetooth
- Enable: Enable bluetooth
  - Macro switch: CONFIG_BLUETOOTH
  - Description: Enable Bluetooth functionality
Enable GAP, GATT Client, BLE connection manager:
- Path: Sifli middleware → Bluetooth → Bluetooth service → BLE service
- Enable: Enable BLE GAP central role
  - Macro switch: CONFIG_BLE_GAP_CENTRAL
  - Description: Switch for BLE CENTRAL (central device). When enabled, it provides scanning and active connection initiation with peripherals.
- Enable: Enable BLE GATT client
  - Macro switch: CONFIG_BLE_GATT_CLIENT
  - Description: Switch for GATT CLIENT. When enabled, it can actively search and discover services, read/write data, and receive notifications.
- Enable: Enable BLE connection manager
  - Macro switch: CONFIG_BSP_BLE_CONNECTION_MANAGER
  - Description: Provides BLE connection control management, including multi-connection management, BLE pairing, link connection parameter updates, etc.
Enable NVDS:
- Path: Sifli middleware → Bluetooth → Bluetooth service → Common service
- Enable: Enable NVDS synchronous
  - Macro switch: CONFIG_BSP_BLE_NVDS_SYNC
  - Description: Bluetooth NVDS synchronization. When Bluetooth is configured to HCPU, BLE NVDS can be accessed synchronously, so enable this option; when Bluetooth is configured to LCPU, this option needs to be disabled
Enable transmission related macros:
- Path: Sifli middleware → Bluetooth → Bluetooth service → BLE service
- Enable: Enable BLE serial transmission
  - Macro switch: CONFIG_BSP_BLE_SERIAL_TRANSMISSION
  - Description: Serial transmission protocol. When enabled, it provides a simple serial transmission protocol that allows users to transmit content to the development board via BLE.
- Enable: Enable watch face downloaded via BLE
  - Macro switch: CONFIG_BSP_BLE_WATCH_FACE
  - Description: Watch face transmission protocol. Depends on serial transmission. When enabled, files can be transferred to the development board via BLE using the encapsulated mobile SDK.

Compilation and Flashing

Navigate to the example’s project/common directory and run the scons command to compile:

> scons --board=eh-lb525 -j32

Navigate to the example’s project/common/build_xx directory and run uart_download.bat, then select the port as prompted to download:

$ ./uart_download.bat
     Uart Download
please input the serial port num:5

For detailed compilation and downloading steps, please refer to the relevant sections in Quick Start.

Expected Results

After the example starts:

It can be discovered and connected by a mobile BLE app.
Compress the files to be transferred into a single .zip file and transfer this file to your mobile device.
Use the SIFLI BLE APP to search, connect the device, then go to the watchface interface, select the custom file, and then choose this file. This file can then be transferred to the file system of the development board.
Mobile app operation steps:

Enable location permission for opening the feature
Click the query button at the bottom right corner to enter the Bluetooth scanning interface.
Click on “SCAN” to start the scan.
After finding the device, click on “SORT”, and the broadcast named “SIFLI_APP-xx-xx-xx-xx-xx-xx” will be placed at the top.
Click on the broadcast name “SIFLI_APP-xx-xx-xx-xx-xx-xx” to enter the device interface.
Click on the upper right corner to enter the operation interface.
Click “CONNECT” to ensure that the State is “CONNECT”
Swipe up the last box, find File transfer WFPUSH2 and click to enter the file transfer interface
Click on “SELECT FILE” to select the pre-prepared zip file from your phone, and set the “File Type” to 3. Then, check the “With Byte Align” option, and finally click “START”.
After the transmission is completed, execute the command in the console window to enter the “file_recv” folder, and then execute the “ls” command to view the list of files. Among them, the content of the zip file will be displayed.