onsemi Ezairo 8300 User manual

Ezairo®8300 Software Development Kit Getting
Started Guide
M-20865-010
June 2022
© SCILLC, 2022
Previous Edition © 2021
"All Rights Reserved"
onsemi Confidential

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Table of Contents
Page
Ezairo®8300 Software Development Kit Getting Started Guide 1
Table of Contents 2
1. Introduction 4
1.1 Purpose 4
1.2 Intended Audience 4
1.3 Conventions 4
1.4 Further Reading 4
2. Overview 5
2.1 High-Level Overview 5
2.2 Features 5
3. Connecting Hardware and Installing Software 7
3.1 Connecting the Hardware 7
3.1.1 Hardware Prerequisites 7
3.1.2 Connecting the Board 7
3.2 Software Prerequisites 9
3.3 Installing the Software 9
3.3.1 Using the ide.json File 9
3.4 Preparing the System to Build Source Code with the ASIP Designer toolchain 10
4. Working with Sample Applications 12
4.1 Starting the Ezairo 8300 SDK 12
4.2 CFX Assembler Sample Application 12
4.2.1 Importing and Building the CFX Assembler Sample Project 12
4.2.2 Debugging the CFX Sample Code 13
4.3 CFX C Sample Application 18
www.onsemi.com
2

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
4.3.1 Importing and Building the CFX C Sample Project 18
4.3.2 Debugging CFX C Sample Code 19
4.3.3 CFX C Debug Troubleshooting 19
4.4 Arm Cortex-M3 Processor Sample Application 20
4.4.1 Importing and Building an Arm Cortex-M3 Processor Sample Project 20
4.4.2 Debugging Arm Cortex-M3 Processor Sample Code 21
5. More Information 27
5.1 Where to Find PDF Documentation 27
5.2 Documentation Roadmap 27
www.onsemi.com
3

1. Introduction
1.1 PURPOSE
IMPORTANT: onsemi acknowledges that this document might contain the inappropriate terms “white list",
"master" and "slave”. We have a plan to work with other companies to identify an industry wide solution
that can eradicate non-inclusive terminology but maintains the technical relationship of the original wording.
Once new terminologies are agreed upon, future products will contain new terminology.
This group of topics describes how to begin using the Ezairo8300 Software Development Kit (SDK). It
provides the prerequisites and instructions necessary to install the relevant software, connect the hardware, and
develop applications for Ezairo8300 using the Synopsys® ASIP Designer™ toolchain. Sample applications are
included for introduction and practice purposes.
1.2 INTENDED AUDIENCE
This group of topics is for software developers who are designing and implementing Ezairo8300 applications.
1.3 CONVENTIONS
The following conventions are used in this group of topics to signify particular types of information:
monospace font
Macros, functions, defines and addresses.
italics
File and path names, or any portion of them.
<angle brackets>
Optional parameters and placeholders for specific information. To use an optional parameter or
replace a placeholder, specify the information within the brackets; do not include the brackets
themselves.
1.4 FURTHER READING
For more information about Ezairo8300, refer to the following documents:
•Ezairo8300 Hardware Reference
•Ezairo8300 Firmware Reference
•Introduction to Ezairo8300 Programming
•Ezairo8300 Evaluation and Development Board Manual
•Ezairo8300 Datasheet
onsemi Confidential
CHAPTER 1
www.onsemi.com
4

2. Overview
Ezairo8300 is an open-programmable DSP-based System-on-Chip (SoC) specifically designed for use in ultra-
low-power high-performance portable audio devices.
Ezairo8300 includes five programmable or semi-programmable processing cores, providing a high degree of
parallelism and flexibility:
•The CFX processor is an open-programmable dual-Harvard 24-bit digital signal processor (DSP), providing
support for any type of audio signal processing.
•The HEAR configurable accelerator core is optimized for pre-programmed functions that are frequently
needed in audio signal processing.
•The Filter Engine allows time domain filtering and supports an ultra-low-delay audio path.
•The Arm® Cortex®-M3 core functions as the system master.
•The LPDSP32 is an open-programmable dual-Harvard 32-bit DSP.
2.1 HIGH-LEVEL OVERVIEW
Each of the Ezairo8300‘s programmable cores has a separate toolchain which is integrated in the SDK.
Section3.4 “Preparing the System to Build Source Code with the ASIP Designer toolchain” on page10 contains
more information about the ASIP Designer toolchain for the CFX as a starting point. Information about the other
toolchains, and more information about the CFX toolchain, can be found in the relevant sections of related manuals.
2.2 FEATURES
Ezairo8300 includes the following features:
•Four ADCs with signal detection mode and 2 direct digital output drivers, with high quality and ultra-low
power performances
•Peripherals and interfaces needed to make it a complete hardware platform, when combined with non-volatile
memory, wireless transceivers or multiple sensors
•A neural network accelerator that allows the Ezairo8300 to perform neural network computations in a highly
efficient and flexible way
The architecture of the Ezairo8300 is shown in the "Ezairo 8300 Architecture Overview" figure (Figure 1).
onsemi Confidential
CHAPTER 2
www.onsemi.com
5

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 1. Ezairo 8300 Architecture Overview
www.onsemi.com
6

3. Connecting Hardware and Installing Software
This topic explains what you need for using the Ezairo8300 SDK, how to connect the onsemi Evaluation and
Development Board, and how to install the necessary software before you begin working.
3.1 CONNECTING THE HARDWARE
3.1.1 Hardware Prerequisites
The following items are needed before you can make connections:
•Ezairo8300 Evaluation and Development Board and a USB to Micro-USB cable
•A Promira programmer and its associated cables
•A computer running Windows
•A SEGGER J-Link™, if you are debugging the LPDSP32 processor
3.1.2 Connecting the Board
To connect the Evaluation and Development Board to a computer:
1. Check the jumper positions. The "Ezairo 8300 Evaluation and Development Board Diagram" figure (Figure
2), below, depicts the jumper positions necessary to power the Evaluation and Development Board from the
USB port and connect the Board to the Windows computer. The black rectangles in the diagram indicate the
required jumper positions.
NOTE: In order for the onboard flash (LE25S161) to work, the VDDO1−S header must be shorted
across only pins 1 and 2 OR only pins 7 and 8. It is important not to short 1 and 2 and 7 and 8 at
the same time. This supplies 1.8 V to the EEPROM.
2. Ensure that the power switch (SW1) is in the ON position.
onsemi Confidential
CHAPTER 3
www.onsemi.com
7

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 2. Ezairo 8300 Evaluation and Development Board Diagram
3. Once the jumpers are in the right positions, you can plug the micro USB cable into the socket (J5) on the
board. The LED close to the USB connector flashes green when it is initially plugged in. After a second or
two, the green LED turns a steady green to show an established connection. If there are any communication
issues and the USB port cannot establish a connection with the Ezairo8300, the LED flashes red instead of
green, and continues to flash. If this occurs, double check the jumper configuration and ensure that the ON-
OFF switch is set to ON.
4. To enable debugging of a CFX program, connect the cable from the Promira to the development board socket
J1. If you are only debugging a CFX program and not an Arm Cortex-M3 core program, it is also possible to
power the board from the Promira by moving the PSU_SEL jumper to the 3-4 position, and then the USB
cable is not required. More information about this can be found in the Ezairo8300 Evaluation and
Development Board Manual.
www.onsemi.com
8

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
3.2 SOFTWARE PREREQUISITES
Ezairo8300 SDK (available at www.onsemi.com)
The ASIP Programmer tools require the Visual C++ 2015 64-bit runtime be installed. If you do not have Visual
Studio or Visual C++ 2015 installed, you can download the runtime redistributable from the address below:
https://www.microsoft.com/en-us/download/confirmation.aspx?id=52685
NOTE: The ASIP Designer is a license based product which requires access to a license server. To
configure the license server location, use the User_Setup.exe tool located in the following
directory, where <version> is the installed version number of the tool (e.g.: P-2019.03-SP2):
C:/Program Files (x86)/ON Semiconductor\Ezairo 8300 SDK\ASIP Programmer\<version>\win64\bin\WINbin
3.3 INSTALLING THE SOFTWARE
To install the SDK, run the Ezairo_8300_SDK_<version>.exe application, where <version>is the the SDK
version number. If you are using Windows 10, the installer prompts you to run as an administrator.
The installer copies the files to C:/Program Files (x86)/ON Semiconductor\Ezairo8300 SDK by default.
The installer also copies the Ezairo8300 device support files into C:\Program Files (x86)\Common
Files\SignaKlara\CTK.
A desktop link to the Ezairo8300 SDK is installed. Use this for opening the SDK, so that it can properly
configure the build environment for the SDK.
3.3.1 Using the ide.json File
ide.json is a JSON-format file that includes all the paths that need to be in your system variable path, and all the
necessary environment variables, so that your Ezairo8300 SDK code projects can work properly.
The ide.json file is included with your Ezairo8300 SDK install. The "Default ide.json File" figure (Figure 3)
shows an example of the file’s contents, which can change from release to release.
www.onsemi.com
9

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 3. Default ide.json File
As the figure shows, the ide.json file’s path array contains all the recommended system variable paths, whereas
env is a dictionary containing all the necessary key value pairs for the environment variables.
The ide.json file contains the default paths when you download it along with the SDK. However, the tools you
want to use in your coding projects might be different locations from the default ones shown in the file. If so, you
can carefully edit the file, by following these steps:
1. Before you do anything else, back up the file in its original default configuration.
CAUTION: Do not neglect this step! If ide.json is deleted, or if its syntax is incorrect, the SDK cannot
work properly, so be sure you have a backup of the original.
2. Edit the file so that it points to locations appropriate for your system.
NOTE: You need administrator rights to edit ide.json if the Ezairo8300 SDK has been installed in its
default location.
3. Save the edited file; and keep the backup of the original version, just in case.
3.4 PREPARING THE SYSTEM TO BUILD SOURCE CODE WITH THE ASIP DESIGNER TOOLCHAIN
Prior to starting the IDE you need to create a new environment variable, which the IDE uses to find the
Synopsys license server. The environment variable needs to be named SNPSLMD_LICENSE_FILE. The value of this
variable needs to be the location of the license server being used, in the format port@ServerName. The default port
www.onsemi.com
10

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
is 27020, so the name of the license server needs to resemble 27020@YourServerName. See the "Adding the
SNPSLMD Environment Variable" figure (Figure 4) for an example. For further information, see
https://www.synopsys.com/support/licensing-installation-computeplatforms/licensing.html.
Figure 4. Adding the SNPSLMD Environment Variable
If this environment variable is entered incorrectly, any attempt to create an ASIP Debug configuration fails, with
a message indicating that the plugin cannot load a debug configuration class. (See the "ASIP Debug Configuration
Error" figure (Figure 5).)
Figure 5. ASIP Debug Configuration Error
The IDE can also fail in other ways when attempting to use ASIP plugins if this environment variable is
incorrect.
Once the SDK has been started, there is one more step to perform before you can build code using the ASIP
Designer toolchain: configure the location of the processor model project file cf624c.prx. To do this, follow the
steps below:
1. Click on the menu item ASIP Designer and select Add/Remove ASIP Processor(s).
2. The dialog that pops open must not have any previous processor models populated.
3. Select Add ASIP. A new dialog appears, asking for the location of the ASIP processor's .prx file. If the
installation has been performed to the default location, you can point to the following file:
C:/Program Files (x86)/ON Semiconductor\Ezairo8300 SDK \cf624c-a20_<version>\lib\cf624c.prx
4. Click Open, then click Done to save the new location of the project file.
5. A window pops up, asking you to select the processors you want to activate. Select them, and choose
Activate.
6. Follow a similar process to add the processor model for LPDSP32.
www.onsemi.com
11

4. Working with Sample Applications
This topic contains basic information about working with the CFX Assembler, CFX C, and Arm Cortex-M3
processor sample application code, taking you through importing, building, and debugging three different kinds of
sample applications. For additional in-depth information about working with sample applications, including those
for the HEAR, Filter Engine, and LPDSP32 cores, see the Introduction to Ezairo8300 Programming. Note that the
intended usage for sample applications is for familiarizing yourself with possible uses for Ezairo8300 and becoming
comfortable with the development environment. Since Ezairo8300 relies on external non volatile memory and does
not contain on-chip flash memory, the expected usage for sample applications is debugging applications from RAM.
If you wish to build the sample applications into an NVM image for use with an external NVM device, take
care to read the appropriate information in the documentation to determine which modifications are needed. The
NVMUpdate utility found in the utilities folder of the SDKcan be used to download NVM images using I2C or
JTag. See the Integrated Development User’s Guide for Ezairo8300 or the readme file along with NVMUpdate for
more information.
4.1 STARTING THE EZAIRO 8300 SDK
1. If you are upgrading the Ezairo8300 SDK, create a new workspace at, for example, c:\workspace — using
either Windows Explorer or the onsemi Launcher in step 2.
2. Open the onsemi IDE by going to the Windows Start menu and selecting onsemi >Ezairo8300 SDK. From
the Ezairo8300 Development Tools IDE Launcher screen, browse to your new workspace, select it, and click
Launch.
4.2 CFX ASSEMBLER SAMPLE APPLICATION
4.2.1 Importing and Building the CFX Assembler Sample Project
To use the Ezairo8300 CFX DSP sample project included with this release, first start the Ezairo8300 SDK as
described in Section4.1 “Starting the Ezairo 8300 SDK” on page12.
To import sample applications in the Ezairo8300 SDK, use the Sample Code Explorer view. This view is open
by default in the C/C++ perspective when starting the SDK for the first time. To access the Sample Code Explorer
view at any other time, choose Window >Show View >Other > onsemi > Sample Code Explorer. The explorer
appears in the views panel in the lower section of the IDE.
In the Sample Code Explorer view, follow these steps to import the CFX assembler sample application:
1. In the Name panel at the lower part of the view, click the arrow next to Sample Code. This reveals the
samples directory.
2. Click the arrow next to samples. This opens a list of the sample applications. Clicking the arrow next to
CFX reveals the sample_CFX_assembly application.
3. Optional step: if you want to read the sample application’s readme file, click on the application name. The
readme file appears in a separate panel, providing a description of what the sample does.
4. To import the CFX sample project, right-click sample_CFX_assembly and select Import Single Project from
the dropdown menu.
5. A copy of the sample application is imported directly into your workspace, as can be seen in the Project
Explorer panel on the left side of the view. This copying does not modify the original source in the SDK
installation folder.
6. Right-click on the project’s name in the Project Explorer panel, and choose Build Project from the dropdown
menu. This builds the project with no errors.
onsemi Confidential
CHAPTER 4
www.onsemi.com
12

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Before starting development with the ASIP Programmer tools the developer must first point to the CFX or
LPDSP32 model library. To do this:
1. Click on the ASIP Designer menu item in the top menu and select Add/Remove ASIP Processor(s).
2. Click on Add ASIP in the right column.
3. When selecting the CFX processor point to a directory similiar to this: C:/Program Files (x86)/ON
Semiconductor\Ezairo 8300 SDK\cf624c<version>\lib, or C:/Program Files (x86)/ON Semiconductor\Ezairo
8300 SDK\lpdsp32<version>\lib for the LPDSP32 processor.
4. Click on Done to save and close the dialog.
5. After selecting the processors to include click on ASIP Designer >Select Active ASIP programmer
processor.
6. The dialog shows all selected processors and blank checkboxes beside them. Enable the checkboxes for the
processors you want to use with the ASIP programmer tools; multiple processors can be selected. When you
are done, click Finish to close the dialog box.
(See the ASIP Designer - ASIP Programmer Eclipse Reference Manual (eclipse-manual.pdf) for more
information.)
At this point the ASIP Programmer tools are configured for use with projects and debuggers.
4.2.2 Debugging the CFX Sample Code
NOTE: To change the Communication Toolkit (CTK) configuration used for CFX debugging, you can
set the E8300_CTK_CONFIG environment variable to any existing CTK configuration. By
default without the environment variable, the CFX_CFG_8300 configuration is used for CFX
debugging, which provides the ideal settings for Ezairo8300 when using Promira. Another
approach to changing the configuration used for CFX debugging (and loading of HEAR and
Filter Engine applications) is to edit the CFX_CFG_8300 CTK configuration. To change or
view CTK configurations such as this one (for example if you are using a CAA rather than the
Promira), open the CTK Configuration Manager using the Windows Search or Start Menu. It is
not possible to change the CTK configuration for a CFX debug session through the IDE, nor
the CTK configuration itself.
To debug the built code on the CFX, create a new debug configuration by following the steps outlined in the
"Creating CFX Assembler Debug Configuration, Step 1" figure (Figure 6):
1. Right click on the built .elf file (sample_CFX_assembly in this case) and select Debug As >Debug
Configurations.
www.onsemi.com
13

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 6. Creating CFX Assembler Debug Configuration, Step 1
2. The Debug Configurations dialog is displayed. Right click on the ASIP Designer Application configuration
type and select New (as shown in the "Creating CFX Assembler Debug Configuration, Step 2" figure (Figure
7)).
www.onsemi.com
14

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 7. Creating CFX Assembler Debug Configuration, Step 2
3. A new dialog is displayed, allowing you to create your debug configuration. Within this dialog the
following information must be added (shown for the sample_CFX_assembly executable):
a. In the Executable tab view, select your desired Project (in Figure 8,sample_CFX_assembly) and
Executable (in Figure 8,C:\eclipse-workspace\sample_CFX_assembly\Debug), and uncheck the box
labeled Stop At. (See the "Selecting Project and Executable" figure (Figure 8).)
www.onsemi.com
15

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 8. Selecting Project and Executable
b. In the ASIP Target tab view, click the Connection Type dropdown menu and select Remote
Hardware/Emulation (see "Selecting Connection Type" figure (Figure 9)).
www.onsemi.com
16

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
Figure 9. Selecting Connection Type
NOTE: The Debug Client is an application that is located in the model (selected during setup) under
the ISS directory. If Remote Hardware/Emulation is selected and a red Xappears on the
dialog, this indicates that cf624c_client might be missing. Check the ISS directory; if the file is
missing (cf624c_client.exe), it can be found in the Debug_Client directory off the root of the
SDK installation. Copying the client application into ISS resolves the issue.
All other information in the debug configuration can remain set to defaults. The debug client uses the CTK to
communicate with the chip, and always uses the CFX_CFG_8300 CTK configuration, which must be left as the
default Promira configuration. Host and Port are not used in this case.
www.onsemi.com
17

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
1. Click on Apply and Debug. The application begins loading to the device. If this is successful, an ASIP
Designer Debug session opens.
2. You are now able to step through the code, look at registers and memory views, and more.
4.3 CFX C SAMPLE APPLICATION
4.3.1 Importing and Building the CFX C Sample Project
To use the Ezairo8300 C sample project included with this release, start the Ezairo8300 SDK from the desktop
link.
To import sample applications in the Ezairo8300 SDK, use the Sample Code Explorer view. This view is open
by default in the C/C++ perspective when starting the SDK for the first time. To access the Sample Code Explorer
view at any other time, choose Window >Show View >Other > onsemi > Sample Code Explorer. The explorer
appears in the views panel in the lower section of the IDE.
In the Sample Code Explorer view, follow these steps to import the CFX C sample application:
1. In the Name panel at the lower part of the view, click the arrow next to Sample Code. This reveals the
samples directory.
2. Click the arrow next to samples. This opens a list of the sample applications. Clicking the arrow next to
CFX reveals the factorial_calculation_demo application.
3. Optional step: if you want to read the sample application’s readme file, click on the application name. The
readme file appears in a separate panel, providing a description of what the sample does.
4. To import the CFX sample project, right-click factorial_calculation_demo and select Import Single Project
from the dropdown menu.
5. A copy of the sample application is imported directly into your workspace, as can be seen in the Project
Explorer panel on the left side of the view. This copying does not modify the original source in the SDK
installation folder.
6. Right-click on the project’s name in the Project Explorer panel, and choose Build Project from the dropdown
menu. This builds the project with no errors.
Before starting development with the ASIP Programmer tools the developer must first point to the CFX or
LPDSP32 model library. To do this:
1. Click on the ASIP Designer menu item in the top menu and select Add/Remove ASIP Processor(s).
2. Click on Add ASIP in the right column.
3. When selecting the CFX processor point to a directory similiar to this: C:/Program Files (x86)/ON
Semiconductor\Ezairo 8300 SDK\cf624c<version>\lib, or C:/Program Files (x86)/ON Semiconductor\Ezairo
8300 SDK\lpdsp32<version>\lib for the LPDSP32 processor.
4. Click on Done to save and close the dialog.
5. After selecting the processors to include click on ASIP Designer >Select Active ASIP programmer
processor.
6. The dialog shows all selected processors and blank checkboxes beside them. Enable the checkboxes for the
processors you want to use with the ASIP programmer tools; multiple processors can be selected. When you
are done, click Finish to close the dialog box.
(See the ASIP Designer - ASIP Programmer Eclipse Reference Manual (eclipse-manual.pdf) for more
information.)
At this point the ASIP Programmer tools are configured for use with projects and debuggers.
www.onsemi.com
18

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
4.3.2 Debugging CFX C Sample Code
To debug the built factorial_calculation_demo sample code, which is implemented in C, follow the same
procedure described in Section4.2.2 “Debugging the CFX Sample Code” on page13.
4.3.3 CFX C Debug Troubleshooting
The following are some possible issues that may arise while debugging CFX C sample code, along with
recommended solutions to the problems:
Configuration is Blank with red X in tab:
If you see a screen like "CFX C Debug Configuration Setup Error" figure (Figure 10), below, when
you create a new ASIP Designer debug configuration, it indicates that you have not configured the
ASIP Designer with a model project yet, or that the processor has not been selected as active. To
resolve this, follow the instructions in Section3.4 “Preparing the System to Build Source Code
with the ASIP Designer toolchain” on page10.
Figure 10. CFX C Debug Configuration Setup Error
When the debugging operation begins, it stops with a launch error:
This indicates that the loading process has attempted to start, but has encountered an error. Some
possible causes and solutions for this are:
There might be no device or Promira connected. Make sure your Promira and device are properly
communicating. You can confirm your CTK configuration by using the CTK Configuration Manager (found in the
Windows Start menu under onsemi). Edit the CFX_CFG_8300 configuration and choose Test. Seeing the result
Configuration is okay confirms the configuration. If communication with the device is fine, the utility returns a
chip family of 10 (SK5). PSU-SEL pins 3 and 4 need to be shorted to power the board through the Promira. See the
Ezairo 8300 Evaluation and Development Board Manual for more information.
A license is required during debugging; if a license cannot be found for the Synopsys debugging tools, the
launch fails.
There might be issues with the Promira programmer. Two specific issues can cause problems:
www.onsemi.com
19

onsemi Confidential
Ezairo8300 Software Development Kit Getting Started Guide
When using the SV1 evaluation board, the Promira needs to have its pull-ups disabled; otherwise, false NAKs
occur.
The Promira cannot have an application load on boot, as it only supports 32-bit applications and the debugger
for Synopsys requires 64-bit support.
IMPORTANT: Depending on your individual or company configurations and restrictions in place when
using a Virtual Private Network, it might not be possible to use the Promira device when connected to VPN.
The CTK might have become corrupted. Either run the SDK installer and use the repair function to fix the CTK
installation, or click uninstall from the Windows Control Panel and then click on repair.
4.4 ARM CORTEX-M3 PROCESSOR SAMPLE APPLICATION
4.4.1 Importing and Building an Arm Cortex-M3 Processor Sample Project
To use the Arm Cortex-M3 processor sample projects, start the Ezairo8300 SDK from the desktop link.
To import sample applications in the Ezairo8300 SDK, use the Sample Code Explorer view. This view is open
by default in the C/C++ perspective when starting the SDK for the first time. To access the Sample Code Explorer
view at any other time, choose Window >Show View >Other > onsemi > Sample Code Explorer. The explorer
appears in the views panel in the lower section of the IDE.
In the Sample Code Explorer view, follow these steps to import an Arm Cortex-M3 processor sample
application:
1. In the Name panel at the lower part of the view, click the arrow next to Sample Code. This reveals the
samples directory.
2. Click the arrow next to samples. This opens a list of the sample applications. Clicking the arrow next to
Cortex-M3 reveals the Arm Cortex-M3 core applications.
3. Optional step: if you want to read the sample application’s readme file, click on the application name. The
readme file appears in a separate panel, providing a description of what the sample does.
4. To import an Arm Cortex-M3 processor sample application, right-click on the desired application name
(ASRC,blinky,cm3_bootloader,i2c_cmsis,swmTraceExample, or uart_cmsis) and select Import Single
Project from the dropdown menu.
5. A copy of the sample application is imported directly into your workspace, as can be seen in the Project
Explorer panel on the left side of the view. This copying does not modify the original source in the SDK
installation folder.
6. Right-click on the project’s name in the Project Explorer panel, and choose Build Project from the dropdown
menu. This builds the project with no errors.
IMPORTANT: The Ezairo 8300 SDK requires certain files to be present in the path when building Arm
Cortex-M3 processor-based applications. Depending on the system path configuration and/or command shells
present, the build might fail due to these files not being found. In some cases sh.exe is found, which also causes
a build to fail on Windows. To prevent such failures when generating a new project for the Arm Cortex-M3
core using File->New->C/C++ Project, add "SHELL=cmd" (no quotes, case sensitive) to the build command,
and uncheck "Use default build command", as shown in the "Build Argument Shell Command" figure (Figure
11). This is done in the Project Properties under the C/C++ Build->Builder Settings Tab.
www.onsemi.com
20