Skip to content

Getting Started

Jump to bottom
Erich Styger edited this page May 9, 2013 · 20 revisions

It is assumed that

  • You are familiar with GIT :-)
  • You have Processor Expert (e.g. with CodeWarrior for MCU, Eclipse based, http://freescale.com/cwmcu10) installed. The current version is 10.3. Things might be backward compatible, but it is recommended to use the latest and greatest one.
  • Processor Expert is enabled to create/change/edit components (CDE (Component Development Environment)

Only installing the components

Normally, Processor Expert components are exported and imported using *.PEupd files. Basically this is a kind of encrypted zip file. http://steinerberg.com/EmbeddedComponents/ contains such *.PEupd files. Because it takes an extra step (and time) to create such *.PEupd files, such files are not (yet) availble in this GitHub repository. However, it is possible to install the components from this repository without using Git. Alternatively you can use the *.PEupd files as explained in the next section.

  1. Download this repository as zip archive file
  2. Identify the Processor Expert User Working directory. This is reported in the Eclipse Console view (select Processor Expert output). For CW MCU10.3 this is C:\ProgramData\Processor Expert\CWMCU_PE5_00
  3. Exit Eclipse
  4. Copy the Drivers and Beans folder into the above directory. You might create a backup first, just in case
  5. Restart Eclipse. This should update the Processor Expert component data base. If not, use the 'Refresh' in the component view

*.PEupd Files

https://github.com/ErichStyger/mcuoneclipse/tree/master/PEupd contains the components in *.PEupd (Processor Expert Update Files). Follow the instructions in http://mcuoneclipse.com/2013/05/09/processor-expert-component-peupd-files-on-github/ for additional information.

License File

NOTE: CodeWarrior for MCU10.4 includes CDE as 'Community Edition', so the steps below are not needed for MCU10.4

In order to use CDE, you either have a professional edition license, or the free 'Community Edition'. The difference is that components created with the Community Edition shall not be used for commercial usage: this means you cannot make business with them (e.g. selling them). See the license terms in the CDE standalone installation for details.

The community edition license file is available here: http://www.freescale.com/files/soft_dev_tools/software/app_software/code_examples/CDE_MCU_License.dat?fpsp=1 (pasted for reference below).

Installing the license: Place the above lines to your license.dat located in CodeWarriorInstallationPath\MCU\license.dat:

NOTE: depending on your editor, remove the spaces/tabs at the beginning of each line, and after the backslash at the end!

    ##################################################################################################
    #   Component Development Environment (CodeWarrior - 'metrowks' vendor daemon)
    ##################################################################################################
    INCREMENT CommunityCDE metrowks 10.300 28-jul-2013 uncounted \
    0EA8C9C29F95 HOSTID=ANY ISSUER="Freescale Semiconductor" \
    ISSUED=16-nov-2011 START=1-nov-2011 TS_OK

NOTE: In case no such license.dat exists (e.g. for special edition), create a new (text) file named license.dat

How to use the repository directly with Processor Expert

Instead of exporting/importing *.PEupd files, is possible to directly work on the Processor Expert component files. For this, the 'Beans' and 'Drivers' repository folders need to be checked out into the Processor Expert 'working directory'. The working directory is shown in the console view at CodeWarrior startup, and is e.g. 'C:\ProgramData\Processor Expert\CWMCU_PE5_00'. The path and the version number might differ between different host machine operating systems, and/or different Processor Expert versions.

NOTE: As it is not possible to check out individual folders with Git, the whole Git repository gets checked out into the Processor Expert working directory.

  1. Use the 'Clone in Windows' button of the repository (within the browser window of github.com)
  2. This will ask you what local application to use (default 'GitHub' on windows)
  3. It will clone it into your local GitHub folder, into a folder named 'mcuoneclipse'
  4. Move the content of the 'mcuoneclipse' folder into C:\ProgramData\Processor Expert\CWMCU_PE5_00
  5. Remove the 'mcuoneclipse' folder
  6. The Windows GitHub Client will now show that the mcuoneclipse local repository is not found: right click on it and select 'stop tracking this repo'
  7. Drag and drop the folder C:\ProgramData\Processor Expert\CWMCU_PE5_00 into GitHub to have it listed

Below are the steps how to use the repository direcly within the Processor Expert working directory:

  1. Identify your working directory
  2. Make a backup of it (or rename it)
  3. Close Eclipse/CodeWarrior
  4. Clone the Git repository as the Processor Expert working directory:
  1. That way you should get both the 'Beans' and the 'Drivers' directory from the repository into the working directory.
  2. Restart Eclipse/CodeWarrior
  3. Now you should see the new components in the Components Library view. If not, perform a refresh in that view

Have fun :-)

Clone this wiki locally