Getting Started with the MCSXSR1CS12ZVM Evaluation Board for 3-Phase BLDC/PMSM High-Current Applications

2.1 Download the Quick Start Package

Download the complete motor control application software for MCSXSR1CS12ZVM evaluation board.

Note: The installation process offers also downloading the latest version of Automotive Math and Motor Control Library (AMMCLib) set but requires internet connection.

Download the MCSXSR1CS12ZVM QSP

2.2 Get the Integrated Development Environment (IDE)

MCSXTE2BK142 performs better when using CodeWarrior^® for MCUs 11.x IDE.

Note: Check the CodeWarrior for MCU page for the latest version.

Download CodeWarrior for MCUs 11.x IDE

2.3 Get the Run-Time Debugging Tool

MCSXTE2BK142 performs better when using the FreeMASTER tool for run-time debugging.

You can also download and install the FreeMASTER Communication Driver (source code already included in example project).

Note: Check the FreeMASTER page for the latest version.

Download FreeMASTER tool

2.4 Install an OSBDM Debug Interface Driver

Download the latest version from P&E.

Note: For details, go to EMBEDDED OSBDM

Get OSBDM debug interface driver

3.1 Set Up Jumpers

3.2 Plug in the Power Supply

Connect the appropriate 12 V power supply (8-18 V range or 3.5-18 V range with boost option enabled) to the power supply terminals J3 and J4 using M5 ring-eye connector and proper wiring (10 A/mm2max).

3.3 Plug In the USB Cable

Connect MCSXSR1CS12ZVM to the PC using the USB cable.

3.4 4. Connect the Motor

Connect to the output terminals J66, J67 and J68 using M5 ring-eye connector and proper wiring (10 A/mm2 max).

Let’s take it for a test drive.

4.1 Import and Debug the Project to IDE

1. To import the installed application software project in the CodeWarrior for MCUs 11.x by launch IDE by going to File → Import
2. Then, select General → Existing Projects in the workspace. To choose the root directory, click Next
3. Navigate to MC_DevKits\MCSXSR1CS12ZVM\sw\...
4. Then, choose your motor control driving control:
   • MCSXSR1CS12ZVM_PMSM for PMSM with the field-oriented driving control
   • MCSXSR1CS12ZVM_BLDC for BLDC with six-step commutation driving control

5. Click on Copy project into workspace and then click Finish.

   Note: to clear the project, click Debug to build and flash the software. Once flashed, Run the session and click Disconnect to release the USB resources.

   

Optional: Build Your Project

Note: These steps shouldn't be necessary since they are executed in the next step automatically.

Right click on the imported project and select Clean from the context menu.

4.2 Debug for Loading Code into the MCU

To load built code into MCU, go to Run → Debug Configuration → select predefined debug configuration and click Debug button:

4.3 Communicate with the Run-Time Debugger

1. Launch the FreeMASTER application
2. Open a project ❮selected project❯ FreeMASTER_control\ MCSXSR1CS12ZVM_PMSM_SW_CW11.pmp by clicking File → Open Project
3. To enable communication, in the FreeMASTER tool bar, click Go (or press CNTRL+G)
4. Successful communication is signalized in the status bar at the very bottom as:

   RS232 UART Communication;COMn; speed = 19200

5. Let code run by clicking on the Resume (F8) button, and use Disconnect button for avoiding interference between CW debugger and FreeMASTER tool

4.4 Launch the Control Application

Launch the Motor Control Application Tuning (MCAT) tool, then display the application control page on the tool menu. When the power supply is connected to the board, the application is in READY state indicated by a blue LED on the board. The LED also indicates:

• READY, INIT states - slowly flashing LED
• CALIB, ALIGN states - flashing LED
• RUN state - lighting LED
• FAULT state - fast-flashing LED

Note: In case of pending faults, click the fault button Clear FAULT on the FreeMASTER MCAT Control Page.

4.5 Debug Your Project Using the Run-Time Debugging Tool

Run appropriate *.pmp file from your application project folder.

Note: You may start it by double click directly from CodeWarrior project explorer.

4.6 Establish a Connection with the MCU

1. Start the application by clicking ON/OFF button on the FreeMASTER MCAT control page.

2. Set required speed by changing the Speed Required variable value manually in the variable watch window, or by clicking the speed gauge in the MCAT control tab.

   Note: the connection parameters are already predefined,You can change them in project options or by using the Connection Wizard.

4.7 Tune the Motor

Now you are ready to tune your motor control application.

1. Successfully tune the control loops
2. In FreeMASTER, go to the Control tab and set the required motor rpms and turn on the motor drive
3. Stop the application by clicking ON/OFF button on the FreeMASTER MCAT control page

Your motor should now be running.

Board Documents

• MCSXSR1CS12ZVM evaluation board - User Guide
• MCSXSR1CS12ZVM evaluation board - Schematics
• MCSXSR1CS12ZVM evaluation board - Design Files
• MCSXSR1CS12ZVM evaluation board - Quick Start Package

Chip Documents

• S12ZVM - Reference Manual

Software

• FreeMASTER Run-Time Debugging Tool
• Motor Control Application Tuning (MCAT) Tool
• Automotive Math and Motor Control Library Set (AMMCLib)
• CodeWarrior^® for MCUs (Eclipse IDE) - ColdFire^®, 56800/E DSC, Qorivva^® 56xx, RS08/S08, S12Z - 11.1

Training

• Streamline your Motor Control Application with Flexible and Reliable NXP Solution
• Speeding Up 3-Phase Motor Control for Automotive and Industrial

Forums

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

• S12 / MagniV microcontrollers online community
• CodeWarrior Community
• FreeMASTER Community