Silicon Laboratories F321DC User manual

ToolStick-F321DC

TOOLSTICK C8051F321 DAUGHTER CARD USER’SGUIDE

1. Handling Recommendations

To enable development, the ToolStick Base Adapter and daughter cards are distributed without any protective

plastics. To prevent damage to the devices and/or the host PC, please take into consideration the following

recommendations when using the ToolStick:

Never connect or disconnect a daughter card to or from the ToolStick Base Adapter while the Base Adapter is

connected to a PC.

Always connect and disconnect the ToolStick Base Adapter from the PC by holding the edges of the boards.

Figure 1. Proper Method of Holding the ToolStick

Avoid directly touching any of the other components.

Figure 2. Improper Method of Holding the ToolStick

Manipulate mechanical devices on the daughter cards, such as potentiometers, with care to prevent the Base

Adapter or daughter card from accidentally dislodging from their sockets.

ToolStick-F321DC

2 Rev. 0.1

2. Contents

The ToolStick-F321DC kit contains the following items:

ToolStick C8051F321 Daughter Card

A ToolStick daughter card requires a ToolStick Base Adapter to communicate with the PC. ToolStick Base Adapters

can be purchased at www.silabs.com/toolstick.

3. ToolStick Overview

The purpose of the ToolStick is to provide a development and demonstration platform for Silicon Laboratories

microcontrollers and to demonstrate the Silicon Laboratories software tools, including the Integrated Development

Environment (IDE).

The ToolStick development platform consists of two components: the ToolStick Base Adapter and a daughter card.

The ToolStick Base Adapter provides a USB debug interface and data communications path between a Windows

PC and a target microcontroller.

The C8051F321 Daughter Card includes a pair of LEDs, a potentiometer, a micro USB connector, a switch

connected to a GPIO, and a small prototyping area which provides access to all of the pins of the device. This

prototyping area can be used to connect additional hardware to the microcontroller and use the daughter card as a

development platform.

Figure 3 shows the ToolStick C8051F321 Daughter Card and identifies the various components.

Figure 3. ToolStick C8051F321 Daughter Card

F321 U2

TOOLSTICK F321 DC

PWR

GND

Px.0 Px.1 Px.2 Px.3 Px.4 Px.5 Px.6 Px.7

VDD

GND

VBUS_BA

VBUS_COMM

VBUS

Power LED

P2.2 LED

P1.7 Potentiometer P2.0 Switch

USB

Connector

Full Pin

access

P2.0

P1.7

P2.2

C8051F321

ToolStick-F321DC

Rev. 0.1 3

4. Getting Started

The necessary software to download, debug and communicate with the target microcontroller must be downloaded

from www.silabs.com/toolstick. The following software is necessary to build a project, download code to, and

communicate with the target microcontroller:

Silicon Laboratories Integrated Development Environment (IDE)

Keil Demonstration Tools

ToolStick Terminal application

The Keil Demo Toolset includes a compiler, assembler, and linker. See Section “5.2.2. Keil Demonstration C51 C

Compiler” for more details about the demo tools. ToolStick Terminal communicates with the target microcontroller's

UART through the ToolStick Base Adapter. It can also read/write the two GPIO pins available on the ToolStick Base

Adapter.

Other useful software that is provided on the Silicon Labs Downloads (www.silabs.com/mcudownloads) website

includes:

Configuration Wizard 2

Keil uVision2 and uVision3 Drivers

The software described above is provided in several download packages. The ToolStick download package

includes example code, documentation, including user’s guides and data sheets, and the ToolStick Terminal

application. The IDE, Keil Demonstration Tools, Configuration Wizard 2, and the Keil µVision Drivers are available

as separate downloads. After downloading and installing these packages, see the following sections for

information.

5. Software Overview

5.1. Silicon Laboratories IDE

The Silicon Laboratories IDE integrates a source code editor, source-level debugger, and an in-system Flash

programmer. See Section “6. ToolStick C8051F321 Daughter Card Features Demo” for detailed information on how

to use the IDE. The Keil Demonstration Toolset includes a compiler, linker, and assembler and easily integrates

into the IDE. The use of third-party compilers and assemblers is also supported.

5.1.1. IDE System Requirements

The Silicon Laboratories IDE requirements:

Pentium-class host PC running Microsoft Windows 2000 or newer.

One available USB port.

5.1.2. 3rd Party Toolsets

The Silicon Laboratories IDE has native support for many 8051 compilers. The full list of natively supported tools is:

Keil

IAR

Raisonance

Tasking

Hi-Tech

SDCC

Please note that the demo applications for the C8051F321 Daughter Card are written for the Keil toolset.

ToolStick-F321DC

4 Rev. 0.1

5.2. Keil Demonstration Toolset

5.2.1. Keil Assembler and Linker

The Keil demonstration toolset assembler and linker place no restrictions on code size.

5.2.2. Keil Demonstration C51 C Compiler

The evaluation version of the C51 compiler is the same as the full version with the following limitations:

Maximum 4 kB code generation.

There is no floating point library included.

When initially installed, the C51 compiler is limited to a code size of 2 kB, and programs start at code address

0x0800. Refer to “AN104: Integrating Keil Tools into the Silicon Labs IDE" for instructions to change the

limitation to 4 kB and have the programs start at code address 0x0000.

5.3. Configuration Wizard 2

The Configuration Wizard 2 is a code generation tool for all of the Silicon Laboratories devices. Code is generated

through the use of dialog boxes for each of the device's peripherals.

Figure 4. Configuration Wizard 2 Utility

The Configuration Wizard 2 utility helps accelerate development by automatically generating initialization source

code to configure and enable the on-chip resources needed by most design projects. In just a few steps, the wizard

creates complete startup code for a specific Silicon Laboratories MCU. The program is configurable to provide the

output in C or assembly.

For more information, please refer to the Configuration Wizard 2 documentation. The documentation and software

available from the Downloads webpage (www.silabs.com/mcudownloads).

ToolStick-F321DC

Rev. 0.1 5

5.4. Keil uVision2 and uVision3 Silicon Laboratories Drivers

As an alternative to the Silicon Laboratories IDE, the uVision debug driver allows the Keil uVision2 and uVision3

IDEs to communicate with Silicon Laboratories on-chip debug logic. In-system Flash memory programming

integrated into the driver allows for rapidly updating target code. The uVision2 and uVision3 IDEs can be used to

start and stop program execution, set breakpoints, check variables, inspect and modify memory contents, and

single-step through programs running on the actual target hardware.

For more information, please refer to the uVision driver documentation. The documentation and software are

available from the Downloads webpage (www.silabs.com/mcudownloads).

5.5. ToolStick Terminal

The ToolStick Terminal program provides the standard terminal interface to the target microcontroller's UART.

However, instead of requiring the usual RS-232 and COM port connection, ToolStick Terminal uses the USB

interface of the ToolStick Base Adapter to provide the same functionality.

In addition to the standard terminal functions (send file, receive file, change baud rate), two GPIO pins on the target

microcontroller can be controlled using the Terminal for either RTS/CTS handshaking or software-configurable

purposes (see the demo software for an example).

See Section "6.8. Using ToolStick Terminal‚" on page 12 for more information. The software is available on the

ToolStick webpage (www.silabs.com/toolstick).

ToolStick-F321DC

6 Rev. 0.1

6. ToolStick C8051F321 Daughter Card Features Demo

The ToolStick kit includes a few simple code examples. The example described in this section is titled

F321DC_FeaturesDemo. The purpose of this example is to guide a new user through the features and capabilities

of the IDE and demonstrate the microcontroller’s on-chip debug capabilities. The F321DC_FeaturesDemo

example code uses the potentiometer on the daughter card to vary the blinking rate of the LED. The first part of

this demo shows how to use the IDE to connect and download the firmware, view and modify registers, use watch

windows, use breakpoints, and single step through code. The second part of the demo shows how to use ToolStick

Terminal to receive UART data from the daughter card and how to use the GPIO pins.

6.1. Hardware Setup

Connect the ToolStick hardware to the PC using the steps below while taking note of the recommendations in

Section 1:

1. Connect the ToolStick Base Adapter to the ToolStick C8051F321 Daughter Card.

2. If available, connect the USB extension cable to the ToolStick Base Adapter.

3. Connect the ToolStick to a USB port on a PC.

See Figure 5 below for an example hardware setup using the C8051F330 ToolStick Daughter Card.

Figure 5. Hardware Setup Example

ToolStick-F321DC

Rev. 0.1 7

6.2. Connecting to the Device and Downloading Firmware

This section describes how to open the IDE, open and build a project, connect to a device and download the

firmware.

1. Open the Silicon Laboratories IDE from the Start →Programs →Silicon Laboratories menu.

2. In the IDE, go to Project →Open Project.

3. Browse to the default location, C:\SiLabs\MCU\ToolStick\F321DC\Firmware\.

4. Select F321DC_FeaturesDemo.wsp and click OK.

5. In the IDE, select Project →Rebuild Project.

6. Go to Options →Connection Options.

7. Select “USB Debug Adapter” for the Serial Adapter and “C2” for the Debug Interface, and then click “OK”.

8. Go to Debug →Connect.

9. Download the code using the download button on the menu bar or use alt-D.

Once these steps are completed, the firmware is built into an object file (step 5) and downloaded to the device

(step 9). The device is now ready to begin executing code. If all of these steps were followed successfully, the “Go”

option is enabled in the Debug menu. A green circle icon in the IDE toolbar also indicates that the device is ready

to run. If one of the steps leads to an error, make sure that the ToolStick is properly inserted in a USB port and start

again with step 6.

6.3. Running and Stopping Code Execution

Once the IDE is connected to the device and the firmware is loaded, the IDE can start and stop the code execution.

The following steps can be performed using the buttons on the toolbar or using the options in the Debug menu.

1. To start code execution, click the green “Go” button on the toolbar or use the Debug →Go menu option. The

green LED on the daughter card will start to flash. The debug commands in the IDE (single-step, multiple-step,

set breakpoint, and others) are disabled when the device is running.

While the firmware is running, the

potentiometer on the daughter card can be turned to alter the blinking speed of the LED. The switch labeled S1

can also be pressed to toggle the ADC on and off. When the ADC is off, the blink rate or brightness of the LED will

not change.

2. To stop code execution, click the red “Stop” button on the toolbar or use the Debug →Stop menu option. The

device will halt code execution and all of the registers and pins on the device will hold their state.

All debug windows and watch windows are refreshed when the device is stopped. If any of the values in these

windows have changed since the last time the device was halted, the new value is shown in red text instead of

black text.

ToolStick-F321DC

8 Rev. 0.1

6.4. Viewing and Modifying Registers

All registers on the device can be viewed and modified when the device is in a halted state. The registers are

grouped together according to which peripheral or part of hardware they belong. As an example, this guide shows

how to open the ADC0 Debug Window and disable the ADC0 directly from the IDE.

1. Open the ADC0 Debug Window from the View →Debug Windows →SFR’s →ADC0 menu option. The

ADC0 Debug Window appears on the right-hand side of the IDE. In this window, the ADC0CN register is

shown. This register is used to enable and configure the on-chip ADC. When the firmware is running, the

ADC0CN register reads as 0x82 indicating that the ADC is running.

2. In the debug window, change the value of ADC0CN from 0x82 to 0x02. This value turns off the ADC on the

target microcontroller.

3. To write this new value to the device, select Refresh from the Debug Menu or click the Refresh button in the

toolbar.

4. Click “Go” to resume running the device with the new ADC0CN value.

5. Turn the potentiometer on the daughter card and notice that it has no effect on the blinking rate of the LED.

6. Re-enable the ADC by writing 0x82 to the ADC0CN and clicking the Refresh button.

Changing the values of registers does not require recompiling the code and redownloading the firmware. At any

time, the device can be halted and the values of the registers can be changed. After selecting “Go”, the firmware

will continue execution using the new values. This capability greatly speeds up the debugging process. See the

data sheet for the C8051F32x device family for the definitions and usage for all registers.

The debug windows for other sets of registers are found in the View →Debug Windows →SFR’s menu.

ToolStick-F321DC

Rev. 0.1 9

6.5. Enabling and Using Watch Windows

The Debug Windows in the View menu are used to view and modify hardware registers. To view and modify

variables in code, the IDE provides Watch Windows. Just as with register debug windows, variables in the watch

windows are updated each time the device is halted. This section of the User’s Guide explains how to add a

variable to the watch window and modify the variable. In the F321DC_FeaturesDemo example code, the variable

Num_LED_Flashes is a counter that stores the number of times the LED blinks.

1. If the device is running, stop execution using the “Stop” button or use the Debug →Stop menu option.

2. In the File View on the left-hand side of the IDE, double-click on F321DC_FeaturesDemo.c to open the source

file.

3. Scroll to the ADC0_ISR function and right-click on the variable “Num_LED_Flashes”. In the context menu that

appears, select “Add Num_LED_Flashes to Watch” and then choose “Default.” On the right-hand portion of

the IDE, the watch window appears and the variable is added. The current value of the variable is shown to the

right of the name.

4. Start and stop the device a few times. See that the value of the Num_LED_Flashes is incremented each time

the LED blinks.

5. When the device is halted, click on the value field in the watch window and change the value to 0. Then click the

Refresh button or select Debug →Refresh to write the new value to the device.

6. Start and stop the device a few times to watch the variable increment starting at 0.

Changing the values of variables does not require recompiling the code and redownloading the firmware. At any

time, the device can be halted and the values of the variables can be changed. The firmware will continue

execution using the new values.

ToolStick-F321DC

10 Rev. 0.1

6.6. Setting and Running to Breakpoints

The Silicon Laboratories microcontroller devices support up to four hardware breakpoints. A breakpoint is

associated with a specific line of code. When the processor reaches a hardware breakpoint, the code execution

stops, and the IDE refreshes all debug and watch windows. The on-chip debug hardware allows for breakpoints to

be placed on any line of executable code, including code in Interrupt Service Routines. This section provides steps

to set a breakpoint on the line of source code that increments the Num_LED_Flashes variable.

1. If the device is running, stop execution using the "Stop" button or use the Debug→Stop menu option.

2. Scroll to the ADC0_ISR function and right-click on the variable "Num_LED_Flashes". In the context menu that

appears, select "Insert/Remove Breakpoint." On the left side of the line in the editor window, a red circle is

added to indicate a breakpoint is placed on the source line.

3. Click the "Go" button or select the Debug→Go menu option.

4. After a short time, the IDE will show that the device is halted. A blue line will be placed in the editor window to

indicate where the code execution has stopped.

5. Start and stop the processor a few more times. Notice that the LED blinks once for every time the processor is

started and the Num_LED_Flashes variable also increments by one.

This manual suits for next models

Table of contents

Other Silicon Laboratories Computer Hardware manuals

Silicon Laboratories

Silicon Laboratories Si825x User manual

Silicon Laboratories

Silicon Laboratories Si5319 Series User manual

Silicon Laboratories

Silicon Laboratories C8051F04X-DK User manual

Silicon Laboratories

Silicon Laboratories BRD4170A User manual

Silicon Laboratories

Silicon Laboratories EFR32xG21 Wireless Gecko User manual

Silicon Laboratories

Silicon Laboratories CP240 Series User manual

Silicon Laboratories

Silicon Laboratories SLWSTK6240A User manual

Silicon Laboratories

Silicon Laboratories EFR32xG14 Wireless Gecko User manual

Silicon Laboratories

Silicon Laboratories SI5324 User manual

Silicon Laboratories

Silicon Laboratories SLWSTK6060B User manual

Silicon Laboratories

Silicon Laboratories EFR32MG1 User manual

Silicon Laboratories

Silicon Laboratories WFM200S User manual

Silicon Laboratories

Silicon Laboratories Alcom UG525 User manual

Silicon Laboratories

Silicon Laboratories TOOLSTICK EK User manual

Silicon Laboratories

Silicon Laboratories C8051T620/2-DK User manual

Silicon Laboratories

Silicon Laboratories Si446 Series User manual

Silicon Laboratories

Silicon Laboratories Si5328 User manual

Silicon Laboratories

Silicon Laboratories SLWSTK6243A User manual

Silicon Laboratories

Silicon Laboratories SiM3L1xx User manual

Silicon Laboratories

Silicon Laboratories QSG120 User manual

Silicon Laboratories

Silicon Laboratories UG291 User manual

Silicon Laboratories

Silicon Laboratories UG319 User manual

Silicon Laboratories

Silicon Laboratories Si114X User manual

Silicon Laboratories

Silicon Laboratories BRD4259A User manual

Popular Computer Hardware manuals by other brands

EMC2

EMC2 VNX Series Hardware Information Guide

Panasonic

Panasonic DV0PM20105 Operation manual

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 user manual

Gigabyte

Gigabyte B660M DS3H AX DDR4 user manual

Raidon

Raidon iT2300 Quick installation guide

National Instruments

National Instruments PXI-8186 user manual

Hauppauge

Hauppauge WinTV-HVR-2250 Quick installation guide

Kontron

Kontron CP6002 user guide

Manhattan

Manhattan 702843 user manual

Aphex

Aphex 230 instruction manual

AMD

AMD Phenom II Product data sheet

Intel

Intel NUC 12 Pro user guide

dbx

dbx Zone Pro 1260 user manual

Galaxy

Galaxy GHDX2-2430S-24F4D Installation and hardware reference manual

Intel

Intel AXXRMFBU4 Quick installation user's guide

Kontron

Kontron DIMM-PC/MD product manual

ST X-NUCLEO-SAFEA1B How to use

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 installation manual