Pic Micro Pascal V1.6 User Manual Doc date: 2011-05-31, revision: A. Author: Philippe Paternotte (PPA) PIC MICRO PASCAL V1.6 - USER MANUAL Summary 1 Overview.....................................................................................................................................6 1.1 Legal stuff......................................................................................................................................... 7 1.2 BSD License..................................................................................................................................... 7 2 Operation....................................................................................................................................8 2.1 Operating system............................................................................................................................. 8 2.2 MPLAB® suite.................................................................................................................................. 8 2.3 Console version................................................................................................................................ 8 2.3.1 Command line usage..........................................................................................................8 2.3.2 Message output from PMP compiler...................................................................................9 2.3.3 Exit code.............................................................................................................................9 2.4 Windows version............................................................................................................................ 10 2.4.1 PMP Project .....................................................................................................................12 2.4.1.1 Project general options......................................................................................12 2.4.1.2 Compiler options...............................................................................................13 2.4.1.3 Assembler options.............................................................................................14 2.4.1.4 Linker options....................................................................................................14 2.4.1.5 Processor options.............................................................................................14 2.4.1.6 Version and comments......................................................................................15 2.4.2 Code Explorer...................................................................................................................16 2.4.3 The tools menu..................................................................................................................17 2.4.4 Syntax highlighting and other editor options......................................................................19 2.5 Generated files............................................................................................................................... 21 2.6 Configuration file............................................................................................................................. 22 3 Language features....................................................................................................................23 3.1 BNF representation in this document.............................................................................................23 3.2 Keywords........................................................................................................................................ 23 3.3 Constant formats............................................................................................................................ 24 3.4 Program structure........................................................................................................................... 25 3.5 Unit structure.................................................................................................................................. 26 3.6 Comments...................................................................................................................................... 27 3.7 Directives........................................................................................................................................ 27 3.7.1 $C | $CODEGEN - PLC mode code..................................................................................27 3.7.2 $CONFIG - Configuration bits...........................................................................................27 3.7.3 $DEPRECATED – Define a unit, procedure or function as obsolete.................................28 3.7.4 $EEPROM - Define useable EEPROM area....................................................................28 3.7.5 $EOL – Define end of line behavior...................................................................................28 3.7.6 $EXTENDED – Enable / disable extended Pascal syntax - NEW! (V1.6.0).......................28 3.7.7 $FREQUENCY - Processor frequency..............................................................................28 3.7.8 $IDLOC Define user ID bytes............................................................................................29 3.7.9 $I | $INCLUDE - Include source file...................................................................................29 3.7.10 $INIT | $INITIALIZE - Define start-up initializations.........................................................30 3.7.11 $INTERRUPTS – Enable / disable / define interrupts......................................................30 3.7.12 $JUMPS – Define jumps range.......................................................................................31 3.7.13 $O | $OPTIM | $OPTIMIZE - Define optimization mode..................................................31 3.7.14 $OPTIMIZE_PARAMS - Define parameter passing optimization mode...........................31 3.7.15 $OSCCAL – Activates or deactivates OSCCAL processor feature..................................31 3.7.16 $P | $POINTERS - Define pointers size..........................................................................32 3.7.17 $POP – Restore compiler options ..................................................................................32 3.7.18 $PROCESSOR - Define processor.................................................................................32 3.7.19 $PUSH – Save compiler options.....................................................................................33 3.7.20 $RESERVED RAM | EEPROM - Specify a memory region as unusable........................33 3.7.21 $SCRIPT – Define the linker script to use.......................................................................33 3.7.22 $S | $SPACE - Switch memory allocation to RAM or EEPROM......................................33 3.7.23 $STRINGS - Set default string size.................................................................................34 Document revision: A - Page 2/101 PIC MICRO PASCAL V1.6 - USER MANUAL 3.7.24 $UERROR - Generate a compiler error...........................................................................34 3.7.25 $UWARNING - Generate a compiler warning.................................................................34 3.7.26 $V $VARIABLES Define the memory region for RAM variables......................................34 3.7.27 $VECTORS - Define reset and interrupt vectors.............................................................34 3.7.28 $W | $WARN | $WARNING - Define a compiler warnings behavior................................35 3.7.29 Conditional compilation...................................................................................................36 3.8 Configuration bits declaration as CONST.......................................................................................38 3.9 Identifiers........................................................................................................................................ 38 3.10 Constant declaration.....................................................................................................................39 3.10.1 Special constants behaviors............................................................................................40 3.10.2 Pseudo SET, IN keyword.................................................................................................41 3.10.3 System constants and pseudo variables.........................................................................42 3.11 Type declaration........................................................................................................................... 43 3.11.1 Pointer types....................................................................................................................45 3.11.2 Records........................................................................................................................... 45 3.11.2.1 Dynamic records..............................................................................................46 3.12 Variables declaration....................................................................................................................48 3.12.1 Special behaviors............................................................................................................48 3.12.2 Special considerations about memory allocation.............................................................49