armv7m: Remove unused armv7m_nvic_acknowledge_irq() return value
[qemu.git] / hw / intc / armv7m_nvic.c
blob9336bca142d8d7cd03bf3096a570e712b8d17593
1 /*
2 * ARM Nested Vectored Interrupt Controller
4 * Copyright (c) 2006-2007 CodeSourcery.
5 * Written by Paul Brook
7 * This code is licensed under the GPL.
9 * The ARMv7M System controller is fairly tightly tied in with the
10 * NVIC. Much of that is also implemented here.
13 #include "qemu/osdep.h"
14 #include "qapi/error.h"
15 #include "qemu-common.h"
16 #include "cpu.h"
17 #include "hw/sysbus.h"
18 #include "qemu/timer.h"
19 #include "hw/arm/arm.h"
20 #include "target/arm/cpu.h"
21 #include "exec/address-spaces.h"
22 #include "qemu/log.h"
23 #include "trace.h"
25 /* IRQ number counting:
27 * the num-irq property counts the number of external IRQ lines
29 * NVICState::num_irq counts the total number of exceptions
30 * (external IRQs, the 15 internal exceptions including reset,
31 * and one for the unused exception number 0).
33 * NVIC_MAX_IRQ is the highest permitted number of external IRQ lines.
35 * NVIC_MAX_VECTORS is the highest permitted number of exceptions.
37 * Iterating through all exceptions should typically be done with
38 * for (i = 1; i < s->num_irq; i++) to avoid the unused slot 0.
40 * The external qemu_irq lines are the NVIC's external IRQ lines,
41 * so line 0 is exception 16.
43 * In the terminology of the architecture manual, "interrupts" are
44 * a subcategory of exception referring to the external interrupts
45 * (which are exception numbers NVIC_FIRST_IRQ and upward).
46 * For historical reasons QEMU tends to use "interrupt" and
47 * "exception" more or less interchangeably.
49 #define NVIC_FIRST_IRQ 16
50 #define NVIC_MAX_VECTORS 512
51 #define NVIC_MAX_IRQ (NVIC_MAX_VECTORS - NVIC_FIRST_IRQ)
53 /* Effective running priority of the CPU when no exception is active
54 * (higher than the highest possible priority value)
56 #define NVIC_NOEXC_PRIO 0x100
58 typedef struct VecInfo {
59 /* Exception priorities can range from -3 to 255; only the unmodifiable
60 * priority values for RESET, NMI and HardFault can be negative.
62 int16_t prio;
63 uint8_t enabled;
64 uint8_t pending;
65 uint8_t active;
66 uint8_t level; /* exceptions <=15 never set level */
67 } VecInfo;
69 typedef struct NVICState {
70 /*< private >*/
71 SysBusDevice parent_obj;
72 /*< public >*/
74 ARMCPU *cpu;
76 VecInfo vectors[NVIC_MAX_VECTORS];
77 uint32_t prigroup;
79 /* vectpending and exception_prio are both cached state that can
80 * be recalculated from the vectors[] array and the prigroup field.
82 unsigned int vectpending; /* highest prio pending enabled exception */
83 int exception_prio; /* group prio of the highest prio active exception */
85 struct {
86 uint32_t control;
87 uint32_t reload;
88 int64_t tick;
89 QEMUTimer *timer;
90 } systick;
92 MemoryRegion sysregmem;
93 MemoryRegion container;
95 uint32_t num_irq;
96 qemu_irq excpout;
97 qemu_irq sysresetreq;
98 } NVICState;
100 #define TYPE_NVIC "armv7m_nvic"
102 #define NVIC(obj) \
103 OBJECT_CHECK(NVICState, (obj), TYPE_NVIC)
105 static const uint8_t nvic_id[] = {
106 0x00, 0xb0, 0x1b, 0x00, 0x0d, 0xe0, 0x05, 0xb1
109 /* qemu timers run at 1GHz. We want something closer to 1MHz. */
110 #define SYSTICK_SCALE 1000ULL
112 #define SYSTICK_ENABLE (1 << 0)
113 #define SYSTICK_TICKINT (1 << 1)
114 #define SYSTICK_CLKSOURCE (1 << 2)
115 #define SYSTICK_COUNTFLAG (1 << 16)
117 int system_clock_scale;
119 /* Conversion factor from qemu timer to SysTick frequencies. */
120 static inline int64_t systick_scale(NVICState *s)
122 if (s->systick.control & SYSTICK_CLKSOURCE)
123 return system_clock_scale;
124 else
125 return 1000;
128 static void systick_reload(NVICState *s, int reset)
130 /* The Cortex-M3 Devices Generic User Guide says that "When the
131 * ENABLE bit is set to 1, the counter loads the RELOAD value from the
132 * SYST RVR register and then counts down". So, we need to check the
133 * ENABLE bit before reloading the value.
135 if ((s->systick.control & SYSTICK_ENABLE) == 0) {
136 return;
139 if (reset)
140 s->systick.tick = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
141 s->systick.tick += (s->systick.reload + 1) * systick_scale(s);
142 timer_mod(s->systick.timer, s->systick.tick);
145 static void systick_timer_tick(void * opaque)
147 NVICState *s = (NVICState *)opaque;
148 s->systick.control |= SYSTICK_COUNTFLAG;
149 if (s->systick.control & SYSTICK_TICKINT) {
150 /* Trigger the interrupt. */
151 armv7m_nvic_set_pending(s, ARMV7M_EXCP_SYSTICK);
153 if (s->systick.reload == 0) {
154 s->systick.control &= ~SYSTICK_ENABLE;
155 } else {
156 systick_reload(s, 0);
160 static void systick_reset(NVICState *s)
162 s->systick.control = 0;
163 s->systick.reload = 0;
164 s->systick.tick = 0;
165 timer_del(s->systick.timer);
168 static int nvic_pending_prio(NVICState *s)
170 /* return the priority of the current pending interrupt,
171 * or NVIC_NOEXC_PRIO if no interrupt is pending
173 return s->vectpending ? s->vectors[s->vectpending].prio : NVIC_NOEXC_PRIO;
176 /* Return the value of the ISCR RETTOBASE bit:
177 * 1 if there is exactly one active exception
178 * 0 if there is more than one active exception
179 * UNKNOWN if there are no active exceptions (we choose 1,
180 * which matches the choice Cortex-M3 is documented as making).
182 * NB: some versions of the documentation talk about this
183 * counting "active exceptions other than the one shown by IPSR";
184 * this is only different in the obscure corner case where guest
185 * code has manually deactivated an exception and is about
186 * to fail an exception-return integrity check. The definition
187 * above is the one from the v8M ARM ARM and is also in line
188 * with the behaviour documented for the Cortex-M3.
190 static bool nvic_rettobase(NVICState *s)
192 int irq, nhand = 0;
194 for (irq = ARMV7M_EXCP_RESET; irq < s->num_irq; irq++) {
195 if (s->vectors[irq].active) {
196 nhand++;
197 if (nhand == 2) {
198 return 0;
203 return 1;
206 /* Return the value of the ISCR ISRPENDING bit:
207 * 1 if an external interrupt is pending
208 * 0 if no external interrupt is pending
210 static bool nvic_isrpending(NVICState *s)
212 int irq;
214 /* We can shortcut if the highest priority pending interrupt
215 * happens to be external or if there is nothing pending.
217 if (s->vectpending > NVIC_FIRST_IRQ) {
218 return true;
220 if (s->vectpending == 0) {
221 return false;
224 for (irq = NVIC_FIRST_IRQ; irq < s->num_irq; irq++) {
225 if (s->vectors[irq].pending) {
226 return true;
229 return false;
232 /* Return a mask word which clears the subpriority bits from
233 * a priority value for an M-profile exception, leaving only
234 * the group priority.
236 static inline uint32_t nvic_gprio_mask(NVICState *s)
238 return ~0U << (s->prigroup + 1);
241 /* Recompute vectpending and exception_prio */
242 static void nvic_recompute_state(NVICState *s)
244 int i;
245 int pend_prio = NVIC_NOEXC_PRIO;
246 int active_prio = NVIC_NOEXC_PRIO;
247 int pend_irq = 0;
249 for (i = 1; i < s->num_irq; i++) {
250 VecInfo *vec = &s->vectors[i];
252 if (vec->enabled && vec->pending && vec->prio < pend_prio) {
253 pend_prio = vec->prio;
254 pend_irq = i;
256 if (vec->active && vec->prio < active_prio) {
257 active_prio = vec->prio;
261 s->vectpending = pend_irq;
262 s->exception_prio = active_prio & nvic_gprio_mask(s);
264 trace_nvic_recompute_state(s->vectpending, s->exception_prio);
267 /* Return the current execution priority of the CPU
268 * (equivalent to the pseudocode ExecutionPriority function).
269 * This is a value between -2 (NMI priority) and NVIC_NOEXC_PRIO.
271 static inline int nvic_exec_prio(NVICState *s)
273 CPUARMState *env = &s->cpu->env;
274 int running;
276 if (env->daif & PSTATE_F) { /* FAULTMASK */
277 running = -1;
278 } else if (env->daif & PSTATE_I) { /* PRIMASK */
279 running = 0;
280 } else if (env->v7m.basepri > 0) {
281 running = env->v7m.basepri & nvic_gprio_mask(s);
282 } else {
283 running = NVIC_NOEXC_PRIO; /* lower than any possible priority */
285 /* consider priority of active handler */
286 return MIN(running, s->exception_prio);
289 bool armv7m_nvic_can_take_pending_exception(void *opaque)
291 NVICState *s = opaque;
293 return nvic_exec_prio(s) > nvic_pending_prio(s);
296 /* caller must call nvic_irq_update() after this */
297 static void set_prio(NVICState *s, unsigned irq, uint8_t prio)
299 assert(irq > ARMV7M_EXCP_NMI); /* only use for configurable prios */
300 assert(irq < s->num_irq);
302 s->vectors[irq].prio = prio;
304 trace_nvic_set_prio(irq, prio);
307 /* Recompute state and assert irq line accordingly.
308 * Must be called after changes to:
309 * vec->active, vec->enabled, vec->pending or vec->prio for any vector
310 * prigroup
312 static void nvic_irq_update(NVICState *s)
314 int lvl;
315 int pend_prio;
317 nvic_recompute_state(s);
318 pend_prio = nvic_pending_prio(s);
320 /* Raise NVIC output if this IRQ would be taken, except that we
321 * ignore the effects of the BASEPRI, FAULTMASK and PRIMASK (which
322 * will be checked for in arm_v7m_cpu_exec_interrupt()); changes
323 * to those CPU registers don't cause us to recalculate the NVIC
324 * pending info.
326 lvl = (pend_prio < s->exception_prio);
327 trace_nvic_irq_update(s->vectpending, pend_prio, s->exception_prio, lvl);
328 qemu_set_irq(s->excpout, lvl);
331 static void armv7m_nvic_clear_pending(void *opaque, int irq)
333 NVICState *s = (NVICState *)opaque;
334 VecInfo *vec;
336 assert(irq > ARMV7M_EXCP_RESET && irq < s->num_irq);
338 vec = &s->vectors[irq];
339 trace_nvic_clear_pending(irq, vec->enabled, vec->prio);
340 if (vec->pending) {
341 vec->pending = 0;
342 nvic_irq_update(s);
346 void armv7m_nvic_set_pending(void *opaque, int irq)
348 NVICState *s = (NVICState *)opaque;
349 VecInfo *vec;
351 assert(irq > ARMV7M_EXCP_RESET && irq < s->num_irq);
353 vec = &s->vectors[irq];
354 trace_nvic_set_pending(irq, vec->enabled, vec->prio);
357 if (irq >= ARMV7M_EXCP_HARD && irq < ARMV7M_EXCP_PENDSV) {
358 /* If a synchronous exception is pending then it may be
359 * escalated to HardFault if:
360 * * it is equal or lower priority to current execution
361 * * it is disabled
362 * (ie we need to take it immediately but we can't do so).
363 * Asynchronous exceptions (and interrupts) simply remain pending.
365 * For QEMU, we don't have any imprecise (asynchronous) faults,
366 * so we can assume that PREFETCH_ABORT and DATA_ABORT are always
367 * synchronous.
368 * Debug exceptions are awkward because only Debug exceptions
369 * resulting from the BKPT instruction should be escalated,
370 * but we don't currently implement any Debug exceptions other
371 * than those that result from BKPT, so we treat all debug exceptions
372 * as needing escalation.
374 * This all means we can identify whether to escalate based only on
375 * the exception number and don't (yet) need the caller to explicitly
376 * tell us whether this exception is synchronous or not.
378 int running = nvic_exec_prio(s);
379 bool escalate = false;
381 if (vec->prio >= running) {
382 trace_nvic_escalate_prio(irq, vec->prio, running);
383 escalate = true;
384 } else if (!vec->enabled) {
385 trace_nvic_escalate_disabled(irq);
386 escalate = true;
389 if (escalate) {
390 if (running < 0) {
391 /* We want to escalate to HardFault but we can't take a
392 * synchronous HardFault at this point either. This is a
393 * Lockup condition due to a guest bug. We don't model
394 * Lockup, so report via cpu_abort() instead.
396 cpu_abort(&s->cpu->parent_obj,
397 "Lockup: can't escalate %d to HardFault "
398 "(current priority %d)\n", irq, running);
401 /* We can do the escalation, so we take HardFault instead */
402 irq = ARMV7M_EXCP_HARD;
403 vec = &s->vectors[irq];
404 s->cpu->env.v7m.hfsr |= R_V7M_HFSR_FORCED_MASK;
408 if (!vec->pending) {
409 vec->pending = 1;
410 nvic_irq_update(s);
414 /* Make pending IRQ active. */
415 void armv7m_nvic_acknowledge_irq(void *opaque)
417 NVICState *s = (NVICState *)opaque;
418 CPUARMState *env = &s->cpu->env;
419 const int pending = s->vectpending;
420 const int running = nvic_exec_prio(s);
421 int pendgroupprio;
422 VecInfo *vec;
424 assert(pending > ARMV7M_EXCP_RESET && pending < s->num_irq);
426 vec = &s->vectors[pending];
428 assert(vec->enabled);
429 assert(vec->pending);
431 pendgroupprio = vec->prio & nvic_gprio_mask(s);
432 assert(pendgroupprio < running);
434 trace_nvic_acknowledge_irq(pending, vec->prio);
436 vec->active = 1;
437 vec->pending = 0;
439 env->v7m.exception = s->vectpending;
441 nvic_irq_update(s);
444 void armv7m_nvic_complete_irq(void *opaque, int irq)
446 NVICState *s = (NVICState *)opaque;
447 VecInfo *vec;
449 assert(irq > ARMV7M_EXCP_RESET && irq < s->num_irq);
451 vec = &s->vectors[irq];
453 trace_nvic_complete_irq(irq);
455 vec->active = 0;
456 if (vec->level) {
457 /* Re-pend the exception if it's still held high; only
458 * happens for extenal IRQs
460 assert(irq >= NVIC_FIRST_IRQ);
461 vec->pending = 1;
464 nvic_irq_update(s);
467 /* callback when external interrupt line is changed */
468 static void set_irq_level(void *opaque, int n, int level)
470 NVICState *s = opaque;
471 VecInfo *vec;
473 n += NVIC_FIRST_IRQ;
475 assert(n >= NVIC_FIRST_IRQ && n < s->num_irq);
477 trace_nvic_set_irq_level(n, level);
479 /* The pending status of an external interrupt is
480 * latched on rising edge and exception handler return.
482 * Pulsing the IRQ will always run the handler
483 * once, and the handler will re-run until the
484 * level is low when the handler completes.
486 vec = &s->vectors[n];
487 if (level != vec->level) {
488 vec->level = level;
489 if (level) {
490 armv7m_nvic_set_pending(s, n);
495 static uint32_t nvic_readl(NVICState *s, uint32_t offset)
497 ARMCPU *cpu = s->cpu;
498 uint32_t val;
500 switch (offset) {
501 case 4: /* Interrupt Control Type. */
502 return ((s->num_irq - NVIC_FIRST_IRQ) / 32) - 1;
503 case 0x10: /* SysTick Control and Status. */
504 val = s->systick.control;
505 s->systick.control &= ~SYSTICK_COUNTFLAG;
506 return val;
507 case 0x14: /* SysTick Reload Value. */
508 return s->systick.reload;
509 case 0x18: /* SysTick Current Value. */
511 int64_t t;
512 if ((s->systick.control & SYSTICK_ENABLE) == 0)
513 return 0;
514 t = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
515 if (t >= s->systick.tick)
516 return 0;
517 val = ((s->systick.tick - (t + 1)) / systick_scale(s)) + 1;
518 /* The interrupt in triggered when the timer reaches zero.
519 However the counter is not reloaded until the next clock
520 tick. This is a hack to return zero during the first tick. */
521 if (val > s->systick.reload)
522 val = 0;
523 return val;
525 case 0x1c: /* SysTick Calibration Value. */
526 return 10000;
527 case 0xd00: /* CPUID Base. */
528 return cpu->midr;
529 case 0xd04: /* Interrupt Control State. */
530 /* VECTACTIVE */
531 val = cpu->env.v7m.exception;
532 /* VECTPENDING */
533 val |= (s->vectpending & 0xff) << 12;
534 /* ISRPENDING - set if any external IRQ is pending */
535 if (nvic_isrpending(s)) {
536 val |= (1 << 22);
538 /* RETTOBASE - set if only one handler is active */
539 if (nvic_rettobase(s)) {
540 val |= (1 << 11);
542 /* PENDSTSET */
543 if (s->vectors[ARMV7M_EXCP_SYSTICK].pending) {
544 val |= (1 << 26);
546 /* PENDSVSET */
547 if (s->vectors[ARMV7M_EXCP_PENDSV].pending) {
548 val |= (1 << 28);
550 /* NMIPENDSET */
551 if (s->vectors[ARMV7M_EXCP_NMI].pending) {
552 val |= (1 << 31);
554 /* ISRPREEMPT not implemented */
555 return val;
556 case 0xd08: /* Vector Table Offset. */
557 return cpu->env.v7m.vecbase;
558 case 0xd0c: /* Application Interrupt/Reset Control. */
559 return 0xfa050000 | (s->prigroup << 8);
560 case 0xd10: /* System Control. */
561 /* TODO: Implement SLEEPONEXIT. */
562 return 0;
563 case 0xd14: /* Configuration Control. */
564 return cpu->env.v7m.ccr;
565 case 0xd24: /* System Handler Status. */
566 val = 0;
567 if (s->vectors[ARMV7M_EXCP_MEM].active) {
568 val |= (1 << 0);
570 if (s->vectors[ARMV7M_EXCP_BUS].active) {
571 val |= (1 << 1);
573 if (s->vectors[ARMV7M_EXCP_USAGE].active) {
574 val |= (1 << 3);
576 if (s->vectors[ARMV7M_EXCP_SVC].active) {
577 val |= (1 << 7);
579 if (s->vectors[ARMV7M_EXCP_DEBUG].active) {
580 val |= (1 << 8);
582 if (s->vectors[ARMV7M_EXCP_PENDSV].active) {
583 val |= (1 << 10);
585 if (s->vectors[ARMV7M_EXCP_SYSTICK].active) {
586 val |= (1 << 11);
588 if (s->vectors[ARMV7M_EXCP_USAGE].pending) {
589 val |= (1 << 12);
591 if (s->vectors[ARMV7M_EXCP_MEM].pending) {
592 val |= (1 << 13);
594 if (s->vectors[ARMV7M_EXCP_BUS].pending) {
595 val |= (1 << 14);
597 if (s->vectors[ARMV7M_EXCP_SVC].pending) {
598 val |= (1 << 15);
600 if (s->vectors[ARMV7M_EXCP_MEM].enabled) {
601 val |= (1 << 16);
603 if (s->vectors[ARMV7M_EXCP_BUS].enabled) {
604 val |= (1 << 17);
606 if (s->vectors[ARMV7M_EXCP_USAGE].enabled) {
607 val |= (1 << 18);
609 return val;
610 case 0xd28: /* Configurable Fault Status. */
611 return cpu->env.v7m.cfsr;
612 case 0xd2c: /* Hard Fault Status. */
613 return cpu->env.v7m.hfsr;
614 case 0xd30: /* Debug Fault Status. */
615 return cpu->env.v7m.dfsr;
616 case 0xd34: /* MMFAR MemManage Fault Address */
617 return cpu->env.v7m.mmfar;
618 case 0xd38: /* Bus Fault Address. */
619 return cpu->env.v7m.bfar;
620 case 0xd3c: /* Aux Fault Status. */
621 /* TODO: Implement fault status registers. */
622 qemu_log_mask(LOG_UNIMP,
623 "Aux Fault status registers unimplemented\n");
624 return 0;
625 case 0xd40: /* PFR0. */
626 return 0x00000030;
627 case 0xd44: /* PRF1. */
628 return 0x00000200;
629 case 0xd48: /* DFR0. */
630 return 0x00100000;
631 case 0xd4c: /* AFR0. */
632 return 0x00000000;
633 case 0xd50: /* MMFR0. */
634 return 0x00000030;
635 case 0xd54: /* MMFR1. */
636 return 0x00000000;
637 case 0xd58: /* MMFR2. */
638 return 0x00000000;
639 case 0xd5c: /* MMFR3. */
640 return 0x00000000;
641 case 0xd60: /* ISAR0. */
642 return 0x01141110;
643 case 0xd64: /* ISAR1. */
644 return 0x02111000;
645 case 0xd68: /* ISAR2. */
646 return 0x21112231;
647 case 0xd6c: /* ISAR3. */
648 return 0x01111110;
649 case 0xd70: /* ISAR4. */
650 return 0x01310102;
651 /* TODO: Implement debug registers. */
652 default:
653 qemu_log_mask(LOG_GUEST_ERROR, "NVIC: Bad read offset 0x%x\n", offset);
654 return 0;
658 static void nvic_writel(NVICState *s, uint32_t offset, uint32_t value)
660 ARMCPU *cpu = s->cpu;
661 uint32_t oldval;
662 switch (offset) {
663 case 0x10: /* SysTick Control and Status. */
664 oldval = s->systick.control;
665 s->systick.control &= 0xfffffff8;
666 s->systick.control |= value & 7;
667 if ((oldval ^ value) & SYSTICK_ENABLE) {
668 int64_t now = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
669 if (value & SYSTICK_ENABLE) {
670 if (s->systick.tick) {
671 s->systick.tick += now;
672 timer_mod(s->systick.timer, s->systick.tick);
673 } else {
674 systick_reload(s, 1);
676 } else {
677 timer_del(s->systick.timer);
678 s->systick.tick -= now;
679 if (s->systick.tick < 0)
680 s->systick.tick = 0;
682 } else if ((oldval ^ value) & SYSTICK_CLKSOURCE) {
683 /* This is a hack. Force the timer to be reloaded
684 when the reference clock is changed. */
685 systick_reload(s, 1);
687 break;
688 case 0x14: /* SysTick Reload Value. */
689 s->systick.reload = value;
690 break;
691 case 0x18: /* SysTick Current Value. Writes reload the timer. */
692 systick_reload(s, 1);
693 s->systick.control &= ~SYSTICK_COUNTFLAG;
694 break;
695 case 0xd04: /* Interrupt Control State. */
696 if (value & (1 << 31)) {
697 armv7m_nvic_set_pending(s, ARMV7M_EXCP_NMI);
699 if (value & (1 << 28)) {
700 armv7m_nvic_set_pending(s, ARMV7M_EXCP_PENDSV);
701 } else if (value & (1 << 27)) {
702 armv7m_nvic_clear_pending(s, ARMV7M_EXCP_PENDSV);
704 if (value & (1 << 26)) {
705 armv7m_nvic_set_pending(s, ARMV7M_EXCP_SYSTICK);
706 } else if (value & (1 << 25)) {
707 armv7m_nvic_clear_pending(s, ARMV7M_EXCP_SYSTICK);
709 break;
710 case 0xd08: /* Vector Table Offset. */
711 cpu->env.v7m.vecbase = value & 0xffffff80;
712 break;
713 case 0xd0c: /* Application Interrupt/Reset Control. */
714 if ((value >> 16) == 0x05fa) {
715 if (value & 4) {
716 qemu_irq_pulse(s->sysresetreq);
718 if (value & 2) {
719 qemu_log_mask(LOG_UNIMP, "VECTCLRACTIVE unimplemented\n");
721 if (value & 1) {
722 qemu_log_mask(LOG_UNIMP, "AIRCR system reset unimplemented\n");
724 s->prigroup = extract32(value, 8, 3);
725 nvic_irq_update(s);
727 break;
728 case 0xd10: /* System Control. */
729 /* TODO: Implement control registers. */
730 qemu_log_mask(LOG_UNIMP, "NVIC: SCR unimplemented\n");
731 break;
732 case 0xd14: /* Configuration Control. */
733 /* Enforce RAZ/WI on reserved and must-RAZ/WI bits */
734 value &= (R_V7M_CCR_STKALIGN_MASK |
735 R_V7M_CCR_BFHFNMIGN_MASK |
736 R_V7M_CCR_DIV_0_TRP_MASK |
737 R_V7M_CCR_UNALIGN_TRP_MASK |
738 R_V7M_CCR_USERSETMPEND_MASK |
739 R_V7M_CCR_NONBASETHRDENA_MASK);
741 cpu->env.v7m.ccr = value;
742 break;
743 case 0xd24: /* System Handler Control. */
744 /* TODO: Real hardware allows you to set/clear the active bits
745 under some circumstances. We don't implement this. */
746 s->vectors[ARMV7M_EXCP_MEM].enabled = (value & (1 << 16)) != 0;
747 s->vectors[ARMV7M_EXCP_BUS].enabled = (value & (1 << 17)) != 0;
748 s->vectors[ARMV7M_EXCP_USAGE].enabled = (value & (1 << 18)) != 0;
749 nvic_irq_update(s);
750 break;
751 case 0xd28: /* Configurable Fault Status. */
752 cpu->env.v7m.cfsr &= ~value; /* W1C */
753 break;
754 case 0xd2c: /* Hard Fault Status. */
755 cpu->env.v7m.hfsr &= ~value; /* W1C */
756 break;
757 case 0xd30: /* Debug Fault Status. */
758 cpu->env.v7m.dfsr &= ~value; /* W1C */
759 break;
760 case 0xd34: /* Mem Manage Address. */
761 cpu->env.v7m.mmfar = value;
762 return;
763 case 0xd38: /* Bus Fault Address. */
764 cpu->env.v7m.bfar = value;
765 return;
766 case 0xd3c: /* Aux Fault Status. */
767 qemu_log_mask(LOG_UNIMP,
768 "NVIC: Aux fault status registers unimplemented\n");
769 break;
770 case 0xf00: /* Software Triggered Interrupt Register */
772 /* user mode can only write to STIR if CCR.USERSETMPEND permits it */
773 int excnum = (value & 0x1ff) + NVIC_FIRST_IRQ;
774 if (excnum < s->num_irq &&
775 (arm_current_el(&cpu->env) ||
776 (cpu->env.v7m.ccr & R_V7M_CCR_USERSETMPEND_MASK))) {
777 armv7m_nvic_set_pending(s, excnum);
779 break;
781 default:
782 qemu_log_mask(LOG_GUEST_ERROR,
783 "NVIC: Bad write offset 0x%x\n", offset);
787 static uint64_t nvic_sysreg_read(void *opaque, hwaddr addr,
788 unsigned size)
790 NVICState *s = (NVICState *)opaque;
791 uint32_t offset = addr;
792 unsigned i, startvec, end;
793 uint32_t val;
795 switch (offset) {
796 /* reads of set and clear both return the status */
797 case 0x100 ... 0x13f: /* NVIC Set enable */
798 offset += 0x80;
799 /* fall through */
800 case 0x180 ... 0x1bf: /* NVIC Clear enable */
801 val = 0;
802 startvec = offset - 0x180 + NVIC_FIRST_IRQ; /* vector # */
804 for (i = 0, end = size * 8; i < end && startvec + i < s->num_irq; i++) {
805 if (s->vectors[startvec + i].enabled) {
806 val |= (1 << i);
809 break;
810 case 0x200 ... 0x23f: /* NVIC Set pend */
811 offset += 0x80;
812 /* fall through */
813 case 0x280 ... 0x2bf: /* NVIC Clear pend */
814 val = 0;
815 startvec = offset - 0x280 + NVIC_FIRST_IRQ; /* vector # */
816 for (i = 0, end = size * 8; i < end && startvec + i < s->num_irq; i++) {
817 if (s->vectors[startvec + i].pending) {
818 val |= (1 << i);
821 break;
822 case 0x300 ... 0x33f: /* NVIC Active */
823 val = 0;
824 startvec = offset - 0x300 + NVIC_FIRST_IRQ; /* vector # */
826 for (i = 0, end = size * 8; i < end && startvec + i < s->num_irq; i++) {
827 if (s->vectors[startvec + i].active) {
828 val |= (1 << i);
831 break;
832 case 0x400 ... 0x5ef: /* NVIC Priority */
833 val = 0;
834 startvec = offset - 0x400 + NVIC_FIRST_IRQ; /* vector # */
836 for (i = 0; i < size && startvec + i < s->num_irq; i++) {
837 val |= s->vectors[startvec + i].prio << (8 * i);
839 break;
840 case 0xd18 ... 0xd23: /* System Handler Priority. */
841 val = 0;
842 for (i = 0; i < size; i++) {
843 val |= s->vectors[(offset - 0xd14) + i].prio << (i * 8);
845 break;
846 case 0xfe0 ... 0xfff: /* ID. */
847 if (offset & 3) {
848 val = 0;
849 } else {
850 val = nvic_id[(offset - 0xfe0) >> 2];
852 break;
853 default:
854 if (size == 4) {
855 val = nvic_readl(s, offset);
856 } else {
857 qemu_log_mask(LOG_GUEST_ERROR,
858 "NVIC: Bad read of size %d at offset 0x%x\n",
859 size, offset);
860 val = 0;
864 trace_nvic_sysreg_read(addr, val, size);
865 return val;
868 static void nvic_sysreg_write(void *opaque, hwaddr addr,
869 uint64_t value, unsigned size)
871 NVICState *s = (NVICState *)opaque;
872 uint32_t offset = addr;
873 unsigned i, startvec, end;
874 unsigned setval = 0;
876 trace_nvic_sysreg_write(addr, value, size);
878 switch (offset) {
879 case 0x100 ... 0x13f: /* NVIC Set enable */
880 offset += 0x80;
881 setval = 1;
882 /* fall through */
883 case 0x180 ... 0x1bf: /* NVIC Clear enable */
884 startvec = 8 * (offset - 0x180) + NVIC_FIRST_IRQ;
886 for (i = 0, end = size * 8; i < end && startvec + i < s->num_irq; i++) {
887 if (value & (1 << i)) {
888 s->vectors[startvec + i].enabled = setval;
891 nvic_irq_update(s);
892 return;
893 case 0x200 ... 0x23f: /* NVIC Set pend */
894 /* the special logic in armv7m_nvic_set_pending()
895 * is not needed since IRQs are never escalated
897 offset += 0x80;
898 setval = 1;
899 /* fall through */
900 case 0x280 ... 0x2bf: /* NVIC Clear pend */
901 startvec = 8 * (offset - 0x280) + NVIC_FIRST_IRQ; /* vector # */
903 for (i = 0, end = size * 8; i < end && startvec + i < s->num_irq; i++) {
904 if (value & (1 << i)) {
905 s->vectors[startvec + i].pending = setval;
908 nvic_irq_update(s);
909 return;
910 case 0x300 ... 0x33f: /* NVIC Active */
911 return; /* R/O */
912 case 0x400 ... 0x5ef: /* NVIC Priority */
913 startvec = 8 * (offset - 0x400) + NVIC_FIRST_IRQ; /* vector # */
915 for (i = 0; i < size && startvec + i < s->num_irq; i++) {
916 set_prio(s, startvec + i, (value >> (i * 8)) & 0xff);
918 nvic_irq_update(s);
919 return;
920 case 0xd18 ... 0xd23: /* System Handler Priority. */
921 for (i = 0; i < size; i++) {
922 unsigned hdlidx = (offset - 0xd14) + i;
923 set_prio(s, hdlidx, (value >> (i * 8)) & 0xff);
925 nvic_irq_update(s);
926 return;
928 if (size == 4) {
929 nvic_writel(s, offset, value);
930 return;
932 qemu_log_mask(LOG_GUEST_ERROR,
933 "NVIC: Bad write of size %d at offset 0x%x\n", size, offset);
936 static const MemoryRegionOps nvic_sysreg_ops = {
937 .read = nvic_sysreg_read,
938 .write = nvic_sysreg_write,
939 .endianness = DEVICE_NATIVE_ENDIAN,
942 static int nvic_post_load(void *opaque, int version_id)
944 NVICState *s = opaque;
945 unsigned i;
947 /* Check for out of range priority settings */
948 if (s->vectors[ARMV7M_EXCP_RESET].prio != -3 ||
949 s->vectors[ARMV7M_EXCP_NMI].prio != -2 ||
950 s->vectors[ARMV7M_EXCP_HARD].prio != -1) {
951 return 1;
953 for (i = ARMV7M_EXCP_MEM; i < s->num_irq; i++) {
954 if (s->vectors[i].prio & ~0xff) {
955 return 1;
959 nvic_recompute_state(s);
961 return 0;
964 static const VMStateDescription vmstate_VecInfo = {
965 .name = "armv7m_nvic_info",
966 .version_id = 1,
967 .minimum_version_id = 1,
968 .fields = (VMStateField[]) {
969 VMSTATE_INT16(prio, VecInfo),
970 VMSTATE_UINT8(enabled, VecInfo),
971 VMSTATE_UINT8(pending, VecInfo),
972 VMSTATE_UINT8(active, VecInfo),
973 VMSTATE_UINT8(level, VecInfo),
974 VMSTATE_END_OF_LIST()
978 static const VMStateDescription vmstate_nvic = {
979 .name = "armv7m_nvic",
980 .version_id = 3,
981 .minimum_version_id = 3,
982 .post_load = &nvic_post_load,
983 .fields = (VMStateField[]) {
984 VMSTATE_STRUCT_ARRAY(vectors, NVICState, NVIC_MAX_VECTORS, 1,
985 vmstate_VecInfo, VecInfo),
986 VMSTATE_UINT32(systick.control, NVICState),
987 VMSTATE_UINT32(systick.reload, NVICState),
988 VMSTATE_INT64(systick.tick, NVICState),
989 VMSTATE_TIMER_PTR(systick.timer, NVICState),
990 VMSTATE_UINT32(prigroup, NVICState),
991 VMSTATE_END_OF_LIST()
995 static Property props_nvic[] = {
996 /* Number of external IRQ lines (so excluding the 16 internal exceptions) */
997 DEFINE_PROP_UINT32("num-irq", NVICState, num_irq, 64),
998 DEFINE_PROP_END_OF_LIST()
1001 static void armv7m_nvic_reset(DeviceState *dev)
1003 NVICState *s = NVIC(dev);
1005 s->vectors[ARMV7M_EXCP_NMI].enabled = 1;
1006 s->vectors[ARMV7M_EXCP_HARD].enabled = 1;
1007 /* MEM, BUS, and USAGE are enabled through
1008 * the System Handler Control register
1010 s->vectors[ARMV7M_EXCP_SVC].enabled = 1;
1011 s->vectors[ARMV7M_EXCP_DEBUG].enabled = 1;
1012 s->vectors[ARMV7M_EXCP_PENDSV].enabled = 1;
1013 s->vectors[ARMV7M_EXCP_SYSTICK].enabled = 1;
1015 s->vectors[ARMV7M_EXCP_RESET].prio = -3;
1016 s->vectors[ARMV7M_EXCP_NMI].prio = -2;
1017 s->vectors[ARMV7M_EXCP_HARD].prio = -1;
1019 /* Strictly speaking the reset handler should be enabled.
1020 * However, we don't simulate soft resets through the NVIC,
1021 * and the reset vector should never be pended.
1022 * So we leave it disabled to catch logic errors.
1025 s->exception_prio = NVIC_NOEXC_PRIO;
1026 s->vectpending = 0;
1028 systick_reset(s);
1031 static void armv7m_nvic_realize(DeviceState *dev, Error **errp)
1033 NVICState *s = NVIC(dev);
1035 s->cpu = ARM_CPU(qemu_get_cpu(0));
1036 assert(s->cpu);
1038 if (s->num_irq > NVIC_MAX_IRQ) {
1039 error_setg(errp, "num-irq %d exceeds NVIC maximum", s->num_irq);
1040 return;
1043 qdev_init_gpio_in(dev, set_irq_level, s->num_irq);
1045 /* include space for internal exception vectors */
1046 s->num_irq += NVIC_FIRST_IRQ;
1048 /* The NVIC and System Control Space (SCS) starts at 0xe000e000
1049 * and looks like this:
1050 * 0x004 - ICTR
1051 * 0x010 - 0x1c - systick
1052 * 0x100..0x7ec - NVIC
1053 * 0x7f0..0xcff - Reserved
1054 * 0xd00..0xd3c - SCS registers
1055 * 0xd40..0xeff - Reserved or Not implemented
1056 * 0xf00 - STIR
1058 * At the moment there is only one thing in the container region,
1059 * but we leave it in place to allow us to pull systick out into
1060 * its own device object later.
1062 memory_region_init(&s->container, OBJECT(s), "nvic", 0x1000);
1063 /* The system register region goes at the bottom of the priority
1064 * stack as it covers the whole page.
1066 memory_region_init_io(&s->sysregmem, OBJECT(s), &nvic_sysreg_ops, s,
1067 "nvic_sysregs", 0x1000);
1068 memory_region_add_subregion(&s->container, 0, &s->sysregmem);
1070 /* Map the whole thing into system memory at the location required
1071 * by the v7M architecture.
1073 memory_region_add_subregion(get_system_memory(), 0xe000e000, &s->container);
1074 s->systick.timer = timer_new_ns(QEMU_CLOCK_VIRTUAL, systick_timer_tick, s);
1077 static void armv7m_nvic_instance_init(Object *obj)
1079 /* We have a different default value for the num-irq property
1080 * than our superclass. This function runs after qdev init
1081 * has set the defaults from the Property array and before
1082 * any user-specified property setting, so just modify the
1083 * value in the GICState struct.
1085 DeviceState *dev = DEVICE(obj);
1086 NVICState *nvic = NVIC(obj);
1087 SysBusDevice *sbd = SYS_BUS_DEVICE(obj);
1089 sysbus_init_irq(sbd, &nvic->excpout);
1090 qdev_init_gpio_out_named(dev, &nvic->sysresetreq, "SYSRESETREQ", 1);
1093 static void armv7m_nvic_class_init(ObjectClass *klass, void *data)
1095 DeviceClass *dc = DEVICE_CLASS(klass);
1097 dc->vmsd = &vmstate_nvic;
1098 dc->props = props_nvic;
1099 dc->reset = armv7m_nvic_reset;
1100 dc->realize = armv7m_nvic_realize;
1103 static const TypeInfo armv7m_nvic_info = {
1104 .name = TYPE_NVIC,
1105 .parent = TYPE_SYS_BUS_DEVICE,
1106 .instance_init = armv7m_nvic_instance_init,
1107 .instance_size = sizeof(NVICState),
1108 .class_init = armv7m_nvic_class_init,
1109 .class_size = sizeof(SysBusDeviceClass),
1112 static void armv7m_nvic_register_types(void)
1114 type_register_static(&armv7m_nvic_info);
1117 type_init(armv7m_nvic_register_types)