NXP MC56F84xxx User guide

Type
User guide

This manual is also suitable for

DSC56800EX Quick Start User’s
Guide
DSC56800EXQSUG
Rev. 4
10/2019
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors iii
Contents
Paragraph
Number Title
Page
Number
Chapter 1
Introduction
1.1 Overview.............................................................................................................1-1
1.1.1 Features..........................................................................................................1-1
1.2 Quick Start..........................................................................................................1-3
1.2.1 CodeWarrior for Microcontrollers ....................................................................1-4
1.2.2 Install DSC56800EX_Quick_Start ..................................................................1-4
1.2.3 Build and Run Sample Application ..................................................................1-9
Chapter 2 Stationery New Project Wizard
2.1 Installing New Project Wizard.............................................................................2-1
2.2 New Project Wizard Use.....................................................................................2-3
Chapter 3
Core System Infrastructure
3.1 Boot Sequence ...................................................................................................3-1
3.1.1 Power-up/Reset ..............................................................................................3-2
3.1.2 Start() - entry point ..........................................................................................3-2
3.1.3 userPreMain() .................................................................................................3-3
3.1.4 main() the User’s Application Code.................................................................3-3
3.1.5 userPostMain()................................................................................................3-3
3.2 Data Types..........................................................................................................3-3
3.3 ArchIO Peripheral Register Structures ...............................................................3-4
3.4 Core System’s Routines and Macros .................................................................3-5
3.4.1 Architecture dependent routines .....................................................................3-5
3.5 Macros for peripheral memory access..............................................................3-11
3.5.1 periphMemRead - memory read ...................................................................3-11
3.5.2 periphMemWrite - memory write...................................................................3-11
3.5.3 periphBitSet - set selected bits .....................................................................3-12
3.5.4 periphMemInvBitSet - invert memory content and set selected bits .............3-12
3.5.5 periphBitClear - clear selected bits ...............................................................3-13
3.5.6 periphBitGrpSR - set bit group to given value...............................................3-14
3.5.7 periphBitGrpSRVar - set bit group to given value .........................................3-14
3.5.8 periphBitGrpRS - set bit group to given value...............................................3-15
3.5.9 periphBitGrpRSVar - set bit group to given value .........................................3-16
3.5.10 periphBitGrpRS32 - set bit group to given value...........................................3-16
3.5.11 periphBitGrpZS - set bit group to given value ...............................................3-17
3.5.12 periphBitGrpZSVar - set bit group to given value..........................................3-18
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
iv NXP Semiconductors
Contents
Paragraph
Number Title
Page
Number
3.5.13 periphBitGrpSet - set bit group to given value ..............................................3-19
3.5.14 periphBitGrpSetVar - set bit group to given value .........................................3-19
3.5.15 periphBitGrpSet32 - set bit group to given value ..........................................3-20
3.5.16 periphSafeAckByOne - clear (acknowledge) bit flags which are active-high and
are cleared by write-one............................................................................3-21
3.5.17 periphSafeAckByOneVar - clear (acknowledge) bit flags which are active-high
and are cleared by write-one.....................................................................3-21
3.5.18 periphSafeBitClear - clear bits and keep value of bit flags which are cleared by
write-one....................................................................................................3-22
3.5.19 periphSafeBitSet - Set bits and keep value of bit flags which are cleared by
write-one....................................................................................................3-23
3.5.20 periphSafeBitSetVar - Set bits and keep value of bit flags which are cleared by
write-one....................................................................................................3-23
3.5.21 periphSafeBitSet32 - Set bits and keep value of bit flags which are cleared by
write-one....................................................................................................3-24
3.5.22 periphSafeBitGrpSet - set bit group to given value and keep value of bit flags
which are cleared by write-one..................................................................3-25
3.5.23 periphSafeBitGrpSetVar - set bit group to given value and keep value of bit flags
which are cleared by write-one..................................................................3-26
3.5.24 periphSafeBitGrpSet32 - set bit group to given value and keep value of bit flags
which are cleared by write-one..................................................................3-26
3.5.25 periphBitChange - change selected bits .......................................................3-27
3.5.26 periphBitTest - test selected bits ...................................................................3-28
3.5.27 periphMemDummyRead - memory dummy read..........................................3-28
3.5.28 periphMemForcedRead- memory force read (Never optimized out) ............3-29
3.5.29 Miscellaneous Routines ................................................................................3-29
3.5.30 Intrinsic Functions .........................................................................................3-32
3.6 Interrupts...........................................................................................................3-32
3.6.1 Processing Interrupts ....................................................................................3-32
3.6.2 Configuring Interrupts ...................................................................................3-35
3.6.3 Code Example ..............................................................................................3-37
3.7 Advanced Topics...............................................................................................3-44
3.7.1 Project Targets ..............................................................................................3-44
3.7.2 Inside Startup Code ......................................................................................3-45
Chapter 4
Directory Structure
4.1 Root Directory.....................................................................................................4-1
4.2 Sample Applications Directory ............................................................................4-1
4.3 Tools Directory....................................................................................................4-2
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors v
Contents
Paragraph
Number Title
Page
Number
4.4 Src Directory.......................................................................................................4-2
4.5 Stationery Directory ............................................................................................4-3
4.6 User_manuals Directory .....................................................................................4-3
Chapter 5
Developing Software
5.1 Creating a new project........................................................................................5-1
5.2 On-chip peripheral initialization...........................................................................5-5
5.3 On-chip drivers - interface description ................................................................5-6
5.3.1 ioctl() ...............................................................................................................5-7
5.3.2 read() ..............................................................................................................5-8
5.3.3 write() ..............................................................................................................5-8
5.4 Interrupts and Interrupt Service Routines...........................................................5-8
5.5 appconfig.h file....................................................................................................5-9
Chapter 6 On-chip Drivers
6.1 API Specification.................................................................................................6-4
6.1.1 12-bit Cyclic Analog-to-Digital Converter (ADC) Driver...................................6-6
6.1.2 16-bit SAR Analog-to-Digital Converter (ADC16) .........................................6-23
6.1.3 Crossbar AND/OR/INVERT (AOI) Driver ......................................................6-30
6.1.4 Computer Operating Properly (COP) Driver .................................................6-36
6.1.5 Cyclic Redundancy Check (CRC) Driver ......................................................6-38
6.1.6 12-bit Digital-to-Analog Converter (DAC) Driver ...........................................6-41
6.1.7 DMA Controller (DMA ) Driver .......................................................................6-45
6.1.8 Enhanced Direct Memory Access (eDMA)....................................................6-57
6.1.9 Enhanced Flexible Pulse Width Modulator (EFPWM) Driver........................6-69
6.1.10 Enhanced Quadrature Encoder/Decoder (ENC)...........................................6-92
6.1.11 Event Generator (EVTG) ..............................................................................6-99
6.1.12 External Watchdog Monitor (EWM) Driver ..................................................6-103
6.1.13 FlexCAN (FCAN) Driver..............................................................................6-106
6.1.14 Flash Memory Module (FTFA) Driver..........................................................6-116
6.1.15 Flash Memory Module (FTFL) Driver..........................................................6-117
6.1.16 Flash Memory Module (FTFE) ....................................................................6-118
6.1.17 Flash Memory Controller (FMC) Driver....................................................... 6-118
6.1.18 General-Purpose Input/Output (GPIO) Driver.............................................6-120
6.1.19 High Speed Comparator (HSCMP) Driver ..................................................6-124
6.1.20 Inter-Integrated Circuit (IIC) Driver..............................................................6-127
6.1.21 Interrupt Controller (INTC) Driver................................................................6-134
6.1.22 Miscellaneous Control Module (MCM) Driver .............................................6-136
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
vi NXP Semiconductors
Contents
Paragraph
Number Title
Page
Number
6.1.23 Modular/Scalable Controller Area Network (MSCAN) Driver ......................6-137
6.1.24 On-Chip Clock Synthesis (OCCS) Driver....................................................6-149
6.1.25 Periodic Interrupt Timer (PIT) Driver ...........................................................6-156
6.1.26 Power Management Controller (PMC) Driver .............................................6-158
6.1.27 Programmable Delay Block (PDB)..............................................................6-161
6.1.28 Quad Timer (QT) Driver ..............................................................................6-168
6.1.29 Queued Serial Communication Interface (SCI) Driver ................................6-175
6.1.30 Serial Peripheral Interface (SPI) Driver.......................................................6-181
6.1.31 System (SYS) Driver...................................................................................6-185
6.1.32 Inter-Peripheral Crossbar Switch (XBAR) Driver ........................................6-200
Chapter 7
FreeMASTER Driver
7.1 Introduction.........................................................................................................7-1
7.2 Driver Files..........................................................................................................7-2
7.3 Interrupt Handling ...............................................................................................7-3
7.4 New Features .....................................................................................................7-4
7.4.1 Target-side Addressing ...................................................................................7-4
7.4.2 Application Command Callbacks ....................................................................7-4
7.5 Driver Configuration............................................................................................7-4
7.6 Driver Usage.....................................................................................................7-10
7.6.1 Driver API......................................................................................................7-10
7.6.2 Code Listing: freemaster_demo....................................................................7-27
7.6.3 Code Listing: freemaster_demo2..................................................................7-32
Chapter 8
Graphical Configuration Tool
8.1 Introduction.........................................................................................................8-1
8.1.1 Features..........................................................................................................8-1
8.1.2 How does it work?...........................................................................................8-2
8.2 Program usage ...................................................................................................8-3
8.2.1 GUI Description...............................................................................................8-3
8.2.2 Application Configuration File Structure..........................................................8-9
Chapter 9
License
Chapter 10
Revision History
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors vii
Tables
Table
Number Title
Page
Number
Tables
3-1 archGetSetSaturationMode arguments...................................................................3-10
3-2 archDelay arguments ..............................................................................................3-10
3-3 periphMemRead arguments....................................................................................3-11
3-4 periphMemWrite arguments.................................................................................... 3-11
3-5 periphBitSet arguments...........................................................................................3-12
3-6 periphMemInvBitSet arguments..............................................................................3-12
3-7 periphBitClear arguments .......................................................................................3-13
3-8 periphBitSet arguments...........................................................................................3-14
3-9 periphBitSet arguments...........................................................................................3-14
3-10 periphBitSet arguments...........................................................................................3-15
3-11 periphBitSet arguments...........................................................................................3-16
3-12 periphBitSet arguments...........................................................................................3-17
3-13 periphBitSet arguments...........................................................................................3-17
3-14 periphBitSet arguments...........................................................................................3-18
3-15 periphBitSet arguments.....................................
......................................................3-19
3-16 periphBitSet arguments...........................................................................................3-19
3-17 periphBitSet arguments...........................................................................................3-20
3-18 periphSafeAckByOne arguments............................................................................3-21
3-19 periphSafeAckByOneVar arguments ......................................................................3-22
3-20 periphSafeBitClear arguments ................................................................................3-22
3-21 periphSafeBitSet arguments ...................................................................................3-23
3-22 periphSafeBitSetVar arguments..............................................................................3-24
3-23 periphSafeBitSet arguments ...................................................................................3-24
3-24 periphSafeBitGrpSet arguments .............................................................................3-25
3-25 periphSafeBitGrpSetVar arguments........................................................................3-26
3-26 periphSafeBitGrpSet arguments .............................................................................3-27
3-27 periphBitChange arguments ...................................................................................3-27
3-28 periphBitTest arguments .........................................................................................3-28
3-29 periphMemDummyRead arguments .......................................................................3-28
3-30 periphMemForcedRead arguments ........................................................................3-29
3-31 impyuu arguments...................................................................................................3-29
3-32 impysu arguments...................................................................................................3-30
3-33 shl2 arguments........................................................................................................3-31
3-34 shr2 arguments .......................................................................................................3-31
3-35 Targets of the MC56F83000EVK project.................................................................3-44
6-1 Driver Arguments - ioctl.............................................................................................6-4
6-2 Identifiers for ADC Driver ..........................................................................................6-6
6-3 ADC Driver Commands.............................................................................................6-6
6-4 Identifiers for ADC16 Driver ....................................................................................6-23
6-5 ADC16 Driver Command ........................................................................................6-23
6-6 Identifiers for AOI Driver..........................................................................................6-30
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
viii NXP Semiconductors
Tables
Table
Number Title
Page
Number
6-7 AOI Driver Commands ............................................................................................6-30
6-8 Identifiers for COP Driver ........................................................................................6-36
6-9 COP Driver Commands ..........................................................................................6-36
6-10 Identifiers for CRC Driver ........................................................................................6-38
6-11 CRC Driver Commands ..........................................................................................6-38
6-12 Identifiers for DAC Driver ........................................................................................6-41
6-13 DAC Driver Commands...........................................................................................6-41
6-14 Identifiers for DMA Driver .......................................................................................6-45
6-15 DMA Driver Commands ..........................................................................................6-45
6-16 Identifiers for DMA Driver ........................................................................................6-54
6-17 DAC_x Driver Commands.......................................................................................6-54
6-18 Identifiers for eDMA Driver ......................................................................................6-57
6-19 eDMA driver commands..........................................................................................6-57
6-20 Identifiers for EFPWM Driver ..................................................................................6-69
6-21 EFPWM Driver Commands.....................................................................................6-70
6-22 Identifiers for ENC Driver ........................................................................................6-92
6-23 ENC Driver Command ............................................................................................6-92
6-24 Identifiers for EVTG Driver ......................................................................................6-99
6-25 EVTG Driver Commands ........................................................................................6-99
6-26 Identifiers for EWM Driver .....................................................................................6-104
6-27 EWM Driver Commands .......................................................................................6-104
6-28 Identifiers for FCAN Driver ....................................................................................6-106
6-29 FCAN Driver Command ........................................................................................6-106
6-30 FCAN driver - MB-specific commands ..................................................................6-113
6-31 Identifiers for FTFA Driver .....................................................................................6-116
6-32 FTFA Driver Command ......................................................................................... 6-116
6-33 Identifiers for FTFL Driver .....................................................................................6-117
6-34 FTFL Driver Command..........................................................................................6-117
6-35 Identifiers for FTFE Driver.....................................................................................6-118
6-36 FTFE Driver Commands .......................................................................................6-118
6-37 Identifiers for FMC Driver ...................................................................................... 6-119
6-38 FMC Driver Command ..........................................................................................6-119
6-39 Identifiers for GPIO Driver.....................................................................................6-120
6-40 GPIO Driver Commands .......................................................................................6-120
6-41 Identifiers for HSCMP Driver.................................................................................6-124
6-42 HSCMP Driver Commands ...................................................................................6-124
6-43 Identifiers for I2C Driver ........................................................................................6-127
6-44 IIC Driver Commands............................................................................................6-127
6-45 Identifiers for INTC Driver .....................................................................................6-134
6-46 INTC Driver Commands........................................................................................6-134
6-47 Identifiers for MCM Driver .....................................................................................6-136
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors ix
Tables
Table
Number Title
Page
Number
6-48 MCM Driver Command .........................................................................................6-136
6-49 Identifiers for MSCAN Driver.................................................................................6-137
6-50 MSCAN Driver Commands ...................................................................................6-137
6-51 Identifiers for MSCAN Driver.................................................................................6-145
6-52 MSCANMB Driver Commands..............................................................................6-146
6-53 Identifiers for OCCS Driver ...................................................................................6-149
6-54 OCCS Driver Commands......................................................................................6-149
6-55 Identifiers for PIT Driver ........................................................................................6-156
6-56 PIT Driver Commands...........................................................................................6-156
6-57 Identifiers for PMC Driver......................................................................................6-158
6-58 PMC Driver Commands ........................................................................................6-158
6-59 Identifiers for PDB Driver ......................................................................................6-161
6-60 PDB Driver Command...........................................................................................6-161
6-61 Identifiers for QTIMER Driver................................................................................6-168
6-62 QT Driver Commands ...........................................................................................6-169
6-63 Identifiers for SCI Driver........................................................................................6-175
6-64 SCI Driver Commands ..........................................................................................6-175
6-65 Identifiers for SPI Driver ........................................................................................6-181
6-66 SPI Driver Commands ..........................................................................................6-181
6-67 Identifiers for SYS Driver.......................................................................................6-185
6-68 SYS Driver Commands .........................................................................................6-185
6-69 Identifiers for XBAR Driver ....................................................................................6-200
6-70 XBAR Driver Commands ......................................................................................6-200
7-1 FreeMASTER Driver Interrupt Mode.........................................................................7-3
7-2 FreeMASTER Communication Configuration Items for appconfig.h.........................7-5
7-3 TSA Type Constants ...............................................................................................7-25
10-1 Revision history.......................................................................................................10-1
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
x NXP Semiconductors
Figures
Figure
Number Title
Page
Number
Figures
1-1 Software Structure ....................................................................................................1-2
1-2 ..................................................................................................................................1-5
1-3 External Tool Configurations .....................................................................................1-6
1-4 GCT Integration.........................................................................................................1-7
1-5 Build Before Launch..................................................................................................1-7
1-6 GCT Key Binding ......................................................................................................1-8
1-7 Import Dialog Box....................................................................................................1-10
1-8 Root Directory Selection .........................................................................................1-10
1-9 Drag & Drop CodeWarrior Project File ....................................................................1-11
2-1 ..................................................................................................................................2-1
2-2 ..................................................................................................................................2-2
2-3 ..................................................................................................................................2-3
2-4 ..................................................................................................................................2-4
2-5 ..................................................................................................................................2-5
2-6 ..................................................................................................................................2-6
2-7 ..................................................................................................................................2-7
3-1 Boot Sequence..........................................................................................................3-2
3-2 Interrupt Processing Flow .......................................................................................3-33
3-3 Memory Checking Process .....................................................................................3-53
4-1 Root Directory Structure............................................................................................4-1
4-2 Sample Applications Directory Structure...................................................................4-2
4-3 Src Directory Structure..............................................................................................4-3
4-4 Stationery Directory Structure ...................................................................................4-3
5-1 Import Dialog Box......................................................................................................5-1
5-2 Project Import Settings..............................................................................................5-2
5-3 Drag & Drop CodeWarrior Project File ......................................................................5-3
5-4 DSC56800EX_Quick_Start Variable .........................................................................5-4
5-5 User Interface............................................................................................................5-6
6-1 Macro Expansion Process ........................................................................................6-3
7-1 FreeMASTER Application Window............................................................................7-2
8-1 GCT Usage ...............................................................................................................8-2
8-2 GCT Main Window ....................................................................................................8-4
8-3 Pinout Page Status Icons..........................................................................................8-5
8-4 Pinout Page...............................................................................................................8-6
8-5 Register View ............................................................................................................8-7
8-6 Warnings View ..........................................................................................................8-8
8-7 Options dialog ...........................................................................................................8-9
8-8 The appconfig.h File................................................................................................8-10
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors 1-1
Chapter 1
Introduction
This user’s manual is targeted for NXP 56F82xxx, 56F83xxx, and 56F84xxx application developers. Its
purpose is to describe the development environment, the software modules and the tools for the 56F82xxx,
56F83xxx, and 56F84xxx and the Application Programming Interface (API). Simply, this manual
describes how to use the NXP DSC56800EX_Quick_Start tool to develop software for the NXP
56F82xxx, 56F83xxx, and 56F84xxx Digital Signal Controllers (DSC).
1.1 Overview
The DSC56800EX_Quick_Start development environment provides fully debugged peripheral drivers,
examples and interfaces, that allow programmers to create their own C application code, independent of
the core architecture. This environment has been developed to complement the existing development
environment for NXP 56F8xxx embedded processors. It provides a software infrastructure that allows
development of efficient, ready to use high level software applications, that are fully portable and reusable
between different core architectures. The maximum portability is achieved for devices with comparable
on-chip peripheral modules.
This manual contains information specific only to DSC56800EX_Quick_Start tool as it applies to the NXP
56F8xxx software development. Therefore it is required that users of the DSC56800EX_Quick_Start tool
should be familiar with the 56800E family in general, as described in the DSP56800E and DSP56800EX
16-Bit DSP Core Reference Manual (DSP56800ERM/D), MC56F84XXX Reference Manual
(MC56F84XXXRM), 56F82XXX Reference Manual (MC56F82XXXRM), and the 56F83XXX
Reference Manual (MC56F83XXXRM) before continuing. The 56F82xxx and 56F84xxx devices are
supported by a complete set of hardware development boards.
Comprehensive information about available tools and documentation can be found on NXP web pages:
NXP.com
NXP DSC56800EX_Quick_Start tool is designed for and can be fully integrated with NXP CodeWarrior
development tools. Before starting to explore the full feature set of the DSC56800EX_Quick_Start, one
should install and become familiar with the CodeWarrior development environment.
All together, the DSC56800EX_Quick_Start, the CodeWarrior, and the development boards (TWR or
EVK) create a complete and scalable tool solution for easy, fast and efficient development.
1.1.1 Features
The DSC56800EX_Quick_Start environment is composed of the following major components:
core-system infrastructure, on-chip drivers with defined API, sample example applications, Graphical
Configuration Tool and FreeMASTER software support. This section brings very illustrative information
about these components, while the comprehensive description can be found in specially targeted chapters.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
1-2 NXP Semiconductors
1.1.1.1 Core-system Infrastructure
The core-system infrastructure creates the fundamental infrastructure for the 56F82xxx, 56F83xxx, and
56F84xxx device operation and enables further integration with other components, e.g. on-chip drivers.
The basic development support provided includes: setting of the required operation mode, commonly used
macro definitions, portable architecture-dependent register declaration, mechanism for static
configuration of on-chip peripherals as well as interrupt vectors, and the project templates.
1.1.1.2 On-chip Drivers
The on-chip drivers isolate the hardware-specific functionality into a set of driver commands with defined
API. The API standardizes the interface between the software and the hardware, see Figure 1-1. This
isolation enables a high degree of portability or architectural and hardware independence for application
code. This is mainly valid for devices with similar peripheral modules. The driver code reuses lead for
greater efficiency and performance.
Figure 1-1. Software Structure
1.1.1.3 Sample Applications
The DSC56800EX_Quick_Start tool contains many sample applications that demonstrate how to use
on-chip drivers and how to implement some user-specific tasks. These sample examples are kept simple
and illustrative and their intention is to minimize the learning curve.
1.1.1.4 Graphical Configuration Tool
The Graphical Configuration Tool (GCT) is a graphical user interface (GUI), designed to provide static
chip and on-chip peripheral module setting/initialization, including association of the interrupt vectors
with user interrupt service routines.
The Graphical Configuration Tool is not required in order to use the DSC56800EX_Quick_Start
environment, i.e. it is optional. Nevertheless, this tool simplifies the configuration of on-chip peripheral
HARDWARE
on-chip peripheral modules
ON-CHIP DRIVERS
API
APPLICATION
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors 1-3
modules and the device itself. It also guides the user by supplying a lot of useful information and hints. It
is therefore recommended to use the Graphical Configuration Tool.
1.1.1.5 FreeMASTER Software
The FreeMASTER application is a software tool initially created for developers of Motor Control
applications, but it may be extended to any other application development. This tool allows remote control
of an application using a user-friendly graphical environment running on a PC. It also provides the ability
to view some real-time application variables in both textual and graphical form.
Main features:
Graphical environment
Visual Basic Script or Java Script can be used for control of target board
Easy to understand navigation
Connection to target board possible over a network, including Internet
Demo mode with password protection support
Visualization of real-time data in Scope window
Acquisition of fast data changes using integrated Recorder
Value interpretation using custom defined text messages
Built-in support for standard variable types (integer, floating point, bit fields)
Several built-in transformations for real type variables
Automatic variable extraction from CodeWarrior linker output files (MAP, ELF)
Remote control of application execution
The FreeMASTER tool is not required in order to use the DSC56800EX_Quick_Start environment, i.e. it
is optional. Nevertheless, FreeMASTER is a versatile tool to be used for multipurpose algorithms and
applications. It provides a lot of excellent features, including:
Real-Time debugging
Diagnostic tool
Demonstration tool
Education tool
The full description can be found in the FreeMASTER User Manual attached to the FreeMASTER tool.
1.2 Quick Start
This chapter provides the information required to get the DSC56800EX_Quick_Start tool installed and
running.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
1-4 NXP Semiconductors
1.2.1 CodeWarrior for Microcontrollers
CodeWarrior Development Studio V11.1 (or later) is a complete Integrated Development Environment
(IDE) that provides a highly visual and automated framework to accelerate development of the most
complex embedded applications.
CodeWarrior for Microcontrollers integrates the development tools for the ColdFire®, ColdFire+, DSC,
Kinetis, Qorivva, PX, RS08, S08, and S12Z architectures into a single product based on the Eclipse open
development platform. Eclipse offers an excellent framework for building software development
environments and is a standard framework used by many embedded software vendors.
As previously mentioned, DSC56800EX_Quick_Start tool is designed for and can be integrated with
CodeWarrior for Microcontrollers development tool. With CodeWarrior for Microcontrollers tool, users
can build applications and integrate other software included as part of the DSC56800EX_Quick_Start
release. Once the software is built, CodeWarrior tools allows users to download executable images into the
target platform and run or debug the downloaded code.
To install CodeWarrior for Microcontrollers V11.1, it is recommended to use the installation guide
attached to the actual version of CodeWarrior for Microcontrollers, if available.
1.2.2 Install DSC56800EX_Quick_Start
In order for the DSC56800EX_Quick_Start to integrate itself with the development tools, the CodeWarrior
tools should be installed prior to the installation of DSC56800EX_Quick_Start installation (see previous
section). If the DSC56800EX_Quick_Start tool is installed while CodeWarrior is not present, users can
only browse the installed software package, but will not be able to build, download and run the released
code. However, the installation can be simply completed once CodeWarrior is installed, see Section 1.2.1.
The installation itself consists of copying the required files to the destination hard drive, checking the
presence of CodeWarrior and creating the shortcut under the Start->Programs menu. It is recommended to
use the default installation directory path c:\NXP\... .
NOTE
Each DSC56800EX_Quick_Start release is installed in its own new
directory named DSC56800EX_Quick_Start rX.Y (where X.Y denotes the
release number). Thus, it enables to maintain the older releases and projects.
It gives free choice to select the active release.
To start the installation process, perform the following steps:
1. Execute DSC56800EX_Quick_Start_rXY.exe
2. Follow the DSC56800EX_Quick_Start software installation instructions on your screen.
3. In case the installation directory is different than default path, it is essential to change
DSC56800EX_Quick_Start path variable in CodeWarrior Development Studio
1.2.2.1 Correct path to DSC56800EX_Quick_Start
This step is mandatory if DSC56800EX_Quick_Start is not installed
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors 1-5
in a default path of c:\NXP\DSC56800EX_Quick_Start_r2.7 and
if the project was not created with the Quick_Start Stationery New Project
Wizard.
To simplify creation of new Quick_Start application projects in
the CodeWarrior 11.x IDE, please install the NXP Stationery
New Project Wizard. See more information about the Wizard in Chapter 2, “Stationery New Project
Wizard”.
1. In case the DSC56800EX_Quick_Start was installed into a non-default location in the host
computer, you need to update the path variable pointing to DSC56800EX_Quick_Start source files
any time you work with a new project.
2. When a project is imported into the CodeWarrior Workspace, open the project "Properties"
window.
3. In the "Properties" dialog, select the "Resource / Linked Resources" page, select the
DSP56800E_QS_SRC_270 variable and press the Edit button.
4. Specify the installation folder of the DSC56800EX_Quick_Start tool and press the OK button.
Figure 1-2.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
1-6 NXP Semiconductors
1.2.2.2 Install Graphical Configuration Tool
Graphical Configuration Tool is installed together with the DSC56800EX_Quick_Start environment as
part of the Typical installation. Graphical configuration tool can also be installed as a selectable component
within the Custom installation.
Graphical Configuration Tool is able to work as stand-alone, but integration with the CodeWarrior IDE
markedly increases the efficiency of this tool. The integration is based on the IDE user-configurable menus
and its interface for external plug-ins.
NOTE
External Tool Configurations are set only for the actual Workspace. Newly created
Workspace requires new configuration setting for GCT integration.
To integrate the Graphical Configuration Tool with CodeWarrior Workspace, perform the following steps:
a) Launch CodeWarrior IDE from the Start->Programs->NXP CodeWarrior menu.
b) Open the External Tools Configurations dialog window using Run->External Tools->External
Tools Configurations.
Figure 1-3. External Tool Configurations
c) Set the GCT launcher settings in Main tab Location (path to the project folder should be less
than 120 characters and must not contain a "space" character), Working directory and
Arguments as a system variable ${project_loc}.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors 1-7
Figure 1-4. GCT Integration
d) Untick the Build before lanunch box and click Apply.
Figure 1-5. Build Before Launch
e) Click on Run button.
f) Optionally the key bidding for GCT might be set.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
1-8 NXP Semiconductors
g) Open Window -> Preferences dialog box.
h) Search for “keys” and “run last” in Preferences window.
i) Select “Run Last Launched External Tool” in command menu.
j) Set required binding.
Figure 1-6. GCT Key Binding
k) Click on “Apply” and “OK” buttons.
Now you should be able to execute the Graphical Configuration Tool from the CodeWarrior IDE menu
Run->External Tools->GCT by clicking on the icon or by pressing the chosen key shortcut. Note that the
DSC56800EX_Quick_Start project should be open in the Workspace to quickly execute the Graphical
Configuration Tool.
1.2.2.3 Install FreeMASTER (PC Master Software)
1.2.2.3.1 System Requirements
The FreeMASTER application can run on any computer with Microsoft Windows 7 (or later) operating
system. Before installing, the Internet Explorer 10 (or higher).
Operating system: Microsoft Windows 7, through Windows 10 (on the host side)
Required software: Internet Explorer 10 or higher installed. For selected features (e.g. regular
expression-based parsing), Internet Explorer 11 or higher is required.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
NXP Semiconductors 1-9
1.2.2.3.2 Target Development Board Requirements
To enable the FreeMASTER connection to the target board application, follow the instructions provided
with the embedded-side development tool. The recommended and fastest way to start using FreeMASTER
is by trying the sample application.
FreeMASTER software relies on the following items to be provided by the target development board:
Interface: Serial communication port or the JTAG port (available on all NXP EVM boards).
Data RAM Memory: Approximately 160 words of data memory plus the size of the recorder buffer is
needed for the full configuration. Optionally, some features can be disabled to reduce required data
memory size.
Program Flash Memory: Required size is approximately 2K words for the full configuration. Optionally,
some features can be removed to reduce required program memory size
1.2.2.3.3 Enabling FreeMASTER on Target Application
To enable the FreeMASTER operation on the target board application, see description and an example in
Chapter 6, “FreeMASTER Driver.”
1.2.2.3.4 How to Install
The FreeMASTER application is an optional part of the DSC56800EX_Quick_Start environment and
must be installed separately, e.g. running the FMASTERSW25.exe (or later).
1.2.3 Build and Run Sample Application
Once the DSC56800EX_Quick_Start tool is installed, the user can build and run any released demo
application for the TWR or EVK DSC modules by opening and building the project and using the
CodeWarrior development environment. pwm_demo is used as an example in this case.
Two methods can be used to open an example project Import (Step 2&3) or drag&drop (Step 4):
Step 1: Launch CodeWarrior IDE from the Start->Programs->NXP CodeWarrior menu and open existing
or create new Workspace.
Step 2: Choose File->Import command and select General->Existing Projects into Workspace and click
on Next.
DSC56800EX Quick Start User’s Guide, Rev. 4, 10/2019
1-10 NXP Semiconductors
Figure 1-7. Import Dialog Box
Step 3: Select root directory of the example project, e.g ..\DSC56800EX_Quick_Start
r2.7\sample_applications\MC56F83000EVK\pwm_demo. The example project might be copied into the
CodeWarrior Workspace by ticking Copy project into workspace tick box and click on Finish.
Figure 1-8. Root Directory Selection
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203
  • Page 204 204
  • Page 205 205
  • Page 206 206
  • Page 207 207
  • Page 208 208
  • Page 209 209
  • Page 210 210
  • Page 211 211
  • Page 212 212
  • Page 213 213
  • Page 214 214
  • Page 215 215
  • Page 216 216
  • Page 217 217
  • Page 218 218
  • Page 219 219
  • Page 220 220
  • Page 221 221
  • Page 222 222
  • Page 223 223
  • Page 224 224
  • Page 225 225
  • Page 226 226
  • Page 227 227
  • Page 228 228
  • Page 229 229
  • Page 230 230
  • Page 231 231
  • Page 232 232
  • Page 233 233
  • Page 234 234
  • Page 235 235
  • Page 236 236
  • Page 237 237
  • Page 238 238
  • Page 239 239
  • Page 240 240
  • Page 241 241
  • Page 242 242
  • Page 243 243
  • Page 244 244
  • Page 245 245
  • Page 246 246
  • Page 247 247
  • Page 248 248
  • Page 249 249
  • Page 250 250
  • Page 251 251
  • Page 252 252
  • Page 253 253
  • Page 254 254
  • Page 255 255
  • Page 256 256
  • Page 257 257
  • Page 258 258
  • Page 259 259
  • Page 260 260
  • Page 261 261
  • Page 262 262
  • Page 263 263
  • Page 264 264
  • Page 265 265
  • Page 266 266
  • Page 267 267
  • Page 268 268
  • Page 269 269
  • Page 270 270
  • Page 271 271
  • Page 272 272
  • Page 273 273
  • Page 274 274
  • Page 275 275
  • Page 276 276
  • Page 277 277
  • Page 278 278
  • Page 279 279
  • Page 280 280
  • Page 281 281
  • Page 282 282
  • Page 283 283
  • Page 284 284
  • Page 285 285
  • Page 286 286
  • Page 287 287
  • Page 288 288
  • Page 289 289
  • Page 290 290
  • Page 291 291
  • Page 292 292
  • Page 293 293
  • Page 294 294
  • Page 295 295
  • Page 296 296
  • Page 297 297
  • Page 298 298
  • Page 299 299
  • Page 300 300
  • Page 301 301
  • Page 302 302
  • Page 303 303
  • Page 304 304
  • Page 305 305
  • Page 306 306
  • Page 307 307
  • Page 308 308
  • Page 309 309
  • Page 310 310
  • Page 311 311
  • Page 312 312
  • Page 313 313
  • Page 314 314
  • Page 315 315
  • Page 316 316
  • Page 317 317
  • Page 318 318
  • Page 319 319
  • Page 320 320
  • Page 321 321
  • Page 322 322
  • Page 323 323
  • Page 324 324
  • Page 325 325
  • Page 326 326
  • Page 327 327
  • Page 328 328
  • Page 329 329
  • Page 330 330
  • Page 331 331
  • Page 332 332
  • Page 333 333
  • Page 334 334
  • Page 335 335
  • Page 336 336
  • Page 337 337
  • Page 338 338
  • Page 339 339
  • Page 340 340
  • Page 341 341
  • Page 342 342
  • Page 343 343
  • Page 344 344
  • Page 345 345
  • Page 346 346
  • Page 347 347
  • Page 348 348
  • Page 349 349
  • Page 350 350
  • Page 351 351
  • Page 352 352
  • Page 353 353
  • Page 354 354
  • Page 355 355
  • Page 356 356
  • Page 357 357
  • Page 358 358
  • Page 359 359
  • Page 360 360
  • Page 361 361
  • Page 362 362
  • Page 363 363
  • Page 364 364
  • Page 365 365
  • Page 366 366
  • Page 367 367
  • Page 368 368
  • Page 369 369
  • Page 370 370
  • Page 371 371
  • Page 372 372
  • Page 373 373
  • Page 374 374
  • Page 375 375

NXP MC56F84xxx User guide

Type
User guide
This manual is also suitable for

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI