11 Migration guide from PIC32MZ1025W104132/WFI32E01/WFI32E02 to PIC32MZ2051W104132/WFI32E03/WFI32E04

Introduction

This document provides the steps to port an existing project created for PIC32MZ1025W10432 to PIC32MZ2051W10432.

Software Details

Tool versions

Note:

User must make sure that the all the tool versions are same or greater than the versions given below.

IDE, Compiler and MCC pluginVersionLocation
MPLAB X IDE6.15 or aboveWeb
MPLAB® XC32 C/C++ Compilerv4.35 or aboveWeb
Microchip Code Configurator(MCC)5.3.7 or aboveWeb

Note:

User should take MPLABX IDE 6.20 or above for WFI32E04.

Harmony3 Repository versions:

Note:

User must make sure that the all the dependent Harmony3 repository versions are same or greater than the versions given below.

Harmony components to be cloned with MCC Content ManagerVersion
corev3.13.2
cspv3.18.2
wireless_wifiv3.9.1
wolfsslv5.4.0
netv3.11.0
cryptov3.8.0
CMSIS-FreeRTOSv10.4.6
bspv3.17.0
dev_packsv3.18.1
CMSIS_5v5.9.0
DevicesMaster Branch
touchv3.16.0

Note:

'touch' repo is needed for WFI32E04 only.

Steps for Porting an MCC project.

Follow the below mentioned steps to port an existing application of PIC32MZ1025W10432 to PIC32MZ2051W10432.

  • Open an existing PIC32MZ1025W10432 MCC project in MPLABx.

  • Open Project properties by selecting customize option available in the drop-down options as shown below.

    Customize option
  • Change the Device name to PIC32MZ2051W10432 and select the DFP pack 1.8.326 and compiler version. If the DFP pack is not installed, click on “Install” to install the DFP as shown below. Then apply the changes by pressing “Apply” and “Ok”.

    Device name and DFP pack
  • Open the MCC by pressing the MCC button available at top in MPLABx and Accept('Yes') the project migration confirmation.

    Project migration
  • Accept the DFP migration confirmation by selecting “Yes”.

    DFP migration
  • Once MCC opened, enable Force update on All option (by right clicking onto the Project Resources Tab) then press Generate button.

    Force Update on all
  • User need to merge newly generated code except for application files as it appears in the merge window.

  • Build and Flash the Project onto the device.

Note:

If the project is having multiple applications ( such as Bootloader along with Application ), user should take care of the below mentioned items.

  • user should add startup code to the first application/Bootloader.

    Refer the KBA for more details.

  • The Linker files for both Applications should be taken care by the user and update the NVM size (2MB) and SRAM size (512KB) for PIC32MZ2051W104132/WFI32E03.