Getting Started with the MCSPTE1AK344 Development Kit

2.1 Get to Know the MCSPTE1AK344 Motor Control Development Kit

Review each visual below to familiarize yourself with all of the components of the kit's parts.

Figure 1. S32K3xx_MC_EVB_001_LR

Figure 1. S32K3xx_MC_EVB_001_LR

2.2 Get to Know the S32K344 Evaluation Board

The diagram below locates and identifies components of the S32K344 evaluation board.

Figure 2. S32K3X4EVB-Q172 Callouts

Figure 2. S32K3X4EVB-Q172 Callouts

2.3 Get to Know the DEVKIT-MOTORGD

Labeled below are the components for the DEVKIT-MOTORGD.

Figure 3. DEVKIT-MOTORGD Board

Figure 3. DEVKIT-MOTORGD Board

2.4 Header/Pinout for PMSM Motor Control

The S32K344EVB controls the DEVKIT-MOTORGD through the inner pins of the I/O headers, which are Arduino compatible.

Below you will find the pin configuration for the PMSM motor control with the configurable pins indicated in red.

Figure 4. PMSM Pinout

Figure 4. PMSM Pinout

2.5 Header/Pinout for BLDC Motor Control

The S32K344EVB controls the DEVKIT-MOTORGD through the inner pins of the I/O headers, which are Arduino compatible.

Below you will find the pin configuration for the BLDC motor control with the configurable pins indicated in red.

Figure 5. BLDC Pinout

Figure 5. BLDC Pinout

To access the software (SW) for this development kit, you will sign in at NXP.com with your credentials.

3.1 Select SW packages from Automotive Software Package Manager

First, you will open the Automotive Software Package Manager and select option "S32K3" under "General-Purpose MCUs".

Figure 6. Package Manager S32K3

Figure 6. Package Manager S32K3

Expand the "FRDM Automotive Board Installation Package" bundle and check the boxes for "S32 Design Studio", "Real-Time Drivers" and "FreeMASTER" software (other packages are optional).

Figure 7. Package Manager FRDM-A Bundle

Figure 7. Package Manager FRDM-A Bundle

Click the "Generate Bundle Installer" button at the end of the page.

Next you will go through accepting the Export Control and SW License Agreement. Review and scroll all the way to the bottom where you will accept the terms. Once you have accepted the terms, you will close the wizard to proceed with installation. Installer and Installer User Manual download will start automatically in a few moments.

Note: Because the NXP Multi Installer is available only for a limited time once it appears, please start the installation immediately.

Figure 9. MultiInstaller

Figure 9. MultiInstaller

To simplify the installation process for the FRDM Automotive Board Installation Package SW bundle, the installation and configuration is automated.

Figure 10. MultiInstaller

Figure 10. MultiInstaller

3.2 Add GNU Compiler Collection (GCC) Toolchain Version 10.2

Because the latest versions of S32 Design Studio only include GCC toolchain version 11.4., you will need to install version 10.2, which is compatible with Real-Time Drivers (RTD).

In S32 Design Studio, from the top menu, go to Help > S32DS Extensions and Updates. In the S32DS Extensions and Updates dialog, you will install GCC toolchain version 10.2.

Figure 11. GCC 10.2

Figure 11. GCC 10.2

Note: Optional SW can be downloaded from the S32K3 Standard Software Package or the S32K3 Reference Software Package.

For access to the optional SW go to S32 Design Studio and from the top menu, select Help > S32DS Extensions and Updates. In the S32DS Extensions and Updates dialog, click Add Update Sites.

Alternatively, you can drag the downloaded update site file and drop it into the S32DS Extensions and Updates dialog. The added software package will be automatically selected for installation.

Figure 12. Add Update Sites

Figure 12. Add Update Sites

3.3 Get FreeMASTER Application Tool for Real-Time Debugging

Download and install the FreeMASTER application tool for real-time debugging.

Note: For the FreeMASTER set up, you have the option to skip the Lite service installation, which requires an activation code.

Figure 13. FreeMASTER Installer Lite

Figure 13. FreeMASTER Installer Lite

3.4 Get Automotive Math and Motor Control Library (AMMCLib) Set

Download and install AMMCLib for S32K3xx.

Note: Version 1.1.44 or newer is required.

Figure 14. Download AMMCLib

Figure 14. Download AMMCLib

Figure 15. AMMCLib Installer

Figure 15. AMMCLib Installer

Note: For easier path modification, install the Automotive Math and Motor Control Library (AMMCLib) in the default path location.

3.5 Download the Development Kit Application Software

Download and install the MCSTE1AK344 motor control application software package.

Figure 16. MCSPTE1AK344_SW Install

Figure 16. MCSPTE1AK344_SW Install

Note: You will be prompted to download the latest version of the AMMCLib. The installer will test the minimum required version.

Figure 17. AMMCLib Install

Figure 17. AMMCLib Install

3.6 Elektrobit Tresos Studio and Standalone RTDs (Optional Step for AUTOSAR Examples)

1. Download and install Elektrobit Tresos Studio / AUTOSAR® Configuration Tool from S32K3 Standard Software Package.

Figure 18. EB Tresos installer



Figure 18. EB Tresos installer


2. Download and install the .exe file of the S32K3 Real-Time Drivers for Cortex-M from the S32K3 Standard Software Package.

Figure 19. RTD Installer



Figure 19. RTD Installer



To save configuration time, select the EB Tresos installation directory when prompted.

If you installed RTD prior EB Tresos, create a SW32K3_S32M27x_RTD_R23-11_7.0.0_QLP03.link file in C:\EB\tresos\links folder with the content: "path=C:/NXP/SW32K3_S32M27x_RTD_R23-11_7.0.0_QLP03".

Figure 20. RTD Link



Figure 20. RTD Link

This section will walk you through how to set up connections.

4.1 Check the Default Jumper Positions in the MCSPTE1AK344 Development Kit

Reference the charts and diagrams below for set-up of the development kit jumpers.

Figure 21. Default Jumpers

Figure 21. Default Jumpers

Figure 22. Default Jumpers

Figure 22. Default Jumpers

4.2 Set Up Jumpers in the DEVKIT-MOTORGD Evaluation Board

Reference the charts and diagrams below for set-up of the evaluation board jumpers.

Place DEVKIT-MOTORGD jumpers J9, J10 and J11 into position 1-2 for PMSM application or 2-3 for BLDC application. Jumper J8 stays open for 5 V HALL sensors.

Figure 23. J9-11 PMSM

Figure 23. J9-11 PMSM

Figure 24. J9-11 BLDC

Figure 24. J9-11 BLDC

Make sure that the potentiometer for overcurrent comparator is set in the correct position (approximately 8 - 10 A, slightly to the left from the middle).

Figure 25. Overcurrent Potentiometer

Figure 25. Overcurrent Potentiometer

4.3 Connect the Motor

Ensure that the motor phase wires are in the following order, from phase A to phase C:

A: Yellow

B: Green

C: Blue

Figure 26. Motor Phases

Figure 26. Motor Phases

4.4 Connect the Power Supply

Switch SW1 to the OFF position (fully to the left).

Figure 27. OFF

Figure 27. OFF

Connect the 12 V power supply adapter.

Figure 28. Plug Power

Figure 28. Plug Power

Switch SW1 to the ON position (fully to the right).

Figure 29. ON

Figure 29. ON

When power is applied to the EVB, four orange LEDs next to the voltage regulators indicate that the 12 V, 5 V, 3.3 V and 1.5 V supply voltages are present.

Note: This power-up sequence ensures that the FS26 system basis chip (SBC) starts with the watchdog disabled.

4.5 Connect the Debug Interface

Connect a micro-USB cable to the J40 connector to debug via the onboard S32K3 debugger.

Figure 30. USB cable

Figure 30. USB cable

Note: Some USB hubs may cause problems during connection, so instead connect the USB directly to your computer.

Let's take your MCSTE1AK344 motor control kit for a test drive.

5.1 Select Application and MCU Programming

Select the appropriate PMSM or BLDC motor control application from the installed directory NXP\MC_DevKits\MCSPTE1AK344\sw

To import the installed application software project in the S32 Design Studio IDE for S32 Platform:

1. Launch S32DS for S32 Platform
2. Go to File > Import then select General > Existing Projects into Workspace

Figure 31. Import Project



Figure 31. Import Project


3. Find the installed application directory: NXP\MC_DevKits\MCSPTE1AK344\sw and choose the corresponding project and click "OK". Then, click "Finish".

Note: Check the box to select "Copy projects into workspace".

Figure 32. MCSPTE1AK344 Projects

Figure 32. MCSPTE1AK344 Projects

Figure 33. SW Project Nomenclature

Figure 33. SW Project Nomenclature

5.2 Use Configuration Tool

If you selected a project with low-level drivers (ll in project name), follow these steps:

1. Expand the imported project folder in S32 Design Studio, such as MCSPTE1AK344_PMSM_FOC_2Sh_ll. Then, double-click the corresponding *.mex file to open the project configuration in the Configuration Tool.

Figure 34. MEX file



Figure 34. MEX file


2. After confirming that you configured the correct project, click "Update Code" button for generating configuration files.

Figure 35. Update Code



Figure 35. Update Code

If you selected a project with AUTOSAR drivers (with as_tr in the project name), the S32DS project will contain a Tresos folder with EB tresos configuration. Follow the following steps.

1. Open EB tresos Studio and import the appropriate subfolder.

Note: Uncheck the box to deselect "Copy projects into workspace".

Figure 36. Import Tresos Project



Figure 36. Import Tresos Project


2. In EB tresos Studio, double-click on ECU (CORTEXM, S32K3XX) and generate the project (Menu > Project > Generate Project)

5.3 Upload Software and Debug

To upload the SW and debug, follow the following steps.

1. In S32DS, return back to the C/C++ perspective.

Figure 37. C_Cpp perspective



Figure 37. C_Cpp perspective


2. Go to the Debug Configuration menu and select the predefined debug configuration for building and uploading software onto the MCU.

Figure 38. Debug Menu



Figure 38. Debug Menu



Figure 39. Debug Configuration



Figure 39. Debug Configuration


3. The S32DS will switch into debug perspective. Click Resume or press F8 to run the code. Then, click Disconnect to avoid interference between the S32 Design Studio debugger and the FreeMASTER tool.

Figure 40. Let Code Run

Figure 40. Let Code Run

Figure 41. Disconnect

Figure 41. Disconnect

5.4 Set Up the Debugging Tool

Launch the FreeMASTER application to set up the debugging tool. To open the FreeMASTER project, select File > Open Project, then browse to the FreeMASTER_control folder in the selected project directory and open the *.pmpx file.

Note: Alternatively, you can also start by double-clicking directly in the S32DS project folder.

Figure 42. FM project

Figure 42. FM project

To enable communication, access the FreeMASTER toolbar and click Go (or press Ctrl+G). You will know that communication has been successfully activated when you see the following at the bottom of the status bar:

RS-232; port=COMn; speed = 115200

Figure 43. FM Start

Figure 43. FM Start

Application Setup (optional step)

If you run the MCSPTE1AK344 software on modified or custom hardware, you may need to edit hardware scales and fault triggers. In the Motor Control Application Tuning (MCAT) tool, open the Application Setup page and edit the values on the left side of the page.

Figure 44. Application Setup

Figure 44. Application Setup

Once you finish, click Save config to generate a static configuration file. You may check file content at the Output file page.

Next, repeat the step from the Upload Software and Debug section to build the project and upload the code into MCU.

Motor parametrization and control loops autotuning (optional step)

In a case of motor change, you may benefit from new MCAT 2.0 motor parametrization and control loops autotuning features.

On the Motor Parameters page, enter the four basic motor parameters that cannot be detected automatically:

• Number of pole pairs
• Nominal Current
• Nominal Speed
• Maximum Speed

Click Update Target to start motor-parameter estimation and automatic control-loop tuning. The parameters are typically updated automatically in less than one minute.

Figure 45. Auto Param

Figure 45. Auto Param

Note: For more information about the automatic motor parameterization and control loops autotuning, please read AN15061 Application Note in MCSPTE1AK344\doc folder. Default path:

c:\NXP\MC_DevKits\MCSPTE1AK344\doc\ApplicationNotes\AN15061 MCAT 2.0 - Motor Control Application Tuning Tool for PMSM FOC.pdf

Run the Motor

Open the Speed Loop page, then use the Speed Control tab to set the required speed and turn on the motor drive.

Figure 46. FM App Control

Figure 46. FM App Control

Select one of the predefined Scopes or Recorders in Project Tree to watch the application variables in real time.

For runtime debugging, you can create or modify scopes and recorders as needed.

Figure 47. Speed

Figure 47. Speed

Check Pending Faults

If there are pending faults and the red LED indicates a fault state, click CLEAR on the MCAT Control tab. You can also press SW5 and SW6 simultaneously on the board.

Figure 48. Fault

Figure 48. Fault

Start Application

Click On/Off on the control bar, or press SW5 or SW6 on the board, to start clockwise or counterclockwise rotor rotation. The blue LED indicates the running state.

Set Speed

Modify the Required Speed field on the control bar, or change the Speed Required value in the Variable Watch window. You can also control the speed by pressing SW5 or SW6 on the board.

Figure 49. Speed Required

Figure 49. Speed Required

Stop Application

Stop the motor by clicking On/Off on the MCAT control page, clearing the On/Off variable, or pressing and holding SW5 and SW6 on the S32K344EVB board. The green LED indicates the ready state.

Note: For more information about MCAT tool, refer to AN15061 Application Note in the MCSPTE1AK344\doc folder. Default path: c:\NXP\MC_DevKits\MCSPTE1AK344\doc\ApplicationNotes\AN15061 MCAT 2.0 - Motor Control Application Tuning Tool for PMSM FOC.pdf

Board Information

• S32K3X4EVB-T172 Evaluation Board Design Files
• S32K3X4EVB-Q172 Evaluation Board Hardware User Manual
• DEVKIT-MOTORGD Layout Files
• S32K3 MCUs for General Purpose – Hardware Design Package
• DEVKIT-MOTORGD Board – REV B2 Schematic
• DEVKIT-MOTORGD Layout Files
• DEVKIT-MOTORGD BOM Files

Chip Information

• AN13767 3-Phase Sensorless PMSM Motor Control Kit with S32K344 Using RTD Low Level API Application Note
• AN13884 3-Phase Sensorless PMSM Motor Control Kit with S32K344 Using RTD AUTOSAR® API
• AN13902 3-Phase Sensorless PMSM Motor Control Kit with S32K344 Using MBDT Blocks
• AN12881 Motor Control Using FreeRTOS

Chip Documents

• Motor Control Solutions Based on S32K3 MCUs Brochure
• S32K3 Arm Cortex-M7-Based Automotive MCUs: Brochure
• S32K3xx MCU Family - Reference Manual
• Mask Set Errata for Mask 0P55A/1P55A - Errata
• MC33GD3000, Three Phase Field Effect Transistor Pre-Driver - Data Sheet
• FS26, Safety System Basis Chip with Low Power for ASIL D /ASIL B - Product Brief

Software

• MCSPTE1AK344 Development Kit Application Software
• S32K3 Standard Software Package
• S32K3 Reference Software Package
• S32 Design Studio IDE
• Real-Time Drivers (RTD)
• S32K Power Estimation Tool (PET)
• Model-Based Design Toolbox (MBDT)
• Structural Core Self-Test (SCST) Library
• FreeMASTER Run-Time Debugging Tool
• Inter-Platform Communication Framework (IPCF)
• Automotive Math and Motor Control Library (AMMCLib)
• S32 Safety Software Framework (SAF) and Safety Peripheral Drivers (SPD)

Training

• Comprehensive Overview of the S32K3xx Automotive MCU Family and What Its Software Offers
• A Model-Based Design (MBDT) Environment for Motor Control Algorithm Development

Forums

Connect with other engineers and get expert advice on designing with the MCSPTE1AK344 on one of our community sites.

• S32K
• S32 Design Studio
• Model-Based Design Toolbox (MBDT)
• FreeMASTER
• S32K3 Motor control SW examples
• S32K344 - FOC with dual shunt current measurement
• S32K344 - FOC with single shunt current measurement
• S32K344 - FOC integrated with FreeRTOS
• S32K344 - Six-step commutation control