Package Details

Version: 3.1

CPU: Silicon Labs SiM3

CrossWorks Versions: 3.2 or later

Required Additional Packages

Supported Targets

SiM3C Series

SiM3C134
SiM3C136
SiM3C144
SiM3C146
SiM3C154
SiM3C156
SiM3C157
SiM3C164
SiM3C166
SiM3C167

SiM3L Series

SiM3L134
SiM3L136
SiM3L144
SiM3L146
SiM3L154
SiM3L156
SiM3L157
SiM3L164
SiM3L166
SiM3L167

SiM3U Series

SiM3U134
SiM3U136
SiM3U144
SiM3U146
SiM3U154
SiM3U156
SiM3U157
SiM3U164
SiM3U166
SiM3U167

Included Solutions

Silicon Labs SiM3 Samples Solution
Silicon Labs SiM3 CMSIS DSP Library Samples Solution
Silicon Labs SiM3 CTL Samples Solution
SiM3 Loader Application Solution

Silicon Labs SiM3 CPU Support Package

This package contains project templates and system files for the Silicon Labs SiM3.

CrossWorks Version 3 Installation Instructions

To install this support package

Click the Tools > Package Manager menu option to open the package manager window.
Right click on the Silicon Labs SiM3 CPU Support Package entry and select Install Selected Packages.
Click Next to take you to the summary page.
Click Next to install the package.
Click Finish to close the package manager window.
Click the Tools > Show Installed Packages.
Click on the Silicon Labs SiM3 CPU Support Package link to view the package and its contents.

To manually install this support package

If you have not done so already, follow the CMSIS 3 Support Package and CrossWorks Tasking Library Package installation instructions.
Download the file SiM3.hzq using your web browser.
Click the Tools > Manually Install Packages menu option.
Select the file you have just downloaded to install the package.
Click the Tools > Show Installed Packages.
Click on the Silicon Labs SiM3 CPU Support Package link to view the package and its contents.

To install this support package using other versions

CrossWorks Version 4 Installation Instructions

Release Notes

Documentation

Creating SiM3 Projects

To create a new SiM3 project

Select the File > New > New Project menu item.
Select the appropriate Generic SiM3 from the Categories list.
Select the required project template type from the Templates list.
Set the required project name and location directory.
Click OK.

To build and debug an application the runs in Flash memory

Select the project to work on by using the Project > Set Active Project menu option.
Select the configuration you require by using the Build > Set Active Build Configuration menu option.
Right click on the project node in the project explorer and select the Flash placement property.
Build the project by using the Build > Build Project menu option.
Connect to the appropriate target in the target window.
Download and start debugging the current project by using Debug > Start Debugging.

To make the application startup from reset

Right click on the project node in the project explorer and select Properties...
In the properties window scroll down to the Preprocessor Options section.
Type STARTUP_FROM_RESET into the Preprocessor Definitions property editor.

SiM3 Project Specifics

Target Processor

Once a project has been created you can select different target processors by right clicking on the project node in the project explorer and selecting the Target Processor entry.

Selecting the target processor will specify the memory map that is used for the build and debug. You can view the selected memory map by right clicking on the project node in the project explorer and selecting Edit Memory Map.

Section Placement

CrossStudio for ARM supports SiM3 projects running applications in a number of different memory configurations. You can select the memory configuration you require by right clicking on the project node in the project explorer and selecting the Placement property.

For SiM3 projects the set of placements are:

Flash application runs in internal Flash memory.
Flash Vectors In RAM application run in internal Flash memory exception vectors are copied to RAM memory.
Flash Copy To RAM application starts in internal flash and copies itself to run internal RAM memory.
RAM application runs internal RAM memory.

Stack and Heap Sizes

The stack and heap sizes are set to be 128 bytes by default when a project is created. It is likely that you will need to change these values when developing applications to run on the larger of the SiM3 processors.

Target Startup Code

The startup code SiM3_Startup.s is common to all SiM3 processors. There are a set of preprocessor defines that configure the startup code and are documented in the startup file itself. The startup code calls out to a weak symbol SystemInit with the stack pointer set to the top of the first block of SRAM. The SystemInit function can be used to set the CPU clock or configure any external memories prior to the C initialisation code as such it cannot access initialised static data.

The startup code declares symoblic names (and weak implementations) for each interrupt service routine, for example the CMP0_IRQHandler function will be called when this interrupt occurs. If you are porting code that has application specific interrupt service routine names then you can use the preprocessor definitions to rename the symbol for example CMP0_IRQHandler=MyCMP0_IRQHandlerISR.

Target Reset Script

The reset script SiM3_Target.js is used by the debugger to reset the target board.

Memory Simulator

An SiM3 memory simulator is provided that simulates the memories of the various devices. The memory simulation parameter (which is set by the Target Processor selection) specifies the device name, the size of the internal Flash and RAM memories.