Table of Contents
- 1. Introduction
- 2. Requirements
- 3. NXP Account Login
- 4. Installation
- 5. Running a Demo from the MBDT examples for S32K3
- 6. Running a Motor Control Demo using MBDT
1. Introduction
This article aims to help new users prepare and install the necessary software and hardware to use the FRDM Automotive S32K312 with the latest Model-Based Design Toolbox for S32K3 version 1.8.0.
Note: These steps can also be followed with any NXP Evaluation Board from the supported list referenced in the toolbox documentation.
S32K312MINI‑EVB Renamed to FRDM‑A‑S32K312: Now part of the FRDM Automotive Ecosystem under its new name, the board keeps the same hardware and adds full ecosystem compatibility for flexible, scalable development.
2.1 Software Required
- MATLAB® R2023b or later, with following Add-ons:
- NXP Model-Based Design Toolbox for S32K3 version 1.8.0
- FreeMASTER Run-Time Debugging Tool
- PEmicro Hardware Interface Drivers
2.2 Hardware Required
- FRDM-A-S32K312 Development Board
- MCSPTE1AK344 Motor Control Kit, which includes:
- Sunrise motor
- DEVKIT-MOTORGD
- 12V power supply
- USB Type-C cable
3. NXP Account Login
Open Software Licensing: Support, make sure you are logged into your NXP Account, and select:
- Click on My NXP Account.
- Select Software Licensing and Support.
- Then click on View accounts:
These steps will ensure that you are properly authenticated with your NXP Account before proceeding with step 4.5 MBDT for S32K3 v1.8.0 Installation.
Keep the page opened for login to persist.
4. Installation
Note: Before proceeding, make sure you have full access to your PC or Laptop. Some installers require local admin rights. Contact your IT department to assist you with installation.
4.1 PEmicro driver Installation
After downloading PEmicro Hardware Interface Drivers
- Open the installer package and select default Destination Folder:
- Click on Install and then wait to finish successfully.
- Connect the USB cable to your PC and the FRDM Automotive S32K312 board:
- Open Device Manager to check OpenSDA and the COM port number.
- OpenSDA - CDC Serial Port → note this COM port number
Note: The COM port number may differ on your system.
4.2 FreeMASTER Installation
Download the FreeMASTER Run-Time Debugging Tool:
- Open the installer FMASTERSW32.exe
- Click Next, then select all available products:
- Use the default installation path: "C:\NXP\FreeMASTER 3.2"
- Wait for the installation to complete.
4.3 MATLAB® Installation
First, check whether MATLAB® R2023b or later is already installed. If so, you can skip this section.
- For this tutorial, MATLAB® R2025b is downloaded from MathWorks®:
- Download the matlab_R2025b_Windows.exe (246 MB) file.
- A MathWorks® Account login is required.
- After signing in, select the installation directory, default is C:\Program Files\MATLAB\R2025b
- For minimum requirements, install the following Products:
- MATLAB®
- Simulink®
- AUTOSAR Blockset
- Embedded Coder
- MATLAB® Coder
- Motor Control Blockset
- Simulink® Coder
- Stateflow
- By default Select All is enabled during install:
- Wait for the installation to finish.
- After installation, open MATLAB® and change the default Add-ons path to a shorter path such as: "C:\MathWorks".
4.4 MATLAB® Add-Ons Installation
Open Add-On Explorer and install:
- Embedded Coder Support Package for ARM Cortex-M Processors
- NXP Support Package for S32K3 (NXP_Support_Package_S32K3)
4.5 MBDT for S32K3 v1.8.0 Installation
- After installing the support package, run the following command in MATLAB®:
sp_s32k3.nxp.setup(); - Select version 1.8.0, the installer will check prerequisites:
- If any toolboxes are missing, install them before continuing.
- Click Download to proceed.
- The Download button opens the Software Terms and Conditions dialog; if the page is not properly loading, follow the steps in 3. NXP Account Login.
- After reading, click I Agree.
- Download the SW32_MBDT_S32K3_1.8.0_D2512.mltbx file (approx. 1.6GB):
- Once the download completes, browse the location of SW32_MBDT_S32K3_1.8.0_D2512.zip file:
- Click Install to proceed, and accept the license agreement.
- After a few minutes, the dialog will display: Installation successfully completed!
- Click Next.
- Select an option such as Open S32K3 Root Folder.
-
MATLAB®’s current folder will change to the root of the toolbox.
- Click Finish to close the installer.
- The current folder in MATLAB® is now "C:\MathWorks\Toolboxes\NXP_MBDToolbox_S32K3":
5. Running a Demo from the MBDT examples for S32K3
Navigate to:
- "C:\MathWorks\Toolboxes\NXP_MBDToolbox_S32K3\S32K3_Examples\demos\s32k3xx_uart_leds_s32ct"
- Open the model s32k3xx_uart_leds_s32ct.mdl.
- Click on Hardware Settings:
- Go to Hardware board Settings → Hardware → Select Configuration Project Template:
- For the FRDM-A-S32K312 select Custom: S32K312MINI-EVB S32 Config Tool
- A Warning Dialog will appear, click OK.
- Wait for the configuration update to complete.
- Click on Apply and close the Configuration Parameters window.
- Press Build, Deploy & Start (CTRL+B) in order to generate the code:
- After the build completes successfully, the executable is downloaded to the board.
- Open a terminal application and connect to the board's COM Port at 115200 Baud:
- Pressing r, g, or b on the keyboard toggles the corresponding RGB LED on the board.
6. Running a Motor Control Demo using MBDT
Navigate to "C:\MathWorks\Toolboxes\NXP_MBDToolbox_S32K3\S32K3_Examples\mc\PMSM"
- Open the folder s32k312_mc_pmsm_2sh_s32ct
- Open the model s32k312_mc_pmsm_2sh_s32ct.mdl:
- Press Build, Deploy & Start (CTRL+B) in order to generate the code.
- After the executable file is downloaded
- Disconnect the FRDM-A-S32K312 board from the PC.
- Insert the DEVKIT-MOTORGD on top of the FRDM-A-S32K312 ensuring proper pin alignment.
- Plug-in the 12V power supply to the DEVKIT-MOTORGD.
- Reconnect the USB Type-C cable to the FRDM-A-S32K312.
- The RGB LED, User Buttons are on top side, Reset Button is on the left side, while the 12V power, Motor Phases and USB Type-C are on the right side.
- Open FreeMASTER s32k312_mc_pmsm_2sh_s32ct.pmpx
- Press GO button to connect at 115200 baud.
- In the App Control Tab, press On and set Speed Required to 1000 RPM:
- Apply a small mechanical load to the motor (friction force to the motor shaft) and observe the iABC currents.
Conclusion
These steps conclude the Getting started with FRDM Automotive S32K312 using Model Based Design Toolbox guide.
For more details, refer to:
- s32k312_mc_pmsm_2sh_s32ct_example_readme.html
- The corresponding example_readme.html for the selected model.
Thank you for your time,
Stefan V.