Release Notes For MPLAB Code Configurator V4.0

Oct 5th, 2020MPLAB Code Configuratorv4.0.2Release Notes for MPLAB Code Configurator v4.0.21Core versions bundled with this MCC releaseCore v5.0.22What is MPLAB Code Configurator (MCC)The MPLAB Code Configurator generates seamless, easy to understand code that is inserted into yourproject. It enables, configures and utilizes a rich set of peripherals and libraries across select devices. Itis integrated into MPLAB X IDE to provide a very powerful and extremely easy to use developmentplatform.3System Requirements 4MPLAB X IDE v5.35 or laterDocumentation SupportThe MPLAB Code Configurator v4 User’s Guide may be found on the MPLAB Code Configurator pageon the Microchip web site. http://www.microchip.com/mcc5Installing MPLAB Code ConfiguratorBasic steps for installing MPLAB Code Configurator v4 Plugin are given here.To install the MPLAB Code Configurator v4 Plugin through the MPLAB X IDE:1. In the MPLAB X IDE, select Plugins from the Tools menu2. Select the Available Plugins tab3. Check the box for the MPLAB Code Configurator v4, and click on InstallTo install the MPLAB Code Configurator v4 Plugin manually:(If installing on a computer that has internet access, you can skip steps 3 through 5)1. Download the zip file from the Microchip website, www.microchip.com/mcc, and extract the file.2. Open MPLAB X IDE.3. Go to Tools - Plugins - Settings. Click on add button.4. Provide a name for the new Update Center, and the file URL. This URL should point to theupdates.xml in the folder where you extracted the zip file. For example the URL may look like thisfile:/path to extracted mcc/updates.xml. When finished, click OK.1

Oct 5th, 2020MPLAB Code Configuratorv4.0.25. Uncheck the Microchip Plugins in the Update Center.6. Go to Tools - Plugins - Downloaded and click on the Add Plugins. button.7. Navigate to the folder where you extracted the zip file and select the MCC plugin file, commicrochip-mcc.nbm.8. Click on the Install button. MPLAB X IDE will ask to be restarted. Upon restart, the pluginis installed.9. If you unchecked the Microchip Plugins in the Update Center, go back and recheck theselection.6What’s New6.1Backwards-noncompatible Core ChangesThe latest MCC release has incremented its major version to v4.0.0, due to the non-backwardscompatible changes made in its Core. The purpose of the change is to better support future librarydevelopment and should have minimal effect in user’s experience. As a result of the upgrade to Corev5.0.0, users will only be able to use libraries that are compatible with it. The previous versions of thelibraries will not be compatible with Core v5.0.0, but can still be loaded by earlier Core versions (v4.x.x).Existing MCC projects will be opened with the Core version that they were configured with. Users canthen switch to the latest Core (v5.0.0), and will be prompted to load the new compatible libraries instead.To perform the Core switch, simply go to the Versions tab at the bottom left corner, expand the MPLAB Code Configurator (Plugin) v4 option, and double click on the core version you would like to use(see figure below).2

Oct 5th, 2020MPLAB Code Configuratorv4.0.2Green check markindicates currentlyused Core versionDouble click on theCore version thathas a grey icon toswitch6.2Group Layout Re-ordering in the Project Resources WindowThe Project Resources window now demonstrates an improved visualization of project layers. The newordering of the layers is presented in the order below (From top to bottom): itional Custom Buttons for Specific Libraries in the Resources AreaSome libraries will display an additional ‘Group Help’ button () on the left-hand side of its library’sgroup name in the Project Resources/Device Resources windows. Additional custom buttons may alsobe provided by certain libraries for their modules. The corresponding behaviors of each custom buttonswill be described in the library’s release notes.3

Oct 5th, 2020MPLAB Code Configuratorv4.0.2Group Help Buttonfor LibraryCustom Button7Repairs and EnhancementsThis section lists the repairs and enhancements for the plugin and core. For library specific issues, pleaselook at the individual library release 5MCCV3XX-10053DescriptionNew project in MCC will create the config file but not save the contentsKnown IssuesThis section lists the known issues for the plugin, for library specific issues please look at the individuallibrary release notes.8.1#WorkaroundsIDDescriptionMCC Interrupt Syntax Compatibility with XC8 v2.00.1.4MCCV3XX-8013Workaround: If you are using MPLAB XC8 v2.00 to compile an MCC projectand there are errors generated regarding interrupt syntax, please add thecommand line argument -std c90. If you’re using the MPLABX IDE: right-clickon your project and open your project properties, go to your active projectconfiguration and from the XC8 Global options select the C Standard C90option.

Oct 5th, 2020#MPLAB Code ConfiguratorIDv4.0.2DescriptionMCC hanging on Mac OS X.There is a compatibility issue between MCC and some of theapplications which make use of the Mac OS X Accessibilityinterface (i.e. HyperDock, Magnet). Depending on the hardwareconfiguration and the suite of Accessibility-using applications running ata given time, users might experience a hanging behavior either whenstarting or using MCC.2.MCCV3XX-8423Workaround: The easiest way would be to stop all apps which makeuse of the Apple Accessibility interface before starting MCC. If this isnot an option, you may want to start closing Accessibility-basedapplications one by one. Not all of these apps cause MCC to hang, soidentifying which applications in particular cause the behavior wouldhelp keeping the rest of them running along with MCC.How to disable an Accessibility-based application: Using the Applemenu, go to System Preferences - Security & Privacy - Accessibilityand un-check the application you want to disable. See -4354Multiple MPLAB X configurations are not supported2.MCCV3XX-2621Multiple initialization functions (with custom names) for a peripheral notsupported in MCC v3.xx3.MCCV3XX-8949MCCV3XX-8799MCC UIs squashed on high resolution displays (i.e. 4K)Frequently Asked QuestionsFor frequently asked questions, please refer to the FAQ post on the MCC Forum.5

Oct 5th, 2020MPLAB Code Configuratorv4.0.210 Supported FamiliesFor the list of supported families, refer to the release notes of respective libraries.This version of MCC is distributed with the core versions specified in the table shown in Chapter 1 of thisdocument. The following libraries are also distributed with core compatibility as shown in the table 8-bit AVR MCUsv2.4.0PIC24/dsPIC33/PIC32MMv1.169.2USB Framework ditional and archived libraries can be found at: http://www.microchip.com/mcc.11 Customer Support11.1 MCC SupportFor any MCC-related issue or inquiry please write to MCC Support@microchip.com.11.2 The Microchip Web SiteMicrochip provides online support via our web site at http://www.microchip.com. This web site is used asa means to make files and information easily available to customers. Accessible by using your favoriteInternet browser, the web site contains the following information: Product Support – Data sheets and errata, application notes and sample programs, designresources, user’s guides and hardware support documents, latest software releases and archivedsoftwareGeneral Technical Support – Frequently Asked Questions (FAQs), technical support requests,online discussion groups/forums (http://forum.microchip.com), Microchip consultant program memberlistingBusiness of Microchip – Product selector and ordering guides, latest Microchip press releases,listing of seminars and events, listings of Microchip sales offices, distributors and factoryrepresentatives 6

Oct 5th, 2020MPLAB Code Configuratorv4.0.211.3 Additional SupportUsers of Microchip products can receive assistance through several channels: Distributor or RepresentativeLocal Sales OfficeField Application Engineering (FAE)Technical SupportCustomers should contact their distributor, representative or field application engineer (FAE) for support.Local sales offices are also available to help customers. A listing of sales offices and locations is availableon our web site.Generic technical support is available through the web site at: http://support.microchip.com.12 Appendix: Supported DevicesFor the list of supported devices, please refer to the release notes of respective libraries.7

MCC hanging on Mac OS X. There is a compatibility issue between MCC and some of the applications which make use of the Mac OS X Accessibility interface (i.e. HyperDock, Magnet). Depending on the hardware configuration and the suite of Accessibility-using applications running at a given ti