Bluetooth Applications v3.0.0

Author: silabs-DanielN

README.md

@@ -13,9 +13,9 @@
 
 # Silicon Labs Bluetooth Applications #
 
-[![Version Badge](https://img.shields.io/badge/-v2.2.0-green)](https://github.com/SiliconLabs/bluetooth_applications/releases)
-[![GSDK Badge](https://img.shields.io/badge/GSDK-v4.4.0-green)](https://github.com/SiliconLabs/gecko_sdk/releases)
-[![TPHD Version Badge](https://img.shields.io/badge/TPHD-v2.0.0+-green)](https://github.com/SiliconLabs/third_party_hw_drivers_extension/releases)
+[![Version Badge](https://img.shields.io/badge/-v3.0.0-green)](https://github.com/SiliconLabs/bluetooth_applications/releases)
+[![SDK Badge](https://img.shields.io/badge/SiSDK-v2024.12.0-green)](https://github.com/SiliconLabs/simplicity_sdk/releases)
+[![TPHD Version Badge](https://img.shields.io/badge/TPHD-v4.1.0+-green)](https://github.com/SiliconLabs/third_party_hw_drivers_extension/releases)
 ![License badge](https://img.shields.io/badge/License-Zlib-green)
 
 The Silicon Labs Bluetooth stack allows for a wide variety applications to be built on its foundation. This repo showcases some example applications using the Silicon Labs Bluetooth stack.
@@ -86,21 +86,22 @@ This repository provides both SLCP projects (as External Repositories) and SLS p
 | 58 | Bluetooth - BTHome v2 - PIR Alarm | [Click Here](./bluetooth_bthome_v2_pir_alarm/) |
 | 59 | Bluetooth - DW3000 TWR demo | [Click Here](./bluetooth_uwb_dw3000_slotted_twr/) |
 | 60 | Bluetooth - BThome v2 - People Counting (VL53L1X)  | [Click Here](./bluetooth_bthome_v2_people_counting/) |
+| 61 | Bluetooth - MIDI over BLE  | [Click Here](./bluetooth_midi_over_ble/) |
 
 ## Requirements ##
 
 1. Silicon Labs EFR32 Development Kit
 2. Simplicity Studio 5
-3. Compatible GSDK version that specified in each project's readme file. You can install it via Simplicity Studio or download it from our GitHub [gecko_sdk](https://github.com/SiliconLabs/gecko_sdk)
+3. Compatible SDK version that specified in each project's readme file. You can install it via Simplicity Studio or download it from our GitHub [gecko_sdk](https://github.com/SiliconLabs/gecko_sdk) or [simplicity_sdk](https://github.com/SiliconLabs/simplicity_sdk)
 4. Compatible Third-Party Hardware Drivers extension that also specified in each project's readme file, available [here](https://github.com/SiliconLabs/third_party_hw_drivers_extension)
 
 ## Working with Projects ##
 
 1. To add an external repository, perform the following steps.
 
-    - From Simpilicity Studio 5, go to **Preferences > Simplicity Studio > External Repos**. Here you can add the repo `https://github.com/SiliconLabs/bluetooth_applications.git`. 
+    - From Simpilicity Studio 5, go to **Preferences > Simplicity Studio > External Repos**. Here you can add the repo `https://github.com/SiliconLabs/bluetooth_applications.git`.
 
-    - Cloning and then selecting the branch, tag, or commit to add. The default branch is Master. This repo cloned to `<path_to_the_SimplicityStudio_v5>\developer\repos\`
+    - Cloning and then selecting the branch, tag, or commit to add. The default branch is Master. This repo cloned to `<path_to_the_SimplicityStudio_v5>/developer/repos/`
 
 2. From Launcher, select your device from the "Debug Adapters" on the left before creating a project. Then click the **EXAMPLE PROJECTS & DEMOS** tab -> check **bluetooth_applications** under **Provider** to show a list of Bluetooth example projects compatible with the selected device. Click CREATE on a project to generate a new application from the selected template.
 

bluetooth_accelerometer_bma400/README.md

@@ -1,12 +1,13 @@
 # Bluetooth - Accelerometer (BMA400) #
 
-![Type badge](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_common.json&label=Type&query=type&color=green)
-![Technology badge](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_common.json&label=Technology&query=technology&color=green)
-![License badge](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_common.json&label=License&query=license&color=green)
-![SDK badge](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_common.json&label=SDK&query=sdk&color=green)
-![Build badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_build_status.json)
-![Flash badge](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_common.json&label=Flash&query=flash&color=blue)
-![RAM badge](https://img.shields.io/badge/dynamic/json?url=https://raw.githubusercontent.com/SiliconLabs/application_examples_ci/master/bluetooth_applications/bluetooth_accelerometer_bma400_common.json&label=RAM&query=ram&color=blue)
+![Type badge](https://img.shields.io/badge/Type-Virtual%20Application-green)
+![Technology badge](https://img.shields.io/badge/Technology-Bluetooth-green)
+![License badge](https://img.shields.io/badge/License-Zlib-green)
+![SDK badge](https://img.shields.io/badge/SDK-v2024.12.0-green)
+[![Required board](https://img.shields.io/badge/Mikroe-Accel%205%20Click%20board-green)](https://www.mikroe.com/accel-5-click)
+![Build badge](https://img.shields.io/badge/Build-passing-green)
+![Flash badge](https://img.shields.io/badge/Flash-198.95%20KB-blue)
+![RAM badge](https://img.shields.io/badge/RAM-10.7%20KB-blue)
 ## Overview ##
 
 This project aims to implement an accelerometer application using Silicon Labs development kits and external sensors integrated with the BLE wireless stack.
@@ -15,25 +16,21 @@ The following picture shows the system view of how it works.
 
 ![hardware_connect](image/hardware_connect.png)
 
-## Gecko SDK Suite version ##
+## SDK version ##
 
-- GSDK v4.4.0
-- [Third-Party Hardware Drivers v2.0.0.0](https://github.com/SiliconLabs/third_party_hw_drivers_extension)
+- [SiSDK v2024.12.0](https://github.com/SiliconLabs/simplicity_sdk)
+- [Third Party Hardware Drivers v4.1.0](https://github.com/SiliconLabs/third_party_hw_drivers_extension)
 
-## Hardware Required ##
-
-- [A BGM220P Explorer Kit board.](https://www.silabs.com/development-tools/wireless/bluetooth/bgm220-explorer-kit)
+## Software Required ##
 
-- [A MikroE Accel 5 Click board.](https://www.mikroe.com/accel-5-click)
+- [Simplicity Studio v5 IDE](https://www.silabs.com/developers/simplicity-studio)
+- [Simplicity Connect Mobile App](https://www.silabs.com/developer-tools/simplicity-connect-mobile-app)
 
-**NOTE:**
-Tested boards for working with this example:
+## Hardware Required ##
 
-| Board ID | Description  |
-| ---------------------- | ------ |
-| BRD2703A | [EFR32xG24 Explorer Kit - XG24-EK2703A ](https://www.silabs.com/development-tools/wireless/efr32xg24-explorer-kit?tab=overview)    |
-| BRD4314A | [BGM220 Bluetooth Module Explorer Kit - BGM220-EK4314A](https://www.silabs.com/development-tools/wireless/bluetooth/bgm220-explorer-kit?tab=overview)  |
-| BRD4108A | [EFR32BG22 Explorer Kit Board](https://www.silabs.com/development-tools/wireless/bluetooth/bg22-explorer-kit?tab=overview)  |
+- 1x [Bluetooth Low Energy Explorer Kit](https://www.silabs.com/development-tools/wireless/bluetooth). For example, [BGM220-EK4314A](https://www.silabs.com/development-tools/wireless/bluetooth/bgm220-explorer-kit)
+- 1x [MikroE Accel 5 Click board](https://www.mikroe.com/accel-5-click)
+- 1x smartphone running the 'Simplicity Connect' mobile app
 
 ## Connections Required ##
 
@@ -49,13 +46,13 @@ To test this application, you can either create a project based on an example pr
 
 **NOTE**:
 
-- Make sure that the SDK extension is already installed and this repository is added to [Preferences > Simplicity Studio > External Repos](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-about-the-launcher/welcome-and-device-tabs).
+- Make sure that the [Third Party Hardware Drivers extension](https://github.com/SiliconLabs/third_party_hw_drivers_extension) is installed as part of the SiSDK and the [bluetooth_applications](https://github.com/SiliconLabs/bluetooth_applications) repository is added to [Preferences > Simplicity Studio > External Repos](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-about-the-launcher/welcome-and-device-tabs).
 
 - SDK Extension must be enabled for the project to install the required components.
 
 ### Create a project based on an example project ###
 
-1. From the Launcher Home, add your hardware to My Products, click on it, and click on the **EXAMPLE PROJECTS & DEMOS** tab. Find the example project with the filter "accelerometer".
+1. From the Launcher Home, add your hardware to My Products, click on it, and click on the **EXAMPLE PROJECTS & DEMOS** tab. Find the example project filtering by "accelerometer".
 
 2. Click **Create** button on the example:
 
@@ -79,7 +76,7 @@ To test this application, you can either create a project based on an example pr
     - Open the .slcp file in the project.
 
     - Select the **CONFIGURATION TOOLS** tab and open the **Bluetooth GATT Configurator**.
-    
+
     - Find the Import button and import the attached `config/gatt_configuration.btconf` file.
 
     - Save the GATT configuration (ctrl-s).
@@ -96,6 +93,8 @@ To test this application, you can either create a project based on an example pr
 
     - [Platform] → [Driver] → [LED] → [Simple LED] → default instance name: *led0*
 
+    - [Platform] → [Driver] → [GPIOINT]
+
     - If using the I2C interface: [Third Party Hardware Drivers] → [Sensors] → [BMA400 - Accel 5 Click (Mikroe) - I2C] → use default configuration
 
     - If using the SPI interface: [Third Party Hardware Drivers] → [Sensors] → [BMA400 - Accel 5 Click (Mikroe) - SPI] → use default configuration
@@ -104,7 +103,7 @@ To test this application, you can either create a project based on an example pr
 
 **NOTE**:
 
-- Do not forget to flash a bootloader to your board, see [Bootloader](https://github.com/SiliconLabs/bluetooth_applications/blob/master/README.md#bootloader) for more information.
+- A bootloader needs to be flashed to your board if the project starts from the "Bluetooth - SoC Empty" project, see [Bootloader](https://github.com/SiliconLabs/bluetooth_applications/blob/master/README.md#bootloader) for more information.
 
 ## How It Works ##
 
@@ -118,18 +117,18 @@ After resetting, the program will continuously query the interrupt from bma400.
 
 Follow the below steps to test the example:
 
-1. Open the EFR Connect app on your smartphone.
+1. Open the Simplicity Connect app on your smartphone and allow the permission requested the first time it is opened.
 
 2. Find your device in the Bluetooth Browser, advertising as "Silabs Example", and tap Connect.
 
 3. Find the unknown service, try to read the unknown characteristic and check the value.
 
 4. Enable notify on the unknown characteristic. Try to move your kit in some direction and check the value.
 
-    ![](image/unknown_service.png)
+    ![image](image/unknown_service.png)
 
 5. You can launch the Console that is integrated in Simplicity Studio or can use a third-party terminal tool like TeraTerm to receive the logs from the virtual COM port.
 
-    ![](image/console.png)
+    ![image](image/console.png)
 
 *Note*: The LED blinks once if the accelerometer initialization is successful. If the LED stays on, the initialization has been failed. The reason is typically wrong sensor I2C address (see "I2C ADD" resistors) or wrongly configured Click board mode (SPI-mode instead I2C) or if using some own ways to connect the sensor.

…/bluetooth_accelerometer_bma400_i2c.slcp …yStudio/bt_accelerometer_bma400_i2c.slcpbluetooth_accelerometer_bma400/SimplicityStudio/bluetooth_accelerometer_bma400_i2c.slcp renamed to bluetooth_accelerometer_bma400/SimplicityStudio/bt_accelerometer_bma400_i2c.slcp bluetooth_accelerometer_bma400/SimplicityStudio/bluetooth_accelerometer_bma400_i2c.slcp renamed to bluetooth_accelerometer_bma400/SimplicityStudio/bt_accelerometer_bma400_i2c.slcp

@@ -1,10 +1,10 @@
-# Silicon Labs Project Configuration Tools: slcp, v0, Component selection file.
-project_name: bluetooth_accelerometer_bma400_i2c
+project_name: bt_accelerometer_bma400_i2c
+package: Bluetooth
 label: Bluetooth - Accelerometer (BMA400) - I2C
-description: |
-    This project aims to implement an accelerometer application using Silicon Labs development kits and external sensors integrated with the BLE wireless stack.
+description: >
+  This project aims to implement an accelerometer application using Silicon Labs Dev kits
+  and external sensors integrated with the BLE wireless stack.
 category: Bluetooth Examples
-
 quality: experimental
 
 filter:
@@ -17,48 +17,43 @@ filter:
   - name: "Wireless Technology"
     value: ["Bluetooth"]
 
-package: Bluetooth
-
-readme:
-- path: ../README.md
-source:
-- path: ../src/app.c
-- path: ../src/main.c
+component:
+  - id: bluetooth_stack
+  - id: gatt_configuration
+  - id: gatt_service_device_information
+  - id: bluetooth_feature_legacy_advertiser
+  - id: bluetooth_feature_connection
+  - id: bluetooth_feature_gatt
+  - id: bluetooth_feature_gatt_server
+  - id: bluetooth_feature_legacy_scanner
+  - id: bluetooth_feature_sm
+  - id: bluetooth_feature_system
+  - id: rail_util_pti
+  - id: app_assert
+  - id: mpu
+  - id: sl_system
+  - id: clock_manager
+  - id: device_init
+  - id: sl_common
+  - id: i2cspm
+    instance: [mikroe]
+  - id: gpiointerrupt
+  - id: simple_led
+    instance: [led0]
+  - id: iostream_usart
+    instance: [vcom]
+  - id: app_log
+  - id: mikroe_accel5_bma400_i2c
+    from: third_party_hw_drivers
 
 include:
-- path: ../inc
-  file_list:
-  - path: ../inc/app.h
+  - path: ../inc
+    file_list:
+      - path: app.h
 
-component:
-- id: sl_system
-- id: device_init
-- id: bluetooth_stack
-- id: gatt_configuration
-- id: gatt_service_device_information
-- id: bluetooth_feature_legacy_advertiser
-- id: bluetooth_feature_connection
-- id: bluetooth_feature_gatt
-- id: bluetooth_feature_gatt_server
-- id: bluetooth_feature_legacy_scanner
-- id: bluetooth_feature_system
-- id: bluetooth_feature_sm
-- id: rail_util_pti
-- id: mpu
-- id: bt_post_build
-- id: i2cspm
-  instance: [mikroe]
-- id: gpiointerrupt
-- id: simple_led
-  instance: [led0]
-- id: iostream_usart
-  instance: [vcom]
-- id: app_log
-- id: app_assert
-- id: mikroe_accel5_bma400_i2c
-  from: third_party_hw_drivers
-define:
-- name: DEBUG_EFM
+source:
+  - path: ../src/app.c
+  - path: ../src/main.c
 
 config_file:
   - override:
@@ -67,12 +62,16 @@ config_file:
     path: "../config/gatt_configuration.btconf"
     directory: "btconf"
 
-sdk_extension:
-  - id: third_party_hw_drivers
-    version: 2.0.0
+configuration:
+  - name: SL_STACK_SIZE
+    value: "2752"
+  - name: SL_PSA_KEY_USER_SLOT_COUNT
+    value: "0"
+    condition:
+      - psa_crypto
 
-tag:
-  - hardware:rf:band:2400
+readme:
+  - path: ../README.md
 
 other_file:
   - path: ../image/create_project.png
@@ -86,15 +85,12 @@ other_file:
   - path: ../image/connection.png
     directory: image
 
-configuration:
-  - name: SL_STACK_SIZE
-    value: "2752"
-  - name: SL_HEAP_SIZE
-    value: "9200"
-  - name: SL_PSA_KEY_USER_SLOT_COUNT
-    value: "0"
-    condition:
-      - psa_crypto
+sdk_extension:
+  - id: third_party_hw_drivers
+    version: 4.1.0
+
+tag:
+  - hardware:rf:band:2400
 
 ui_hints:
   highlight: