AN670
G
ETTING
S
TAR TED WITH TH E
S
I L I C O N
L
A B S
P
RECISION
32™ A
PP
B
UILDER
1. Introduction
Precision32™ AppBuilder is a software program that generates configuration code for MCU devices. The software
dynamically generates configuration code for peripherals, clocks, and pins in user-definable modes, greatly
simplifying the device initialization process. This application note overviews the AppBuilder software for the Silicon
Labs 32-bit microcontrollers.
Figure 1. Precision32 AppBuilder
2. Key Points
Creating
and navigating a new project
Configuring peripherals, clocks, pins, and modes
Exporting a project
3. Relevant Documentation
Precision32 Application Notes are listed on the following website: www.silabs.com/32bit-mcu.
AN663:
Precision32™ MCU Family Clocking Options
AN664: Precision32™ CMSIS and HAL User’s Guide
AN667: Getting Started with the Silicon Labs Precision32™ IDE
AN671: Precision32™ Port I/O Crossbar Decoder
Rev. 0.2 9/12
Copyright © 2012 by Silicon Laboratories
AN670
AN670
4. Creating a New Project
1. Start a new project by selecting
New Project…
from the File menu, or click the
New Project…
link on the
Start Page. This will display a
New Project
window.
Figure 2. Creating a New Project
2. In the
New Project
window, select the Family, Device, Revision, and SDK version. Each selection will
reveal all other possible selections.
a. The Revision selection is the MCU device revision.
b. The SDK version determines the functions used by AppBuilder. This selection should match the SDK
base path.
3. Name the project and select the location where the generated source will be exported.
4. Select the toolset (IDE) and compiler.
5. Select the Silicon Labs 32-bit SDK base path (C:\SiLabs\32bit\si32-x.y by default). This selection should
match the SDK version.
6. Click OK.
2
Rev. 0.2
AN670
5. Migrating a Project
AppBuilder includes a project migration feature to update a created project with a new device family, new device
within the same family, device revision, or SDK version. This allows existing and complicated projects to be easily
ported without redoing all the peripheral, clock, and pin configurations manually.
To migrate a project:
1. Go to the
Project
menu and select
Migrate Project....
Figure 3. Migrating a Project
2. In the
Migrate Project
dialog, select the new settings. The
Change family, device, or rev
checkbox must
be checked to change the hardware platform. If the hardware platform changes, the project should be
generated to a new location to prevent any build errors. The
Show Report
and
Create Backup
options are
enabled by default.
This must be
checked to change
the device type or
revision
Select new
SDK version
Figure 4. Migrate Project Options
Rev. 0.2
3
AN670
3. Press
OK.
4. If the
Show Report
option remains enabled, AppBuilder generates a report of the migration results. This
report contains a summary of the migration process and any Errors, Warnings, or Messages that resulted
from the operation.
Migration
Summary
Figure 5. Project Migration Report
4
Rev. 0.2
AN670
6. Navigating in AppBuilder
Figure 6 shows the basic AppBuilder components: Project window, Source Layout, Error and Warning list, Canvas,
Toolbox window, Power Tips, and Properties window.
Canvas
Project
window
Power Tips
Toolbox
window
Source
Layout
Error and
Warning list
Properties
window
Figure 6. AppBuilder Project Components
6.1. Project Window
The
Project Window
contains the project modes. Each mode has a set of peripherals, clock settings, and port I/O
configurations.
Clicking on the part number at the top of the window will open the project properties configured in the
New Project
window and in the
Properties
window.
6.2. Source Layout
The
Source Layout
window shows the current files included in the project. Each of the files can be opened to view
their current state.
Note:
The source files in the
Source Layout
window are read-only and do not exist on disk until the project is exported.
Rev. 0.2
5