NXP Semiconductors MPC57 Series User manual

© 2019 NXP Semiconductors. All rights reserved
Model-Based Design Toolbox
MPC57xx Series
Quick Start Guide
An Embedded Target for the MPC57xx Family of Processors
Version 3.0.0
Target Based Automatic Code Generation Tools
For MATLAB™/Simulink™/Stateflow™ Models working with Simulink Coder ™ and Embedded Coder®

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-2
Summary
1Installation.......................................................................................................................... 1-3
1.1 System Requirements .................................................................................................. 1-3
1.2 Installation Steps.......................................................................................................... 1-3
1.2.1 Run Add-on installer............................................................................................ 1-4
1.2.2 License Registration & Installation...................................................................... 1-7
1.2.3 Setting up the Target Compilers........................................................................... 1-8
1.2.4 Setting the Path for Model-Based Design Toolbox.............................................. 1-8
2Run Models ...................................................................................................................... 2-10
2.1 Examples Library & Help.......................................................................................... 2-10
2.2 Hardware Setup ......................................................................................................... 2-12
2.3 BootLoader Setup...................................................................................................... 2-13
2.4 Hello World Example................................................................................................ 2-17

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-3
1 Installation
Installing the Model-Based Design Toolbox is the first step in setting up and running automatic
C code generation from MATLAB/Simulink for NXP’s embedded target processors and
development boards.
1.1 System Requirements
For a flowless development experience the minimum recommended PC platform is:
•Windows® OS: any x64 processor
•At least 4 GB of RAM
•At least 6 GB of free disk space.
•Internet connectivity for web downloads.
Operating System Supported
SP Level
64-bit
Windows 7
SP1
X
Windows 10
X
1.2 Installation Steps
NXP’s Model-Based Design Toolbox is delivered as MATLAB Toolbox Package that can be
installed offline or online from MathWorks Add-ons. This document shows how to install the
offline package, assuming you have already downloaded the file from NXP’s official web page.
To have the toolbox installed and configured properly the following actions should be executed:
1. Run the MATLAB toolbox package file *.mltbx downloaded from NXP’s Model-
Based Design Toolbox web page
2. Register and install the toolbox license file into ..\My Documents\MATLAB\Add-
Ons\Toolboxes\NXP_MBDToolbox_MPC57xx\code\lic
3. Set the Target Compiler Environment Variables
4. Setup the MATLAB path for Model-Based Design Toolbox
Each of these actions are explained in the following sub-chapters.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-4
1.2.1 Run Add-on installer
Install the NXP’s Model-Based Design Toolbox by double clicking the *.mltbx file. This will
activate the MATLAB Add-ons installer that will automatically start the installation process.
After the MATLAB opens, you will be prompted with the following options:
1. The NXP’s Model-Based Design Toolbox Installation Wizard dialog will appear.
Click “Install” to proceed.
2. Indicate acceptance of the NXP Software License Agreement by selecting “I
agree to the terms of the license” to proceed.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-5
3. Click “OK” to start the MATLAB installation process. The rest of the process is
silent and under MATLAB control. All the files will be automatically copied into
default Add-Ons folder within the MATLAB
The default location can be changed prior to installation by changing the Add-Ons
path from MATLAB Preferences
4. After a couple of minutes (2-5min), the NXP’s Model-Based Design Toolbox should
be visible as a new Add-ons.
5. More details about the NXP’s Model-Based Design Toolbox can be found by
clicking on View Details

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-6
6. NXP’s Model-Based Design Toolbox documentation, help and examples are fully
integrated with MATLAB development environment. Get more details by accessing
the standard Help and Supplemental Software section

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-7
1.2.2 License Registration & Installation
The NXP’s Model Based Design Toolbox is available free of charge, however, a license is
required. If you need to get a license it can be obtained by following the path outlined below.
If you encounter issues getting a license please submit a ticket at
https://www.nxp.com/support/support:SUPPORTHOME describing the issue.
Please perform the following steps to obtain your license:
1. Go to www.nxp.com/mbdt and click on “Download Eval”
2. Once you have logged in, the “Product Information”page for Model-Based
Design Toolbox appears.
Select the appropriate toolbox you wish you evaluate to bring up the Software Terms
and Conditions page.
3. Click “I Agree” to consent to the software license agreement.
4. If you need to download the tool, click on the linked file name. Otherwise, click on
“License Keys” tab.
5. Verify the correct tool is identified and click on “Generate”.
6. Enter your Disk Serial Number as the Host ID. If you do not know your Disk
Serial Number, go to “Locating the Host ID”in the document Model-Based
Design Toolbox License Installation to learn how to locate your Disk Serial
Number, which is needed to generate your license.
7. Click “Generate”
8. Either click on “Save All” or copy and paste the file into a text editor and save the
file as “license.lic”to the folder “..\MATLAB\Add-
Ons\Toolboxes\NXP_MBDToolbox_MPC57xx\code\lic”

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-8
1.2.3 Setting up the Target Compilers
The target compiler for Model-Based Design Toolbox needs to be configured. Use the notation
below to setup these compiler environmental variables. Ensure a system environment variable
called <COMPILER_STRING>_TOOL, corresponding to the compiler(s) you have installed, is
defined to compiler path value as shown below:
S32DS_PA_TOOL = {Toolbox installation path}/tools or
{S32 Design Studio installation path}/
GHS_TOOL = {GHS installation path}/comp_201516/
DIAB_TOOL = {DIAB installation path}/diab/5.9.6.2/
Note: Paths shown are for illustration, your installation path may be different. Once
environmental variables are setup you will need to restart MATLAB for the IDE environment to
see these system variables.
In case there is no compiler installed, the NXP’s Model-Based Design Toolbox is going to
default to the internal GCC 4.9.4 compiler.
1.2.4 Setting the Path for Model-Based Design Toolbox
If the toolbox installation as Add-ons was successful, then the MATLAB will automatically
detect the NXP’s Model-Based Design Toolbox. Nonetheless, in special circumstances you
might need to run a special script to instruct the MALAB to recognize the NXP’s Model Based
Design Toolbox. This is done by changing the MATLAB Current Directory to the toolbox
installation directory (e.g.: ..\MATLAB\Add-Ons\Toolboxes\NXP_MBDToolbox_MPC57xx\code)
and running the “mbd_mpc_path” script.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
1-9
>> mbd_mpc_path
Treating 'C:\Users\xxxxx\Documents\MATLAB\Add-
Ons\Toolboxes\NXP_MBDToolbox_MPC57xx\code' as MBD Toolbox installation
root.
MBD Toolbox path prepended.
Successful.
>>

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-10
2 Run Models
2.1 Examples Library & Help
NXP’s Model Based Design Toolbox comes with an Examples Library collection that let you
test different MCU on-chip modules and run complex applications.
The Examples Library mbd_mpc574x_examples.mdl can be opened from “{Model
Based Design Install Directory}\MPC_Examples\”folder.
Note: the example library is divided into two sections: custom & generic examples. The generic
examples can be executed on all the processors and boards supported with none or minimal
changes. The custom examples are targeted for a specific processor and board and are highly
dependent on peripherals and pins available.
Each category contains multiple examples that showcase different Model-Based Design
Toolbox capabilities that are clarified in three layers:
-On-chip modules and peripherals examples covers the basic functionalities of the MCU;
-Modelling, Verification and Validation examples covers the SIL, PIL and additional
blocks supported by toolbox to help faster prototyping;
-Applications covers the AMMCLIB and Motor Control scenarios;
The examples are also available from standard MATLAB Help for NXP’s Model-Based Design
Toolbox Example

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-11

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-12
2.2 Hardware Setup
All examples provided with the Model-Based Design Toolbox were developed on DEVKIT-
MPC5744P as primary target. Additional information about this development kit can be found
on NXP official web page here.
Before running any example on the DEVKIT-MPC5744P a proper communication setup
between the board and the host PC must be enabled. Please follow the next steps to ensure a
working setup:
1. Place J13 jumper on positions 2-3 to power the DEVKIT-MPC5744P via the USB
micro connector;
2. Connect the EVB micro USB connector J12 to a host PC USB connector using supplied
USB cable;
3. Allow the PC to automatically configure the USB drivers if needed. Windows OS
should automatically detect the DEVKIT-MPC5744P and should assigned a virtual
COM port to the host;

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-13
4. When powered through USB, LEDs DS1, DS2 and DS5 should light green;
2.3 BootLoader Setup
To be able to download the applications from MATLAB/Simulink to the target we need to
program a special application called RBF into the MCU flash memory. For the first time
programming you need to have the S32 Design Studio for PA IDE installed. Follow the next
steps to flash the RBF image to the processor flash memory.
1. Click on the Flash icon to open the wizard that allows you to connect with the target and
flash the boot loader algorithm
2. The Flash Wizard will appear on your screen. Add a new configuration and name if RBF
Flash.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-14
3. Click on the C/C++ Application Browse button to navigate to the {Model-Based
Design Toolbox installation folder}\code\tools\BootLoader\
RBF_Files and choose the appropriate RBF image to be flashed on your setup.
Note: each file contains in its name the interfaces allowed for Flash Tool download
communication. Choose the one that is suitable for your processor and communication
interface. In this case, we are going to use the UART1(openSDA) to download the code
from host PC to DEVKIT-MPC5744P board.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-15
4. Configure the Debugger interface to connect with the target.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-16
5. Click on Flash button to start the flash programming sequence. The debugger will
connect with the target selected and will start to flash the RBF image into the non-
volatile memory of the target.
At this point the target should be ready for receiving applications from MATLAB/Simulink
environment over the UART interface connected via OpenSDA.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-17
2.4 Hello World Example
If the hardware and BootLoader setup is completed successful and a virtual COM port is created
and visible in Control Panel -> Device Manager -> Port (COM & LPT), then
all requirements for running a Model-Based Design Toolbox for MPC57xx Examples are
fulfilled.
Open the Examples Library and go to Communications block and double click on UART Hello
World.
The Simulink uart_hello_world_mpc574xP.mdl model will open. This model
programs the MPC5744P MCU to sent a message over the UART.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-18

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-19
Follow the next steps to run the example:
1. Double click on MBD_MPC574x_Config_Information block and setup the
Download Config parameters according with your PC and HW setup
2. Apply and close this window.

Model Based Design Toolbox MPC57xx Series
Quick Start Guide
2-20
3. Press Build Model button and wait until the code is generated, compiled and
downloaded to the evaluation board.
4. Wait until the application is built and the following message is displayed on the screen.
Press the board reset button SW3 and then (within 5 seconds) press the OK button to
start the application programming to the target.
5. Wait until the BootLoader finishes the flasing of the application to the target processor.
6.
7. Open any UART terminal for the virtual COM port assinged and set up the baud rate at
115200, data bits 8 and parity none.