model-based design toolbox s12zvmx series...model-based design toolbox s12zvmx series release notes...

Model-Based Design Toolbox S12ZVMx Series

Release Notes for version 1.4.0

1-1

Model-Based Design Toolbox

S12ZVMx Series

Release Notes

An Embedded Target for the S12ZVMx Family of Processors

Version 1.4.0



1-9

Summary

1 What is New in Version 1.4.0 ............................................................................................ 1-3

2 S12ZVMx MCU Support ................................................................................................... 2-4

2.1 S12ZVMx MCUs......................................................................................................... 2-4 2.2 Peripherals & Devices ................................................................................................. 2-4

3 Model-Based Design Toolbox Features ............................................................................. 3-5

3.1 Extended MATLAB version support........................................................................... 3-6

3.2 S12ZVMx Automotive Math and Motor Control ........................................................ 3-6 3.3 Motor control examples ............................................................................................... 3-7

3.4 MAAB checks ............................................................................................................. 3-8

4 New Model-Based Design Toolbox Extras ........................................................................ 4-9

4.1 Processor-In-the-Loop Support (PIL) .......................................................................... 4-9 4.2 Boot Loader ................................................................................................................. 4-9

5 Prerequisites ..................................................................................................................... 5-10

5.1 MATLAB Releases and OSes Supported .................................................................. 5-10

5.2 Compiler Support ....................................................................................................... 5-11

6 Support Information ......................................................................................................... 6-11



1-9

1 What is New in Version 1.4.0

The latest NXP’s Model-Based Design Toolbox for S12ZVMx version 1.4.0 is designed to

support S12ZVMx microcontrollers and brings the following important enhancements compared

with the previous version:

- Extended MATLAB versions supported – now covering the entire R2015a – R2020a

range

- Compatible with S12ZVM AMMCLIB 1.1.21 (standalone)

- Integrated CW compiler tool into the product and set it as default - setting up the

compiler environment variables is no longer required

- Compatible with MAAB checks

- Extended examples library – over 50 new examples added, including:

• Motor control (both BLDC and PMSM)

• AMMCLib

• GDU

• Profiler

- Added support for referenced models

- Packaged in .mltbx format - available directly from MATLAB add-on explorer

- SIL/PIL updates (to enable them on extended MATLAB support)

https://www.nxp.com/webapp/swlicensing/sso/downloadSoftware.sp?catid=MCTB-EX



1-9

2 S12ZVMx MCU Support

2.1 S12ZVMx MCUs

This toolbox supports the MC9S12ZVMx MCU. The tool supports operation with a 4MHz,

8MHz and 16 MHz external XTAL.

This build includes direct support of the following MCU derivatives:

• S12ZVM 32/L31/16 target: o MC9S12ZVM16 o MC9S12ZVML31 o MC9S12ZVM32

• S12ZVML/C 128/64/32 target: o MC9S12ZVML32 o MC9S12ZVML64 o MC9S12ZVMC64 o MC9S12ZVML128 o MC9S12ZVMC128

• S12ZVMC256 target: o MC9S12ZVMC256

2.2 Peripherals & Devices

NXP’s Model-Based Design Toolbox for S12ZVMx version 1.4.0 supports the following

peripherals:

o ADC – Analog to Digital Converter o PMF – Pulse width Modulator with Fault protection o PTU – Programmable Trigger Unit o TIM – Timer output and Hall Sensor Port o Digital I/O – general Purpose Digital Input and output o SCI – Serial Communication Interface o SPI – Serial Peripheral Interface o MSCAN – Multi-Scalable Controller Area Network o GDU – Gate Drive Unit o PWM – Pulse Width Modulation




1-9

3 Model-Based Design Toolbox Features NXP’s Model-Based Design Toolbox for S12ZVMx version 1.4.0 is delivered with a complete

S12ZVMx MCU Simulink Block Library as shown below.

There are four main categories:

- S12Z Automotive Math and Motor Control which generic 16bit, 32bit, and floating-point single precision blocks

- S12ZVM 32/L31/16 – with Communication, Motor Control, Peripheral Interface and Utility blocks which contains all blocks related with MCU peripheral

configurations

- S12ZVMC256 – similar to S12ZVMx, but for different derivatives - S12ZVML/C 128/64/32 similar to S12ZVMx, but for different derivatives




1-9

3.1 Extended MATLAB version support

We extended support for our toolbox to cover a wider range of MATLAB releases – starting

from R2015a and going up to R2020a. This way we want to avoid locking out users that have

constraints regarding MATLAB versions.

3.2 S12ZVMx Automotive Math and Motor Control

All functions in the Automotive Math and Motor Control Functions Library v1.1.21 are

supported as blocks for simulation and embedded target code generation for:

- Bit Accurate Model for 16-bit fixed-point implementation; - Bit Accurate Model for 32-bit fixed-point implementation; - Bit Accurate Model for floating-point single precision implementation;

The main functionalities supported are:

- Mathematical Function Library (MLIB) – supports basic mathematical operations such as addition, multiplication, etc;

- General Function Library (GFLIB) – supports basic trigonometric and general math functions such as sine, cosine, tan, hysteresis, limit, etc;

- General Digital Filters Library (GDFLIB) – comprising digital IIR and FIR filters designed to be used in a motor control application;

- General Motor Control Library (GMCLIB) – supports standard algorithms used for motor control such as Clarke/Park transformations, Space Vector Modulation, etc;

- Advanced Motor Control Function Library (AMCLIB) – comprising advanced algorithms used for motor control purposes;

https://www.nxp.com/support/developer-resources/run-time-software/automotive-software-and-tools/automotive-math-and-motor-control-library-set:AUTOMATH_MCL



1-9

3.3 Motor control examples

Added two new motor control examples – one for BLDC (closed loop) and one for PMSM

(closed loop, sensorless).



1-9

3.4 MAAB checks

NXP’s Model-Based Design Toolbox for S12ZVMx version 1.4.0 is compatible with

MathWorks Automotive Advisory Board checks – you can reach them by going to Model

advisor – Task – Modeling standards for MAAB – Run selected checks and Generate report.




1-9

4 New Model-Based Design Toolbox Extras NXP’s Model-Based Design Toolbox for S12ZVMx version 1.4.0 enables additional

functionalities that are not MCU specific but could help faster prototyping, validation, and

verification of the developed models.

4.1 Processor-In-the-Loop Support (PIL)

The NXP’s Model-Based Design Toolbox for S12ZVMx version 1.4.0 provides PIL support for purposes of ASIL software development processes, “Model PIL Block” (Model Reference) and “PIL

Block” modes of operation are supported “Top Model PIL” mode is not supported. PIL contains full

support for Math and Motor Control Blocks, and limited support for peripheral blocks. No support

for interrupts exists in supported PIL modes of execution, therefore no blocks with interrupts are

supported in PIL mode.

For PIL support you need to install the MATLAB Support for MinGW-w64 C/C++ Compiler

toolbox.

An alternative is Microsoft Windows SDK 7.1. Please refer to the following links for

troubleshooting: - https://www.mathworks.com/matlabcentral/answers/95039-why-does-the-sdk-7-1-installation-

fail-with-an-installation-failed-message-on-my-windows-system

- https://www.mathworks.com/matlabcentral/answers/101105-how-do-i-install-microsoft-

windows-sdk-7-1

4.2 Boot Loader

Internal Boot Loader is a standalone application which requires the Microsoft .NET Framework

version 4.0 installed on PC; It may be required to download the package from

http://www.microsoft.com/download and install if you are going to use PIL and internal

Boot Loader.

The board should be configured to work with BAM to use Internal Boot Loader. Please check

board documentation.

https://www.nxp.com/webapp/swlicensing/sso/downloadSoftware.sp?catid=MCTB-EXhttps://www.nxp.com/webapp/swlicensing/sso/downloadSoftware.sp?catid=MCTB-EXhttps://www.mathworks.com/matlabcentral/fileexchange/52848-matlab-support-for-mingw-w64-c-c-compilerhttps://www.mathworks.com/matlabcentral/fileexchange/52848-matlab-support-for-mingw-w64-c-c-compilerhttps://www.mathworks.com/matlabcentral/answers/95039-why-does-the-sdk-7-1-installation-fail-with-an-installation-failed-message-on-my-windows-systemhttps://www.mathworks.com/matlabcentral/answers/95039-why-does-the-sdk-7-1-installation-fail-with-an-installation-failed-message-on-my-windows-systemhttps://www.mathworks.com/matlabcentral/answers/101105-how-do-i-install-microsoft-windows-sdk-7-1https://www.mathworks.com/matlabcentral/answers/101105-how-do-i-install-microsoft-windows-sdk-7-1



1-9

5 Prerequisites

5.1 MATLAB Releases and OSes Supported

This toolbox is developed and tested to supports the following MATLAB releases:

- R2015a - R2015b - R2016a; - R2016b; - R2017a; - R2017b; - R2018a; - R2018b; - R2019a; - R2019b; - R2020a;

In general, the older version of MATLAB may be supported with small updates that can be done

after installation. As a rule, if you are planning to use an older version you need to update the

Simulink version in every MDL file delivered with the toolbox

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-9

5.2 Compiler Support

The following compilers are supported:

Compiler Supported Release Version

CW for MCU V11.1

Cosmic for Freescale S12Z V4.2

The target compiler for the Model-Based Design Toolbox needs to be configured. Use the

notation below to set up these compiler environmental variables. Ensure a system environment

variable called _TOOL, corresponding to the compiler(s) you have

installed, is defined to compiler path value as shown below:

e.g.: CW_TOOL = C:\Freescale\CW MCU v11.1

e.g.: CS_TOOL = C:\Cosmic

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 CW compiler.

6 Support Information

For technical support please sign on to the following NXP’s Model-Based Design Toolbox

Community: https://community.nxp.com/community/mbdt

https://community.nxp.com/community/mbdt

© 2020 NXP Semiconductors. All rights reserved

How to Reach Us:

Home Page:

www.nxp.com

Web Support: www.nxp.com/support

Information in this document is provided solely to enable system and software implementers to use NXP Semiconductor products. There are no express or implied copyright licenses granted hereunder to design or fabricate any integrated circuits or integrated circuits based on the information in this document. NXP Semiconductor reserves the right to make changes without further notice to any products herein. NXP Semiconductor makes no warranty, representation or guarantee regarding the suitability of its products for any particular purpose, nor does Freescale Semiconductor assume any liability arising out of the application or use of any product or circuit, and specifically disclaims any and all liability, including without limitation consequential or incidental damages. “Typical” parameters that may be provided in NXP Semiconductor data sheets and/or specifications can and do vary in different applications and actual performance may vary over time. All operating parameters, including “Typicals”, must be validated for each customer application by customer’s technical experts. NXP Semiconductor does not convey any license under its patent rights nor the rights of others. NXP Semiconductor products are not designed, intended, or authorized for use as components in systems intended for surgical implant into the body, or other applications intended to support or sustain life, or for any other application in which the failure of the NXP Semiconductor product could create a situation where personal injury or death may occur. Should Buyer purchase or use NXP Semiconductor products for any such unintended or unauthorized application, Buyer shall indemnify and hold NXP Semiconductor and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs, damages, and expenses, and reasonable attorney fees arising out of, directly or indirectly, any claim of personal injury or death associated with such unintended or unauthorized use, even if such claim alleges that NXP Semiconductor was negligent regarding the design or manufacture of the part. MATLAB, Simulink, Stateflow, Handle Graphics, and Real-Time Workshop are registered trademarks, and TargetBox is a trademark of The MathWorks, Inc. Microsoft and .NET Framework are trademarks of Microsoft Corporation. Flexera Software, Flexlm, and FlexNet Publisher are registered trademarks or trademarks of Flexera Software, Inc. and/or InstallShield Co. Inc. in the United States of America and/or other countries. NXP, the NXP logo, CodeWarrior and ColdFire are trademarks of NXP Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. Flexis and Processor Expert are trademarks of NXP Semiconductor, Inc. All other product or service names are the property of their respective owners ©2020 NXP Semiconductors. All rights reserved.

model-based design toolbox s12zvmx series...model-based design toolbox s12zvmx series release notes...

Documents