Harmony 3 getting started
From both forum and customer feedback we feel there may be some challenges in getting started with MPLAB Harmony 3 in general. We hope all of the required information is out there, but finding it may be a challenge to some. So here are some tips to help you get started.
- There is no Harmony downloader (like there was in Harmony 2 anyway) as this is all separate repos on GitHub now. The branch point to see the architecture and various repos is in the overall Wiki.
- We have included a utility internal to the MHC / MPLAB X platform to enable clone of your chosen repos. Yes, you are using Git framework, even if you do not realize it. But you do not require any explicit knowledge or training to do this, as our tools can do it for you.
- There is a document that shows you how to do this step by step
- There are several advantages to Harmony 3 including: the ability to move between MIPS and Cortex architecture, refined PLIB architecture, stand-alone projects that do not require the framework (except to configure), customized repo clone / download, and updated user interfaces.
- We started with Cortex SAM devices, and then moved to our classic PIC32 devices. Some of these are still a work in progress. You can always check here for compatible devices (for core and CSP).
Where do you go from there:
- Most repos have a getting started with a project guide, and this can be useful for your own training. Examples include audio, USB and graphics.
- All repos also have an apps folder, which contain several or many application examples. This is a separate folder from the API or library contained within that repository
- You can check your version in the tools, but it is best to verify your download is complete. The best way to do this is by the release notes which are at the root of each repo. The release notes clearly say which version was the most recent at the top.
- Many of the repositories are now updated several times to v3.3.0 (as of this post), although any given repository may be a different version. Over time you should not expect that each repo will be the same revision. The release notes and download manager show clear dependencies on version numbers of other required repos for a given function.
- Each repo also has on-line help in addition to the downloaded CHM or PDF version. This may be faster for you, but consists of the same information. Each repo has this, such as the example for CORE.
If you have a problem:
- This forum can be a resource to you, but there is some misinformation. Not everyone is on the same installation and all versions are not the same.
- Check your installation version. We have had reports that some installations are not completing for various reasons, and this can cause your repository to not be updated like you think it is. When in doubt look for that release_notes.md. You can always create a fresh install at a new location with the download manager.
- If your problem is not answered in the forum, we encourage you to put in a support ticket. This will go to our corporate applications team, and if needed pushed to additional support including specialized development teams.