1 /*-------------------------------------------------------------------------
3 device.c - Accomodates subtle variations in PIC16 devices
5 Written By - Scott Dattalo scott@dattalo.com
6 Ported to PIC16 By - Martin Dubuc m.dubuc@rogers.com
8 This program is free software; you can redistribute it and/or modify it
9 under the terms of the GNU General Public License as published by the
10 Free Software Foundation; either version 2, or (at your option) any
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 -------------------------------------------------------------------------*/
25 VR - Began writing code to make PIC16 C source files independent from
26 the header file (created by the inc2h.pl)
28 - adding maximum RAM memory into PIC_Device structure
34 #include "common.h" // Include everything in the SDCC src directory
43 stats_t statistics = { 0, 0, 0, 0 };
45 #define DEVICE_FILE_NAME "pic16devices.txt"
47 static PIC16_device default_device = {
48 { "p18f452", "18f452", "pic18f452", "f452" },
51 { /* configuration words */
53 { { 0x27, 0, 0xff } /* 1 */ , { 0x0f, 0, 0xff } /* 2 */ ,
54 { 0x0f, 0, 0xff } /* 3 */ , { -1 , 0, 0xff } /* 4 */ ,
55 { 0x01, 0, 0xff } /* 5 */ , { 0x85, 0, 0xff } /* 6 */ ,
56 { -1 , 0, 0xff } /* 7 */ , { 0x0f, 0, 0xff } /* 8 */ ,
57 { 0xc0, 0, 0xff } /* 9 */ , { 0x0f, 0, 0xff } /* a */ ,
58 { 0xe0, 0, 0xff } /* b */ , { 0x0f, 0, 0xff } /* c */ ,
59 { 0x40, 0, 0xff } /* d */ }
63 { { 0, 0 }, { 0, 0 }, { 0, 0 }, { 0, 0 }, { 0, 0 },
64 { 0, 0 }, { 0, 0 }, { 0, 0 } }
69 PIC16_device *pic16 = &default_device;
70 static PIC16_device *devices = NULL;
72 extern set *includeDirsSet;
73 extern set *userIncDirsSet;
75 extern char *iComments2;
77 void pic16_dump_equates(FILE *of, set *equs)
81 r = setFirstItem(equs);
84 fprintf(of, "%s", iComments2);
85 fprintf(of, ";\tEquates to used internal registers\n");
86 fprintf(of, "%s", iComments2);
88 for(; r; r = setNextItem(equs)) {
89 fprintf(of, "%s\tequ\t0x%02x\n", r->name, r->address);
94 void pic16_dump_access(FILE *of, set *section)
98 r = setFirstItem(section);
101 fprintf(of, "%s", iComments2);
102 fprintf(of, ";\tAccess bank symbols\n");
103 fprintf(of, "%s", iComments2);
105 fprintf(of, "\tudata_acs\n");
106 for(; r; r = setNextItem(section)) {
107 fprintf(of, "%s\tres\t%d\n", r->name, r->size);
108 statistics.adsize += r->size;
113 int regCompare(const void *a, const void *b)
115 const regs *const *i = a;
116 const regs *const *j = b;
118 /* sort primarily by the address */
119 if( (*i)->address > (*j)->address)return 1;
120 if( (*i)->address < (*j)->address)return -1;
122 /* and secondarily by size */
123 /* register size sorting may have strange results use with care */
124 if( (*i)->size > (*j)->size)return 1;
125 if( (*i)->size < (*j)->size)return -1;
127 /* finally if in same address and same size sort by name */
128 return (strcmp( (*i)->name, (*j)->name));
133 int symCompare(const void *a, const void *b)
135 const symbol *const *i = a;
136 const symbol *const *j = b;
138 /* sort primarily by the address */
139 if( SPEC_ADDR((*i)->etype) > SPEC_ADDR((*j)->etype))return 1;
140 if( SPEC_ADDR((*i)->etype) < SPEC_ADDR((*j)->etype))return -1;
142 /* and secondarily by size */
143 /* register size sorting may have strange results use with care */
144 if( getSize((*i)->etype) > getSize((*j)->etype))return 1;
145 if( getSize((*i)->etype) < getSize((*j)->etype))return -1;
147 /* finally if in same address and same size sort by name */
148 return (strcmp( (*i)->rname, (*j)->rname));
153 void pic16_dump_usection(FILE *of, set *section, int fix)
155 static int abs_usection_no=0;
156 static unsigned int usection_no=0;
158 unsigned int init_addr, i;
162 /* put all symbols in an array */
163 if (!elementsInSet(section)) return;
164 rlist = Safe_calloc(elementsInSet(section), sizeof(regs *));
166 for(rprev = setFirstItem(section); rprev; rprev = setNextItem(section)) {
167 rlist[i] = rprev; i++;
171 if(rlist)Safe_free(rlist);
175 /* sort symbols according to their address */
176 qsort(rlist, i /*elementsInSet(section)*/, sizeof(regs *), regCompare);
180 #define EMIT_SINGLE_UDATA_SECTION 0
181 #if EMIT_SINGLE_UDATA_SECTION
182 fprintf(of, "\n\n\tudata\n");
183 for(r = setFirstItem(section); r; r = setNextItem(section)) {
184 fprintf(of, "%s\tres\t%d\n", r->name, r->size);
185 statistics.udsize += r->size;
188 for(r = setFirstItem(section); r; r = setNextItem(section)) {
189 //fprintf(of, "\nudata_%s_%s\tudata\n", moduleName, r->name);
190 fprintf(of, "\nudata_%s_%u\tudata\n", moduleName, usection_no++);
191 fprintf(of, "%s\tres\t%d\n", r->name, r->size);
192 statistics.udsize += r->size;
200 init_addr = rlist[j]->address;
201 deb_addr = init_addr;
202 fprintf(of, "\n\nustat_%s_%02d\tudata\t0X%04X\n", moduleName, abs_usection_no++, init_addr);
206 if(j < i-1)r1 = rlist[j+1]; else r1 = NULL;
208 init_addr = r->address;
209 deb_addr = init_addr;
211 if((rprev && (init_addr > (rprev->address + rprev->size)))) {
212 fprintf(of, "\n\nustat_%s_%02d\tudata\t0X%04X\n", moduleName, abs_usection_no++, init_addr);
215 if(r1 && (init_addr == r1->address)) {
216 fprintf(of, "\n%s\tres\t0\n", r->name);
218 fprintf(of, "%s\tres\t%d\n", r->name, r->size);
220 statistics.udsize += r->size;
229 void pic16_dump_gsection(FILE *of, set *sections)
234 for(sname = setFirstItem(sections); sname; sname = setNextItem(sections)) {
235 if(!strcmp(sname->name, "access"))continue;
236 fprintf(of, "\n\n%s\tudata\n", sname->name);
238 for(r=setFirstItem(sname->regsSet); r; r=setNextItem(sname->regsSet)) {
240 fprintf(stderr, "%s:%d emitting variable %s for section %s (%p)\n", __FILE__, __LINE__,
241 r->name, sname->name, sname);
243 fprintf(of, "%s\tres\t%d\n", r->name, r->size);
244 statistics.udsize += r->size;
250 /* forward declaration */
251 void pic16_printIval(symbol * sym, sym_link * type, initList * ilist, char ptype, void *p);
252 extern void pic16_pCodeConstString(char *name, char *value);
254 void pic16_dump_isection(FILE *of, set *section, int fix)
256 static int abs_isection_no=0;
258 unsigned int init_addr, i;
261 /* put all symbols in an array */
262 if (!elementsInSet(section)) return;
263 slist = Safe_calloc(elementsInSet(section), sizeof(symbol *));
265 for(sprev = setFirstItem(section); sprev; sprev = setNextItem(section)) {
266 slist[i] = sprev; i++;
270 if(slist)Safe_free(slist);
274 /* sort symbols according to their address */
275 qsort(slist, i, sizeof(symbol *), symCompare);
280 fprintf(of, "\n\n\tidata\n");
281 for(s = setFirstItem(section); s; s = setNextItem(section)) {
284 fprintf(of, "%s", s->rname);
285 pic16_printIval(s, s->type, s->ival, 'f', (void *)of);
286 pic16_flushDB('f', (void *)of);
288 if (IS_ARRAY (s->type) && IS_CHAR (s->type->next)
289 && SPEC_CVAL (s->etype).v_char) {
291 // fprintf(stderr, "%s:%d printing code string from %s\n", __FILE__, __LINE__, s->rname);
292 pic16_pCodeConstString(s->rname , SPEC_CVAL (s->etype).v_char);
304 init_addr = SPEC_ADDR(slist[j]->etype);
305 fprintf(of, "\n\nistat_%s_%02d\tidata\t0X%04X\n", moduleName, abs_isection_no++, init_addr);
309 if(j < i-1)s1 = slist[j+1]; else s1 = NULL;
311 init_addr = SPEC_ADDR(s->etype);
313 if(sprev && (init_addr > (SPEC_ADDR(sprev->etype) + getSize(sprev->etype)))) {
314 fprintf(of, "\nistat_%s_%02d\tidata\t0X%04X\n", moduleName, abs_isection_no++, init_addr);
318 fprintf(of, "%s", s->rname);
319 pic16_printIval(s, s->type, s->ival, 'f', (void *)of);
320 pic16_flushDB('f', (void *)of);
322 if (IS_ARRAY (s->type) && IS_CHAR (s->type->next)
323 && SPEC_CVAL (s->etype).v_char) {
325 // fprintf(stderr, "%s:%d printing code string from %s\n", __FILE__, __LINE__, s->rname);
326 pic16_pCodeConstString(s->rname , SPEC_CVAL (s->etype).v_char);
340 void pic16_dump_int_registers(FILE *of, set *section)
346 /* put all symbols in an array */
347 if (!elementsInSet(section)) return;
348 rlist = Safe_calloc(elementsInSet(section), sizeof(regs *));
350 for(rprev = setFirstItem(section); rprev; rprev = setNextItem(section)) {
351 rlist[i] = rprev; i++;
354 /* sort symbols according to their address */
355 qsort(rlist, elementsInSet(section), sizeof(regs *), regCompare);
358 if(rlist)Safe_free(rlist);
362 fprintf(of, "\n\n; Internal registers\n");
364 fprintf(of, "%s\tudata_ovr\t0x0000\n", ".registers");
365 for(r = setFirstItem(section); r; r = setNextItem(section)) {
366 fprintf(of, "%s\tres\t%d\n", r->name, r->size);
367 statistics.intsize += r->size;
374 * Find the device structure for the named device.
375 * Consider usind pic16_find_device() instead!
378 * a name for the desired device
380 * a pointer to the head of the list of devices
382 * a pointer to the structure for the desired
385 static PIC16_device *
386 find_in_list(const char *name, PIC16_device *head)
391 for (i = 0; i < 4; i++) {
392 if (0 == strcmp(head->name[i], name)) {
404 * Print a list of supported devices.
405 * If --verbose was given, also emit key characteristics (memory size,
406 * access bank split point, address range of SFRs and config words).
409 * a pointer to the head of the list of devices
412 pic16_list_devices(PIC16_device *head)
416 if (options.verbose) {
417 printf("device RAM split config words\n");
420 printf("%-10s ", head->name[0]);
421 if (options.verbose) {
422 printf("%5d 0x%02x 0x%06x..0x%06x\n",
425 head->cwInfo.confAddrStart,
426 head->cwInfo.confAddrEnd);
439 * Read a single line from the given file.
440 * The caller should free() the returned value!
443 * a pointer to the open file to read
445 * a pointer to a malloc'ed copy of the (next) line, or NULL
448 get_line (FILE *file)
455 while (!feof(file)) {
456 line = (char *) Safe_realloc(line, len);
457 got += fread(&line[done], 1, 128, file);
462 if (('\r' == line[done]) || ('\n' == line[done])) {
464 fseek(file, done + 1 - got, SEEK_CUR);
477 * Truncate the given string in place (!) at the first '#' character (if any).
480 * a pointer to the string to truncate
482 * a pointer to the truncated string (i.e., line)
485 strip_comment (char *line)
494 while (0 != (c = *l)) {
506 * Report errors in the device specification.
509 * a pointer to the detailed message
511 #define SYNTAX(msg) do { \
512 fprintf(stderr, "%s:%d: Syntax error: %s\n", \
513 DEVICE_FILE_NAME, lineno, msg); \
517 * Locate and read in the device specification (if required) and
518 * return the device structure for the named device.
521 * a pointer to the name of the desired device
523 * a pointer to the device structure, or NULL
525 static PIC16_device *
526 pic16_find_device(const char *name)
529 char buffer[PATH_MAX];
531 const char *sep = " \t\n\r";
533 PIC16_device *d = NULL, *template;
534 PIC16_device *head = NULL, *tail = NULL;
535 set *_sets[] = { userIncDirsSet, includeDirsSet };
536 set **sets = &_sets[0];
542 //printf("%s: searching %s\n", __func__, DEVICE_FILE_NAME);
544 // locate the specification file in the include search paths
545 for (i = 0; (NULL == f) && (i < 2); i++) {
546 for (path = setFirstItem(sets[i]);
548 path = setNextItem(sets[i]))
550 SNPRINTF(&buffer[0], PATH_MAX, "%s%s%s",
551 path, DIR_SEPARATOR_STRING, DEVICE_FILE_NAME);
552 //printf("%s: checking %s\n", __func__, &buffer[0]);
553 f = fopen(&buffer[0], "r");
559 // list already set up, nothing to do
560 } else if (NULL == f) {
561 fprintf(stderr, "ERROR: device list %s not found, specify its path via -I<path>\n", DEVICE_FILE_NAME);
564 // parse the specification file and construct a linked list of
567 while (NULL != (line = get_line(f))) {
569 //printf("%s: read %s\n", __func__, line);
571 key = strtok(line, sep);
573 // empty line---ignore
574 } else if (0 == strcmp(key, "name")) {
586 res = sscanf(&line[1+strlen(key)], " %16s", &buffer[3]);
587 if ((1 < res) || (3 > strlen(&buffer[3]))) {
588 SYNTAX("<name> (e.g., 18f452) expected.");
590 d = Safe_calloc(1, sizeof(PIC16_device));
592 // { "p18f452", "18f452", "pic18f452", "f452" }
596 d->name[3] = Safe_strdup(&buffer[5]);
597 d->name[2] = Safe_strdup(&buffer[0]);
598 d->name[1] = Safe_strdup(&buffer[3]);
600 d->name[0] = Safe_strdup(&buffer[2]);
602 } else if (0 == strcmp(key, "using")) {
604 res = sscanf(&line[1+strlen(key)], " %16s", &buffer[0]);
605 if ((1 < res) || (3 > strlen(&buffer[3]))) {
606 SYNTAX("<name> (e.g., 18f452) expected.");
608 template = find_in_list(&buffer[0], head);
610 SYNTAX("<name> (e.g., 18f452) expected.");
612 memcpy(&d->RAMsize, &template->RAMsize,
613 ((char *)&d->next) - ((char *)&d->RAMsize));
616 } else if (0 == strcmp(key, "ramsize")) {
618 res = sscanf(&line[1+strlen(key)], " %i", &val[0]);
620 SYNTAX("<bytes> (e.g., 256) expected.");
624 } else if (0 == strcmp(key, "split")) {
626 res = sscanf(&line[1+strlen(key)], " %i", &val[0]);
628 SYNTAX("<offset> (e.g., 0x80) expected.");
630 d->acsSplitOfs = val[0];
632 } else if (0 == strcmp(key, "configrange")) {
633 // configrange %<first>i %<last>i
634 res = sscanf(&line[1+strlen(key)], " %i %i",
637 SYNTAX("<first> <last> (e.g., 0xf60 0xfff) expected.");
639 d->cwInfo.confAddrStart = val[0];
640 d->cwInfo.confAddrEnd = val[1];
642 } else if (0 == strcmp(key, "configword")) {
643 // configword %<address>i %<mask>i %<value>i
644 res = sscanf(&line[1+strlen(key)], " %i %i %i",
645 &val[0], &val[1], &val[2]);
647 SYNTAX("<address> <mask> <value> (e.g., 0x200001 0x0f 0x07) expected.");
649 val[0] -= d->cwInfo.confAddrStart;
651 || (val[0] > (d->cwInfo.confAddrEnd - d->cwInfo.confAddrStart))
652 || (val[0] >= CONFIGURATION_WORDS))
654 SYNTAX("address out of bounds.");
656 d->cwInfo.crInfo[val[0]].mask = val[1];
657 d->cwInfo.crInfo[val[0]].value = val[2];
660 } else if (0 == strcmp(key, "idlocrange")) {
661 // idlocrange %<first>i %<last>i
662 res = sscanf(&line[1+strlen(key)], " %i %i",
665 SYNTAX("<first> <last> (e.g., 0xf60 0xfff) expected.");
667 d->idInfo.idAddrStart = val[0];
668 d->idInfo.idAddrEnd = val[1];
670 } else if (0 == strcmp(key, "idword")) {
671 // idword %<address>i %<value>i
672 res = sscanf(&line[1+strlen(key)], " %i %i",
675 SYNTAX("<address> <value> (e.g., 0x3fffff 0x00) expected.");
677 val[0] -= d->idInfo.idAddrStart;
679 || (val[0] > (d->idInfo.idAddrEnd - d->idInfo.idAddrStart))
680 || (val[0] >= IDLOCATION_BYTES))
682 SYNTAX("address out of bounds.");
684 d->idInfo.irInfo[val[0]].value = val[1];
688 printf("%s: Invalid keyword in %s ignored: %s\n",
689 __func__, DEVICE_FILE_NAME, key);
709 d = find_in_list(name, devices);
717 /*-----------------------------------------------------------------*
719 *-----------------------------------------------------------------*/
720 void pic16_init_pic(const char *pic_type)
722 pic16 = pic16_find_device(pic_type);
724 if (&default_device == pic16) {
726 fprintf(stderr, "'%s' was not found.\n", pic_type);
728 fprintf(stderr, "No processor has been specified (use -pPROCESSOR_NAME)\n");
732 fprintf(stderr,"Valid devices are (use --verbose for more details):\n");
733 pic16_list_devices(devices);
739 /*-----------------------------------------------------------------*
740 * char *pic16_processor_base_name(void) - Include file is derived from this.
741 *-----------------------------------------------------------------*/
742 char *pic16_processor_base_name(void)
748 return pic16->name[0];
751 #define DEBUG_CHECK 0
754 * return 1 if register wasn't found and added, 0 otherwise
756 int checkAddReg(set **set, regs *reg)
763 fprintf(stderr, "%s: about to insert REGister: %s ... ", __FUNCTION__, reg->name);
766 for(tmp = setFirstItem(*set); tmp; tmp = setNextItem(*set)) {
767 if(!strcmp(tmp->name, reg->name))break;
773 fprintf(stderr, "added\n");
779 fprintf(stderr, "already added\n");
784 int checkAddSym(set **set, symbol *sym)
790 fprintf(stderr, "%s: about to add SYMbol: %s ... ", __FUNCTION__, sym->name);
793 for(tmp = setFirstItem( *set ); tmp; tmp = setNextItem(*set)) {
794 if(!strcmp(tmp->name, sym->name))break;
800 fprintf(stderr, "added\n");
806 fprintf(stderr, "already added\n");
812 int checkSym(set *set, symbol *sym)
819 fprintf(stderr, "%s: about to search for SYMbol: %s ... ", __FUNCTION__, sym->name);
822 for(tmp = setFirstItem( set ); tmp; tmp = setNextItem( set )) {
823 if(!strcmp(tmp->name, sym->name))break;
828 fprintf(stderr, "not found\n");
834 fprintf(stderr, "found\n");
840 /*-----------------------------------------------------------------*
841 * void pic16_groupRegistersInSection - add each register to its *
842 * corresponding section *
843 *-----------------------------------------------------------------*/
844 void pic16_groupRegistersInSection(set *regset)
850 for(reg=setFirstItem(regset); reg; reg = setNextItem(regset)) {
853 fprintf(stderr, "%s:%d group registers in section, reg: %s (used: %d, %p)\n",
854 __FILE__, __LINE__, reg->name, reg->wasUsed, reg);
857 && !(reg->regop && SPEC_EXTR(OP_SYM_ETYPE(reg->regop))))
860 /* avoid grouping registers that have an initial value,
861 * they will be added later in idataSymSet */
862 if(reg->regop && (OP_SYMBOL(reg->regop)->ival && !OP_SYMBOL(reg->regop)->level))
866 fprintf(stderr, "%s:%d register %s alias:%d fix:%d ival=%i level=%i code=%i\n",
867 __FILE__, __LINE__, reg->name, reg->alias, reg->isFixed,
868 (reg->regop?(OP_SYMBOL(reg->regop)->ival?1:0):-1),
869 (reg->regop?(OP_SYMBOL(reg->regop)->level):-1),
870 (reg->regop?(IS_CODE(OP_SYM_ETYPE(reg->regop))):-1) );
874 for(ssym=setFirstItem(sectSyms);ssym;ssym=setNextItem(sectSyms)) {
875 if(!strcmp(ssym->name, reg->name)) {
876 // fprintf(stderr, "%s:%d section found %s (%p) with var %s\n",
877 // __FILE__, __LINE__, ssym->section->name, ssym->section, ssym->name);
878 if(strcmp(ssym->section->name, "access")) {
879 addSet(&ssym->section->regsSet, reg);
890 if(docontinue)continue;
892 // fprintf(stderr, "%s:%d reg: %s\n", __FILE__, __LINE__, reg->name);
894 if(reg->alias == 0x80) {
895 checkAddReg(&pic16_equ_data, reg);
898 checkAddReg(&pic16_fix_udata, reg);
901 if(reg->pc_type == PO_GPR_TEMP)
902 checkAddReg(&pic16_int_regs, reg);
904 if(reg->accessBank) {
905 if(reg->alias != 0x40)
906 checkAddReg(&pic16_acs_udata, reg);
908 checkAddReg(&pic16_rel_udata, reg);
919 /*-----------------------------------------------------------------*
920 * void pic16_assignConfigWordValue(int address, int value)
922 * All high performance RISC CPU PICs have seven config word starting
923 * at address 0x300000.
924 * This routine will assign a value to that address.
926 *-----------------------------------------------------------------*/
927 void pic16_assignConfigWordValue(int address, unsigned int value)
931 for(i=0;i<pic16->cwInfo.confAddrEnd-pic16->cwInfo.confAddrStart+1;i++) {
932 if((address == pic16->cwInfo.confAddrStart+i)
933 && (pic16->cwInfo.crInfo[i].mask != -1)
934 && (pic16->cwInfo.crInfo[i].mask != 0)) {
937 fprintf(stderr, "setting location 0x%X to value 0x%x\tmask: 0x%x\ttest: 0x%x\n",
938 /*address*/ pic16->cwInfo.confAddrStart+i, (~value)&0xff,
939 pic16->cwInfo.crInfo[i].mask,
940 (pic16->cwInfo.crInfo[i].mask) & (~value));
944 if((((pic16->cwInfo.crInfo[i].mask) & (~value))&0xff) != ((~value)&0xff)) {
945 fprintf(stderr, "%s:%d a wrong value has been given for configuration register 0x%x\n",
946 __FILE__, __LINE__, address);
951 pic16->cwInfo.crInfo[i].value = value;
952 pic16->cwInfo.crInfo[i].emit = 1;
958 void pic16_assignIdByteValue(int address, char value)
962 for(i=0;i<pic16->idInfo.idAddrEnd-pic16->idInfo.idAddrStart+1;i++) {
963 if(address == pic16->idInfo.idAddrStart+i) {
964 pic16->idInfo.irInfo[i].value = value;
965 pic16->idInfo.irInfo[i].emit = 1;