Pic Lite

3

PICC Lite C Manual Copyright ©2004 HI-TECH Software. All Rights Reserved. Printed in Australia.

3

Seventh Printing (c), September 2004

HI-TECH Software A division of Gretetoy Pty. Ltd. ACN 002 724 549 PO Box 103 Alderley QLD 4051 Australia Email:hitech@htsoft.com Web:http://www.htsoft.com/ FTP:ftp.htsoft.com

Introduction Tutorials Using HTLPIC Command Line Compiler DriverFeatures and Runtime Environment PICC Lite Macro Assembler Linker and Utilities Reference Manual Error Messages Library Functions

1 2 3 4 5 6 7 8 9

Contents

1 - Introduction - - - - - - - - - - - - - - - - - - - - - - - - - 15
1.1 Compiler Limitations - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 15 1.2 Typographic conventions - - - - - - - - - - - - - - - - - - - - - - -- - - - - - - 15 1.3 Using This Manual - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 15

1

2 - Tutorials - - - - - - - - - - - - - - - - - - - - - - - - - - - 17
2.1 Overview of the compilation process - - - - 2.1.1 Compilation - - - - - - - - - - - - 2.1.2 The compiler input - - - - - - - - - 2.1.2.1 Steps before linking - - - - 2.1.2.2 The link stage - - - - - - - 2.2Psects and the linker - - - - - - - - - - - - 2.2.1 Psects - - - - - - - - - - - - - - - 2.2.1.1 The psect directive - - - - 2.2.1.2 Psect types - - - - - - - - 2.3 Linking the psects - - - - - - - - - - - - - 2.3.1 Grouping psects - - - - - - - - - - 2.3.2 Positioning psects - - - - - - - - - 2.3.3 Linker options to position psects - - 2.3.3.1 Placing psects at an address 2.3.3.2 Exceptional cases- - - - - 2.3.3.3 Psect classes - - - - - - - 2.3.3.4 User-defined psects - - - - 2.3.4 Issues when linking- - - - - - - - - 2.3.4.1 Paged memory - - - - - - 2.3.4.2 Separate memory areas - - 2.3.4.3 Objects at absolute addresses 2.3.5 Modifying the linker options - - - - 2.4 Addresses used with the PIC - - - - - - - - 2.4.1 Code addresses - - - - - - - - - - - 2.4.2 Data addresses - - - - - - -- - - - 2.4.3 Bit addresses - - - - - - - - - - - - 17 17 18 21 27 29 29 30 31 32 33 33 34 34 37 38 40 41 41 42 43 44 45 46 46 49

HI-TECH PICC Lite compiler

1

3 - Using HTLPIC - - - - - - - - - - - - - - - - - - - - - - - - 51
3.1 Introduction - - - - - - - - - - - - - - - - 3.1.1 Starting HTLPIC - - - - - - - - - 3.2 The HI-TECH Windows User Interface - - - 3.2.1 Environment variables- - - - - - - 3.2.2 Hardware Requirements - - - - - - 3.2.3 Colours - - - - - - - - - - - - - - 3.2.4 Pull-Down Menus - - - - - - - - - 3.2.4.1 Keyboard Menu Selection 3.2.4.2 Mouse Menu Selection - - 3.2.4.3 Menu Hot Keys - - - - - 3.2.5 Selecting windows - - - - - - - - 3.2.6 Moving and Resizing Windows - - 3.2.7 Buttons - - - - - - - - - - - - - - 3.2.8 The Setup menu - - - - - - - - - - 3.3Tutorial: Creating and Compiling a C Program 3.4 The HTLPIC editor - - - - - - - - - - - - 3.4.1 Frame - - - - - - - - - - - - - - 3.4.2 Content Region - - - - - - - - - - 3.4.3 Status Line - - - - - - - - - - - - 3.4.4 Keyboard Commands - - - - - - - 3.4.5 Block Commands - - - - - - - - - 3.4.6 Clipboard Editing - - - - - - - - - 3.4.6.1 Selecting Text - - - - - - 3.4.6.2 Clipboard Commands - - 3.5HTLPIC menus - - - - - - - - - - - - - - 3.5.1 menu - - - - - - - - - - - - 3.5.2 File menu - - - - - - - - - - - - - 3.5.3 Edit menu- - - - - - - - - - - - - 3.5.4 Options menu - - - - - - - - - - 3.5.5 Compile menu - - - - - - - - - - 3.5.6 Make menu - - - - - - - - - - - - 3.5.7 Run menu- - - - - - - - - - - - - 3.5.8 Utility menu - - - - - - - - - - - 3.5.9 Help menu - - - - - - - - - - - -- 51 51 - 52 52 52 53 53 - 54 - 55 - 56 56 58 59 59 - 60 - 66 66 66 66 67 69 71 - 71 - 72 - 73 73 73 74 77 79 81 85 85 88

2

Contents

4 - Command Line Compiler Driver - - - - - - - - - - - - - - - 91
4.1 Long Command Lines - - - - - - - - - - - - - - - - - - - - - - 4.2 Default Libraries - - - - - - - - - - - - - - - - - - - - - - - - - 4.3 Standard Run-Time Code - - - - - - - - - - -...