Documentation for Pic Micro Pascal

Total Page:16

File Type:pdf, Size:1020Kb

Documentation for Pic Micro Pascal 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
Recommended publications
  • Visualage for Smalltalk Handbook Volume 2: Features
    SG24-2219-00 VisualAge for Smalltalk Handbook Volume 2: Features September 1997 SG24-2219-00 International Technical Support Organization VisualAge for Smalltalk Handbook Volume 2: Features September 1997 IBM Take Note! Before using this information and the product it supports, be sure to read the general information in Appendix A, “Special Notices.” First Edition (September 1997) This edition applies to VisualAge for Smalltalk, Versions 2, 3, and 4, for use with OS/2, AIX, and Microsoft Windows 95/NT. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. QXXE Building 80-E2 650 Harry Road San Jose, California 95120-6099 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1997. All rights reserved. Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Preface . xiii How This Redbook Is Organized ....................... xiv ITSO on the Internet ................................ xv VisualAge Support on CompuServe ..................... xvii About the Authors ................................ xvii Acknowledgments . xviii Comments Welcome . xix Chapter 1. AS/400 Connection . 1 Multiple Programs with a Single Remote Procedure Call ......... 1 RPC Part Sets Commit Boundary ........................ 1 Connection Problem with V3R1 ......................... 2 AS/400 Communication Error .......................... 2 Strange Characters on Log-on Window .................... 3 Quick Form from AS/400 Record Classes ................... 3 Communication . 4 Read Next/Previous . 4 SQL Statements . 5 Data Queues and Records ............................ 6 ODBC Requirements .
    [Show full text]
  • Programming-8Bit-PIC
    Foreword Embedded microcontrollers are everywhere today. In the average household you will find them far beyond the obvious places like cell phones, calculators, and MP3 players. Hardly any new appliance arrives in the home without at least one controller and, most likely, there will be several—one microcontroller for the user interface (buttons and display), another to control the motor, and perhaps even an overall system manager. This applies whether the appliance in question is a washing machine, garage door opener, curling iron, or toothbrush. If the product uses a rechargeable battery, modern high density battery chemistries require intelligent chargers. A decade ago, there were significant barriers to learning how to use microcontrollers. The cheapest programmer was about a hundred dollars and application development required both erasable windowed parts—which cost about ten times the price of the one time programmable (OTP) version—and a UV Eraser to erase the windowed part. Debugging tools were the realm of professionals alone. Now most microcontrollers use Flash-based program memory that is electrically erasable. This means the device can be reprogrammed in the circuit—no UV eraser required and no special packages needed for development. The total cost to get started today is about twenty-five dollars which buys a PICkit™ 2 Starter Kit, providing programming and debugging for many Microchip Technology Inc. MCUs. Microchip Technology has always offered a free Integrated Development Environment (IDE) including an assembler and a simulator. It has never been less expensive to get started with embedded microcontrollers than it is today. While MPLAB® includes the assembler for free, assembly code is more cumbersome to write, in the first place, and also more difficult to maintain.
    [Show full text]
  • Cobol Pic Clause Example
    Cobol Pic Clause Example Albuminous and sonsie Scarface never apotheosising nae when Nealon mischarges his hogs. Unlawful Ingmar clips contiguously and super, she revering her cookers benefit symmetrically. Trifoliate Chaim sometimes circularize his breaches see and dilly-dallies so dichotomously! Quetelet index file exactly the coefficient is not confuse the input procedure division resets the rerun in another accept message or paragraphs that? Early cobol example of examples are evaluated one having to pic x when clause is considered useless instructions and date formats will be made quickly than one. After a group item is never reserved words cannot be written under different format you can it occupies in an operational sign printed documentation is suppressed. Because they may be a sample program by requesting a short paragraph in each source item can be greater detail report item is impossible in the records. Exit program using pic n it will be only, or more sections into a pic clause is executed as shown in a file to. Duplicate keys or fetch a call to_char with input call to describe data description during execution of examples of this area b it! We delimit by cobol example illustrates this server outputs data division sections having one. Basic cobol example. The individual file is provided for pic x variables being defined by use of messages. The cobol picture indicates a cobol api to cobol pic clause example. This call function is defined width of the usage is to a table can you explicitly searched last sentence and pic clause scales as steps. No cobol example with clause indicates the pic clause specifies that truncation or.
    [Show full text]
  • PIC Assembly Language for the Complete Beginner
    PIC Assembly Language for the Complete Beginner Michael A. Covington Artificial Intelligence Center The University of Georgia Athens, Georgia 30602-7415 http://www.ai.uga.edu/mc This article appeared in Electronics Now Magazine in 1999 and is reprinted here by permission. Some web addresses have been up- dated but the content has not; you will find that MPLAB, for instance, now looks somewhat different. You may print out this article for personal use but not for further pub- lication. Copyright c 1999 Gernsback Publications, Inc. Copyright c 1999, 2004 Michael A. Covington. These days, the field of electronics is divided into “haves” and “have- nots” – people who can program microcontrollers and people who can’t. If you’re one of the “have-nots,” this article is for you. 1 Microcontrollers are one-chip computers designed to control other equip- ment, and almost all electronic equipment now uses them. The average American home now contains about 100 computers, almost all of which are microcontrollers hidden within appliances, clocks, thermostats, and even automobile engines. Although some microcontrollers can be programmed in C or BASIC, you need assembly language to get the best results with the least expensive micros. The reason is that assembly language lets you specify the exact instructions that the CPU will follow; you can control exactly how much time and memory each step of the program will take. On a tiny computer, this can be important. What’s more, if you’re not already an experienced programmer, you may well find that assembly language is simpler than BASIC or C.
    [Show full text]
  • Extensible Markup Language (XML) 1.0
    REC-xml-19980210 Extensible Markup Language (XML) 1.0 W3C Recommendation 10-Feb-98 This version http://www.w3.org/TR/1998/REC-xml-19980210 http://www.w3.org/TR/1998/REC-xml-19980210.xml http://www.w3.org/TR/1998/REC-xml-19980210.html http://www.w3.org/TR/1998/REC-xml-19980210.pdf http://www.w3.org/TR/1998/REC-xml-19980210.ps Latest version http://www.w3.org/TR/REC-xml Previous version http://www.w3.org/TR/PR-xml-971208 Editors Tim Bray, Textuality and Netscape ([email protected]) Jean Paoli, Microsoft ([email protected]) C. M. Sperberg-McQueen, University of Illinois at Chicago ([email protected]) Abstract The Extensible Markup Language (XML) is a subset of SGML that is completely described in this document. Its goal is to enable generic SGML to be served, received, and processed on the Web in the way that is now possible with HTML. XML has been designed for ease of implementation and for interoperability with both SGML and HTML. Status of this document This document has been reviewed by W3C Members and other interested parties and has been endorsed by the Director as a W3C Recommendation. It is a stable document and may be used as reference material or cited as a normative reference from another document. W3C's role in making the Recommendation is to draw attention to the specification and to promote its widespread deployment. This enhances the functionality and interoperability of the Web. This document specifies a syntax created by subsetting an existing, widely used international text processing standard (Standard Generalized Markup Language, ISO 8879:1986(E) as amended and corrected) for use on the World Wide Web.
    [Show full text]
  • Bash Guide for Beginners
    Bash Guide for Beginners Machtelt Garrels Garrels BVBA <tille wants no spam _at_ garrels dot be> Version 1.11 Last updated 20081227 Edition Bash Guide for Beginners Table of Contents Introduction.........................................................................................................................................................1 1. Why this guide?...................................................................................................................................1 2. Who should read this book?.................................................................................................................1 3. New versions, translations and availability.........................................................................................2 4. Revision History..................................................................................................................................2 5. Contributions.......................................................................................................................................3 6. Feedback..............................................................................................................................................3 7. Copyright information.........................................................................................................................3 8. What do you need?...............................................................................................................................4 9. Conventions used in this
    [Show full text]
  • A Special-Purpose Language for Picture-Drawing
    The following paper was originally published in the Proceedings of the Conference on Domain-Specific Languages Santa Barbara, California, October 1997 A Special-Purpose Language for Picture-Drawing Samuel N. Kamin and David Hyatt University of Illinois, Urbana-Champaign For more information about USENIX Association contact: 1. Phone: 510 528-8649 2. FAX: 510 548-5738 3. Email: [email protected] 4. WWW URL:http://www.usenix.org A Sp ecial-Purp ose Language for Picture-Drawing y Samuel N. Kamin David Hyatt Computer Science Department University of Il linois at Urbana-Champaign Urbana, Il linois 61801 fs-kamin,[email protected] Abstract supp orted in programming languages. This supp ort means allowing the creation of \ rst-class" values of eachtyp e, that is, values not sub ject to arbitrary Special purpose languages are typical ly characterized restrictions based on the typ e. It also means pro- by a type of primitive data and domain-speci c oper- viding op erations appropriate to those typ es in a ations on this data. One approach to special purpose concise, non-bureaucratic form. language design is to embed the data and operations In our view, this approach to language design is p er- of the language within an existing functional lan- guage. The data can be de ned using the typecon- fectly suited to the design of sp ecial-purp ose lan- structions provided by the functional language, and guages. These languages are usually characterized the special purpose language then inherits al l of the byatyp e of primitive data sp eci c to a problem domain, and op erations on those data.
    [Show full text]
  • Domain Specific Languages∗
    Domain Specific Languages∗ Paul Hudak Department of Computer Science Yale University December 15, 1997 1 Introduction When most people think of a programming language they think of a general pur- pose language: one capable of programming any application with relatively the same degree of expressiveness and efficiency. For many applications, however, there are more natural ways to express the solution to a problem than those afforded by general purpose programming languages. As a result, researchers and practitioners in recent years have developed many different domain specific languages, or DSL’s, which are tailored to particular application domains. With an appropriate DSL, one can develop complete application programs for a do- main more quickly and more effectively than with a general purpose language. Ideally, a well-designed DSL captures precisely the semantics of an application domain, no more and no less. Table 1 is a partial list of domains for which DSL’s have been created. As you can see, the list covers quite a lot of ground. For a list of some popular DSL’s that you may have heard of, look at Table 2.1 The first example is a set of tools known as Lex and Yacc which are used to build lexers and parsers, respectively. Thus, ironically, they are good tools for building DSL’s (more on this later). Note that there are several document preparation languages listed; for example, LATEX was used to create the original draft of this article. Also on the list are examples of “scripting languages,” such as PERL, Tcl, and Tk, whose general domain is that of scripting text and file manipulation, GUI widgets, and other software components.
    [Show full text]
  • RM/COBOL Syntax Summary (Second Edition)
    Liant Software Corporation RM/COBOL ® Syntax Summary Second Edition This document provides complete syntax for all RM/COBOL commands, divisions, entries, statements, and other general formats. Use this pamphlet in conjunction with the RM/COBOL Language Reference Manual and the RM/COBOL User's Guide. The RM/COBOL Syntax Summary has been prepared for all implementations of RM/COBOL. Consult the RM/COBOL User's Guide for all appropriate operating system rules and conventions (such as command line invocation). No part of this publication may be reproduced, stored in a retrieval system or transmitted, in any form or by any means, electronic, mechanical, photocopied, recorded, or otherwise, without prior written permission of Liant Software Corporation. The information in this document is subject to change without prior notice. Liant Software Corporation assumes no responsibility for any errors that may appear in this document. Liant reserves the right to make improvements and/or changes in the products and programs described in this guide at any time without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. The software described in this document is furnished to the user under a license for a specific number of uses and may be copied (with inclusion of the copyright notice) only in accordance with the terms of such license. Copyright © 1985-2008 by Liant Software Corporation. All rights reserved. Printed in U.S.A. Liant Software Corporation 5914 West Courtyard Dr., Suite 100 Austin, TX 78730-4911 U.S.A. Phone (512) 343-1010 (800) 762-6265 Fax (512) 343-9487 Web site http://www.liant.com RM, RM/COBOL, RM/COBOL-85, Relativity, Enterprise CodeBench, RM/InfoExpress, RM/Panels, VanGui Interface Builder, CodeWatch, CodeBridge, Cobol-WOW, WOW Extensions, InstantSQL, Xcentrisity, XML Extensions, Liant, and the Liant logo are trademarks or registered trademarks of Liant Software Corporation.
    [Show full text]
  • Semantics-Driven DSL Design*
    Semantics-Driven DSL Design* Martin Erwig and Eric Walkingshaw School of EECS, Oregon State University, USA ABSTRACT Convention dictates that the design of a language begins with its syntax. We argue that early emphasis should be placed instead on the identification of general, compositional semantic domains, and that grounding the design process in semantics leads to languages with more consistent and more extensible syntax. We demonstrate this semantics-driven design process through the design and implementation of a DSL for defining and manipulating calendars, using Haskell as a metalanguage to support this discussion. We emphasize the importance of compositionality in semantics-driven language design, and describe a set of language operators that support an incremental and modular design process. INTRODUCTION Despite the lengthy history and recent popularity of domain-specific languages, the task of actually designing DSLs remains a difficult and under-explored problem. This is evidenced by the admission of DSL guru Martin Fowler, in his recent book on DSLs, that he has no clear idea of how to design a good language (2010, p. 45). Instead, recent work has focused mainly on the implementation of DSLs and supporting tools, for example, through language workbenches (Pfeiffer & Pichler, 2008). This focus is understandable—implementing a language is a structured and well-defined problem with clear quality criteria, while language design is considered more of an art than an engineering task. Furthermore, since DSLs have limited scope and are often targeted at domain experts rather than professional programmers, general-purpose language design criteria may not always be applicable to the design of DSLs, complicating the task even further (Mernik et al., 2005).
    [Show full text]
  • Gputils 0.13.3
    gputils 0.13.3 October 27, 2007 1 James Bowman and Craig Franklin July 31, 2005 Contents 1 Introduction 4 1.1 ToolFlows ....................................... ... 4 1.1.1 AbsoluteAsmMode ............................... .. 4 1.1.2 RelocatableAsmMode. .... 4 1.1.3 WhichToolFlowisbest?. ..... 5 1.2 Supportedprocessors . ........ 5 2 gpasm 7 2.1 Runninggpasm .................................... .... 7 2.1.1 Usinggpasmwith“make” . .... 8 2.1.2 Dealingwitherrors.. ... .... .... .... ... .... .... ..... 9 2.2 Syntax.......................................... ... 9 2.2.1 Filestructure ................................. .... 9 2.2.2 Expressions................................... ... 9 2.2.3 Numbers ....................................... 11 2.2.4 Preprocessor .................................. ... 12 2.2.5 Processorheaderfiles. ...... 12 2.3 Directives ...................................... ..... 13 2.3.1 Codegeneration ................................ ... 13 2.3.2 Configuration.................................. ... 13 2.3.3 Conditionalassembly. ...... 13 2.3.4 Macros ........................................ 13 2.3.5 $ ........................................... 14 2.3.6 Suggestionsforstructuringyourcode . ........... 14 2.3.7 Directivesummary .............................. .... 15 2.3.8 Highlevelextensions. ...... 24 2.4 Instructions .................................... ...... 27 2.4.1 Instructionsetsummary . ...... 28 2.5 Errors/Warnings/Messages . .......... 30 2.5.1 Errors........................................ 31 2.5.2 Warnings .....................................
    [Show full text]
  • $Date:: 2020-09-20#$ Contents
    gpsim $Date:: 2020-09-20#$ Contents 1 gpsim - An Overview 6 1.1 Makingtheexecutable ......................... 6 1.1.1 MakeDetails-./configureoptions . 6 1.1.2 RPMs.............................. 7 1.1.3 Windows ............................ 7 1.2 Running................................. 7 1.3 Requirements .............................. 8 2 Command Line Interface 9 2.1 attach .................................. 10 2.2 break .................................. 11 2.3 clear................................... 13 2.4 disassemble ............................... 14 2.5 dump .................................. 14 2.6 echo................................... 15 2.7 frequency ................................ 15 2.8 help ................................... 15 2.9 icd.................................... 15 2.10list ................................... 15 2.11load ................................... 16 2.12macros.................................. 16 2.13module ................................. 18 2.14node................................... 19 2.15processor ................................ 20 2.16quit ................................... 20 2.17run.................................... 20 2.18step ................................... 20 1 CONTENTS 2 2.19symbol.................................. 21 2.20stimulus................................. 21 2.21 stopwatch1 ............................... 22 2.22trace................................... 23 2.23version.................................. 23 2.24x..................................... 23 3 Graphical User Interface
    [Show full text]