Getting Started with FRDM-A-S32K312 using Application Code Hub (ACH)

[#1]

Table of Contents

• 1. Introduction
• 2. Requirements
  • 2.1 Software Required
  • 2.2 Hardware Required
• 3. NXP Account Login
• 4. Installation
  • 4.1 S32K3 FRDM Automotive Board Installation
  • 4.2 FreeMASTER Installation
  • 4.3 AMMCLib Installation
• 5. Open a Demo from ACH (Application Code Hub)
• 6. Running a Motor Control Demo from ACH
• 7. Conclusion

---

1. Introduction

This article aims to help new users prepare and install the necessary software and hardware to use the FRDM-A-S32K312 board with the latest S32K3 FRDM Automotive Bundle and Examples from Application Code Hub (ACH).

Note: These steps can also be followed with other NXP Evaluation Board, for example FRDM-A-S32K344.

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.

FRDM-A-S32K312-Details.png

2. Requirements

2.1 Software Required

• S32K3 FRDM Automotive Board Installation Package
• FreeMASTER Run-Time Debugging Tool
• Automotive Math and Motor Control Library (AMMCLib) Rev 1.1.44

2.2 Hardware Required

• FRDM-A-S32K312 Development Board
• MCSPTE1AK344 Motor Control Kit, which includes:
  • Sunrise motor 
  • DEVKIT-MOTORGD 
  • 12V power supply
• FRDM K64 click shield with Force Click and 4X4 RGB Click
• USB Type-C cable

3. NXP Account Login

Open Software Licensing: Support, make sure you are logged into your NXP Account, and select:

1. Click on My NXP Account.
2. Select Software Licensing and Support.
   

   stefanvlad_4-1766413667183.png

3. Then click on View accounts: stefanvlad_5-1766413890382.png

These steps will ensure that you are properly authenticated with your NXP Account before proceeding with any software downloads.

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 S32K3 FRDM Automotive Board Installation

Navigate to S32K3 FRDM Automotive Bundle

• The page will open with default selection: FRDM Automotive Board Installation Package 
  stefanvlad_0-1779985423843.png
• Click on Generate Bundle Installer and then a popup window will appear:
  stefanvlad_1-1779984167578.png
• Click Next and enter details about Export Control:
  stefanvlad_2-1779984263930.png
• Click on Submit Export Control, then read the License Agreement:
  stefanvlad_3-1779984364018.png
• After reading, click on I Accept the terms of the License Agreement
• Wait for the Generate Bundle Installer to complete and press Done:
  stefanvlad_4-1779984469321.png
• This will download 2 files on your PC:
  • NXP_Multi_Installer_28.05.26.190715_User_Manual.pdf
  • NXP_Multi_Installer_28.05.26.190715_setup.exe
• Open NXP_Multi_Installer_28.05.26.190715_setup.exe:
  stefanvlad_3-1779986630899.png
• Click Next > and read the License Agreement:
  stefanvlad_4-1779986657860.png
• After reading press on I Agree
  stefanvlad_2-1779986607439.png

• Select the type of install: Full and press Next

  stefanvlad_5-1779986759079.png
• Check the Download folder to your location and press Nextstefanvlad_6-1779986834607.png
  
• Select both options:
  • Launch executable files after download
  • Installation and configuration without any interaction
• Click on Download
• Wait for the download to complete, and Installation will begin
  stefanvlad_8-1779987127107.png
• Wait for the installation process to complete (~10-15 minutes)stefanvlad_9-1779987474488.png
• Click Next to close the window
  stefanvlad_10-1779987521122.png
• After installation check PEmicro drivers installed on your PC: 

• Connect the USB cable to your PC and the FRDM Automotive S32K312 board:
  FRDM-A-S32K312-Connect.png
• Open Device Manager to check OpenSDA and the COM port number.
• OpenSDA - CDC Serial Port → note this COM port number stefanvlad_2-1766420223283.png

Note: The COM port number may differ on your system.

4.2 FreeMASTER Installation

Download the  FreeMASTER Run-Time Debugging Tool:

stefanvlad_3-1766420635579.png

• Open the installer FMASTERSW32.exe
• Click Next, then select all available products:
  stefanvlad_3-1766483372281.png
• Use the default installation path: C:\NXP\FreeMASTER 3.2

  stefanvlad_5-1766483553297.png
• Wait for the installation to complete.

4.3 AMMCLib Installation

First, open the S32 Design Studio 3.6.5

• Navigate the Menu to Help -> S32DS Extensions and Updatesstefanvlad_11-1779987676217.png
• Search for AMMCLIB and select AMMCLIB for S32K3xx/S32M27x:
  stefanvlad_12-1779987760221.png
• Click Install/Update 1 item(s) and next
  stefanvlad_13-1779987884046.png
• Read and Click on I accept the terms and press Finish
  stefanvlad_14-1779987944058.png
• Select the Authority/Update Site https://www.nxp.com and Trust Selected
  stefanvlad_15-1779987973847.png
• Select X509 and Trust Selected
  stefanvlad_16-1779988044438.png
• Restart S32 Design Studio 3.6.5

5. Open a Demo from ACH (Application Code Hub)

• Open S32 Design Studio 3.6.5, select Import Project from Application Code Hub
  stefanvlad_1-1780063619713.png
• This will open a new Window:
  stefanvlad_2-1780065330695.png
• Click on Search window and enter "brake"
• Select the Emergency LED-Based Brake Status Monitoring on FRDM-A-S32K312
  stefanvlad_0-1780063360588.png
• Click on GitHub link — this will trigger S32 Design Studio IDE to automatically retrieve project attributes, then click Next>.

• Select main branch and then click Next>.

• Select your local path for the repo in Destination->Directory window. The S32 Design Studio IDE will clone the repo into this path, click Next>.

• Select Import existing Eclipse projects then click Next>.

• Select the project in this repo (only one project in this repo) then click Finish.

• In Project Explorer, right-click the project and select Update Code and Build Project:

  stefanvlad_3-1780065674210.png

• This will generate the configuration (Pins, Clocks, Peripherals), update the source code and build the project using the active configuration (e.g. Debug_FLASH). Make sure the build completes successfully and the *.elf file is generated without errors.

• Go to Debug and select Debug Configurations. There will be a debug configuration for this project:

  stefanvlad_4-1780065730779.png 
• Select the FRDM_A_S32K312_BRAKE_MONITORING_Debug_FLASH_PNE configuration and press Debug:
  stefanvlad_6-1780065836787.png
• Now the perspective will change to the Debug Perspective. Use the controls to control the program flow.

• Results:
  The LED strip lights up in different colors to indicate the current voltage level being monitored. Upon startup, all LEDs perform a test sequence to verify functionality. During normal operation, the entire strip changes color based on the measured voltage: green for safe levels, yellow for moderate levels, orange for elevated levels, and red for critical levels, providing real-time visual feedback of the electrical signal being monitored.

  stefanvlad_5-1780065756598.gif

6. Running a Motor Control Demo from ACH

• Open S32 Design Studio 3.6.5, select Import Project from Application Code Hub - Motor Control
• Open the example:
  PMSM Motor Control Sensorless dual Shunt FOC on FRDM-A-S32K312  stefanvlad_17-1779988229433.png
• Follow the same steps as above in 5. Open a Demo from ACH (Application Code Hub)
• After the executable file is downloaded to the board:
  1. Disconnect the FRDM-A-S32K312 board from the PC.
  2. Insert the DEVKIT-MOTORGD on top of the FRDM-A-S32K312 ensuring proper pin alignment.
  3. Plug-in the 12V power supply to the DEVKIT-MOTORGD.
  4. Reconnect the USB Type-C cable to the FRDM-A-S32K312
      K312_MC_KIT.png
  5. 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. 
     K312_MC_KIT_TOP_A.JPG

      

• Open FreeMASTER_control/S32K_PMSM_Sensorless.pmpx project file:
  stefanvlad_1-1780066630032.png

• This will launch another window with FreeMASTER:
  FreeMASTER_Connect.png

• Press GO button to connect at 115200 baud.
• In the App Control Tab, press On and set Speed Required to 1000 RPM:FreeMASTER_Running.png
• Apply a small mechanical load to the motor (friction force to the motor shaft) and observe the iABC currents:
  FreeMASTER_Waveforms.png
• Here is a short video with the steps above explained:

7. Conclusion

These steps conclude the Getting Started with the FRDM-A-S32K312 board using the latest S32K3 FRDM Automotive Bundle and examples from Application Code Hub (ACH).

For more details, refer to:

• The corresponding Readme for the selected ACH example.

Thank you for your time,

Stefan V.