Platform Applications v2.8.0

Author: silabs-TungD

README.md

@@ -13,7 +13,7 @@
 
 # Silicon Labs Platform Applications #
 
-[![Version Badge](https://img.shields.io/badge/-v2.7.0-green)](https://github.com/SiliconLabs/bluetooth_applications/releases)
+[![Version Badge](https://img.shields.io/badge/-v2.8.0-green)](https://github.com/SiliconLabs/bluetooth_applications/releases)
 [![GSDK Badge](https://img.shields.io/badge/GSDK-v4.4.4-green)](https://github.com/SiliconLabs/gecko_sdk/releases)
 ![License badge](https://img.shields.io/badge/License-Zlib-green)
 
@@ -92,7 +92,7 @@ This repository provides both SLCP projects (as External Repositories) and SLS p
 | 65 | Platform - Wake M33 using PRS |[Click Here](./platform_prs_wfe)
 | 66 | Platform - IADC Synchronous Triggers with PRS |[Click Here](./platform_iadc_synch_prs)
 | 67 | Platform - EMU Temperature Linearization  |[Click Here](./platform_emu_temp_linearization)
-
+| 68 | Platform - I2C Fast Plus Mode  |[Click Here](./platform_i2c_fast_plus_mode)
 
 ## Requirements ##
 

platform_i2c_fast_plus_mode/README.md

@@ -0,0 +1,90 @@
+# Platform - I2C Fast Plus Mode #
+
+![Type badge](https://img.shields.io/badge/Type-Virtual%20Application-green)
+![Technology badge](https://img.shields.io/badge/Technology-Platform-green)
+![License badge](https://img.shields.io/badge/License-Zlib-green)
+![SDK badge](https://img.shields.io/badge/SDK-v2024.12.0-green)
+![Build badge](https://img.shields.io/badge/Build-passing-green)
+![Flash badge](https://img.shields.io/badge/Flash-13.52%20KB-blue)
+![RAM badge](https://img.shields.io/badge/RAM-4.47%20KB-blue)
+
+## Overview ##
+
+This project demonstrates the I2C communication in fast plus mode between 2 EFR32xG2x boards. This project contains the implementation for the leader device. Communication process between 2 boards is triggered once the button 0 is pressed on the leader device.
+
+## SDK version ##
+
+- [SiSDK v2024.12.0](https://github.com/SiliconLabs/simplicity_sdk)
+
+## Software Required ##
+
+- [Simplicity Studio v5 IDE](https://www.silabs.com/developers/simplicity-studio)
+
+## Hardware Required ##
+
+- 1 x [Silicon Labs EFR32xG24 Radio Board (BRD4186C)](https://www.silabs.com/development-tools/wireless/xg24-rb4186c-efr32xg24-wireless-gecko-radio-board?tab=overview) and Wireless Starter Kit
+
+- 1 x [EFR32xG24 Explorer Kit](https://www.silabs.com/development-tools/wireless/efr32xg24-explorer-kit?tab=overview)
+
+## Connections Required ##
+
+The hardware connection is shown in the table below:
+
+| Pin | Leader device (BRD2703A) | Follower device (BRD4186C)|
+|:----|:-------------------------|:--------------------------|
+| SCL | PB4                      | EXP HEADER 11             |
+| SDA | PB5                      | EXP HEADER 7              |
+
+**Note:** You must connect 2 GND pins of 2 board together.
+
+## Setup ##
+
+To test this application, you can either create leader project based on an example project or start with a "Empty C Project" project based on your hardware. You should connect the EFR32xG24 Explorer Kit Board to the PC using a MicroUSB cable.
+
+### Create a project based on an example project ###
+
+1. From the Launcher Home, add the **BRD2703A** to My Products, click on it, and click on the **EXAMPLE PROJECTS & DEMOS** tab. Find the example project filtering by "fast plus".
+
+    ![create_leader](image/create_leader.png)
+
+2. Click Create button on the **Platform - I2C Fast Plus Mode** example. Example project creation dialog pops up -> click Create and Finish and Project should be generated.
+
+3. Build and flash this example to the board.
+
+### Start with a "Empty C Project" project ###
+
+1. Create a **Empty C Project** project for your hardware using Simplicity Studio 5.
+
+2. Copy the .c files 'src/app.c' to the following directory of the project root folder (overwriting the existing files).
+
+3. Install the software components:
+
+    - Open the .slcp file in the project.
+
+    - Select the SOFTWARE COMPONENTS tab.
+
+    - Install the following components:
+        - [Platform] → [Peripheral] → [I2C]
+        - [Platform] → [Peripheral] → [RTCC]
+
+4. Build and flash this project to the board.
+
+### Create follower project ###
+
+1. From the Launcher Home, add the **BRD4186C** to My Products, click on it, and click on the **EXAMPLE PROJECTS & DEMOS** tab. Find the example project filtering by "i2c follower".
+
+    ![create_follower](image/create_follower.png)
+
+2. Click Create button on the **Platform - BRD4186C EFR32MG24 I2C Follower** example. Example project creation dialog pops up -> click Create and Finish and Project should be generated.
+
+3. Build and flash this example to the board.
+
+## How it Works ##
+
+Press **BTN0** on the leader kit to trigger an I2C test (read follower buffer, increment, write, read, verify). **LED0** will toggle with a successful I2C test whereas **LED1** will turn on to indicate a failure. You can observe that received values received from the follower (rxBuffer) match transmitted values sent by leader (txBuffer) by viewing *i2c_rxBuffer* and *i2c_txBuffer* respectively in the Expressions window of Simplicity Studio.
+
+## Testing ##
+
+**LED0** is used to verify the result of the transmission process. To confirm that the I2C transmission uses the fast plus mode, an oscilloscope can be used to monitor the frequency.
+
+![test](image/test.png)

platform_i2c_fast_plus_mode/SimplicityStudio/platform_i2c_fast_plus_mode.slcp

@@ -0,0 +1,51 @@
+project_name: platform_i2c_fast_plus_mode
+package: platform
+label: Platform - I2C Fast Plus Mode
+description: |
+  This project demonstrates the I2C communication in fast plus mode between 2 EFR32xG2x boards.
+category: Example|Platform
+quality: experimental
+
+filter:
+  - name: Device Type
+    value: [SoC]
+  - name: MCU
+    value: [32-bit MCU]
+  - name: Project Difficulty
+    value: [Beginner]
+
+readme:
+- path: ../README.md
+
+source:
+  - path: ../src/main.c
+  - path: ../src/app.c
+
+include:
+  - path: ../inc
+    file_list:
+        - path: app.h
+
+component:
+- id: sl_system
+- id: device_init
+- id: emlib_i2c
+- instance: [btn0]
+  id: simple_button
+
+define:
+- name: DEBUG_EFM
+
+other_file:
+  - path: ../image/create_follower.png
+    directory: "image"
+  - path: ../image/create_leader.png
+    directory: "image"
+  - path: ../image/test.png
+    directory: "image"
+
+ui_hints:
+  highlight:
+    - path: README.md
+      focus: true
+

platform_i2c_fast_plus_mode/image/create_follower.png

@@ -0,0 +1,31 @@
+/***************************************************************************//**
+ * @file
+ * @brief Top level application functions
+ *******************************************************************************
+ * # License
+ * <b>Copyright 2020 Silicon Laboratories Inc. www.silabs.com</b>
+ *******************************************************************************
+ *
+ * The licensor of this software is Silicon Laboratories Inc. Your use of this
+ * software is governed by the terms of Silicon Labs Master Software License
+ * Agreement (MSLA) available at
+ * www.silabs.com/about-us/legal/master-software-license-agreement. This
+ * software is distributed to you in Source Code format and is governed by the
+ * sections of the MSLA applicable to Source Code.
+ *
+ ******************************************************************************/
+
+#ifndef APP_H
+#define APP_H
+
+/***************************************************************************//**
+ * Initialize application.
+ ******************************************************************************/
+void app_init(void);
+
+/***************************************************************************//**
+ * App ticking function.
+ ******************************************************************************/
+void app_process_action(void);
+
+#endif // APP_H