MCC(MPLAB® Code Configurator)开发文档

MCC(MPLAB Code Configurator)开发文档

https://microchipdeveloper.com/xwiki/bin/view/software-tools/mcc/

Getting Started with MCC

The MCC GUI(Graphical User Interface):

• setup the configuration and all the peripherals;
• **generates driver code control the peripherals on PIC microcontrollers;
• configure and generate libraries, which allows you to configure and generate code for software libraries and off-chip peripherals;
• **The generated drivers or libraries can be used in any PIC device application program.
• The GUI provides an easy means for setting up the configuration of the peripherals.

The MCC requires an MPLAB X IDE project to be created, or an existing project opened, before launching the MCC plugin.

This is necessary as the MCC needs to know the device used in the project to have access to device-specific information,

like registers, bits, and configurations and to set up the MCC GUI.

The MCC generates source and header files based on selections made in the GUI.

The generated files are added to the active project of MPLAB X IDE.

Getting Started with MCC

The first step of any project is to use the MPLAB X IDE wizard tool to create a project.

The wizard will walk through selecting:

• the microcontroller,
• the development programmer/debugger
• and the compiler to use.

This should be done before launching the MCC.

The MCC tool, once installed, can be launched from:

"MPLAB X IDE menu" -> "Tools" -> "Embedded" -> "MPLAB Code Configurator v?: Open/Close"

MCC Sections Layout:

We will refer to these MCC sections by name throughout this training page(are shown in the image below).

• Project Resources: shows the current using peripherals in the project.
• Device Resources: shows the peripherals available on the device
• Available Versions:
• Composer Area
• Pin Manager - Package View
• Pin Manager - Table View

This highlight can be enabled over the MCC at any time by clicking on the information icon Info icon.

Using MCC to Select and Setup Peripherals

• Select the Peripherals

  • The Device Resources shows the peripherals available on the device.
    
    

  • By clicking on the name of the peripheral, a list of associated options including multiple versions of the peripheral will appear.
    
    There may be multiple comparators on the device so the submenu will show the list of all available options.

  • Clicking on the specific peripheral will add that peripheral to the Project Resources.
    
    

• Setup the Peripherals
  
  The **central Composer Area **is where the peripherals are set up.
  
  When the peripheral is selected in the Project Resources, the corresponding configuration GUI is displayed in the central composer area.
  
  There are three tabs: Easy Setup, Registers, and Notifications.:

  • Peripheral Setup: is where you select the settings for the peripheral through a variety of drop-down selections and checkboxes.
    
    The example shown is for the System Peripheral setup.
    
    
  • Register View: The Registers tab shows the various registers for the particular peripheral. The configuration settings can also be viewed and modified under this tab.
  • Notifications: Any conflicts or recommendations that a setup would require will show up under the Notifications tab. This may be as simple as an I/O pin being set to analog and is recommended to be set to digital for the peripheral setting selected.

Using MCC to Select I/O Pin Configuration

MCC allows you to set up the I/O pin configurations using a graphical interface in the Pin Manager.

The first step is to select the device package type to use then a representation of the device will appear.

Then click on the accompanying chart to select the arrangement.

• A blue pin is unconnected;
• A green pin is connected to a peripheral or designated as a digital I/O pin.

The menu of peripherals to connect the pin to,

can be positioned on the top (horizontal) or on the left side (vertical),

by clicking on the horizontal or vertical selection.

The pin(s) associated with the peripheral will show up in the row or column of the peripheral name.

This way it can be easily determined which pins to select for that particular peripheral.

Once the pin is selected, the color will change to green and the lock symbol will close,

indicating the pin is locked into that arrangement.

Clicking on the green lock will reset it back to a blue, unused state.

There are several other colors that will appear as described below:

• Gray-colored pin: indicates that the pin is not usable in the selected configuration,
  
  and that there is no enabled module which has any functionality on that pin.
  
  There are also grayed-out locks on a white background that indicate pins that are locked out by selected system functions.
• Blue-colored pin: indicates pins that are available to be allocated to a module.
• Green-colored pin (with a lock): this combination indicates that the pin has been allocated and selected for a module.
  
  The name that appears on the pin is either the name of the pin in the module’s context or a custom name entered.
• Green-colored pin (with chain link): this combination indicates that the pin is shared between multiple functions.
• Yellow-colored pin: indicates a possible alternate pin for an already allocated pin function.
• Grayed-out locks on a white background: indicate pins that are locked out by selected system functions.

Generating Code

MCC has a separate setup screen for each peripheral selected.

After each peripheral is set up along with the configuration and I/O,

then just click on the Generate Code button Generate button to have the MCC:

• create all the peripheral driver code for the project.
• a main.c file will also be produced if it is a new project.
• it will only produce the peripheral driver files, If the project already has a main.c.
• The generated code will be placed into the project automatically.
• The code will show up in the project area of MPLAB X IDE.
• The code produced is used as a base and modified for the project's needs.

This also makes a great way to start a new project so initially,

a set of peripheral driver code with functions for each peripheral is automatically developed.