MAXQ Core Assembly Guide - Maxim

¥MAXQ Core Assembly GuideUSING THE MACRO PREPROCESSORThe MAXQ preprocessor, Macro, is used to perform a number of operations on assembly files before they areprocessed by MaxQAsm. It may be used either automatically as part of the MAX-IDE environment or directly fromthe Windows command line.Invoking Macro from the Command LineRunning Macro from the command line with no parameters will display version information and list command lineoptions.D:\MaxQAsm>macro¥¢¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¤Dallas Semiconductor Macro Preprocessor, Alpha Version 2.001.0001¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£¡£§¦Last build Aug 2 2005 at 12:06:54Usage: macro [options] options:-q Quiet mode-e-Strip "END" statement from output file-I Optional include file directory-s Supress lines removed by macro-D= Add to symbol table with stringas predefined value-L Generate debug informationThe is the name of the MAXQ assembly file to be processed; only one file name may be specified onthe command line. The assembly file must be in plain text ASCII format and may have any extension (“.asm” istypical but is not required). The extension must be provided on the command line as part of the file name; “.asm”will not be assumed as a default.Table 6. Macro Command Line OptionsOption-q-e--Ior-I -s-D=or-D =-LFunctionIf this option is included, the preprocessor will run silently, generating no output on the commandline for a successful run. The default behavior is to output the version header and usageinformation as shown above. Any error messages will be output whether or not this option isincluded.If this option is included, the END statement will be removed from the output file.This option may be included multiple times in a single command line. If included, this optionspecifies (in ) one or more directories to search for include files. Multiple directories may bespecified by separating them with semicolons, and directory paths may be relative or absolute.Normally, lines which are only of interest to Macro and not the assembler (such as equatedefinitions, #define and #include lines, and macro defines) are commented out in the output file.Including this option causes such lines to be removed from the output file completely.This option defines a preprocessor value before the input file is read. Including this option has thesame effect as placing#define at the first line of the assembly source file.Including this option causes additional debugging information (in comments) to be placed into theassembly source file, including begin-module and end-module markers and line numberinginformation. This information is not used by the assembler, but it is scanned by MAX-IDE fordebugging purposes.Version 1.2 25 of 43 March 7, 2007