avr-arch.h revision 1.1.1.1 
1/* Definitions of types that are used to store AVR architecture and
2   device information.
3   Copyright (C) 2012-2013 Free Software Foundation, Inc.
4   Contributed by Georg-Johann Lay (avr@gjlay.de)
5
6This file is part of GCC.
7
8GCC is free software; you can redistribute it and/or modify
9it under the terms of the GNU General Public License as published by
10the Free Software Foundation; either version 3, or (at your option)
11any later version.
12
13GCC is distributed in the hope that it will be useful,
14but WITHOUT ANY WARRANTY; without even the implied warranty of
15MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16GNU General Public License for more details.
17
18You should have received a copy of the GNU General Public License
19along with GCC; see the file COPYING3.  If not see
20<http://www.gnu.org/licenses/>.  */
21
22
23/* This enum supplies indices into the avr_arch_types[] table below. */
24
25enum avr_arch
26{
27  ARCH_UNKNOWN,
28  ARCH_AVR1,
29  ARCH_AVR2,
30  ARCH_AVR25,
31  ARCH_AVR3,
32  ARCH_AVR31,
33  ARCH_AVR35,
34  ARCH_AVR4,
35  ARCH_AVR5,
36  ARCH_AVR51,
37  ARCH_AVR6,
38  ARCH_AVRXMEGA2,
39  ARCH_AVRXMEGA4,
40  ARCH_AVRXMEGA5,
41  ARCH_AVRXMEGA6,
42  ARCH_AVRXMEGA7
43};
44
45
46/* Architecture-specific properties.  */
47
48typedef struct
49{
50  /* Assembler only.  */
51  int asm_only;
52
53  /* Core have 'MUL*' instructions.  */
54  int have_mul;
55
56  /* Core have 'CALL' and 'JMP' instructions.  */
57  int have_jmp_call;
58
59  /* Core have 'MOVW' and 'LPM Rx,Z' instructions.  */
60  int have_movw_lpmx;
61
62  /* Core have 'ELPM' instructions.  */
63  int have_elpm;
64
65  /* Core have 'ELPM Rx,Z' instructions.  */
66  int have_elpmx;
67
68  /* Core have 'EICALL' and 'EIJMP' instructions.  */
69  int have_eijmp_eicall;
70
71  /* This is an XMEGA core.  */
72  int xmega_p;
73
74  /* This core has the RAMPD special function register
75     and thus also the RAMPX, RAMPY and RAMPZ registers.  */
76  int have_rampd;
77
78  /* Default start of data section address for architecture.  */
79  int default_data_section_start;
80
81  /* Offset between SFR address and RAM address:
82     SFR-address = RAM-address - sfr_offset  */
83  int sfr_offset;
84
85  /* Architecture id to built-in define __AVR_ARCH__ (NULL -> no macro) */
86  const char *const macro;
87
88  /* Architecture name.  */
89  const char *const arch_name;
90} avr_arch_t;
91
92
93/* Device-specific properties.  */
94
95typedef struct
96{
97  /* Device name.  */
98  const char *const name;
99
100  /* Index in avr_arch_types[].  */
101  enum avr_arch arch;
102
103  /* Must lie outside user's namespace.  NULL == no macro.  */
104  const char *const macro;
105
106  /* Stack pointer have 8 bits width.  */
107  int short_sp;
108
109  /* Some AVR devices have a core erratum when skipping a 2-word instruction.
110     Skip instructions are:  SBRC, SBRS, SBIC, SBIS, CPSE.
111     Problems will occur with return address is IRQ executes during the
112     skip sequence.
113
114     A support ticket from Atmel returned the following information:
115
116         Subject: (ATTicket:644469) On AVR skip-bug core Erratum
117         From: avr@atmel.com                    Date: 2011-07-27
118         (Please keep the subject when replying to this mail)
119
120         This errata exists only in AT90S8515 and ATmega103 devices.
121
122         For information please refer the following respective errata links
123            http://www.atmel.com/dyn/resources/prod_documents/doc2494.pdf
124            http://www.atmel.com/dyn/resources/prod_documents/doc1436.pdf  */
125
126  /* Core Erratum:  Must not skip 2-word instruction.  */
127  int errata_skip;
128
129  /* Start of data section.  */
130  int data_section_start;
131
132  /* Number of 64k segments in the flash.  */
133  int n_flash;
134
135  /* Name of device library.  */
136  const char *const library_name;
137} avr_mcu_t;
138
139/* Map architecture to its texinfo string.  */
140
141typedef struct
142{
143  /* Architecture ID.  */
144  enum avr_arch arch;
145
146  /* textinfo source to describe the archtiecture.  */
147  const char *texinfo;
148} avr_arch_info_t;
149
150/* Preprocessor macros to define depending on MCU type.  */
151
152extern const avr_arch_t avr_arch_types[];
153extern const avr_arch_t *avr_current_arch;
154
155extern const avr_mcu_t avr_mcu_types[];
156extern const avr_mcu_t *avr_current_device;
157