SW006011

SW006011 Datasheet

Part	Datasheet
SW006011	SW006011 (pdf)

PDF Datasheet Preview
C18 C COMPILER GETTING STARTED 2002 Microchip Technology Inc. DS51295A Note the following details of the code protection feature on MCUs. • The PICmicro family meets the specifications contained in the Microchip Data Sheet. • Microchip believes that its family of PICmicro microcontrollers is one of the most secure products 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 knowl- edge, require using the PICmicro microcontroller in a manner outside the operating specifications contained in the data sheet. The person doing so may be 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 product. If you have any further questions about this matter, please contact the local sales office nearest to you. Information contained in this publication regarding device applications and the like is intended through suggestion only and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. No representation or warranty is given and no liability is assumed by Microchip Technology Incorporated with respect to the accuracy or use of such information, or infringement of patents or other intellectual property rights arising from such use or otherwise. Use of Microchip’s products as critical components in life support systems is not authorized except with express written approval by Microchip. No licenses are conveyed, implicitly or otherwise, under any intellectual property rights. Trademarks The Microchip name and logo, the Microchip logo, KEELOQ, MPLAB, PIC, PICmicro, PICSTART and PRO MATE are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. AMPLAB, FilterLab, microID, MXDEV, MXLAB, PICMASTER, SEEVAL and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the U.S.A. dsPIC, dsPICDEM.net, ECONOMONITOR, FanSense, FlexROM, fuzzyLAB, In-Circuit Serial Programming, ICSP, ICEPIC, microPort, Migratable Memory, MPASM, MPLIB, MPLINK, MPSIM, PICC, PICDEM, PICDEM.net, rfPIC, Select Mode and Total Endurance are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries. Serialized Quick Turn Programming SQTP is a service mark of Microchip Technology Incorporated in the U.S.A. All other trademarks mentioned herein are property of their respective companies. 2002, Microchip Technology Incorporated. Printed in the U.S.A., All Rights Reserved. Printed on recycled paper. DS51295A - page ii Microchip received QS-9000 quality system certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona in July 1999 and Mountain View, California in March The Company’s quality system processes and procedures are QS-9000 compliant for its 8-bit MCUs, code hopping devices, Serial EEPROMs, microperipherals, non-volatile memory and analog products. In addition, Microchip’s quality system for the design and manufacture of development systems is ISO 9001 certified. 2002 Microchip Technology Inc. C18 C COMPILER GETTING STARTED Table of Contents Preface Chapter Overview Introduction 7 Highlights 7 System Requirements 7 Quick Directory Tour 8 About the Language Tools 9 Chapter Installation Introduction 11 Highlights 11 Installing MPLAB C18 11 Uninstalling MPLAB C18 17 Chapter Examples of Use Introduction 19 Highlights 19 Example 1 20 Example 2 37 Example 3 40 Example 4 43 Glossary Index Worldwide Sales and Service 2002 Microchip Technology Inc. DS51295A-page iii C18 C Compiler Getting Started DS51295A-page iv 2002 Microchip Technology Inc. C18 C COMPILER GETTING STARTED INTRODUCTION The purpose of this document is to help you get up and running with Microchip’s MPLAB C18 C compiler. HIGHLIGHTS Items discussed in this chapter are: endianness The ordering of bytes in a multi-byte object. error file A file containing the diagnostics generated by the MPLAB C18 fatal error An error that will halt compilation immediately. No further messages will be produced. frame pointer A pointer that references the location on the stack that separates the stack-based arguments from the stack-based local variables. free-standing An implementation that accepts any strictly conforming program that does not use complex types and in which the use of the features specified in the library clause ANSI ‘89 standard clause 7 is confined to the contents of the standard headers <float.h>, <iso646.h>, <limits.h>, <stdarg.h>, <stdbool.h>, <stddef.h> and <stdint.h>. hexadecimal The base 16 numbering system that uses the digits 0-9 plus the letters A-F or a-f . The digits A-F represent decimal values of 10 to The right-most digit counts ones, the next counts multiples of 16, then 162 = 256, etc. high-level language A language for writing programs that is further removed from the processor than assembly. ICD In-Circuit Debugger ICE In-Circuit Emulator IDE Integrated Development Environment 2002 Microchip Technology Inc. Installation IEEE Institute of Electrical and Electronics Engineers interrupt A signal to the CPU that suspends the execution of a running application and transfers control to an ISR so that the event may be processed. Upon completion of the ISR, normal execution of the application resumes. interrupt service routine A function that handles an interrupt. ISO International Organization for Standardization ISR Interrupt Service Routine latency The time between when an event occurs and the response to it. librarian A program that creates and manipulates libraries. library A collection of relocatable object modules. linker A program that combines object files and libraries to create executable code. little endian Within a given object, the least significant byte is stored at lower addresses. memory model A description that specifies the size of pointers that point to program memory. microcontroller A highly integrated chip that contains a CPU, RAM, some form of ROM, I/O ports and timers. MPASM assembler Microchip Technology's relocatable macro assembler for PICmicro microcontroller families. MPLIB object librarian Microchip Technology's librarian for PICmicro microcontroller families. MPLINK object linker Microchip Technology's linker for PICmicro microcontroller families. 2002 Microchip Technology Inc. C18 C Compiler Getting Started object file A file containing object code. It may be immediately executable or it may require linking with other object code files, e.g. libraries, to produce a complete executable program. object code The machine code generated by an assembler or compiler. octal The base 8 number system that only uses the digits The right-most digit counts ones, the next digit counts multiples of 8, then 82 = 64, etc. pragma A directive that has meaning to a specific compiler. RAM Random Access Memory random access memory A memory device in which information can be accessed in any order. read only memory hardware that allows fast access to permanently stored data but prevents addition to or modification of the data. ROM Read Only Memory recursive Self-referential e.g., a function that calls itself . See recursive. reentrant A function that may have multiple, simultaneously active instances. This may happen due to either direct or indirect recursion or through execution during interrupt processing. relocatable An object whose address has not been assigned to a fixed memory location. runtime model Set of assumptions under which the compiler operates. section A portion of an application located at a specific address of memory. section attribute A characteristic ascribed to a section e.g., an access section . 2002 Microchip Technology Inc. Installation special function register Registers that control I/O processor functions, I/O status, timers, or other modes or peripherals. storage class Determines the lifetime of the memory associated with the identified object. storage qualifier Indicates special properties of the objects being declared e.g., const . vector The memory locations that an application will jump to when either a reset or interrupt occurs. 2002 Microchip Technology Inc. C18 C Compiler Getting Started 2002 Microchip Technology Inc. C18 C COMPILER GETTING STARTED Index A Access RAM 1, 19, 40 Add Files to Project 26 B Breakpoint 29, 31, 36 Build Options 25 Build Project 28 C COD 9 COFF 9 Customer Support 4 D Directory 13 Directory Contents 8 Documentation 14 Conventions 2 Layout 1 Numbering Conventions 2 Updates 2 E Examples 8, 14, 20, 37, 40, 43 H HEX 9 I Installing MPLAB C18 11 interrupt service routine 1, 19, 43, 47 L Language Tools 9, 22 Libraries 3, 8, 14 Linker Scripts 8, 14, 27, 33 Listing Files 32 little endian 47 M Map Files 32 MCC_INCLUDE 15 Memory Model 41 MPLAB C18 C Compiler Libraries 3 MPLAB C18 C Compiler User’s Guide 3 MPLAB ICD 2 32 MPLAB SIM Simulator 29 N New Project 20 P Paths 24 Product Support 5 Project Paths 24 Project Settings 22 Project Tree 21 R README File 3, 12 References 3 S Select Device 21 Select Language Toolsuit 22 Set Tool Locations 22 Support Customer 4 Product 5 System Requirements 7 T Troubleshooting 3 U Uninstalling MPLAB C18 17 User’s Guide 3

PDF Datasheet Preview

C18 C COMPILER GETTING STARTED
2002 Microchip Technology Inc.

DS51295A

Note the following details of the code protection feature on MCUs.
• The PICmicro family meets the specifications contained in the Microchip Data Sheet.
• Microchip believes that its family of PICmicro microcontrollers is one of the most secure products 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 knowl-
edge, require using the PICmicro microcontroller in a manner outside the operating specifications contained in the data sheet. The person doing so may be 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 product.

If you have any further questions about this matter, please contact the local sales office nearest to you.

Information contained in this publication regarding device applications and the like is intended through suggestion only and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. No representation or warranty is given and no liability is assumed by Microchip Technology Incorporated with respect to the accuracy or use of such information, or infringement of patents or other intellectual property rights arising from such use or otherwise. Use of Microchip’s products as critical components in life support systems is not authorized except with express written approval by Microchip. No licenses are conveyed, implicitly or otherwise, under any intellectual property rights.

Trademarks

The Microchip name and logo, the Microchip logo, KEELOQ, MPLAB, PIC, PICmicro, PICSTART and PRO MATE are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

AMPLAB, FilterLab, microID, MXDEV, MXLAB, PICMASTER, SEEVAL and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the U.S.A.
dsPIC, dsPICDEM.net, ECONOMONITOR, FanSense, FlexROM, fuzzyLAB, In-Circuit Serial Programming, ICSP, ICEPIC, microPort, Migratable Memory, MPASM, MPLIB, MPLINK, MPSIM, PICC, PICDEM, PICDEM.net, rfPIC, Select Mode and Total Endurance are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

Serialized Quick Turn Programming SQTP is a service mark of Microchip Technology Incorporated in the U.S.A.

All other trademarks mentioned herein are property of their respective companies.
2002, Microchip Technology Incorporated. Printed in the U.S.A., All Rights Reserved.

Printed on recycled paper.

DS51295A - page ii

Microchip received QS-9000 quality system certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona in July 1999 and Mountain View, California in March The Company’s quality system processes and procedures are QS-9000 compliant for its 8-bit MCUs, code hopping devices, Serial EEPROMs, microperipherals, non-volatile memory and analog products. In addition, Microchip’s quality system for the design and manufacture of development systems is ISO 9001 certified.
2002 Microchip Technology Inc.

C18 C COMPILER GETTING STARTED

Table of Contents

Preface Chapter Overview

Introduction 7 Highlights 7 System Requirements 7 Quick Directory Tour 8 About the Language Tools 9

Chapter Installation

Introduction 11 Highlights 11 Installing MPLAB C18 11 Uninstalling MPLAB C18 17

Chapter Examples of Use

Introduction 19 Highlights 19 Example 1 20 Example 2 37 Example 3 40 Example 4 43

Glossary

Index

Worldwide Sales and Service
2002 Microchip Technology Inc.

DS51295A-page iii

C18 C Compiler Getting Started

DS51295A-page iv
2002 Microchip Technology Inc.

C18 C COMPILER GETTING STARTED

INTRODUCTION

The purpose of this document is to help you get up and running with Microchip’s MPLAB C18 C compiler.

HIGHLIGHTS

Items discussed in this chapter are:
endianness The ordering of bytes in a multi-byte object. error file A file containing the diagnostics generated by the MPLAB C18
fatal error An error that will halt compilation immediately. No further messages will be produced. frame pointer A pointer that references the location on the stack that separates the stack-based arguments from the stack-based local variables. free-standing An implementation that accepts any strictly conforming program that does not use complex types and in which the use of the features specified in the library clause ANSI ‘89 standard clause 7 is confined to the contents of the standard headers <float.h>, <iso646.h>, <limits.h>, <stdarg.h>, <stdbool.h>, <stddef.h> and <stdint.h>.
hexadecimal The base 16 numbering system that uses the digits 0-9 plus the letters A-F or a-f . The digits A-F represent decimal values of 10 to The right-most digit counts ones, the next counts multiples of 16, then 162 = 256, etc. high-level language A language for writing programs that is further removed from the processor than assembly.

ICD In-Circuit Debugger ICE In-Circuit Emulator IDE Integrated Development Environment
2002 Microchip Technology Inc.

Installation

IEEE Institute of Electrical and Electronics Engineers interrupt A signal to the CPU that suspends the execution of a running application and transfers control to an ISR so that the event may be processed. Upon completion of the ISR, normal execution of the application resumes. interrupt service routine A function that handles an interrupt. ISO International Organization for Standardization ISR Interrupt Service Routine
latency The time between when an event occurs and the response to it. librarian A program that creates and manipulates libraries. library A collection of relocatable object modules. linker A program that combines object files and libraries to create executable code. little endian Within a given object, the least significant byte is stored at lower addresses.
memory model A description that specifies the size of pointers that point to program memory. microcontroller A highly integrated chip that contains a CPU, RAM, some form of ROM, I/O ports and timers. MPASM assembler Microchip Technology's relocatable macro assembler for PICmicro microcontroller families. MPLIB object librarian Microchip Technology's librarian for PICmicro microcontroller families. MPLINK object linker Microchip Technology's linker for PICmicro microcontroller families.
2002 Microchip Technology Inc.

C18 C Compiler Getting Started
object file A file containing object code. It may be immediately executable or it may require linking with other object code files, e.g. libraries, to produce a complete executable program. object code The machine code generated by an assembler or compiler. octal The base 8 number system that only uses the digits The right-most digit counts ones, the next digit counts multiples of 8, then 82 = 64, etc.
pragma A directive that has meaning to a specific compiler.

RAM Random Access Memory random access memory A memory device in which information can be accessed in any order. read only memory hardware that allows fast access to permanently stored data but prevents addition to or modification of the data. ROM Read Only Memory recursive Self-referential e.g., a function that calls itself . See recursive. reentrant A function that may have multiple, simultaneously active instances. This may happen due to either direct or indirect recursion or through execution during interrupt processing. relocatable An object whose address has not been assigned to a fixed memory location. runtime model Set of assumptions under which the compiler operates.
section A portion of an application located at a specific address of memory. section attribute A characteristic ascribed to a section e.g., an access section .
2002 Microchip Technology Inc.

Installation
special function register Registers that control I/O processor functions, I/O status, timers, or other modes or peripherals. storage class Determines the lifetime of the memory associated with the identified object. storage qualifier Indicates special properties of the objects being declared e.g., const .
vector The memory locations that an application will jump to when either a reset or interrupt occurs.
2002 Microchip Technology Inc.

C18 C Compiler Getting Started
2002 Microchip Technology Inc.

C18 C COMPILER GETTING STARTED

Index

A Access RAM 1, 19, 40 Add Files to Project 26

B Breakpoint 29, 31, 36 Build Options 25 Build Project 28

C COD 9 COFF 9 Customer Support 4

D Directory 13 Directory Contents 8 Documentation 14

Conventions 2 Layout 1 Numbering Conventions 2 Updates 2

E Examples 8, 14, 20, 37, 40, 43

H HEX 9

I Installing MPLAB C18 11 interrupt service routine 1, 19, 43, 47

L Language Tools 9, 22 Libraries 3, 8, 14 Linker Scripts 8, 14, 27, 33 Listing Files 32 little endian 47

M Map Files 32 MCC_INCLUDE 15 Memory Model 41 MPLAB C18 C Compiler Libraries 3 MPLAB C18 C Compiler User’s Guide 3 MPLAB ICD 2 32 MPLAB SIM Simulator 29

N New Project 20

P Paths 24 Product Support 5 Project Paths 24 Project Settings 22 Project Tree 21

R README File 3, 12 References 3

S Select Device 21 Select Language Toolsuit 22 Set Tool Locations 22 Support

Customer 4 Product 5 System Requirements 7

T Troubleshooting 3

U Uninstalling MPLAB C18 17 User’s Guide 3

Notice: we do not provide any warranties that information, datasheets, application notes, circuit diagrams, or software stored on this website are up-to-date or error free. The archived SW006011 Datasheet file may be downloaded here without warranties.

Datasheet ID: SW006011 648216