Overview

MPLAB ® Code Configurator Melody content for dsPIC33 offers device drivers support for dsPIC33 Digital Signal Controllers (DSCs).

1 Operating Environment

MCC Melody is supported in MPLAB® X

MPLAB® X Operating Environment

  • MPLAB® X IDE v6.20 or later
  • MPLAB® XC16 Compiler v1.70 or later
  • MPLAB® XCDSC Compiler v3.10 or later
  • MCC Plugin v5.5.1 or later
  • MCC Core 5.7.0 or later

2 Documentation Support

MCC Supports various levels of documentations:
  1. MCC User Guide - Explains the overall MCC usage and has pointers to MCC Melody Content type specific help.
  2. MCC Content Manager Help - Provided information about MCC Content Manager.
  3. MCC Melody Technical Reference - Provides detailed technical information about MCC Melody.
  4. Release notes are available for each component(s) in MCC Content Manager.
  5. Individual release information is available for each version of the component in the MCC Content Manager in the Version selection dropdown. Example: OPAMP Driver Change Log.
  6. API Documentation is available for each component through the Resource Management View.
Figure 2-1. MCC Melody Documentation Support

Refer to the individual Component Changelog from Content Manager for the Feature Support, Bug fix information of respective Driver, PLIB Hardware Peripheral, PIC24-dsPIC-Device Releases .

Figure 2-2. MCC Content Manager: Viewing version history for Driver/PLIB/Hardware Peripheral Initializer and PIC24-dsPIC Device

To know how to get the detailed information of individual Component Release version, refer the MCC Content Manager Reference.

3 Installation Requirements

The dsPIC33 MCC Melody content such as Drivers, PLIBs, Hardware Peripherals and dsPIC device can be installed using the Content Manager.

For more information about the content manager, go to the MCC Content Manager Reference.

4 What's New

  1. Introduced MISRA C:2012 Compliance Report support for the dsPIC33AK device families.

  2. Added CAN-FD driver support for the dsPIC33AK512MPS512 device family.

5 Suppported MCU Family Devices

Refer to the below table for the list of device familes supported in both MCC Classic and MCC Melody

Table 5-1. Device Family Support
Sl. No.Device FamilyMCC MelodyMCC Classic
1dsPIC33AK512MPS512
2dsPIC33AK128MC106
3dsPIC33CDVL64MC106
4dsPIC33CDVC256MP506
5dsPIC33CK512MPT608
6dsPIC33CDVL64MC106
7dsPIC33CDV64MC106
8dsPIC33CDVC256MP506
9dsPIC33CDV256MP506
10dsPIC33CK512MPT608
11dsPIC33CK1024MP710
12dsPIC33CK256MC506
13dsPIC33CK512MP608
14dsPIC33CK256MP508
15dsPIC33CK64MP105
16dsPIC33CK64MC105
17dsPIC33CH128MP508 and dsPIC33CH128MP508S1
18dsPIC33CH512MP508 and dsPIC33CH512MP508S1
19dsPIC33EP512MU814
20dsPIC33EP128GS806
21dsPIC33EP64GS506
22dsPIC33EP32GS202
23dsPIC33EP512GM710
24dsPIC33EP512GP506
25dsPIC33EV256GM106
26dsPIC33EV256GM006
27PIC24F16KM204
28PIC24FV32KA302
29PIC24FJ128GA010
30PIC24FJ64GA004
31PIC24FJ64GB004
32PIC24FJ64GA104
33PIC24FJ256GB110
34PIC24FJ256GA110
35PIC24FJ256DA210
36PIC24FJ256GB210
37PIC24FJ128GA310
38PIC24FJ128GB204
39PIC24FJ128GA204
40PIC24FJ128GC010
41PIC24FJ256GB412
42PIC24FJ256GA412
43PIC24FJ1024GB610
44PIC24FJ1024GA610
45PIC24FJ256GA705
46PIC24FJ128GL306
47PIC24FJ512GU410
48PIC24FJ64GU205
49PIC24F16KM204
50PIC24FV32KA302
Note: The version for MCC Melody in the above table represents the PIC24-dsPIC33 device package version.

6 Table: Peripheral Support by MCU Device

The MCC Melody supports the following PIC24/dsPIC33 devices and hardware peripherals:

Table 6-2. Legend
SymbolNote
Peripheral supported
Peripheral presently not supported
…Peripheral does not exist in the device
Table 6-3. PIC24F/dsPIC33 Device Peripherals
DeviceIntegrated AnalogWaveform ControlClocks and TimersSafety and MonitoringWired Communications System FlexibilityUser InterfaceMemory
ADCURefDACCMPOPAPGACCSCBGMCCPPWMICOCDSMTMRRTCCQEILVDDMTWDTCRCIOIMPACCANI2CSPIMSSPUSBSENTPMPBiSSUARTCLCExt IntDMAPTGLCDGFXITCCTMUFLASH
dsPIC33AK512MP512 Family
dsPIC33AK256MPS505……………………………
dsPIC33AK256MPS506……………………………
dsPIC33AK256MPS508……………………………
dsPIC33AK256MPS510……………………………
dsPIC33AK256MPS512……………………………
dsPIC33AK512MPS505……………………………
dsPIC33AK512MPS506……………………………
dsPIC33AK512MPS508……………………………
dsPIC33AK512MPS510……………………………
dsPIC33AK512MPS512……………………………
dsPIC33AK256MPS205………………………………
dsPIC33AK256MPS206………………………………
dsPIC33AK256MPS208………………………………
dsPIC33AK256MPS210………………………………
dsPIC33AK256MPS212………………………………
dsPIC33AK512MPS205………………………………
dsPIC33AK512MPS206………………………………
dsPIC33AK512MPS208………………………………
dsPIC33AK512MPS210………………………………
dsPIC33AK512MPS212………………………………
dsPIC33AK128MC106 Family
dsPIC33AK32MC102……………………………………………
dsPIC33AK32MC103……………………………………………
dsPIC33AK32MC105……………………………………………
dsPIC33AK32MC106……………………………………………
dsPIC33AK64MC102……………………………………………
dsPIC33AK64MC103……………………………………………
dsPIC33AK64MC105……………………………………………
dsPIC33AK64MC106……………………………………………
dsPIC33AK128MC102……………………………………………
dsPIC33AK128MC103……………………………………………
dsPIC33AK128MC105……………………………………………
dsPIC33AK128MC106……………………………………………
dsPIC33CDVL64MC106 Family
dsPIC33CDVL64MC106………………………………………………………
dsPIC33CDV64MC106………………………………………………………
dsPIC33CDVC256MP506 Family
dsPIC33CDVC128MP506……………………………………………………
dsPIC33CDVC256MP506……………………………………………………
dsPIC33CDV128MP506……………………………………………………
dsPIC33CDV256MP506……………………………………………………
dsPIC33CDV128MP206………………………………………………………
dsPIC33CDV256MP206………………………………………………………
dsPIC33CK512MPT608 Family
dsPIC33CK512MPT608…………………………………………………………
dsPIC33CK256MPT608…………………………………………………………
dsPIC33CK256MP508 Family
dsPIC33CK128MP202............................................................
dsPIC33CK128MP203............................................................
dsPIC33CK128MP205............................................................
dsPIC33CK128MP206.........................................................
dsPIC33CK128MP208.........................................................
dsPIC33CK128MP502.........................................................
dsPIC33CK128MP503.........................................................
dsPIC33CK128MP505.........................................................
dsPIC33CK128MP506......................................................
dsPIC33CK128MP508......................................................
dsPIC33CK256MP202............................................................
dsPIC33CK256MP203............................................................
dsPIC33CK256MP205............................................................
dsPIC33CK256MP206.........................................................
dsPIC33CK256MP208.........................................................
dsPIC33CK256MP502.........................................................
dsPIC33CK256MP503.........................................................
dsPIC33CK256MP505.........................................................
dsPIC33CK256MP506......................................................
dsPIC33CK256MP508......................................................
dsPIC33CK32MP202............................................................
dsPIC33CK32MP203............................................................
dsPIC33CK32MP205............................................................
dsPIC33CK32MP206.........................................................
dsPIC33CK32MP502.........................................................
dsPIC33CK32MP503.........................................................
dsPIC33CK32MP505.........................................................
dsPIC33CK32MP506......................................................
dsPIC33CK64MP202............................................................
dsPIC33CK64MP203............................................................
dsPIC33CK64MP205............................................................
dsPIC33CK64MP206.........................................................
dsPIC33CK64MP208.........................................................
dsPIC33CK64MP502.........................................................
dsPIC33CK64MP503.........................................................
dsPIC33CK64MP505.........................................................
dsPIC33CK64MP506......................................................
dsPIC33CK64MP508......................................................
dsPIC33CK64MP105 Family
dsPIC33CK32MP102............................................................
dsPIC33CK32MP103............................................................
dsPIC33CK32MP105............................................................
dsPIC33CK64MP102............................................................
dsPIC33CK64MP103............................................................
dsPIC33CK64MP105............................................................
dsPIC33CK64MC105 Family
dsPIC33CK32MC102............................................................
dsPIC33CK32MC103............................................................
dsPIC33CK32MC105............................................................
dsPIC33CK64MC102............................................................
dsPIC33CK64MC103............................................................
dsPIC33CK64MC105............................................................
dsPIC33CK512MP608 Family
dsPIC33CK256MP305.........................................................
dsPIC33CK256MP306......................................................
dsPIC33CK256MP308......................................................
dsPIC33CK512MP305.........................................................
dsPIC33CK512MP306......................................................
dsPIC33CK512MP308......................................................
dsPIC33CK256MP605......................................................
dsPIC33CK256MP606...................................................
dsPIC33CK256MP608...................................................
dsPIC33CK512MP605......................................................
dsPIC33CK512MP606...................................................
dsPIC33CK512MP608...................................................
dsPIC33CK256MC506 Family
dsPIC33CK256MC506...................................................
dsPIC33CK256MC505...................................................
dsPIC33CK256MC503......................................................
dsPIC33CK256MC502...................................................
dsPIC33CK128MC506...................................................
dsPIC33CK128MC505......................................................
dsPIC33CK128MC503...................................................
dsPIC33CK128MC502...................................................
dsPIC33CK256MC106......................................................
dsPIC33CK256MC105......................................................
dsPIC33CK256MC103.........................................................
dsPIC33CK256MC102......................................................
dsPIC33CK128MC106......................................................
dsPIC33CK128MC105.........................................................
dsPIC33CK128MC103......................................................
dsPIC33CK128MC102......................................................
dsPIC33CK1024MP710 Family
dsPIC33CK256MP705...................................................
dsPIC33CK256MP706...................................................
dsPIC33CK256MP708...................................................
dsPIC33CK256MP710...................................................
dsPIC33CK512MP705...................................................
dsPIC33CK512MP706...................................................
dsPIC33CK512MP708...................................................
dsPIC33CK512MP710...................................................
dsPIC33CK1024MP705...................................................
dsPIC33CK1024MP706...................................................
dsPIC33CK1024MP708...................................................
dsPIC33CK1024MP710...................................................
dsPIC33CK256MP405......................................................
dsPIC33CK256MP406......................................................
dsPIC33CK256MP408......................................................
dsPIC33CK256MP410......................................................
dsPIC33CK512MP405......................................................
dsPIC33CK512MP406......................................................
dsPIC33CK512MP408......................................................
dsPIC33CK512MP410......................................................
dsPIC33CK1024MP405......................................................
dsPIC33CK1024MP406......................................................
dsPIC33CK1024MP408......................................................
dsPIC33CK1024MP410......................................................
dsPIC33CK512MPT608 Family
dsPIC33CK512MPT608-I/PT......................................................
dsPIC33CK256MPT608-I/PT......................................................
dsPIC33CH128MP508 Family
dsPIC33CH128MP202............................................................
dsPIC33CH128MP203............................................................
dsPIC33CH128MP205............................................................
dsPIC33CH128MP206............................................................
dsPIC33CH128MP208............................................................
dsPIC33CH128MP502.........................................................
dsPIC33CH128MP503.........................................................
dsPIC33CH128MP505.........................................................
dsPIC33CH128MP506.........................................................
dsPIC33CH128MP508.........................................................
dsPIC33CH64MP202............................................................
dsPIC33CH64MP203............................................................
dsPIC33CH64MP205............................................................
dsPIC33CH64MP206............................................................
dsPIC33CH64MP208............................................................
dsPIC33CH64MP502.........................................................
dsPIC33CH64MP503.........................................................
dsPIC33CH64MP505.........................................................
dsPIC33CH64MP506.........................................................
dsPIC33CH64MP508.........................................................
dsPIC33CH128MP508S1 Family
dsPIC33CH128MP202S1........................................................................
dsPIC33CH128MP203S1........................................................................
dsPIC33CH128MP205S1........................................................................
dsPIC33CH128MP206S1........................................................................
dsPIC33CH128MP208S1........................................................................
dsPIC33CH128MP502S1........................................................................
dsPIC33CH128MP503S1........................................................................
dsPIC33CH128MP505S1........................................................................
dsPIC33CH128MP506S1........................................................................
dsPIC33CH128MP508S1........................................................................
dsPIC33CH64MP202S1........................................................................
dsPIC33CH64MP203S1........................................................................
dsPIC33CH64MP205S1........................................................................
dsPIC33CH64MP206S1........................................................................
dsPIC33CH64MP208S1........................................................................
dsPIC33CH64MP502S1........................................................................
dsPIC33CH64MP503S1........................................................................
dsPIC33CH64MP505S1........................................................................
dsPIC33CH64MP506S1........................................................................
dsPIC33CH64MP508S1........................................................................
dsPIC33CH512MP508 Family
dsPIC33CH256MP205............................................................
dsPIC33CH256MP206............................................................
dsPIC33CH256MP208............................................................
dsPIC33CH256MP505.........................................................
dsPIC33CH256MP506.........................................................
dsPIC33CH256MP508.........................................................
dsPIC33CH512MP205............................................................
dsPIC33CH512MP206............................................................
dsPIC33CH512MP208............................................................
dsPIC33CH512MP505.........................................................
dsPIC33CH512MP506.........................................................
dsPIC33CH512MP508.........................................................
dsPIC33CH512MP508S1 Family
dsPIC33CH256MP205S1.....................................................................
dsPIC33CH256MP206S1.....................................................................
dsPIC33CH256MP208S1.....................................................................
dsPIC33CH256MP505S1.....................................................................
dsPIC33CH256MP506S1.....................................................................
dsPIC33CH256MP508S1.....................................................................
dsPIC33CH512MP205S1.....................................................................
dsPIC33CH512MP206S1.....................................................................
dsPIC33CH512MP208S1.....................................................................
dsPIC33CH512MP505S1.....................................................................
dsPIC33CH512MP506S1.....................................................................
dsPIC33CH512MP508S1.....................................................................

7 MISRA C:2012 Compliance Report

MCC Melody generated code for dsPIC33A device family are made MISRAC:2012 compliant for all the Mandatory and Required set of rules. However, full compliance with all MISRA rules is not always feasible. The following document provides a detailed list of deviations.

MCC Melody generated code for dsPIC33A device family is analyzed using static analysis tool ‘MISRA Check’ available in MPLAB.

Table 7-4. MISRA C Compliance: Deviation list
Rule(Type)Peripheral(s)DescriptionDeviation Scenario
8.4 (Required)All PeripheralsA compatible declaration shall be visible when an object or function with external linkage is definedIn interrupt service routines, their header is implemented outside of the driver in compiler-supplied header files
8.12 (Required)ClockWithin an enumerator list, the value of an implicitly-specified enumeration constant shall be uniqueMultiple enum mapped to same clock generator which is part of requirement hence cannot be unique

Device Family Compliance Summary

The table below summarizes the MISRA C:2012 compliance status for MCC Melody-generated code across various dsPIC33xx device families. Compliance is evaluated against all Mandatory and Required MISRA C:2012 rules using static analysis tool. A “Yes” indicates that the generated code meets these requirements with documented deviations as listed above.

Device FamilyMISRA C:2012 (Mandatory, Required) Compliant
dsPIC33AKYes – Fully compliant with all Mandatory and Required rules with documented exceptions
dsPIC33CKNo – Compliance not established for this device family
dsPIC33CHNo – Compliance not established for this device family

8 Melody Package Information

Device Content supports the following Packages
  • Drivers
  • PLIBs
  • dsPIC-Devices

Drivers

  • Most of the drivers provide portabability to the functionalities of the hardware peripheral.
  • Migrate-able across devices and provides usable code and configuration

Multiple Drivers for One Hardware Peripheral

The Drivers are categorized based on their functionality of a hardware peripheral helping the customer to precisely select as per the requirment thus avoiding the hassle of too many configurations.
Table 8-5. Driver Categorization
Driver(s)Hardware Peripheral Functionality (PLIBs)
IC, Edge Output, Pulse Output, PWMMCCP/SCCP
CAN FD and CAN 2.0 CAN
I2C Host, I2C Client I2C
SPI Host, SPI ClientSPI

Same Driver for Different Hardware Peripherals

The Driver(s) carefully abstracts out the underlying hardware peripheral details, while providing the functionality.

For Ex. Timer Driver can work either with a Timer peripheral or an SCCP peripheral whichever is supported by the device.

Revamped System Module

Getting an appropriate clock source is always a challenging task, however with the new design of System Module, now it all takes a single input from the user of the required clock frequency and MCC helps the user in getting the requested frequency or the closest frequency that's supported while having the corresponding configurations done at the backend.

Generated Firmware

The generated firmware from the Driver(s) supports portability across multiple MCU devices independent of both a peripheral instance, and the MCU device.

Fig 1 : MCC Generated files for Timeout Driver and generated Timer API's

Hardware Peripheral Initializers

The hardware peripheral intializers are generated for bare metal development and provide non-portable direct access to the hardware registers.

The Initialize function has code comments to describe the settings made.

Fig 2: Only 1 function is generated for Hardware Peripheral Initializers