Juan Benavides

Profile Data

Screen Name: Juan Benavides

Screen Name*

Title

First Name

Address:

Last Name

URL (i.e. Company, Github, LinkedIn)

LinkedIn account

Company

Phone number

Country

Bio

Indicates required field*

My Activities
Following

Member

Action

Date

Juan Benavides

Updated Silicon Labs Peripheral Examples on Blog

Introduction

The Silicon Labs Examples in Simplicity Studio are very easy to access: You connect your Starter Kit and Simplicity Studio will display the list of examples as shown below:

**Figure 1** Examples in Simplicity Studio

We hope that you can find the most appropriate example to test your starter kit and hopefully base your design from one of the examples featured in Simplicity Studio.

But, in case you can’t find the example you were looking for, we have a wide variety of unpublished examples in a public repository. Like when you go to a store and ask one of the store's employees to see if the item you want is in the "back room" because you couldn’t find it on the shelves; The Silicon Labs back room for those examples you couldn’t find as part of Simplicity Studio is our repository in GitHub:

https://github.com/SiliconLabs

There you will find examples for pretty much all the Silicon Labs devices.

In this blog, I will show you how to access the EFM32/EFR32 Peripheral Examples.

EFM32/EFR32 Peripheral Examples

This repository contains low-level examples for each peripheral on the EFM32 and EFR32 devices:

https://github.com/SiliconLabs/peripheral_examples

The examples are organized by Series and then by Peripheral name as illustrated in Figure 2:

**Figure 2** Peripheral Examples GitHub Repo

Device Series

If you want to find out what Series is your device, you can look at the package marking and the number highlighted in the table below is the series number:

EFM32/EFR32 Devices Series
Series 0	Series 1	Series 2
EFM32ZG	EFM32PG1	EFR32BG21
EFM32HG	EFR32MG1	EFR32MG21
EFM32TG	EFR32BG1
EFM32G	EFR32FG1
EFM32LG	EFM32PG12
EFM32GG	EFR32MG12
EFM32WG	EFR32BG12
	EFR32FG12
	EFR32MG13
	EFR32BG13
	EFR32FG13
	EFR32MG14
	EFR32BG14
	EFR32FG14
	EFM32GG11
	EFM32TG11

Table 1 Devices by Series

Peripheral Name

The table below lists all the device peripherals along with their description:

EFM32/EFR32 Peripherals
Name	Description
ACMP	Analog comparator (ACMP) Peripheral.
ADC	Analog to Digital Converter (ADC) Peripheral.
AES	Advanced Encryption Standard Accelerator (AES) Peripheral.
ASSERT	Error checking module.
BURTC	Backup Real Time Counter (BURTC) Peripheral.
BUS	BUS register and RAM bit/field read/write.
CHIP	Chip errata workarounds initialization.
CMU	Clock management unit (CMU) Peripheral.
COMMON	General purpose utilities and cross-compiler support.
CORE	Core interrupt handling.
DAC	Digital to Analog Converter (DAC) Peripheral.
DBG	Debug (DBG) Peripheral.
DMA	Direct Memory Access (DMA) Peripheral.
EBI	EBI External Bus Interface (EBI) Peripheral.
EMU	Energy Management Unit (EMU) Peripheral.
GPIO	General Purpose Input/Output (GPIO).
I2C	Inter-integrated Circuit (I2C) Peripheral.
INT	Safe nesting of interrupt disable/enable.
LCD	Liquid Crystal Display (LCD) Peripheral.
LESENSE	Low Energy Sensor (LESENSE) Peripheral.
LETIMER	Low Energy Timer (LETIMER) Peripheral.
LEUART	Low Energy Universal Asynchronous Receiver/Transmitter (LEUART) Peripheral.
MPU	Memory Protection Unit (MPU) Peripheral.
MSC	Memory System Controller.
OPAMP	Operational Amplifier (OPAMP) peripheral.
PCNT	Pulse Counter (PCNT) Peripheral.
PRS	Peripheral Reflex System (PRS) Peripheral.
RAMFUNC	RAM code support.
RMU	Reset Management Unit (RMU) Peripheral.
RTC	Real Time Counter (RTC) Peripheral.
SYSTEM	System.
TIMER	Timer/Counter (TIMER) Peripheral.
USART	Universal Synchronous/Asynchronous Receiver/Transmitter Peripheral.
USBD	USB Device Peripheral.
VCMP	Voltage Comparator (VCMP) Peripheral.
VERSION	Version.
WDOG	Watchdog (WDOG) Peripheral.

Table 2 Device Peripherals

Accessing the Peripheral Examples

To access the peripheral examples take the following steps:

Clone or Download the repository to the following path in your Simplicity Studio installation:

C:\SiliconLabs\SimplicityStudio\v4\developer\sdks\gecko_sdk_suite\v#.#\app\

where #.# is the Gecko SDK suite version number

Import the example you want from Simplicity Studio by making one of the following series of clicks:

File -> Import, or

Project -> Import -> MCU Project

To access the examples from IAR, simply navigate to the desired .eww file and double click on it.

Micrium OS Module		Example
CANopen		CANopen Module Initialization Example
		CANopen Node Start Example
		CANopen Object Dictionary Read/Write Example
File System		File System Module Initialization Example
		File Read/Write Example
		File Read/Write with Posix API Example
		File Multi-Descriptors Example
		Entry Path Example
		Block Device Read/Write Example
		Media Polling Example
Network	FTP Client	Send Data from a buffer to a file on an FTP Server
		Upload a file to an FTP Server
		Receive a file into a buffer
		Download a file from an FTP server
	HTTP Client	HTTP Client Initialization Example
		HTTP Client GET Request Examples
		HTTP Client POST Request Examples
		HTTP Client PUT Request Examples
		HTTP Client Persistent Connection Examples
		HTTP Client Multi-connection Examples
	HTTP Server	HTTP Server Initialization Example
		Simple Server That Uses No File System
		Basic Server That Uses the HTTP Static File System
		Basic Server That Uses Micrium OS File System
		Server That Handles REST Requests
		Server That Handles Webpages, REST Requests and Authentication Support
		Basic Secure Server That Uses SSL-TLS and the HTTP Static File System
	IPerf	IPerf Initialization Example
	MQTT Client	MQTT Client Initialization Example
		MQTT Client Connect Example
		MQTT Client Publish Example
		MQTT Client Subscribe Example
		MQTT Client Echo Example
	Network Core	Network Module(s) Initialization Example
		Network Core Initialization Example
		Start Network Interface(s) Example
	SMTP Client	SMTP Client Initialization Example
	SMTP Client	SMTP Client Send Email Example
	SNTP Client	SNTP Client Initialization Example
	SNTP Client	Basic SNTP Current Time Retrieve
	Telnet Server	Telnet Server Initialization Example
	Telnet Server	Telnet Server Instance Example
	TFTP Client	Download and Upload a File to a TFTP Server
USB Device	Audio Class	USB Device Audio Class Loopback Example
	CDC ACM Class	USB Device CDC ACM Class Terminal Example
	CDC EEM Class	USB Device CDC EEM Class Example
	USB Device Core	USB Device Core Initialization Example
	HID Class	USB Device HID Class Mouse Example
	MSC Class	USB Device MSC Class Ramdisk LUN Example
	MSC Class	USB Device MSC Class Ramdisk Shared Example
	Vendor Class	USB Device Vendor Class Loopback Example
USB Host	Android Accessory Class	USB Host Android Accessory Class Example
	CDC ACM Class	USB Host CDC ACM Class Example
	USB Host Core	USB Host Module Simple Initialization Example
	USB Host Core	Simple Device Port Operation Example
	MSC Class	USB Host MSC Class Example
	USB-to-Serial Class	USB Host USB-to-Serial Class Example
Table 1. The Hidden Micrium OS Examples

How to run the hidden Micrium OS Examples

The process of including, configuring and initializing the examples is the same for all the examples and can be summarized as follows:

Start off with one of the examples available through Simplicity Studio by connecting your Kit and selecting an Example from the list as illustrated in Figure 1.

If the example project does not have the Micrium OS module files, then you need to include them by inserting in your project the folder located at ${StudioSdkPath}/platform/micrium_os/[module]/include and ${StudioSdkPath}/platform/micrium_os/[module]/source/[module] and configuring your compiler's include paths with the new paths.

Locate the header file rtos_description.h and insert the macro necessary to enable the module. For the full list of macros see this document.

Make sure you have in your project all the configuration files located in STUDIO_SDK_LOC\platform\micrium_os\cfg

Explore the examples listed in Table 1, select the one that you want and follow the corresponding hyperlink.

The hyperlink will take you to the example's documentation which provides four things:

Description: Brief description of the example
Configuration: The name of the #define that needs to be defined in ex_description.h
Location: The location of the files that need to be included
API: The API that needs to be called from your application to start the example

Locate the header file ex_description.h and define the corresponding macro if necessary as described in the example's documentation section: Configuration.

Include in your Simplicity Studio project the required files as listed in the example's documentation section: Location. In this step you can either create a link to the original folder or make a copy of the files and place them in your own workspace directory.

Configure your compiler's include paths with the new paths where the header files are located.

Insert a #include in your application, of the header file where the API to start the example is declared and call the API from your application to get the example started as described in the example's documentation section: API.

Example

To illustrate the process, I'm going to provide an example where one is interested in running an HTTP server:

Connect the SLSTK3701A and select the example SLSTK3701A_micriumos_net from Simplicity Studio.

Inspect which modules are included in the project by looking at the folder net in the Project Explorer. There you will notice that the module HTTP Server is missing.

Include the HTTP Server module by creating a new Linked Folder located at STUDIO_SDK_LOC\platform\micrium_os\net\source\http\server

Open the new folder Properties and either include or exclude the folder from compilation as necessary from the section C/C++ Build.

Open the Project Properties and insert the location to the new header files ${StudioSdkPath}/app/micrium_os_example/net/http/server in the section C/C++ General -> Paths and Symbols

Locate and open the header file rtos_description.h and insert the following line to enable the new HTTP Server Module: #define RTOS_MODULE_NET_HTTP_SERVER_AVAIL

Copy the configuration files from STUDIO_SDK_LOC\platform\micrium_os\cfg to your own workspace directory and make sure the compiler is aware of this include path.

Look at Table 1, locate the Example Basic Server That Uses the HTTP Static File System and explore the documentation.

Open the header file ex_description.h and insert the following line to enable the example: #define EX_HTTP_SERVER_INIT_AVAIL

Create a new Folder named Examples and then create a Linked Folder in it that points to STUDIO_SDK_LOC\app\micrium_os_example\net\http\server

Open the Project Properties and insert the path ${StudioSdkPath}/app/micrium_os_example/net in the section C/C++ General -> Paths and Symbols

Open the file ex_main.c and insert the following line at the top: #include "http/server/ex_http_server.h"

From the same file ex_main.c, locate the calls to the functions Ex_NetworkInit() and Ex_Net_CoreStartIF() and insert right after them, a call the following API to get the example started: Ex_HTTP_Server_InstanceCreateStaticFS();

22 days ago

Level 4

Level 3

Profile Data

Following 0

Followers 0