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