Not everyone is familiar with Git, and not everyone wants to use it. Although I think using Git or SVN is something every software engineer today needs to master 😉 To make it easier for the ‘non-Gitter’ to use the Processor Expert components, they are available now as *.PEupd files as described here. However, the *.PEupd files are just a snapshot, and not the latest and greatest. So how to use the latest component sources and example projects without Git?
💡 How to use Git with the MCUonEclipse GitHub repository, see this wiki page.
Locating the User Working Directory
First, you need to find where Processor Expert stores the ‘user’ components. This might depend on which Processor Expert version you are using.
In CodeWarrior for MCU, the path where the components are installed is shown with the Eclipse menu Window > Preferences > Processor Expert > Component Development:
It is here too:
Because both paths cannot be selected for copy-paste, it is reported as well in the Console View at Processor Expert startup:
Make sure that you select the proper console output:
💡 I recommend to create a shortcut on the Windows desktop to that directory location.
For me Processor Expert stores the ‘user’ components in this folder:
💡 ‘user’ components are components ‘outside’ of the Processor Expert installation. Components I have created with CDE (Component Development Environment) or components you have imported.
On my machine this folder looks like this:
💡 the CWMCU_PE5_00 has a green check-mark, because on my machine I have it under (GitHub) version control.
As you can see: Processor Expert unfortunately uses different folders depending on which Processor Expert version is used :-(:
- CW_PE3_02: this is for classic CodeWarrior for S12(X) V5.1
- CWMCU_PE5_00: this one is for Eclipse base CodeWarrior for MCU 10.x
- PEXDRV_PE3_3: this one is for the Eclipse based Processor Expert Drivers Suite 10.0
- PECache: this is a folder which is used by Processor Expert for caching the components.
💡 In case of troubles with Processor Expert, sometimes it helps to delete the PECache folder. That cache folder will be re-created a Processor Expert startup time.
In my steps below I will use the CWMCU_PE5_00 folder, but things apply to the other PEx_yy folders too.
Note: To my knowledge, the Processor Expert drivers are compatible between the different versions. So if you want to use the same components across different folders as above and in sync, you need to synchronize them manually (or copy them between the folders).
Getting the Files from GitHub
This gives you an archive file with all the latest and greatest files in the repository.
Using the Processor Expert Components
❗ Close CodeWarrior/Eclipse/Processor Expert/Driver Suite first.
You need the two following folders in the archive (as they contain all the Processor Expert files):
💡 In case you already have beans/drivers or other files in this folder, then it is a good idea to make a backup of this folder, or rename it so you can go back later on. If you already have older versions of the components, then I recommend to remove/rename/delete the folder too to have a clean state.
Unzip the two folders into your Processor Expert user working directory (mine is C:\ProgramData\Processor Expert\CWMCU_PE5_00).
💡 it does not hurt if you unpack the repository into the user working directory. But if you only interested in the components, then only install the Beans and Drivers folders.
On my machine this looks like this:
Processor Expert might create the following folders:
- Config: Contains Bean Wizard ini file
- DOCs: HTML files created by the Bean Wizard?
- Templts: has user templates (I’m not using these)
💡 the “Bean Wizard” is the ‘classic’ version of CDE to create user components.
So you do not need to worry about these folders. All what you need is ‘Beans’ and ‘Drivers’.
The ‘Beans’ folder has a folder for each component describing mainly the interface and properties:
The driver code is inside the Drivers folder:
💡 See this post about a dissection of the different Processor Expert Driver files.
If you start now Eclipse/CodeWarrior, the installed components should show up in the Component Library view. If not, use the ‘Refresh’ context menu:
With this, you are ready to use the components :-).
GitHub Example Projects
All the example projects are in that GitHub Zip file:
I recommend to extract the projects you are interested in either into your workspace, or that you unzip it to a place outside of your workspace and then drag&drop the project(s) into your workspace.
If the components are properly loaded, they should show up in color (otherwise they are grayed out if missing).
It is not hard to use Processor Expert components or projects from GitHub: the repository can be downloaded as zip archive. As for the components, I need to place the Beans and Drivers folder into the right place. The projects I can use like normal Eclipse/CodeWarrior projects.
Happy Gitting 🙂