xref: /qemu/target/microblaze/cpu.h (revision e3a6e0da)
1 /*
2  *  MicroBlaze virtual CPU header
3  *
4  *  Copyright (c) 2009 Edgar E. Iglesias
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
18  */
19 
20 #ifndef MICROBLAZE_CPU_H
21 #define MICROBLAZE_CPU_H
22 
23 #include "cpu-qom.h"
24 #include "exec/cpu-defs.h"
25 #include "fpu/softfloat-types.h"
26 
27 typedef struct CPUMBState CPUMBState;
28 #if !defined(CONFIG_USER_ONLY)
29 #include "mmu.h"
30 #endif
31 
32 #define EXCP_MMU        1
33 #define EXCP_IRQ        2
34 #define EXCP_SYSCALL    3  /* user-only */
35 #define EXCP_HW_BREAK   4
36 #define EXCP_HW_EXCP    5
37 
38 /* MicroBlaze-specific interrupt pending bits.  */
39 #define CPU_INTERRUPT_NMI       CPU_INTERRUPT_TGT_EXT_3
40 
41 /* Meanings of the MBCPU object's two inbound GPIO lines */
42 #define MB_CPU_IRQ 0
43 #define MB_CPU_FIR 1
44 
45 /* Register aliases. R0 - R15 */
46 #define R_SP     1
47 #define SR_PC    0
48 #define SR_MSR   1
49 #define SR_EAR   3
50 #define SR_ESR   5
51 #define SR_FSR   7
52 #define SR_BTR   0xb
53 #define SR_EDR   0xd
54 
55 /* MSR flags.  */
56 #define MSR_BE  (1<<0) /* 0x001 */
57 #define MSR_IE  (1<<1) /* 0x002 */
58 #define MSR_C   (1<<2) /* 0x004 */
59 #define MSR_BIP (1<<3) /* 0x008 */
60 #define MSR_FSL (1<<4) /* 0x010 */
61 #define MSR_ICE (1<<5) /* 0x020 */
62 #define MSR_DZ  (1<<6) /* 0x040 */
63 #define MSR_DCE (1<<7) /* 0x080 */
64 #define MSR_EE  (1<<8) /* 0x100 */
65 #define MSR_EIP (1<<9) /* 0x200 */
66 #define MSR_PVR (1<<10) /* 0x400 */
67 #define MSR_CC  (1<<31)
68 
69 /* Machine State Register (MSR) Fields */
70 #define MSR_UM (1<<11) /* User Mode */
71 #define MSR_UMS        (1<<12) /* User Mode Save */
72 #define MSR_VM (1<<13) /* Virtual Mode */
73 #define MSR_VMS        (1<<14) /* Virtual Mode Save */
74 
75 #define MSR_KERNEL      MSR_EE|MSR_VM
76 //#define MSR_USER     MSR_KERNEL|MSR_UM|MSR_IE
77 #define MSR_KERNEL_VMS  MSR_EE|MSR_VMS
78 //#define MSR_USER_VMS MSR_KERNEL_VMS|MSR_UMS|MSR_IE
79 
80 /* Exception State Register (ESR) Fields */
81 #define          ESR_DIZ       (1<<11) /* Zone Protection */
82 #define          ESR_W         (1<<11) /* Unaligned word access */
83 #define          ESR_S         (1<<10) /* Store instruction */
84 
85 #define          ESR_ESS_FSL_OFFSET     5
86 
87 #define          ESR_ESS_MASK  (0x7f << 5)
88 
89 #define          ESR_EC_FSL             0
90 #define          ESR_EC_UNALIGNED_DATA  1
91 #define          ESR_EC_ILLEGAL_OP      2
92 #define          ESR_EC_INSN_BUS        3
93 #define          ESR_EC_DATA_BUS        4
94 #define          ESR_EC_DIVZERO         5
95 #define          ESR_EC_FPU             6
96 #define          ESR_EC_PRIVINSN        7
97 #define          ESR_EC_STACKPROT       7  /* Same as PRIVINSN.  */
98 #define          ESR_EC_DATA_STORAGE    8
99 #define          ESR_EC_INSN_STORAGE    9
100 #define          ESR_EC_DATA_TLB        10
101 #define          ESR_EC_INSN_TLB        11
102 #define          ESR_EC_MASK            31
103 
104 /* Floating Point Status Register (FSR) Bits */
105 #define FSR_IO          (1<<4) /* Invalid operation */
106 #define FSR_DZ          (1<<3) /* Divide-by-zero */
107 #define FSR_OF          (1<<2) /* Overflow */
108 #define FSR_UF          (1<<1) /* Underflow */
109 #define FSR_DO          (1<<0) /* Denormalized operand error */
110 
111 /* Version reg.  */
112 /* Basic PVR mask */
113 #define PVR0_PVR_FULL_MASK              0x80000000
114 #define PVR0_USE_BARREL_MASK            0x40000000
115 #define PVR0_USE_DIV_MASK               0x20000000
116 #define PVR0_USE_HW_MUL_MASK            0x10000000
117 #define PVR0_USE_FPU_MASK               0x08000000
118 #define PVR0_USE_EXC_MASK               0x04000000
119 #define PVR0_USE_ICACHE_MASK            0x02000000
120 #define PVR0_USE_DCACHE_MASK            0x01000000
121 #define PVR0_USE_MMU_MASK               0x00800000
122 #define PVR0_USE_BTC			0x00400000
123 #define PVR0_ENDI_MASK                  0x00200000
124 #define PVR0_FAULT			0x00100000
125 #define PVR0_VERSION_MASK               0x0000FF00
126 #define PVR0_USER1_MASK                 0x000000FF
127 #define PVR0_SPROT_MASK                 0x00000001
128 
129 #define PVR0_VERSION_SHIFT              8
130 
131 /* User 2 PVR mask */
132 #define PVR1_USER2_MASK                 0xFFFFFFFF
133 
134 /* Configuration PVR masks */
135 #define PVR2_D_OPB_MASK                 0x80000000
136 #define PVR2_D_LMB_MASK                 0x40000000
137 #define PVR2_I_OPB_MASK                 0x20000000
138 #define PVR2_I_LMB_MASK                 0x10000000
139 #define PVR2_INTERRUPT_IS_EDGE_MASK     0x08000000
140 #define PVR2_EDGE_IS_POSITIVE_MASK      0x04000000
141 #define PVR2_D_PLB_MASK                 0x02000000      /* new */
142 #define PVR2_I_PLB_MASK                 0x01000000      /* new */
143 #define PVR2_INTERCONNECT               0x00800000      /* new */
144 #define PVR2_USE_EXTEND_FSL             0x00080000      /* new */
145 #define PVR2_USE_FSL_EXC                0x00040000      /* new */
146 #define PVR2_USE_MSR_INSTR              0x00020000
147 #define PVR2_USE_PCMP_INSTR             0x00010000
148 #define PVR2_AREA_OPTIMISED             0x00008000
149 #define PVR2_USE_BARREL_MASK            0x00004000
150 #define PVR2_USE_DIV_MASK               0x00002000
151 #define PVR2_USE_HW_MUL_MASK            0x00001000
152 #define PVR2_USE_FPU_MASK               0x00000800
153 #define PVR2_USE_MUL64_MASK             0x00000400
154 #define PVR2_USE_FPU2_MASK              0x00000200      /* new */
155 #define PVR2_USE_IPLBEXC                0x00000100
156 #define PVR2_USE_DPLBEXC                0x00000080
157 #define PVR2_OPCODE_0x0_ILL_MASK        0x00000040
158 #define PVR2_UNALIGNED_EXC_MASK         0x00000020
159 #define PVR2_ILL_OPCODE_EXC_MASK        0x00000010
160 #define PVR2_IOPB_BUS_EXC_MASK          0x00000008
161 #define PVR2_DOPB_BUS_EXC_MASK          0x00000004
162 #define PVR2_DIV_ZERO_EXC_MASK          0x00000002
163 #define PVR2_FPU_EXC_MASK               0x00000001
164 
165 /* Debug and exception PVR masks */
166 #define PVR3_DEBUG_ENABLED_MASK         0x80000000
167 #define PVR3_NUMBER_OF_PC_BRK_MASK      0x1E000000
168 #define PVR3_NUMBER_OF_RD_ADDR_BRK_MASK 0x00380000
169 #define PVR3_NUMBER_OF_WR_ADDR_BRK_MASK 0x0000E000
170 #define PVR3_FSL_LINKS_MASK             0x00000380
171 
172 /* ICache config PVR masks */
173 #define PVR4_USE_ICACHE_MASK            0x80000000
174 #define PVR4_ICACHE_ADDR_TAG_BITS_MASK  0x7C000000
175 #define PVR4_ICACHE_USE_FSL_MASK        0x02000000
176 #define PVR4_ICACHE_ALLOW_WR_MASK       0x01000000
177 #define PVR4_ICACHE_LINE_LEN_MASK       0x00E00000
178 #define PVR4_ICACHE_BYTE_SIZE_MASK      0x001F0000
179 
180 /* DCache config PVR masks */
181 #define PVR5_USE_DCACHE_MASK            0x80000000
182 #define PVR5_DCACHE_ADDR_TAG_BITS_MASK  0x7C000000
183 #define PVR5_DCACHE_USE_FSL_MASK        0x02000000
184 #define PVR5_DCACHE_ALLOW_WR_MASK       0x01000000
185 #define PVR5_DCACHE_LINE_LEN_MASK       0x00E00000
186 #define PVR5_DCACHE_BYTE_SIZE_MASK      0x001F0000
187 #define PVR5_DCACHE_WRITEBACK_MASK      0x00004000
188 
189 /* ICache base address PVR mask */
190 #define PVR6_ICACHE_BASEADDR_MASK       0xFFFFFFFF
191 
192 /* ICache high address PVR mask */
193 #define PVR7_ICACHE_HIGHADDR_MASK       0xFFFFFFFF
194 
195 /* DCache base address PVR mask */
196 #define PVR8_DCACHE_BASEADDR_MASK       0xFFFFFFFF
197 
198 /* DCache high address PVR mask */
199 #define PVR9_DCACHE_HIGHADDR_MASK       0xFFFFFFFF
200 
201 /* Target family PVR mask */
202 #define PVR10_TARGET_FAMILY_MASK        0xFF000000
203 #define PVR10_ASIZE_SHIFT               18
204 
205 /* MMU descrtiption */
206 #define PVR11_USE_MMU                   0xC0000000
207 #define PVR11_MMU_ITLB_SIZE             0x38000000
208 #define PVR11_MMU_DTLB_SIZE             0x07000000
209 #define PVR11_MMU_TLB_ACCESS            0x00C00000
210 #define PVR11_MMU_ZONES                 0x003E0000
211 /* MSR Reset value PVR mask */
212 #define PVR11_MSR_RESET_VALUE_MASK      0x000007FF
213 
214 #define C_PVR_NONE                      0
215 #define C_PVR_BASIC                     1
216 #define C_PVR_FULL                      2
217 
218 /* CPU flags.  */
219 
220 /* Condition codes.  */
221 #define CC_GE  5
222 #define CC_GT  4
223 #define CC_LE  3
224 #define CC_LT  2
225 #define CC_NE  1
226 #define CC_EQ  0
227 
228 #define STREAM_EXCEPTION (1 << 0)
229 #define STREAM_ATOMIC    (1 << 1)
230 #define STREAM_TEST      (1 << 2)
231 #define STREAM_CONTROL   (1 << 3)
232 #define STREAM_NONBLOCK  (1 << 4)
233 
234 #define TARGET_INSN_START_EXTRA_WORDS 1
235 
236 struct CPUMBState {
237     uint32_t bvalue;   /* TCG temporary, only valid during a TB */
238     uint32_t btarget;  /* Full resolved branch destination */
239 
240     uint32_t imm;
241     uint32_t regs[32];
242     uint32_t pc;
243     uint32_t msr;    /* All bits of MSR except MSR[C] and MSR[CC] */
244     uint32_t msr_c;  /* MSR[C], in low bit; other bits must be 0 */
245     target_ulong ear;
246     uint32_t esr;
247     uint32_t fsr;
248     uint32_t btr;
249     uint32_t edr;
250     float_status fp_status;
251     /* Stack protectors. Yes, it's a hw feature.  */
252     uint32_t slr, shr;
253 
254     /* lwx/swx reserved address */
255 #define RES_ADDR_NONE 0xffffffff /* Use 0xffffffff to indicate no reservation */
256     target_ulong res_addr;
257     uint32_t res_val;
258 
259     /* Internal flags.  */
260 #define IMM_FLAG        (1 << 0)
261 #define BIMM_FLAG       (1 << 1)
262 #define ESR_ESS_FLAG    (1 << 2)  /* indicates ESR_ESS_MASK is present */
263 /* MSR_EE               (1 << 8)  -- these 3 are not in iflags but tb_flags */
264 /* MSR_UM               (1 << 11) */
265 /* MSR_VM               (1 << 13) */
266 /* ESR_ESS_MASK         [11:5]    -- unwind into iflags for unaligned excp */
267 #define D_FLAG		(1 << 12)  /* Bit in ESR.  */
268 #define DRTI_FLAG	(1 << 16)
269 #define DRTE_FLAG	(1 << 17)
270 #define DRTB_FLAG	(1 << 18)
271 
272 /* TB dependent CPUMBState.  */
273 #define IFLAGS_TB_MASK  (D_FLAG | BIMM_FLAG | IMM_FLAG | \
274                          DRTI_FLAG | DRTE_FLAG | DRTB_FLAG)
275 #define MSR_TB_MASK     (MSR_UM | MSR_VM | MSR_EE)
276 
277     uint32_t iflags;
278 
279 #if !defined(CONFIG_USER_ONLY)
280     /* Unified MMU.  */
281     MicroBlazeMMU mmu;
282 #endif
283 
284     /* Fields up to this point are cleared by a CPU reset */
285     struct {} end_reset_fields;
286 
287     /* These fields are preserved on reset.  */
288 };
289 
290 /*
291  * Microblaze Configuration Settings
292  *
293  * Note that the structure is sorted by type and size to minimize holes.
294  */
295 typedef struct {
296     char *version;
297 
298     uint64_t addr_mask;
299 
300     uint32_t base_vectors;
301     uint32_t pvr_user2;
302     uint32_t pvr_regs[13];
303 
304     uint8_t addr_size;
305     uint8_t use_fpu;
306     uint8_t use_hw_mul;
307     uint8_t pvr_user1;
308     uint8_t pvr;
309     uint8_t mmu;
310     uint8_t mmu_tlb_access;
311     uint8_t mmu_zones;
312 
313     bool stackprot;
314     bool use_barrel;
315     bool use_div;
316     bool use_msr_instr;
317     bool use_pcmp_instr;
318     bool use_mmu;
319     bool dcache_writeback;
320     bool endi;
321     bool dopb_bus_exception;
322     bool iopb_bus_exception;
323     bool illegal_opcode_exception;
324     bool opcode_0_illegal;
325     bool div_zero_exception;
326     bool unaligned_exceptions;
327 } MicroBlazeCPUConfig;
328 
329 /**
330  * MicroBlazeCPU:
331  * @env: #CPUMBState
332  *
333  * A MicroBlaze CPU.
334  */
335 struct MicroBlazeCPU {
336     /*< private >*/
337     CPUState parent_obj;
338 
339     /*< public >*/
340 
341     CPUNegativeOffsetState neg;
342     CPUMBState env;
343     MicroBlazeCPUConfig cfg;
344 };
345 
346 
347 void mb_cpu_do_interrupt(CPUState *cs);
348 bool mb_cpu_exec_interrupt(CPUState *cs, int int_req);
349 void mb_cpu_do_unaligned_access(CPUState *cs, vaddr vaddr,
350                                 MMUAccessType access_type,
351                                 int mmu_idx, uintptr_t retaddr);
352 void mb_cpu_dump_state(CPUState *cpu, FILE *f, int flags);
353 hwaddr mb_cpu_get_phys_page_debug(CPUState *cpu, vaddr addr);
354 int mb_cpu_gdb_read_register(CPUState *cpu, GByteArray *buf, int reg);
355 int mb_cpu_gdb_write_register(CPUState *cpu, uint8_t *buf, int reg);
356 
357 static inline uint32_t mb_cpu_read_msr(const CPUMBState *env)
358 {
359     /* Replicate MSR[C] to MSR[CC]. */
360     return env->msr | (env->msr_c * (MSR_C | MSR_CC));
361 }
362 
363 static inline void mb_cpu_write_msr(CPUMBState *env, uint32_t val)
364 {
365     env->msr_c = (val >> 2) & 1;
366     /*
367      * Clear both MSR[C] and MSR[CC] from the saved copy.
368      * MSR_PVR is not writable and is always clear.
369      */
370     env->msr = val & ~(MSR_C | MSR_CC | MSR_PVR);
371 }
372 
373 void mb_tcg_init(void);
374 /* you can call this signal handler from your SIGBUS and SIGSEGV
375    signal handlers to inform the virtual CPU of exceptions. non zero
376    is returned if the signal was handled by the virtual CPU.  */
377 int cpu_mb_signal_handler(int host_signum, void *pinfo,
378                           void *puc);
379 
380 #define CPU_RESOLVING_TYPE TYPE_MICROBLAZE_CPU
381 
382 #define cpu_signal_handler cpu_mb_signal_handler
383 
384 /* MMU modes definitions */
385 #define MMU_NOMMU_IDX   0
386 #define MMU_KERNEL_IDX  1
387 #define MMU_USER_IDX    2
388 /* See NB_MMU_MODES further up the file.  */
389 
390 bool mb_cpu_tlb_fill(CPUState *cs, vaddr address, int size,
391                      MMUAccessType access_type, int mmu_idx,
392                      bool probe, uintptr_t retaddr);
393 
394 typedef CPUMBState CPUArchState;
395 typedef MicroBlazeCPU ArchCPU;
396 
397 #include "exec/cpu-all.h"
398 
399 /* Ensure there is no overlap between the two masks. */
400 QEMU_BUILD_BUG_ON(MSR_TB_MASK & IFLAGS_TB_MASK);
401 
402 static inline void cpu_get_tb_cpu_state(CPUMBState *env, target_ulong *pc,
403                                         target_ulong *cs_base, uint32_t *flags)
404 {
405     *pc = env->pc;
406     *flags = (env->iflags & IFLAGS_TB_MASK) | (env->msr & MSR_TB_MASK);
407     *cs_base = (*flags & IMM_FLAG ? env->imm : 0);
408 }
409 
410 #if !defined(CONFIG_USER_ONLY)
411 void mb_cpu_transaction_failed(CPUState *cs, hwaddr physaddr, vaddr addr,
412                                unsigned size, MMUAccessType access_type,
413                                int mmu_idx, MemTxAttrs attrs,
414                                MemTxResult response, uintptr_t retaddr);
415 #endif
416 
417 static inline int cpu_mmu_index(CPUMBState *env, bool ifetch)
418 {
419     MicroBlazeCPU *cpu = env_archcpu(env);
420 
421     /* Are we in nommu mode?.  */
422     if (!(env->msr & MSR_VM) || !cpu->cfg.use_mmu) {
423         return MMU_NOMMU_IDX;
424     }
425 
426     if (env->msr & MSR_UM) {
427         return MMU_USER_IDX;
428     }
429     return MMU_KERNEL_IDX;
430 }
431 
432 #ifndef CONFIG_USER_ONLY
433 extern const VMStateDescription vmstate_mb_cpu;
434 #endif
435 
436 #endif
437