1 /*-------------------------------------------------------------------------
3 main.c - pic16 specific general functions.
5 Written by - Scott Dattalo scott@dattalo.com
6 Ported to PIC16 by - Martin Dubuc m.debuc@rogers.com
8 Note that mlh prepended _pic16_ on the static functions. Makes
9 it easier to set a breakpoint using the debugger.
12 This program is free software; you can redistribute it and/or modify it
13 under the terms of the GNU General Public License as published by the
14 Free Software Foundation; either version 2, or (at your option) any
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program; if not, write to the Free Software
24 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 -------------------------------------------------------------------------*/
37 static char _defaultRules[] =
42 /* list of key words used by pic16 */
43 static char *_pic16_keywords[] =
73 pic16_sectioninfo_t pic16_sectioninfo;
76 extern char *pic16_processor_base_name(void);
78 void pic16_pCodeInitRegisters(void);
80 void pic16_assignRegisters (eBBlock ** ebbs, int count);
82 static int regParmFlg = 0; /* determine if we can register a parameter */
84 pic16_options_t pic16_options;
86 extern set *includeDirsSet;
87 extern set *dataDirsSet;
88 extern set *libFilesSet;
90 /* Also defined in gen.h, but the #include is commented out */
91 /* for an unknowned reason. - EEP */
92 void pic16_emitDebuggerSymbol (char *);
94 extern regs* newReg(short type, short pc_type, int rIdx, char *name, int size, int alias, operand *refop);
95 extern void pic16_emitConfigRegs(FILE *of);
96 extern void pic16_emitIDRegs(FILE *of);
103 asm_addTree (&asm_asxxxx_mapping);
104 pic16_pCodeInitRegisters();
107 /* set pic16 port options to defaults */
108 pic16_options.no_banksel = 0;
109 pic16_options.opt_banksel = 0;
110 pic16_options.omit_configw = 0;
111 pic16_options.omit_ivt = 0;
112 pic16_options.leave_reset = 0;
113 pic16_options.stack_model = 0; /* 0 for 'small', 1 for 'large' */
114 pic16_options.ivt_loc = 0x000000; /* default location of interrupt vectors */
115 pic16_options.nodefaultlibs = 0; /* link default libraries */
116 pic16_options.dumpcalltree = 0;
120 _pic16_reset_regparm ()
126 _pic16_regparm (sym_link * l)
128 /* for this processor it is simple
129 * can pass only the first parameter in a register */
131 if(regParmFlg)return 0;
141 int initsfpnt=0; /* set to 1 if source provides a pragma for stack
142 * so glue() later emits code to initialize stack/frame pointers */
145 set *sectNames=NULL; /* list of section listed in pragma directives */
146 set *sectSyms=NULL; /* list of symbols set in a specific section */
150 _process_pragma(const char *sz)
152 static const char *WHITE = " \t\n";
154 char *ptr = strtok((char *)sz, WHITE);
156 /* #pragma maxram [maxram] */
157 if (startsWith (ptr, "maxram")) {
158 char *maxRAM = strtok((char *)NULL, WHITE);
160 if (maxRAM != (char *)NULL) {
164 maxRAMVal = constVal(maxRAM);
165 maxRAMaddress = (int)floatFromVal(maxRAMVal);
166 pic16_setMaxRAM(maxRAMaddress);
170 /* #pragma stack [stack-position] [stack-len] */
171 if(startsWith(ptr, "stack")) {
172 char *stackPosS = strtok((char *)NULL, WHITE);
173 char *stackLenS = strtok((char *)NULL, WHITE);
179 stackPosVal = constVal( stackPosS );
180 stackPos = (unsigned int)floatFromVal( stackPosVal );
184 stackLenVal = constVal( stackLenS );
185 stackLen = (unsigned int)floatFromVal( stackLenVal );
190 fprintf(stderr, "%s:%d setting stack to default size 0x%x\n", __FILE__, __LINE__, stackLen);
193 // fprintf(stderr, "Initializing stack pointer at 0x%x len 0x%x\n", stackPos, stackLen);
195 reg=newReg(REG_SFR, PO_SFR_REGISTER, stackPos, "_stack", stackLen-1, 0, NULL);
196 addSet(&pic16_fix_udata, reg);
198 reg = newReg(REG_SFR, PO_SFR_REGISTER, stackPos + stackLen-1, "_stack_end", 1, 0, NULL);
199 addSet(&pic16_fix_udata, reg);
201 sym = newSymbol("stack", 0);
202 sprintf(sym->rname, "_%s", sym->name);
203 addSet(&publics, sym);
205 sym = newSymbol("stack_end", 0);
206 sprintf(sym->rname, "_%s", sym->name);
207 addSet(&publics, sym);
209 initsfpnt = 1; // force glue() to initialize stack/frame pointers */
214 /* #pragma code [symbol] [location] */
215 if(startsWith(ptr, "code")) {
216 char *symname = strtok((char *)NULL, WHITE);
217 char *location = strtok((char *)NULL, WHITE);
221 absS = Safe_calloc(1, sizeof(absSym));
222 absS->name = Safe_strdup( symname );
223 addr = constVal( location );
224 absS->address = (unsigned int)floatFromVal( addr );
226 addSet(&absSymSet, absS);
227 fprintf(stderr, "%s:%d symbol %s will be placed in location 0x%06x in code memory\n",
228 __FILE__, __LINE__, symname, absS->address);
233 /* #pragma udata [section-name] [symbol] */
234 if(startsWith(ptr, "udata")) {
235 char *sectname = strtok((char *)NULL, WHITE);
236 char *symname = strtok((char *)NULL, WHITE);
243 ssym = Safe_calloc(1, sizeof(sectSyms));
244 ssym->name = Safe_calloc(1, strlen(symname)+2);
245 sprintf(ssym->name, "_%s", symname);
248 addSet(§Syms, ssym);
251 for(snam=setFirstItem(sectNames);snam;snam=setNextItem(sectNames)) {
252 if(!strcmp(sectname, snam->name)){ found=1; break; }
256 snam = Safe_calloc(1, sizeof(sectNames));
257 snam->name = Safe_strdup( sectname );
258 snam->regsSet = NULL;
260 addSet(§Names, snam);
263 ssym->section = snam;
265 // fprintf(stderr, "%s:%d placing symbol %s at section %s (%p)\n", __FILE__, __LINE__,
266 // ssym->name, snam->name, snam);
268 symname = strtok((char *)NULL, WHITE);
277 #define REP_UDATA "--preplace-udata-with="
279 #define STACK_MODEL "--pstack-model="
280 #define OPT_BANKSEL "--obanksel="
282 #define ALT_ASM "--asm="
283 #define ALT_LINK "--link="
285 #define IVT_LOC "--ivt-loc"
286 #define NO_DEFLIBS "--nodefaultlibs"
287 #define MPLAB_COMPAT "--mplab-comp"
292 int pic16_mplab_comp=0;
293 extern int pic16_debug_verbose;
294 extern int pic16_ralloc_debug;
295 extern int pic16_pcode_verbose;
298 int pic16_enable_peeps=0;
300 OPTION pic16_optionsTable[]= {
301 { 0, NO_DEFLIBS, &pic16_options.nodefaultlibs, "do not link default libraries when linking"},
302 { 0, "--pno-banksel", &pic16_options.no_banksel, "do not generate BANKSEL assembler directives"},
303 { 0, OPT_BANKSEL, NULL, "set banksel optimization level (default=0 no)"},
304 { 0, "--pomit-config-words", &pic16_options.omit_configw, "omit the generation of configuration words"},
305 { 0, "--pomit-ivt", &pic16_options.omit_ivt, "omit the generation of the Interrupt Vector Table"},
306 { 0, "--pleave-reset-vector",&pic16_options.leave_reset, "when omitting IVT leave RESET vector"},
307 { 0, STACK_MODEL, NULL, "use stack model 'small' (default) or 'large'"},
309 { 0, "--debug-xtra", &pic16_debug_verbose, "show more debug info in assembly output"},
310 { 0, "--debug-ralloc", &pic16_ralloc_debug, "dump register allocator debug file *.d"},
311 { 0, "--pcode-verbose", &pic16_pcode_verbose, "dump pcode related info"},
313 { 0, REP_UDATA, NULL, "Place udata variables at another section: udata_acs, udata_ovr, udata_shr"},
315 { 0, ALT_ASM, NULL, "Use alternative assembler"},
316 { 0, ALT_LINK, NULL, "Use alternative linker"},
318 { 0, "--denable-peeps", &pic16_enable_peeps, "explicit enable of peepholes"},
319 { 0, IVT_LOC, NULL, "<nnnn> interrupt vector table location"},
320 { 0, "--calltree", &pic16_options.dumpcalltree, "dump call tree in .calltree file"},
321 { 0, MPLAB_COMPAT, &pic16_mplab_comp, "enable compatibility mode for MPLAB utilities (MPASM/MPLINK)"},
322 { 0, "--fstack", &pic16_fstack, "enable stack optimizations"},
323 { 0, NULL, NULL, NULL}
327 #define ISOPT(str) !strncmp(argv[ *i ], str, strlen(str) )
329 extern char *getStringArg(const char *, char **, int *, int);
330 extern int getIntArg(const char *, char **, int *, int);
333 _pic16_parseOptions (int *pargc, char **argv, int *i)
338 /* TODO: allow port-specific command line options to specify
339 * segment names here.
341 /* check for arguments that have associated an integer variable */
342 while(pic16_optionsTable[j].pparameter) {
343 if(ISOPT( pic16_optionsTable[j].longOpt )) {
344 (*pic16_optionsTable[j].pparameter)++;
351 if(ISOPT(STACK_MODEL)) {
352 stkmodel = getStringArg(STACK_MODEL, argv, i, *pargc);
353 if(STRCASECMP(stkmodel, "small"))pic16_options.stack_model = 0;
354 else if(STRCASECMP(stkmodel, "large"))pic16_options.stack_model = 1;
356 fprintf(stderr, "Unknown stack model: %s", stkmodel);
362 if(ISOPT(OPT_BANKSEL)) {
363 pic16_options.opt_banksel = getIntArg(OPT_BANKSEL, argv, i, *pargc);
367 if(ISOPT(REP_UDATA)) {
368 pic16_sectioninfo.at_udata = Safe_strdup(getStringArg(REP_UDATA, argv, i, *pargc));
373 alt_asm = Safe_strdup(getStringArg(ALT_ASM, argv, i, *pargc));
377 if(ISOPT(ALT_LINK)) {
378 alt_link = Safe_strdup(getStringArg(ALT_LINK, argv, i, *pargc));
383 pic16_options.ivt_loc = getIntArg(IVT_LOC, argv, i, *pargc);
390 static void _pic16_initPaths(void)
392 char pic16incDir[512];
393 char pic16libDir[512];
394 set *pic16incDirsSet;
395 set *pic16libDirsSet;
398 setMainValue("mcu", pic16->name[2] );
399 addSet(&preArgvSet, Safe_strdup("-D{mcu}"));
401 sprintf(pic16incDir, "%s%cpic16", INCLUDE_DIR_SUFFIX, DIR_SEPARATOR_CHAR);
402 sprintf(pic16libDir, "%s%cpic16", LIB_DIR_SUFFIX, DIR_SEPARATOR_CHAR);
404 if(!options.nostdinc) {
405 /* setup pic16 include directory */
406 pic16incDirsSet = appendStrSet(dataDirsSet, NULL, pic16incDir);
407 mergeSets(&includeDirsSet, pic16incDirsSet);
410 if(!options.nostdlib) {
411 /* setup pic16 library directory */
412 pic16libDirsSet = appendStrSet(dataDirsSet, NULL, pic16libDir);
413 mergeSets(&libDirsSet, pic16libDirsSet);
416 if(!pic16_options.nodefaultlibs) {
417 /* now add the library for the device */
418 sprintf(devlib, "%s.lib", pic16->name[2]);
419 addSet(&libFilesSet, Safe_strdup(devlib));
423 extern set *linkOptionsSet;
424 char *msprintf(hTab *pvals, const char *pformat, ...);
425 int my_system(const char *cmd);
427 /* custom function to link objects */
428 static void _pic16_linkEdit(void)
430 hTab *linkValues=NULL;
438 * link command format:
439 * {linker} {incdirs} {lflags} -o {outfile} {spec_ofiles} {ofiles} {libs}
443 sprintf(lfrm, "{linker} {incdirs} {lflags} -o {outfile} {spec_ofiles} {ofiles} {libs}");
445 shash_add(&linkValues, "linker", "gplink");
447 mergeSets(&tSet, libDirsSet);
448 mergeSets(&tSet, libPathsSet);
450 shash_add(&linkValues, "incdirs", joinStrSet( appendStrSet(tSet, "-I\"", "\"")));
451 shash_add(&linkValues, "lflags", joinStrSet(linkOptionsSet));
453 shash_add(&linkValues, "outfile", dstFileName);
455 if(fullSrcFileName) {
456 sprintf(temp, "%s.o", dstFileName);
457 // shash_add(&linkValues, "srcofile", temp);
458 addSetHead(&relFilesSet, temp);
461 // shash_add(&linkValues, "spec_ofiles", "crt0i.o");
462 shash_add(&linkValues, "ofiles", joinStrSet(relFilesSet));
463 shash_add(&linkValues, "libs", joinStrSet(libFilesSet));
465 lcmd = msprintf(linkValues, lfrm);
467 ret = my_system( lcmd );
476 /* forward declarations */
477 extern const char *pic16_linkCmd[];
478 extern const char *pic16_asmCmd[];
481 _pic16_finaliseOptions (void)
483 port->mem.default_local_map = data;
484 port->mem.default_globl_map = data;
486 /* peepholes are disabled for the time being */
489 /* explicit enable peepholes for testing */
490 if(pic16_enable_peeps)
493 options.all_callee_saves = 1; // always callee saves
494 // options.float_rent = 1;
495 // options.intlong_rent = 1;
498 if(alt_asm && strlen(alt_asm))
499 pic16_asmCmd[0] = alt_asm;
501 if(alt_link && strlen(alt_link))
502 pic16_linkCmd[0] = alt_link;
506 /* all the rest is commented ifdef'd out */
508 /* Hack-o-matic: if we are using the flat24 model,
509 * adjust pointer sizes.
511 if (options.model == MODEL_FLAT24)
514 fprintf (stderr, "*** WARNING: you should use the '-mds390' option "
515 "for DS80C390 support. This code generator is "
516 "badly out of date and probably broken.\n");
518 port->s.fptr_size = 3;
519 port->s.gptr_size = 4;
520 port->stack.isr_overhead++; /* Will save dpx on ISR entry. */
522 port->stack.call_overhead++; /* This acounts for the extra byte
523 * of return addres on the stack.
524 * but is ugly. There must be a
528 fReturn = fReturn390;
532 if (options.model == MODEL_LARGE)
534 port->mem.default_local_map = xdata;
535 port->mem.default_globl_map = xdata;
539 port->mem.default_local_map = data;
540 port->mem.default_globl_map = data;
543 if (options.stack10bit)
545 if (options.model != MODEL_FLAT24)
548 "*** warning: 10 bit stack mode is only supported in flat24 model.\n");
549 fprintf (stderr, "\t10 bit stack mode disabled.\n");
550 options.stack10bit = 0;
554 /* Fixup the memory map for the stack; it is now in
555 * far space and requires a FPOINTER to access it.
558 istack->ptrType = FPOINTER;
565 _pic16_setDefaultOptions (void)
567 /* initialize to defaults section locations, names and addresses */
568 pic16_sectioninfo.at_udata = "udata";
570 /* set pic16 port options to defaults */
571 pic16_options.no_banksel = 0;
572 pic16_options.opt_banksel = 0;
573 pic16_options.omit_configw = 0;
574 pic16_options.omit_ivt = 0;
575 pic16_options.leave_reset = 0;
576 pic16_options.stack_model = 0; /* 0 for 'small', 1 for 'large' */
577 pic16_options.ivt_loc = 0x000000;
578 pic16_options.nodefaultlibs = 0;
579 pic16_options.dumpcalltree = 0;
583 _pic16_getRegName (struct regs *reg)
592 static char *_pic16_mangleFunctionName(char *sz)
594 // fprintf(stderr, "mangled function name: %s\n", sz);
602 _pic16_genAssemblerPreamble (FILE * of)
604 char *name = pic16_processor_base_name();
608 fprintf(stderr,"WARNING: No Pic has been selected, defaulting to %s\n",name);
611 fprintf (of, "\tlist\tp=%s\n",&name[1]);
613 if(!pic16_options.omit_configw) {
614 pic16_emitConfigRegs(of);
616 pic16_emitIDRegs(of);
619 fprintf (of, "\tradix dec\n");
622 /* Generate interrupt vector table. */
624 _pic16_genIVT (FILE * of, symbol ** interrupts, int maxInterrupts)
627 /* PIC18F family has only two interrupts, the high and the low
628 * priority interrupts, which reside at 0x0008 and 0x0018 respectively - VR */
630 if((!pic16_options.omit_ivt) || (pic16_options.omit_ivt && pic16_options.leave_reset)) {
631 fprintf(of, "; RESET vector\n");
632 fprintf(of, "\tgoto\t__sdcc_gsinit_startup\n");
635 if(!pic16_options.omit_ivt) {
636 fprintf(of, "\tres 4\n");
639 fprintf(of, "; High priority interrupt vector 0x0008\n");
641 fprintf(of, "\tgoto\t%s\n", interrupts[1]->rname);
642 fprintf(of, "\tres\t12\n");
644 fprintf(of, "\tretfie\n");
645 fprintf(of, "\tres\t14\n");
648 fprintf(of, "; Low priority interrupt vector 0x0018\n");
650 fprintf(of, "\tgoto\t%s\n", interrupts[2]->rname);
652 fprintf(of, "\tretfie\n");
659 /* return True if the port can handle the type,
660 * False to convert it to function call */
661 static bool _hasNativeMulFor (iCode *ic, sym_link *left, sym_link *right)
663 // fprintf(stderr,"checking for native mult for %c (size: %d)\n", ic->op, getSize(OP_SYMBOL(IC_RESULT(ic))->type));
666 /* multiplication is fixed */
667 /* support mul for char/int/long */
668 if((getSize(OP_SYMBOL(IC_LEFT(ic))->type ) <= 4)
669 && (ic->op == '*'))return TRUE;
673 /* support div for char/int/long */
674 if((getSize(OP_SYMBOL(IC_LEFT(ic))->type ) <= 0)
675 && (ic->op == '/'))return TRUE;
683 /* Do CSE estimation */
684 static bool cseCostEstimation (iCode *ic, iCode *pdic)
686 // operand *result = IC_RESULT(ic);
687 // sym_link *result_type = operandType(result);
690 /* VR -- this is an adhoc. Put here after conversation
691 * with Erik Epetrich */
695 || ic->op == EQ_OP) {
697 fprintf(stderr, "%d %s\n", __LINE__, __FUNCTION__);
702 /* if it is a pointer then return ok for now */
703 if (IC_RESULT(ic) && IS_PTR(result_type)) return 1;
705 /* if bitwise | add & subtract then no since mcs51 is pretty good at it
706 so we will cse only if they are local (i.e. both ic & pdic belong to
707 the same basic block */
708 if (IS_BITWISE_OP(ic) || ic->op == '+' || ic->op == '-') {
709 /* then if they are the same Basic block then ok */
710 if (ic->eBBlockNum == pdic->eBBlockNum) return 1;
715 /* for others it is cheaper to do the cse */
721 /* Indicate which extended bit operations this port supports */
723 hasExtBitOp (int op, int size)
727 /* || op == GETHBIT */ /* GETHBIT doesn't look complete for PIC */
734 /* Indicate the expense of an access to an output storage class */
736 oclsExpense (struct memmap *oclass)
738 /* The IN_FARSPACE test is compatible with historical behaviour, */
739 /* but I don't think it is applicable to PIC. If so, please feel */
740 /* free to remove this test -- EEP */
741 if (IN_FARSPACE(oclass))
747 /** $1 is the input object file (PIC16 specific) // >>always the basename<<.
748 $2 is always the output file.
749 $3 -L path and -l libraries
750 $l is the list of extra options that should be there somewhere...
751 MUST be terminated with a NULL.
753 const char *pic16_linkCmd[] =
755 "gplink", "$l", "-o \"$2\"", "\"$1\"","$3", NULL
760 /** $1 is always the basename.
761 $2 is always the output file.
762 $3 varies (nothing currently)
763 $l is the list of extra options that should be there somewhere...
764 MUST be terminated with a NULL.
766 const char *pic16_asmCmd[] =
768 "gpasm", "$l", "$3", "-c", "\"$1.asm\"", "-o \"$2\"", NULL
777 "MCU PIC16", /* Target name */
778 "p18f452", /* Processor */
781 TRUE, /* Emit glue around main */
782 MODEL_SMALL | MODEL_LARGE | MODEL_FLAT24,
786 pic16_asmCmd, /* assembler command and arguments */
787 NULL, /* alternate macro based form */
788 "-g", /* arguments for debug mode */
789 NULL, /* arguments for normal mode */
790 0, /* print externs as global */
791 ".asm", /* assembler file extension */
792 NULL /* no do_assemble function */
795 NULL, // pic16_linkCmd, /* linker command and arguments */
796 NULL, /* alternate macro based form */
797 _pic16_linkEdit, //NULL, /* no do_link function */
798 ".o", /* extension for object files */
799 0 /* no need for linker file */
811 3, /* fptr, far pointers (see Microchip) */
818 "XSEG (XDATA)", // xstack
819 "STACK (DATA)", // istack
820 "CSEG (CODE)", // code
821 "DSEG (DATA)", // data
822 "ISEG (DATA)", // idata
823 "XSEG (XDATA)", // xdata
825 "RSEG (DATA)", // reg
826 "GSINIT (CODE)", // static
827 "OSEG (OVR,DATA)", // overlay
828 "GSFINAL (CODE)", // post static
829 "HOME (CODE)", // home
832 NULL, // default location for auto vars
833 NULL, // default location for global vars
834 1 // code is read only 1=yes
837 NULL, /* genExtraAreaDeclaration */
838 NULL /* genExatrAreaLinkOptions */
841 /* stack related information */
842 -1, /* -1 stack grows downwards, +1 upwards */
843 1, /* extra overhead when calling between banks */
844 4, /* extra overhead when the function is an ISR */
845 1, /* extra overhead for a function call */
846 1, /* re-entrant space */
847 0 /* 'banked' call overhead, mild overlap with bank_overhead */
849 /* pic16 has an 8 bit mul */
854 pic16_emitDebuggerSymbol
861 _pic16_finaliseOptions,
862 _pic16_setDefaultOptions,
863 pic16_assignRegisters,
866 _pic16_genAssemblerPreamble,
867 NULL, /* no genAssemblerEnd */
869 NULL, // _pic16_genXINIT
870 NULL, /* genInitStartup */
871 _pic16_reset_regparm,
873 _process_pragma, /* process a pragma */
874 _pic16_mangleFunctionName, /* mangles function name */
876 hasExtBitOp, /* hasExtBitOp */
877 oclsExpense, /* oclsExpense */
879 TRUE, /* little endian */
882 1, /* transform <= to ! > */
883 1, /* transform >= to ! < */
884 1, /* transform != to !(a == b) */
886 FALSE, /* No array initializer support. */
887 0, //cseCostEstimation, /* !!!no CSE cost estimation yet */
888 NULL, /* no builtin functions */
889 GPOINTER, /* treat unqualified pointers as "generic" pointers */
890 1, /* reset labelKey to 1 */
891 1, /* globals & local static allowed */