xref: /qemu/target/xtensa/cpu.h (revision 7cef6d686309e2792186504ae17cf4f3eb57ef68)
1 /*
2  * Copyright (c) 2011, Max Filippov, Open Source and Linux Lab.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *     * Redistributions of source code must retain the above copyright
8  *       notice, this list of conditions and the following disclaimer.
9  *     * Redistributions in binary form must reproduce the above copyright
10  *       notice, this list of conditions and the following disclaimer in the
11  *       documentation and/or other materials provided with the distribution.
12  *     * Neither the name of the Open Source and Linux Lab nor the
13  *       names of its contributors may be used to endorse or promote products
14  *       derived from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef XTENSA_CPU_H
29 #define XTENSA_CPU_H
30 
31 #include "cpu-qom.h"
32 #include "qemu/cpu-float.h"
33 #include "exec/cpu-common.h"
34 #include "exec/cpu-defs.h"
35 #include "exec/cpu-interrupt.h"
36 #include "hw/clock.h"
37 #include "xtensa-isa.h"
38 
39 enum {
40     /* Additional instructions */
41     XTENSA_OPTION_CODE_DENSITY,
42     XTENSA_OPTION_LOOP,
43     XTENSA_OPTION_EXTENDED_L32R,
44     XTENSA_OPTION_16_BIT_IMUL,
45     XTENSA_OPTION_32_BIT_IMUL,
46     XTENSA_OPTION_32_BIT_IMUL_HIGH,
47     XTENSA_OPTION_32_BIT_IDIV,
48     XTENSA_OPTION_MAC16,
49     XTENSA_OPTION_MISC_OP_NSA,
50     XTENSA_OPTION_MISC_OP_MINMAX,
51     XTENSA_OPTION_MISC_OP_SEXT,
52     XTENSA_OPTION_MISC_OP_CLAMPS,
53     XTENSA_OPTION_COPROCESSOR,
54     XTENSA_OPTION_BOOLEAN,
55     XTENSA_OPTION_FP_COPROCESSOR,
56     XTENSA_OPTION_DFP_COPROCESSOR,
57     XTENSA_OPTION_DFPU_SINGLE_ONLY,
58     XTENSA_OPTION_MP_SYNCHRO,
59     XTENSA_OPTION_CONDITIONAL_STORE,
60     XTENSA_OPTION_ATOMCTL,
61     XTENSA_OPTION_DEPBITS,
62 
63     /* Interrupts and exceptions */
64     XTENSA_OPTION_EXCEPTION,
65     XTENSA_OPTION_RELOCATABLE_VECTOR,
66     XTENSA_OPTION_UNALIGNED_EXCEPTION,
67     XTENSA_OPTION_INTERRUPT,
68     XTENSA_OPTION_HIGH_PRIORITY_INTERRUPT,
69     XTENSA_OPTION_TIMER_INTERRUPT,
70 
71     /* Local memory */
72     XTENSA_OPTION_ICACHE,
73     XTENSA_OPTION_ICACHE_TEST,
74     XTENSA_OPTION_ICACHE_INDEX_LOCK,
75     XTENSA_OPTION_DCACHE,
76     XTENSA_OPTION_DCACHE_TEST,
77     XTENSA_OPTION_DCACHE_INDEX_LOCK,
78     XTENSA_OPTION_IRAM,
79     XTENSA_OPTION_IROM,
80     XTENSA_OPTION_DRAM,
81     XTENSA_OPTION_DROM,
82     XTENSA_OPTION_XLMI,
83     XTENSA_OPTION_HW_ALIGNMENT,
84     XTENSA_OPTION_MEMORY_ECC_PARITY,
85 
86     /* Memory protection and translation */
87     XTENSA_OPTION_REGION_PROTECTION,
88     XTENSA_OPTION_REGION_TRANSLATION,
89     XTENSA_OPTION_MPU,
90     XTENSA_OPTION_MMU,
91     XTENSA_OPTION_CACHEATTR,
92 
93     /* Other */
94     XTENSA_OPTION_WINDOWED_REGISTER,
95     XTENSA_OPTION_PROCESSOR_INTERFACE,
96     XTENSA_OPTION_MISC_SR,
97     XTENSA_OPTION_THREAD_POINTER,
98     XTENSA_OPTION_PROCESSOR_ID,
99     XTENSA_OPTION_DEBUG,
100     XTENSA_OPTION_TRACE_PORT,
101     XTENSA_OPTION_EXTERN_REGS,
102 };
103 
104 enum {
105     EXPSTATE = 230,
106     THREADPTR = 231,
107     FCR = 232,
108     FSR = 233,
109 };
110 
111 enum {
112     LBEG = 0,
113     LEND = 1,
114     LCOUNT = 2,
115     SAR = 3,
116     BR = 4,
117     LITBASE = 5,
118     SCOMPARE1 = 12,
119     ACCLO = 16,
120     ACCHI = 17,
121     MR = 32,
122     PREFCTL = 40,
123     WINDOW_BASE = 72,
124     WINDOW_START = 73,
125     PTEVADDR = 83,
126     MMID = 89,
127     RASID = 90,
128     MPUENB = 90,
129     ITLBCFG = 91,
130     DTLBCFG = 92,
131     MPUCFG = 92,
132     ERACCESS = 95,
133     IBREAKENABLE = 96,
134     MEMCTL = 97,
135     CACHEATTR = 98,
136     CACHEADRDIS = 98,
137     ATOMCTL = 99,
138     DDR = 104,
139     MEPC = 106,
140     MEPS = 107,
141     MESAVE = 108,
142     MESR = 109,
143     MECR = 110,
144     MEVADDR = 111,
145     IBREAKA = 128,
146     DBREAKA = 144,
147     DBREAKC = 160,
148     CONFIGID0 = 176,
149     EPC1 = 177,
150     DEPC = 192,
151     EPS2 = 194,
152     CONFIGID1 = 208,
153     EXCSAVE1 = 209,
154     CPENABLE = 224,
155     INTSET = 226,
156     INTCLEAR = 227,
157     INTENABLE = 228,
158     PS = 230,
159     VECBASE = 231,
160     EXCCAUSE = 232,
161     DEBUGCAUSE = 233,
162     CCOUNT = 234,
163     PRID = 235,
164     ICOUNT = 236,
165     ICOUNTLEVEL = 237,
166     EXCVADDR = 238,
167     CCOMPARE = 240,
168     MISC = 244,
169 };
170 
171 #define PS_INTLEVEL 0xf
172 #define PS_INTLEVEL_SHIFT 0
173 
174 #define PS_EXCM 0x10
175 #define PS_UM 0x20
176 
177 #define PS_RING 0xc0
178 #define PS_RING_SHIFT 6
179 
180 #define PS_OWB 0xf00
181 #define PS_OWB_SHIFT 8
182 #define PS_OWB_LEN 4
183 
184 #define PS_CALLINC 0x30000
185 #define PS_CALLINC_SHIFT 16
186 #define PS_CALLINC_LEN 2
187 
188 #define PS_WOE 0x40000
189 
190 #define DEBUGCAUSE_IC 0x1
191 #define DEBUGCAUSE_IB 0x2
192 #define DEBUGCAUSE_DB 0x4
193 #define DEBUGCAUSE_BI 0x8
194 #define DEBUGCAUSE_BN 0x10
195 #define DEBUGCAUSE_DI 0x20
196 #define DEBUGCAUSE_DBNUM 0xf00
197 #define DEBUGCAUSE_DBNUM_SHIFT 8
198 
199 #define DBREAKC_SB 0x80000000
200 #define DBREAKC_LB 0x40000000
201 #define DBREAKC_SB_LB (DBREAKC_SB | DBREAKC_LB)
202 #define DBREAKC_MASK 0x3f
203 
204 #define MEMCTL_INIT 0x00800000
205 #define MEMCTL_IUSEWAYS_SHIFT 18
206 #define MEMCTL_IUSEWAYS_LEN 5
207 #define MEMCTL_IUSEWAYS_MASK 0x007c0000
208 #define MEMCTL_DALLOCWAYS_SHIFT 13
209 #define MEMCTL_DALLOCWAYS_LEN 5
210 #define MEMCTL_DALLOCWAYS_MASK 0x0003e000
211 #define MEMCTL_DUSEWAYS_SHIFT 8
212 #define MEMCTL_DUSEWAYS_LEN 5
213 #define MEMCTL_DUSEWAYS_MASK 0x00001f00
214 #define MEMCTL_ISNP 0x4
215 #define MEMCTL_DSNP 0x2
216 #define MEMCTL_IL0EN 0x1
217 
218 #define MAX_INSN_LENGTH 64
219 #define MAX_INSNBUF_LENGTH \
220     ((MAX_INSN_LENGTH + sizeof(xtensa_insnbuf_word) - 1) / \
221      sizeof(xtensa_insnbuf_word))
222 #define MAX_INSN_SLOTS 32
223 #define MAX_OPCODE_ARGS 16
224 #define MAX_NAREG 64
225 #define MAX_NINTERRUPT 32
226 #define MAX_NLEVEL 6
227 #define MAX_NNMI 1
228 #define MAX_NCCOMPARE 3
229 #define MAX_TLB_WAY_SIZE 8
230 #define MAX_NDBREAK 2
231 #define MAX_NIBREAK 2
232 #define MAX_NMEMORY 4
233 #define MAX_MPU_FOREGROUND_SEGMENTS 32
234 
235 #define REGION_PAGE_MASK 0xe0000000
236 
237 #define PAGE_CACHE_MASK    0x700
238 #define PAGE_CACHE_SHIFT   8
239 #define PAGE_CACHE_INVALID 0x000
240 #define PAGE_CACHE_BYPASS  0x100
241 #define PAGE_CACHE_WT      0x200
242 #define PAGE_CACHE_WB      0x400
243 #define PAGE_CACHE_ISOLATE 0x600
244 
245 enum {
246     /* Static vectors */
247     EXC_RESET0,
248     EXC_RESET1,
249     EXC_MEMORY_ERROR,
250 
251     /* Dynamic vectors */
252     EXC_WINDOW_OVERFLOW4,
253     EXC_WINDOW_UNDERFLOW4,
254     EXC_WINDOW_OVERFLOW8,
255     EXC_WINDOW_UNDERFLOW8,
256     EXC_WINDOW_OVERFLOW12,
257     EXC_WINDOW_UNDERFLOW12,
258     EXC_IRQ,
259     EXC_KERNEL,
260     EXC_USER,
261     EXC_DOUBLE,
262     EXC_DEBUG,
263     EXC_MAX
264 };
265 
266 enum {
267     ILLEGAL_INSTRUCTION_CAUSE = 0,
268     SYSCALL_CAUSE,
269     INSTRUCTION_FETCH_ERROR_CAUSE,
270     LOAD_STORE_ERROR_CAUSE,
271     LEVEL1_INTERRUPT_CAUSE,
272     ALLOCA_CAUSE,
273     INTEGER_DIVIDE_BY_ZERO_CAUSE,
274     PC_VALUE_ERROR_CAUSE,
275     PRIVILEGED_CAUSE,
276     LOAD_STORE_ALIGNMENT_CAUSE,
277     EXTERNAL_REG_PRIVILEGE_CAUSE,
278     EXCLUSIVE_ERROR_CAUSE,
279     INSTR_PIF_DATA_ERROR_CAUSE,
280     LOAD_STORE_PIF_DATA_ERROR_CAUSE,
281     INSTR_PIF_ADDR_ERROR_CAUSE,
282     LOAD_STORE_PIF_ADDR_ERROR_CAUSE,
283     INST_TLB_MISS_CAUSE,
284     INST_TLB_MULTI_HIT_CAUSE,
285     INST_FETCH_PRIVILEGE_CAUSE,
286     INST_FETCH_PROHIBITED_CAUSE = 20,
287     LOAD_STORE_TLB_MISS_CAUSE = 24,
288     LOAD_STORE_TLB_MULTI_HIT_CAUSE,
289     LOAD_STORE_PRIVILEGE_CAUSE,
290     LOAD_PROHIBITED_CAUSE = 28,
291     STORE_PROHIBITED_CAUSE,
292 
293     COPROCESSOR0_DISABLED = 32,
294 };
295 
296 typedef enum {
297     INTTYPE_LEVEL,
298     INTTYPE_EDGE,
299     INTTYPE_NMI,
300     INTTYPE_SOFTWARE,
301     INTTYPE_TIMER,
302     INTTYPE_DEBUG,
303     INTTYPE_WRITE_ERR,
304     INTTYPE_PROFILING,
305     INTTYPE_IDMA_DONE,
306     INTTYPE_IDMA_ERR,
307     INTTYPE_GS_ERR,
308     INTTYPE_MAX
309 } interrupt_type;
310 
311 typedef struct CPUArchState CPUXtensaState;
312 
313 typedef struct xtensa_tlb_entry {
314     uint32_t vaddr;
315     uint32_t paddr;
316     uint8_t asid;
317     uint8_t attr;
318     bool variable;
319 } xtensa_tlb_entry;
320 
321 typedef struct xtensa_tlb {
322     unsigned nways;
323     const unsigned way_size[10];
324     bool varway56;
325     unsigned nrefillentries;
326 } xtensa_tlb;
327 
328 typedef struct xtensa_mpu_entry {
329     uint32_t vaddr;
330     uint32_t attr;
331 } xtensa_mpu_entry;
332 
333 typedef struct XtensaGdbReg {
334     int targno;
335     unsigned flags;
336     int type;
337     int group;
338     unsigned size;
339 } XtensaGdbReg;
340 
341 typedef struct XtensaGdbRegmap {
342     int num_regs;
343     int num_core_regs;
344     /* PC + a + ar + sr + ur */
345     XtensaGdbReg reg[1 + 16 + 64 + 256 + 256];
346 } XtensaGdbRegmap;
347 
348 typedef struct XtensaCcompareTimer {
349     CPUXtensaState *env;
350     QEMUTimer *timer;
351 } XtensaCcompareTimer;
352 
353 typedef struct XtensaMemory {
354     unsigned num;
355     struct XtensaMemoryRegion {
356         uint32_t addr;
357         uint32_t size;
358     } location[MAX_NMEMORY];
359 } XtensaMemory;
360 
361 typedef struct opcode_arg {
362     uint32_t imm;
363     uint32_t raw_imm;
364     void *in;
365     void *out;
366     uint32_t num_bits;
367 } OpcodeArg;
368 
369 typedef struct DisasContext DisasContext;
370 typedef void (*XtensaOpcodeOp)(DisasContext *dc, const OpcodeArg arg[],
371                                const uint32_t par[]);
372 typedef uint32_t (*XtensaOpcodeUintTest)(DisasContext *dc,
373                                          const OpcodeArg arg[],
374                                          const uint32_t par[]);
375 
376 enum {
377     XTENSA_OP_ILL = 0x1,
378     XTENSA_OP_PRIVILEGED = 0x2,
379     XTENSA_OP_SYSCALL = 0x4,
380     XTENSA_OP_DEBUG_BREAK = 0x8,
381 
382     XTENSA_OP_OVERFLOW = 0x10,
383     XTENSA_OP_UNDERFLOW = 0x20,
384     XTENSA_OP_ALLOCA = 0x40,
385     XTENSA_OP_COPROCESSOR = 0x80,
386 
387     XTENSA_OP_DIVIDE_BY_ZERO = 0x100,
388 
389     /* Postprocessing flags */
390     XTENSA_OP_CHECK_INTERRUPTS = 0x200,
391     XTENSA_OP_EXIT_TB_M1 = 0x400,
392     XTENSA_OP_EXIT_TB_0 = 0x800,
393     XTENSA_OP_SYNC_REGISTER_WINDOW = 0x1000,
394 
395     XTENSA_OP_POSTPROCESS =
396         XTENSA_OP_CHECK_INTERRUPTS |
397         XTENSA_OP_EXIT_TB_M1 |
398         XTENSA_OP_EXIT_TB_0 |
399         XTENSA_OP_SYNC_REGISTER_WINDOW,
400 
401     XTENSA_OP_NAME_ARRAY = 0x8000,
402 
403     XTENSA_OP_CONTROL_FLOW = 0x10000,
404     XTENSA_OP_STORE = 0x20000,
405     XTENSA_OP_LOAD = 0x40000,
406     XTENSA_OP_LOAD_STORE =
407         XTENSA_OP_LOAD | XTENSA_OP_STORE,
408 };
409 
410 typedef struct XtensaOpcodeOps {
411     const void *name;
412     XtensaOpcodeOp translate;
413     XtensaOpcodeUintTest test_exceptions;
414     XtensaOpcodeUintTest test_overflow;
415     const uint32_t *par;
416     uint32_t op_flags;
417     uint32_t coprocessor;
418 } XtensaOpcodeOps;
419 
420 typedef struct XtensaOpcodeTranslators {
421     unsigned num_opcodes;
422     const XtensaOpcodeOps *opcode;
423 } XtensaOpcodeTranslators;
424 
425 extern const XtensaOpcodeTranslators xtensa_core_opcodes;
426 extern const XtensaOpcodeTranslators xtensa_fpu2000_opcodes;
427 extern const XtensaOpcodeTranslators xtensa_fpu_opcodes;
428 
429 typedef struct XtensaConfig {
430     const char *name;
431     uint64_t options;
432     XtensaGdbRegmap gdb_regmap;
433     unsigned nareg;
434     int excm_level;
435     int ndepc;
436     unsigned inst_fetch_width;
437     unsigned max_insn_size;
438     uint32_t vecbase;
439     uint32_t exception_vector[EXC_MAX];
440     unsigned ninterrupt;
441     unsigned nlevel;
442     unsigned nmi_level;
443     uint32_t interrupt_vector[MAX_NLEVEL + MAX_NNMI + 1];
444     uint32_t level_mask[MAX_NLEVEL + MAX_NNMI + 1];
445     uint32_t inttype_mask[INTTYPE_MAX];
446     struct {
447         uint32_t level;
448         interrupt_type inttype;
449     } interrupt[MAX_NINTERRUPT];
450     unsigned nccompare;
451     uint32_t timerint[MAX_NCCOMPARE];
452     unsigned nextint;
453     unsigned extint[MAX_NINTERRUPT];
454 
455     unsigned debug_level;
456     unsigned nibreak;
457     unsigned ndbreak;
458 
459     unsigned icache_ways;
460     unsigned dcache_ways;
461     unsigned dcache_line_bytes;
462     uint32_t memctl_mask;
463 
464     XtensaMemory instrom;
465     XtensaMemory instram;
466     XtensaMemory datarom;
467     XtensaMemory dataram;
468     XtensaMemory sysrom;
469     XtensaMemory sysram;
470 
471     unsigned hw_version;
472     uint32_t configid[2];
473 
474     void *isa_internal;
475     xtensa_isa isa;
476     XtensaOpcodeOps **opcode_ops;
477     const XtensaOpcodeTranslators **opcode_translators;
478     xtensa_regfile a_regfile;
479     void ***regfile;
480 
481     uint32_t clock_freq_khz;
482 
483     xtensa_tlb itlb;
484     xtensa_tlb dtlb;
485 
486     uint32_t mpu_align;
487     unsigned n_mpu_fg_segments;
488     unsigned n_mpu_bg_segments;
489     const xtensa_mpu_entry *mpu_bg;
490 
491     bool use_first_nan;
492 } XtensaConfig;
493 
494 typedef struct XtensaConfigList {
495     XtensaConfig *config;
496     struct XtensaConfigList *next;
497 } XtensaConfigList;
498 
499 #if HOST_BIG_ENDIAN
500 enum {
501     FP_F32_HIGH,
502     FP_F32_LOW,
503 };
504 #else
505 enum {
506     FP_F32_LOW,
507     FP_F32_HIGH,
508 };
509 #endif
510 
511 struct CPUArchState {
512     const XtensaConfig *config;
513     uint32_t regs[16];
514     uint32_t pc;
515     uint32_t sregs[256];
516     uint32_t uregs[256];
517     uint32_t phys_regs[MAX_NAREG];
518     union {
519         float32 f32[2];
520         float64 f64;
521     } fregs[16];
522     float_status fp_status;
523     uint32_t windowbase_next;
524     uint32_t exclusive_addr;
525     uint32_t exclusive_val;
526 
527 #ifndef CONFIG_USER_ONLY
528     xtensa_tlb_entry itlb[7][MAX_TLB_WAY_SIZE];
529     xtensa_tlb_entry dtlb[10][MAX_TLB_WAY_SIZE];
530     xtensa_mpu_entry mpu_fg[MAX_MPU_FOREGROUND_SEGMENTS];
531     unsigned autorefill_idx;
532     bool runstall;
533     AddressSpace *address_space_er;
534     MemoryRegion *system_er;
535     int pending_irq_level; /* level of last raised IRQ */
536     qemu_irq *irq_inputs;
537     qemu_irq ext_irq_inputs[MAX_NINTERRUPT];
538     qemu_irq runstall_irq;
539     XtensaCcompareTimer ccompare[MAX_NCCOMPARE];
540     uint64_t time_base;
541     uint64_t ccount_time;
542     uint32_t ccount_base;
543 #endif
544 
545     int yield_needed;
546     unsigned static_vectors;
547 
548     /* Watchpoints for DBREAK registers */
549     struct CPUWatchpoint *cpu_watchpoint[MAX_NDBREAK];
550     /* Breakpoints for IBREAK registers */
551     struct CPUBreakpoint *cpu_breakpoint[MAX_NIBREAK];
552 };
553 
554 /**
555  * XtensaCPU:
556  * @env: #CPUXtensaState
557  *
558  * An Xtensa CPU.
559  */
560 struct ArchCPU {
561     CPUState parent_obj;
562 
563     CPUXtensaState env;
564     Clock *clock;
565 };
566 
567 /**
568  * XtensaCPUClass:
569  * @parent_realize: The parent class' realize handler.
570  * @parent_phases: The parent class' reset phase handlers.
571  * @config: The CPU core configuration.
572  *
573  * An Xtensa CPU model.
574  */
575 struct XtensaCPUClass {
576     CPUClass parent_class;
577 
578     DeviceRealize parent_realize;
579     ResettablePhases parent_phases;
580 
581     const XtensaConfig *config;
582 };
583 
584 #ifndef CONFIG_USER_ONLY
585 bool xtensa_cpu_tlb_fill(CPUState *cs, vaddr address, int size,
586                          MMUAccessType access_type, int mmu_idx,
587                          bool probe, uintptr_t retaddr);
588 void xtensa_cpu_do_interrupt(CPUState *cpu);
589 bool xtensa_cpu_exec_interrupt(CPUState *cpu, int interrupt_request);
590 void xtensa_cpu_do_transaction_failed(CPUState *cs, hwaddr physaddr, vaddr addr,
591                                       unsigned size, MMUAccessType access_type,
592                                       int mmu_idx, MemTxAttrs attrs,
593                                       MemTxResult response, uintptr_t retaddr);
594 hwaddr xtensa_cpu_get_phys_page_debug(CPUState *cpu, vaddr addr);
595 bool xtensa_debug_check_breakpoint(CPUState *cs);
596 #endif
597 void xtensa_cpu_dump_state(CPUState *cpu, FILE *f, int flags);
598 void xtensa_count_regs(const XtensaConfig *config,
599                        unsigned *n_regs, unsigned *n_core_regs);
600 int xtensa_cpu_gdb_read_register(CPUState *cpu, GByteArray *buf, int reg);
601 int xtensa_cpu_gdb_write_register(CPUState *cpu, uint8_t *buf, int reg);
602 G_NORETURN void xtensa_cpu_do_unaligned_access(CPUState *cpu, vaddr addr,
603                                                MMUAccessType access_type, int mmu_idx,
604                                                uintptr_t retaddr);
605 
606 #define CPU_RESOLVING_TYPE TYPE_XTENSA_CPU
607 
608 #if TARGET_BIG_ENDIAN
609 #define XTENSA_DEFAULT_CPU_MODEL "fsf"
610 #define XTENSA_DEFAULT_CPU_NOMMU_MODEL "fsf"
611 #else
612 #define XTENSA_DEFAULT_CPU_MODEL "dc232b"
613 #define XTENSA_DEFAULT_CPU_NOMMU_MODEL "de212"
614 #endif
615 #define XTENSA_DEFAULT_CPU_TYPE \
616     XTENSA_CPU_TYPE_NAME(XTENSA_DEFAULT_CPU_MODEL)
617 #define XTENSA_DEFAULT_CPU_NOMMU_TYPE \
618     XTENSA_CPU_TYPE_NAME(XTENSA_DEFAULT_CPU_NOMMU_MODEL)
619 
620 void xtensa_collect_sr_names(const XtensaConfig *config);
621 void xtensa_translate_init(void);
622 void xtensa_translate_code(CPUState *cs, TranslationBlock *tb,
623                            int *max_insns, vaddr pc, void *host_pc);
624 void **xtensa_get_regfile_by_name(const char *name, int entries, int bits);
625 void xtensa_breakpoint_handler(CPUState *cs);
626 void xtensa_register_core(XtensaConfigList *node);
627 void xtensa_sim_open_console(Chardev *chr);
628 void check_interrupts(CPUXtensaState *s);
629 void xtensa_irq_init(CPUXtensaState *env);
630 qemu_irq *xtensa_get_extints(CPUXtensaState *env);
631 qemu_irq xtensa_get_runstall(CPUXtensaState *env);
632 void xtensa_sync_window_from_phys(CPUXtensaState *env);
633 void xtensa_sync_phys_from_window(CPUXtensaState *env);
634 void xtensa_rotate_window(CPUXtensaState *env, uint32_t delta);
635 void xtensa_restore_owb(CPUXtensaState *env);
636 void debug_exception_env(CPUXtensaState *new_env, uint32_t cause);
637 
xtensa_select_static_vectors(CPUXtensaState * env,unsigned n)638 static inline void xtensa_select_static_vectors(CPUXtensaState *env,
639                                                 unsigned n)
640 {
641     assert(n < 2);
642     env->static_vectors = n;
643 }
644 void xtensa_runstall(CPUXtensaState *env, bool runstall);
645 
646 #define XTENSA_OPTION_BIT(opt) (((uint64_t)1) << (opt))
647 #define XTENSA_OPTION_ALL (~(uint64_t)0)
648 
xtensa_option_bits_enabled(const XtensaConfig * config,uint64_t opt)649 static inline bool xtensa_option_bits_enabled(const XtensaConfig *config,
650         uint64_t opt)
651 {
652     return (config->options & opt) != 0;
653 }
654 
xtensa_option_enabled(const XtensaConfig * config,int opt)655 static inline bool xtensa_option_enabled(const XtensaConfig *config, int opt)
656 {
657     return xtensa_option_bits_enabled(config, XTENSA_OPTION_BIT(opt));
658 }
659 
xtensa_get_cintlevel(const CPUXtensaState * env)660 static inline int xtensa_get_cintlevel(const CPUXtensaState *env)
661 {
662     int level = (env->sregs[PS] & PS_INTLEVEL) >> PS_INTLEVEL_SHIFT;
663     if ((env->sregs[PS] & PS_EXCM) && env->config->excm_level > level) {
664         level = env->config->excm_level;
665     }
666     return level;
667 }
668 
xtensa_get_ring(const CPUXtensaState * env)669 static inline int xtensa_get_ring(const CPUXtensaState *env)
670 {
671     if (xtensa_option_bits_enabled(env->config,
672                                    XTENSA_OPTION_BIT(XTENSA_OPTION_MMU) |
673                                    XTENSA_OPTION_BIT(XTENSA_OPTION_MPU))) {
674         return (env->sregs[PS] & PS_RING) >> PS_RING_SHIFT;
675     } else {
676         return 0;
677     }
678 }
679 
xtensa_get_cring(const CPUXtensaState * env)680 static inline int xtensa_get_cring(const CPUXtensaState *env)
681 {
682     if (xtensa_option_bits_enabled(env->config,
683                                    XTENSA_OPTION_BIT(XTENSA_OPTION_MMU) |
684                                    XTENSA_OPTION_BIT(XTENSA_OPTION_MPU)) &&
685         (env->sregs[PS] & PS_EXCM) == 0) {
686         return (env->sregs[PS] & PS_RING) >> PS_RING_SHIFT;
687     } else {
688         return 0;
689     }
690 }
691 
692 #ifndef CONFIG_USER_ONLY
693 int xtensa_get_physical_addr(CPUXtensaState *env, bool update_tlb,
694         uint32_t vaddr, int is_write, int mmu_idx,
695         uint32_t *paddr, uint32_t *page_size, unsigned *access);
696 void reset_mmu(CPUXtensaState *env);
697 void dump_mmu(CPUXtensaState *env);
698 
xtensa_get_er_region(CPUXtensaState * env)699 static inline MemoryRegion *xtensa_get_er_region(CPUXtensaState *env)
700 {
701     return env->system_er;
702 }
703 #else
704 void xtensa_set_abi_call0(void);
705 bool xtensa_abi_call0(void);
706 #endif
707 
xtensa_replicate_windowstart(CPUXtensaState * env)708 static inline uint32_t xtensa_replicate_windowstart(CPUXtensaState *env)
709 {
710     return env->sregs[WINDOW_START] |
711         (env->sregs[WINDOW_START] << env->config->nareg / 4);
712 }
713 
714 /* MMU modes definitions */
715 #define MMU_USER_IDX 3
716 
717 #define XTENSA_TBFLAG_RING_MASK 0x3
718 #define XTENSA_TBFLAG_EXCM 0x4
719 #define XTENSA_TBFLAG_LITBASE 0x8
720 #define XTENSA_TBFLAG_DEBUG 0x10
721 #define XTENSA_TBFLAG_ICOUNT 0x20
722 #define XTENSA_TBFLAG_CPENABLE_MASK 0x3fc0
723 #define XTENSA_TBFLAG_CPENABLE_SHIFT 6
724 #define XTENSA_TBFLAG_WINDOW_MASK 0x18000
725 #define XTENSA_TBFLAG_WINDOW_SHIFT 15
726 #define XTENSA_TBFLAG_YIELD 0x20000
727 #define XTENSA_TBFLAG_CWOE 0x40000
728 #define XTENSA_TBFLAG_CALLINC_MASK 0x180000
729 #define XTENSA_TBFLAG_CALLINC_SHIFT 19
730 
731 #define XTENSA_CSBASE_LEND_MASK 0x0000ffff
732 #define XTENSA_CSBASE_LEND_SHIFT 0
733 #define XTENSA_CSBASE_LBEG_OFF_MASK 0x00ff0000
734 #define XTENSA_CSBASE_LBEG_OFF_SHIFT 16
735 
736 XtensaCPU *xtensa_cpu_create_with_clock(const char *cpu_type,
737                                         Clock *cpu_refclk);
738 
739 /*
740  * Set the NaN propagation rule for future FPU operations:
741  * use_first is true to pick the first NaN as the result if both
742  * inputs are NaNs, false to pick the second.
743  */
744 void xtensa_use_first_nan(CPUXtensaState *env, bool use_first);
745 #endif
746