|
MPLAB C Compilers - Installing and Upgrading
MPLAB C Compiler for PIC18 MCUs
MPLAB C Compiler for PIC18 MCUs (previously MPLAB C18) requires the use of MPLINK Linker; MPLAB C18 v3.00 or later will require MPLINK Linker v4.00 or later. The latest version of MPLINK Linker is included with the installation.
To verify correct installation of MPLAB C Compiler for PIC18 MCUs, execute the batch file <install_dir>\example\an696\buildit.bat. If the compiler system has been installed correctly, the file 18motor.out will be created.
When installing MPLAB C Compiler for PIC18 MCUs, the setup program offers the user the ability to change several environment settings. The following options are provided:
Environment Variables:
- Add MPLAB C18 to PATH environment variable
The directory of the compiler executables is added to the beginning of the current PATH environment variable.
- Add MPASM Assembler to PATH environment variable
The directory of the MPASM Assembler executable is added to the beginning of the current PATH environment variable.
- Add header file path to MCC_INCLUDE environment variable
The location of the header (.h) files is added to the beginning of the user's MCC_INCLUDE environment variable. MPLAB C18 uses this setting to search for header files.
- Modify PATH and MCC_INCLUDE variables for all users
The options listed above are applied to the machine environment variables instead of the user environment variables, so that they affect all users and not just the current user. This option only appears if the user running the installer has administrative rights.
MPLAB IDE Configuration:
The options below only appear if the user has a version of MPLAB IDE installed.
- Update MPLAB IDE to use this MPLAB C18
Path locations used by the MPLAB IDE to find MPLAB C18 will be updated to indicate the location of this release.
- Update MPLAB IDE to use this MPLINK Linker, MPLIB librarian, and MPASM Assembler
Settings used by MPLAB IDE to find the MPLINK Linker, MPLIB librarian, and MPASM Assembler will be updated to point to those in this release.
- Update MPLAB IDE Help with MPLAB C18 documentation
Documentation installed with MPLAB C18 will be made available from the Help menu of the MPLAB IDE. This option only appears if documentation is being installed.
- Perform MPLAB IDE updates for all users
The changes to the MPLAB IDE configuration are applied to the machine registry instead of that of the current user, so that they affect all users and not just the current user.
This option only appears if the user running the installer has administrative rights.
If MPLAB C18 is uninstalled, these changes to the IDE configuration will not be rolled back.
If you have previously installed an Evaluation or Lite edition of MPLAB C18 and you wish to upgrade your current installation, simply purchase and install the full Standard edition - it will overwrite the other edition. So, no license key is required.
MPLAB C Compiler for PIC24 MCUs and dsPIC DSCs
If using MPLAB IDE, be sure to install MPLAB IDE v8.10 or later before installing these tools.
To install the MPLAB C Compiler for PIC24 MCUs and dsPIC DSCs (previously MPLAB C30) tools, perform the following steps:
1. Locate the setup program on the compiler CD ROM.
2. Run the setup program.
3. Follow the directions on the screen.
4. If the installation program indicates that it is necessary, reboot your computer to complete the installation.
5. When the installation is complete, verify that the executable directory has been correctly added to your PATH (i.e., if you chose to install the tools in the default directory, c:\Program Files\Microchip\MPLAB C30, then ensure that c:\Program Files\Microchip\MPLAB C30\bin has been added to your PATH). From a DOS prompt, type: c:\>PATH
To verify installation, perform the following steps:
6. At a DOS prompt, go to the examples directory (by default, it is c:\Program Files\Microchip\MPLAB C30\examples\MPLABC30_Getting_Started)
7. Type: run_hello.bat
8. If the tools are installed correctly, the output should show the various steps in the compilation and execution process ending with the text:
Hello, world!
If you have previously installed an Evaluation or Lite edition of MPLAB C30 and you wish to upgrade your current installation to the Standard edition, there is no need to re-run the installer unless you also wish to upgrade the currently installed product to the latest release. Once you have obtained a valid license key, from www.microchipdirect.com for example, simply execute the following command line:
pic30-lm –ulicensekey
If you have a compiler version older than 3.10, download one of the above free editions from our website and then follow the above procedure to upgrade.
MPLAB C Compiler for PIC32 MCUs
If using MPLAB IDE, be sure to install MPLAB IDE v8.10 or later before installing these tools.
To install the MPLAB C Compiler for PIC32 MCUs (previously MPLAB C32) tools, perform the following steps:
1. Locate the setup program on the 'MPLAB C Compiler for PIC32 MCUs' CD ROM.
2. Run the setup program.
3. Follow the directions on the screen. To install the standard evaluation edition, leave the license key field blank when prompted. To install the full standard edition, enter your full license key.
4. If the installation program indicates that it is necessary, reboot your computer to complete the installation.
5. When the installation is complete, verify that the executable directory has been correctly added to your PATH (i.e., if you chose to install the tools in the default directory, c:\Program Files\Microchip\MPLAB C32, then ensure that c:\Program Files\Microchip\MPLAB C32\bin has been added to your PATH. On some systems, the default path is c:\Program Files\Microchip\MPLAB C32 Suite.).
From a Windows command prompt (cmd.exe), type: c:\>PATH
Time-Limited Standard Evaluation Edition
Feature Limitations - Microchip provides a free time-limited Standard Evaluation edition of the MPLAB C Compiler for PIC32 MCUs. The standard evaluation edition of the compiler provides full functionality for 60 days. After the evaluation period has expired, the compiler becomes feature limited, and optimization features associated with levels -O2, -O3, and -Os are disabled. In addition, MIPS16 code generation is disabled. The compiler continues to accept the -O1 and -O0 optimization levels indefinitely.
Installing the standard evaluation edition - To install the time-limited standard evaluation edition of the compiler, run the standard evaluation-edition installer and follow the on-screen instructions. If the installer asks for a license key, leave the field blank and continue.
Upgrading to a standard-edition license - For applications requiring additional code efficiency, as well as full support via http://support.microchip.com, users are encouraged to upgrade to a full standard-edition compiler license. For further information on upgrading to a full standard-edition license (Part Number: SW006015), visit http://www.microchipdirect.com or contact your preferred Microchip distributor.
Once you've obtained a standard-edition license key, run the Upgrader tool (pic32-upgrader\upgrader.exe) as a Windows administrator. After you enter your license key and press the Upgrade button, the license manager should then report the license upgrade status.
Lite Edition
Feature Limitations - Microchip provides a free Lite edition of the MPLAB C Compiler for PIC32 MCUs intended for use in projects where code efficiency is not critical. This edition of the compiler does not support optimization features associated with levels -O2, -O3, and -Os. In addition, this edition does not support MIPS16 code generation.
Upgrading to the standard edition or standard evaluation edition - To take advantage of the advanced optimization and MIPS16 code generation features, you can upgrade to a standard edition or a 60-day standard evaluation edition. To upgrade to a full or 60-day standard evaluation edition, uninstall the lite edition using the normal Windows Add/Remove Programs feature. Next, install the standard edition or the standard evaluation edition by running the appropriate installer and following the on-screen instructions.
|
