Installing and Licensing MPLAB XC C Compilers 50002059G

Download as pdf or txt
Download as pdf or txt
You are on page 1of 24

Installing and Licensing

MPLAB XC C Compilers

2012-2015 Microchip Technology Inc.

DS50002059G

Note the following details of the code protection feature on Microchip devices:

Microchip products meet the specification contained in their particular Microchip Data Sheet.

Microchip believes that its family of products is one of the most secure families of its kind on the market today, when used in the
intended manner and under normal conditions.

There are dishonest and possibly illegal methods used to breach the code protection feature. All of these methods, to our
knowledge, require using the Microchip products in a manner outside the operating specifications contained in Microchips Data
Sheets. Most likely, the person doing so is engaged in theft of intellectual property.

Microchip is willing to work with the customer who is concerned about the integrity of their code.

Neither Microchip nor any other semiconductor manufacturer can guarantee the security of their code. Code protection does not
mean that we are guaranteeing the product as unbreakable.

Code protection is constantly evolving. We at Microchip are committed to continuously improving the code protection features of our
products. Attempts to break Microchips code protection feature may be a violation of the Digital Millennium Copyright Act. If such acts
allow unauthorized access to your software or other copyrighted work, you may have a right to sue for relief under that Act.

Information contained in this publication regarding device


applications and the like is provided only for your convenience
and may be superseded by updates. It is your responsibility to
ensure that your application meets with your specifications.
MICROCHIP MAKES NO REPRESENTATIONS OR
WARRANTIES OF ANY KIND WHETHER EXPRESS OR
IMPLIED, WRITTEN OR ORAL, STATUTORY OR
OTHERWISE, RELATED TO THE INFORMATION,
INCLUDING BUT NOT LIMITED TO ITS CONDITION,
QUALITY, PERFORMANCE, MERCHANTABILITY OR
FITNESS FOR PURPOSE. Microchip disclaims all liability
arising from this information and its use. Use of Microchip
devices in life support and/or safety applications is entirely at
the buyers risk, and the buyer agrees to defend, indemnify and
hold harmless Microchip from any and all damages, claims,
suits, or expenses resulting from such use. No licenses are
conveyed, implicitly or otherwise, under any Microchip
intellectual property rights.

Trademarks
The Microchip name and logo, the Microchip logo, dsPIC,
FlashFlex, flexPWR, JukeBlox, KEELOQ, KEELOQ logo, Kleer,
LANCheck, MediaLB, MOST, MOST logo, MPLAB,
OptoLyzer, PIC, PICSTART, PIC32 logo, RightTouch, SpyNIC,
SST, SST Logo, SuperFlash and UNI/O are registered
trademarks of Microchip Technology Incorporated in the
U.S.A. and other countries.
The Embedded Control Solutions Company and mTouch are
registered trademarks of Microchip Technology Incorporated
in the U.S.A.
Analog-for-the-Digital Age, BodyCom, chipKIT, chipKIT logo,
CodeGuard, dsPICDEM, dsPICDEM.net, ECAN, In-Circuit
Serial Programming, ICSP, Inter-Chip Connectivity, KleerNet,
KleerNet logo, MiWi, MPASM, MPF, MPLAB Certified logo,
MPLIB, MPLINK, MultiTRAK, NetDetach, Omniscient Code
Generation, PICDEM, PICDEM.net, PICkit, PICtail,
RightTouch logo, REAL ICE, SQI, Serial Quad I/O, Total
Endurance, TSHARC, USBCheck, VariSense, ViewSpan,
WiperLock, Wireless DNA, and ZENA are trademarks of
Microchip Technology Incorporated in the U.S.A. and other
countries.
SQTP is a service mark of Microchip Technology Incorporated
in the U.S.A.
Silicon Storage Technology is a registered trademark of
Microchip Technology Inc. in other countries.
GestIC is a registered trademarks of Microchip Technology
Germany II GmbH & Co. KG, a subsidiary of Microchip
Technology Inc., in other countries.
All other trademarks mentioned herein are property of their
respective companies.
2012-2015, Microchip Technology Incorporated, Printed in
the U.S.A., All Rights Reserved.
ISBN: 978-1-63276-936-7

QUALITY MANAGEMENT SYSTEM


CERTIFIED BY DNV

== ISO/TS 16949 ==
DS50002059G-page 2

Microchip received ISO/TS-16949:2009 certification for its worldwide


headquarters, design and wafer fabrication facilities in Chandler and
Tempe, Arizona; Gresham, Oregon and design centers in California
and India. The Companys quality system processes and procedures
are for its PIC MCUs and dsPIC DSCs, KEELOQ code hopping
devices, Serial EEPROMs, microperipherals, nonvolatile memory and
analog products. In addition, Microchips quality system for the design
and manufacture of development systems is ISO 9001:2000 certified.

2012-2015 Microchip Technology Inc.

XC INSTALLER &
LICENSE MANAGER
Table of Contents
Chapter 1. About the Installer and License Manager
1.1 MPLAB XC C Compilers ................................................................................... 5
1.2 XC Installer ........................................................................................................ 5

Chapter 2. Installing Your Compiler


2.1 Install a Compiler on a Local Computer ............................................................ 8
2.2 Install a Network Client ...................................................................................... 9
2.2.1 Network Server/Client Overview .................................................................. 9
2.2.2 Install a Compiler and Connect to the Network Configuration (Client) ...... 10

2.3 Installation Flow ............................................................................................... 11


2.4 Upgrading the Compiler .................................................................................. 20
2.5 Uninstalling the Compiler ................................................................................ 20

Chapter 3. Licensing Your Compiler


3.1 Purchasing a License ...................................................................................... 21
3.2 Acquiring an Evaluation License ..................................................................... 21
3.3 Activating a License ........................................................................................ 22

Index ............................................................................................................................. 23
Worldwide Sales and Service .................................................................................... 24

2012-2015 Microchip Technology Inc.

DS50002059G-page 3

XC Installer & License Manager


NOTES:

DS50002059G-page 4

2012-2015 Microchip Technology Inc.

XC INSTALLER &
LICENSE MANAGER
Chapter 1. About the Installer and License Manager
This chapter introduces the installers and license managers used in conjunction with
MPLAB XC C Compilers. The next chapter discusses how to install your MPLAB XC
C Compiler.
MPLAB XC C Compilers
XC Installer

1.1

MPLAB XC C COMPILERS
Please see the Microchip website (http://www.microchip.com/mplabxc) for more
information about available MPLAB XC C compilers and related device support. Each
compiler license gives you increased levels of code optimization.

1.2

XC INSTALLER
The GUI installer will install a compiler on your PC or network license server. After the
installation, you can license the compiler for use.

Windows 8 Customers - Troubleshooting


If you have trouble running the installer, you can try running in Windows 7 Compatibility
mode. To set this mode:
1. Right click on the installer executable.
2. In the File Properties window, click on the Compatibility tab.
3. Under Compatibility mode, check the Run the program in compatibility mode
for box and select Windows 7.

2012-2015 Microchip Technology Inc.

DS50002059G-page 5

XC Installer & License Manager


NOTES:

DS50002059G-page 6

2012-2015 Microchip Technology Inc.

XC INSTALLER &
LICENSE MANAGER
Chapter 2. Installing Your Compiler
When you install an MPLAB XC C compiler, you are installing an unlicensed compiler.
This means that you are running under a FREE license and you have access to the
minimum amount of code optimization and support. For greater optimization and support, jump to the licensing sites that are listed near the end of the installation. Acquire
a regular or evaluation license, and activate the license.
The following topics describe compiler installation procedures:
Install a Compiler on a Local Computer
Install a Network Client
- Network Server/Client Overview
- Install a Compiler and Connect to the Network Configuration (Client)
Installation Flow
Upgrading the Compiler
Uninstalling the Compiler

2012-2015 Microchip Technology Inc.

DS50002059G-page 7

XC Installer & License Manager


2.1

INSTALL A COMPILER ON A LOCAL COMPUTER


The following instructions will guide you through the installation of a compiler for a
single user.
When the compiler is installed, you can proceed to get a license. The license can be
used for compiler installations on up to three (3) workstations.

Welcome and License Agreement


From the Welcome screen, click Next to continue.
Read the license agreement and accept the agreement to proceed. When you accept,
Next becomes available. Click it to continue.

Installation Type
Do not select anything. Click Next to continue.
FIGURE 2-1:

INSTALLATION TYPE SCREEN

Continue Installation
To continue installing an MPLAB XC C Compiler, go to the Installation Directory screen
under Section 2.3 Installation Flow.

DS50002059G-page 8

2012-2015 Microchip Technology Inc.

Installing Your Compiler


2.2

INSTALL A NETWORK CLIENT


The installation of a network client is covered in this document. For details on installing
a network server, see the MPLAB XC Network License Server document.

2.2.1

Network Server/Client Overview

You may use a computer network to set up a license server and client(s). To do this,
use one computer to host the license server and license files. Then, other network
computers can contain compilers and license managers that are configured to acquire
licenses from the license server.
To install the license server, install the network license and start the server, see the
MPLAB XC Network License Server document.
To install a license client, follow the steps in the next section. This installation process
will ask for details about the network license server. The operating system for the client
does not have be the same one used for the server, but it must be supported.
Once configured, compiler executions on the network license client will connect to the
network license server to check out a license. This license will be available for immediate use. However, when the compiler is exited, there is a 60-minute delay before that
server license can be used by other clients.
FIGURE 2-2:

NETWORK LICENSE CLIENT/SERVER MODEL


License Server (One license installation)

Any Compiler-Supported OS

License Client

License Client

Any Compiler-Supported OS

Any Compiler-Supported OS

2012-2015 Microchip Technology Inc.

DS50002059G-page 9

XC Installer & License Manager


2.2.2

Install a Compiler and Connect to the Network Configuration


(Client)

When the compiler runs on the network license client, the license manager will check
out licenses from the network license server. This section summarizes how the network
client compiler is installed.

Welcome and License Agreement


From the Welcome screen, click Next to continue.
Read the license agreement and accept the agreement to proceed. When you accept,
Next becomes available. Click it to continue.

Installation Type
Choose Configure MPLAB XC C Compiler as a network client.
Enter information about the network license server here. This information should be
provided by your local network administrator.
Server Name refers to the IP address or host name of the network license server
where licenses are hosted.
Port Number is the port that the network server will use to distribute licenses. A default
port of 5053 is already filled in. The network license server will always run on this port,
unless otherwise specified.
Click Next to continue.
FIGURE 2-3:

DS50002059G-page 10

INSTALLATION TYPE SCREEN

2012-2015 Microchip Technology Inc.

Installing Your Compiler


Continue Installation
To continue installing a network client from a network license server, go to the
Installation Directory screen under Section 2.3 Installation Flow.

2.3

INSTALLATION FLOW
The basic flow of compiler installation is described below. Specific installs are
referenced to other sections.

Welcome
Launch the compiler installation executable. An MPLAB Certified splash screen will
appear and then disappear. Then, the Welcome screen will appear. Click Next to
continue.
FIGURE 2-4:

2012-2015 Microchip Technology Inc.

WELCOME SCREEN

DS50002059G-page 11

XC Installer & License Manager


License Agreement
Read the license agreement, and accept the agreement, to proceed. When you accept,
Next becomes available. Click it to continue.
If you do not agree, the installation terminates.
FIGURE 2-5:

DS50002059G-page 12

LICENSE AGREEMENT SCREEN

2012-2015 Microchip Technology Inc.

Installing Your Compiler


Detailed Install Screens
The next screens will dictate how your compiler is installed.
The most common install is:
Section 2.1 Install a Compiler on a Local Computer
For information about installing on a network, read:
Section 2.2.1 Network Server/Client Overview
Return to the specified section in this flow when you have finished.

2012-2015 Microchip Technology Inc.

DS50002059G-page 13

XC Installer & License Manager


Installation Directory
Enter or browse to a location to install your compiler. It is recommended that you use
the default location displayed in the dialog. Click Next to continue.
FIGURE 2-6:

DS50002059G-page 14

INSTALLATION DIRECTORY SCREEN

2012-2015 Microchip Technology Inc.

Installing Your Compiler


Compiler Settings
You now have the opportunity to select compiler settings. Check any options you need.
In general, if this is the first time you are installing this compiler on your machine, you
should let the installer modify any path or environmental variables to ensure correct
compiler operation.
Click Next to continue.
FIGURE 2-7:

2012-2015 Microchip Technology Inc.

COMPILER SETTINGS SCREEN

DS50002059G-page 15

XC Installer & License Manager


Ready to Install and Installing
You are now set up to install the compiler. This is your chance to make changes to the
compiler settings by using the Back button. If you are ready to install, click Next to continue.
The next dialog shows the progress of the install. When it is complete, click Next to
continue.
FIGURE 2-8:

DS50002059G-page 16

READY TO INSTALL SCREEN

2012-2015 Microchip Technology Inc.

Installing Your Compiler


FIGURE 2-9:

2012-2015 Microchip Technology Inc.

INSTALLING SCREEN

DS50002059G-page 17

XC Installer & License Manager


Licensing Information
A free edition of the compiler (fully functional with minimum optimizations) has now
been installed. If you want more code optimizations, you need to license your compiler.
You may click one of the links on this screen to:
Purchase a license
Get a 60-day-evaluation license of the PRO edition compiler
Activate a license
For more on licensing, see Chapter 3. Licensing Your Compiler.
Click Next to continue.
FIGURE 2-10:

DS50002059G-page 18

LICENSING INFORMATION SCREEN

2012-2015 Microchip Technology Inc.

Installing Your Compiler


Completing Setup
The compiler has now been installed. Click Finish to complete the install.
If you wish to make changes, you can run the installer again and update your install.
FIGURE 2-11:

2012-2015 Microchip Technology Inc.

COMPLETING SETUP SCREEN

DS50002059G-page 19

XC Installer & License Manager


2.4

UPGRADING THE COMPILER


To upgrade your compiler, simply install the new compiler as you installed the previous
one, but skip over the Installation Complete - Licensing Information screen by clicking
Next. Since you already have a license, there is no need to activate or obtain a new
license.

2.5

UNINSTALLING THE COMPILER


To uninstall the compiler, follow the instructions below.

Launch Uninstaller
Go to the compiler installation directory and launch Uninstall MPLAB XC C Compiler.
You are asked if you want to uninstall. Click Yes.

Uninstalling
The uninstaller removes all the compiler-related files from your system.

Uninstall Complete
When the uninstall is done, it displays an Uninstallation Complete message. Click OK
to finish.
Note:

DS50002059G-page 20

The uninstaller does not remove directory structure or path references.

2012-2015 Microchip Technology Inc.

XC INSTALLER &
LICENSE MANAGER
Chapter 3. Licensing Your Compiler
Once you have installed your compiler, you will be presented with the following
licensing options:
Purchasing a License
Acquiring an Evaluation License
Activating a License
If you already have a license file (i.e., you have purchased a license from
microchipDIRECT), there is no need to activate this file, and you are done.
If you do not have a license file, please continue.

3.1

PURCHASING A LICENSE
To license your installed compiler, click on the link Click here if you would like to purchase a license on the installer Licensing Information screen. The link will direct you
to a microchipDIRECT web page where you can select a compiler license to purchase.
If the link in the installation program does not work, copy the following URL into a browser:
http://www.microchipdirect.com/searchparts.aspx?q=mplab%20xc%20compiler&next=0&resperpage=10&filter=Tools%20and%20Software
The types of licenses available are:
Workstation License: This license may be installed on 3 machines for a single user.
Network Server License: The license must be installed on a License Server and can
be shared with any number of users. A Network Server License can only be used by
one user at a time, and that user has exclusive use of the license for 60 minutes.
For details on available types and configurations of MPLAB XC C compilers, see:
http://www.microchip.com/mplabxc/

3.2

ACQUIRING AN EVALUATION LICENSE


To acquire a license for a 60-day evaluation of the maximum optimizations and support,
click on the link If you would like to get a 60-day-evaluation license, please click here
on the installer Licensing Information screen. The link will direct you to a web page
where you can acquire a 60-day PRO license.
http://www.microchip.com/xcdemo/GetDemoLicense.aspx

2012-2015 Microchip Technology Inc.

DS50002059G-page 21

XC Installer & License Manager


3.3

ACTIVATING A LICENSE
If you already have an Activation Code, click on the link If you have an Activation Code,
please click here to activate a license on the installer Licensing Information screen.
The link will direct you to a web page where you can manually activate your license.
http://www.microchip.com/xcdemo/GetXCLicense.aspx
On the web page:
1. You will need your host ID (on the Setup Installation Complete dialog) and your
XC Activation key. Enter this information where specified.
2. You may select to either download your license or have it emailed. Choose one
of these options and then click Get XC License.
To finish license installation:
1. The license information (that you have downloaded or have received via email)
is in the form of a Zip file. In either case, unzip the contents to a temporary
location.
2. Once unzipped, there are three install script windows: windows.bat, linux.sh, and
mac.sh. Run the script that is appropriate for your operating system in a Command window (for a Windows operating system) or a Terminal window (for a Mac
OS X or Linux) to install the file.
3. Your compiler license should be installed.

DS50002059G-page 22

2012-2015 Microchip Technology Inc.

XC INSTALLER &
LICENSE MANAGER
Index
A
Activating a License ................................................. 22

C
Compiler Installation on a Local Computer ................ 8
Compiler Settings..................................................... 15

E
Evaluation License, Acquiring .................................. 21

H
Host Address ........................................................... 10

I
Installing Your Compiler ............................................. 7
IP Address ............................................................... 10

L
Licensing Your Compiler .......................................... 21

M
MCC_INCLUDE ....................................................... 15

N
Network Client Compiler Installation ........................ 10

P
PATH ....................................................................... 15
Port Number............................................................. 10
Purchasing a License............................................... 21

R
Readme Files ........................................................... 19

S
Server Name ............................................................ 10

U
Uninstalling the Compiler ......................................... 20
Upgrading the Compiler ........................................... 20

2012-2015 Microchip Technology Inc.

DS50002059G-page 23

Worldwide Sales and Service


AMERICAS

ASIA/PACIFIC

ASIA/PACIFIC

EUROPE

Corporate Office
2355 West Chandler Blvd.
Chandler, AZ 85224-6199
Tel: 480-792-7200
Fax: 480-792-7277
Technical Support:
http://www.microchip.com/
support
Web Address:
www.microchip.com

Asia Pacific Office


Suites 3707-14, 37th Floor
Tower 6, The Gateway
Harbour City, Kowloon
Hong Kong
Tel: 852-2943-5100
Fax: 852-2401-3431

India - Bangalore
Tel: 91-80-3090-4444
Fax: 91-80-3090-4123

Austria - Wels
Tel: 43-7242-2244-39
Fax: 43-7242-2244-393
Denmark - Copenhagen
Tel: 45-4450-2828
Fax: 45-4485-2829

Australia - Sydney
Tel: 61-2-9868-6733
Fax: 61-2-9868-6755

Atlanta
Duluth, GA
Tel: 678-957-9614
Fax: 678-957-1455

China - Beijing
Tel: 86-10-8569-7000
Fax: 86-10-8528-2104

Austin, TX
Tel: 512-257-3370

China - Chengdu
Tel: 86-28-8665-5511
Fax: 86-28-8665-7889

Boston
Westborough, MA
Tel: 774-760-0087
Fax: 774-760-0088
Chicago
Itasca, IL
Tel: 630-285-0071
Fax: 630-285-0075
Cleveland
Independence, OH
Tel: 216-447-0464
Fax: 216-447-0643
Dallas
Addison, TX
Tel: 972-818-7423
Fax: 972-818-2924
Detroit
Novi, MI
Tel: 248-848-4000
Houston, TX
Tel: 281-894-5983
Indianapolis
Noblesville, IN
Tel: 317-773-8323
Fax: 317-773-5453
Los Angeles
Mission Viejo, CA
Tel: 949-462-9523
Fax: 949-462-9608
New York, NY
Tel: 631-435-6000
San Jose, CA
Tel: 408-735-9110
Canada - Toronto
Tel: 905-673-0699
Fax: 905-673-6509

DS50002059G-page 24

China - Chongqing
Tel: 86-23-8980-9588
Fax: 86-23-8980-9500
China - Hangzhou
Tel: 86-571-8792-8115
Fax: 86-571-8792-8116
China - Hong Kong SAR
Tel: 852-2943-5100
Fax: 852-2401-3431
China - Nanjing
Tel: 86-25-8473-2460
Fax: 86-25-8473-2470
China - Qingdao
Tel: 86-532-8502-7355
Fax: 86-532-8502-7205
China - Shanghai
Tel: 86-21-5407-5533
Fax: 86-21-5407-5066
China - Shenyang
Tel: 86-24-2334-2829
Fax: 86-24-2334-2393
China - Shenzhen
Tel: 86-755-8864-2200
Fax: 86-755-8203-1760
China - Wuhan
Tel: 86-27-5980-5300
Fax: 86-27-5980-5118
China - Xian
Tel: 86-29-8833-7252
Fax: 86-29-8833-7256

India - New Delhi


Tel: 91-11-4160-8631
Fax: 91-11-4160-8632

France - Paris
Tel: 33-1-69-53-63-20
Fax: 33-1-69-30-90-79

India - Pune
Tel: 91-20-3019-1500
Japan - Osaka
Tel: 81-6-6152-7160
Fax: 81-6-6152-9310

Germany - Dusseldorf
Tel: 49-2129-3766400
Germany - Munich
Tel: 49-89-627-144-0
Fax: 49-89-627-144-44

Japan - Tokyo
Tel: 81-3-6880- 3770
Fax: 81-3-6880-3771

Germany - Pforzheim
Tel: 49-7231-424750

Korea - Daegu
Tel: 82-53-744-4301
Fax: 82-53-744-4302

Italy - Milan
Tel: 39-0331-742611
Fax: 39-0331-466781

Korea - Seoul
Tel: 82-2-554-7200
Fax: 82-2-558-5932 or
82-2-558-5934

Italy - Venice
Tel: 39-049-7625286

Malaysia - Kuala Lumpur


Tel: 60-3-6201-9857
Fax: 60-3-6201-9859

Netherlands - Drunen
Tel: 31-416-690399
Fax: 31-416-690340

Malaysia - Penang
Tel: 60-4-227-8870
Fax: 60-4-227-4068

Poland - Warsaw
Tel: 48-22-3325737

Philippines - Manila
Tel: 63-2-634-9065
Fax: 63-2-634-9069
Singapore
Tel: 65-6334-8870
Fax: 65-6334-8850
Taiwan - Hsin Chu
Tel: 886-3-5778-366
Fax: 886-3-5770-955

Spain - Madrid
Tel: 34-91-708-08-90
Fax: 34-91-708-08-91
Sweden - Stockholm
Tel: 46-8-5090-4654
UK - Wokingham
Tel: 44-118-921-5800
Fax: 44-118-921-5820

Taiwan - Kaohsiung
Tel: 886-7-213-7830
Taiwan - Taipei
Tel: 886-2-2508-8600
Fax: 886-2-2508-0102
Thailand - Bangkok
Tel: 66-2-694-1351
Fax: 66-2-694-1350

China - Xiamen
Tel: 86-592-2388138
Fax: 86-592-2388130
China - Zhuhai
Tel: 86-756-3210040
Fax: 86-756-3210049

03/25/14

2012-2015 Microchip Technology Inc.

You might also like