1 /* This file is part of the program GDB, the GNU debugger.
3 Copyright (C) 1998 Free Software Foundation, Inc.
4 Contributed by Cygnus Solutions.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program 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
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
29 mn103int - mn103002 interrupt controller
35 Implements the mn103002 interrupt controller described in the
42 reg = <icr-adr> <icr-siz> <iagr-adr> <iadr-siz> <extmd-adr> <extmd-siz>
44 Specify the address of the ICR (total of 25 registers), IAGR and
45 EXTMD registers (within the parent bus).
47 The reg property value `0x34000100 0x7C 0x34000200 0x8 0x3400280
48 0x8' locates the interrupt controller at the addresses specified in
49 the mn103002 interrupt controller user guide.
57 Non-maskable interrupt output port. An event on this output ports
58 indicates a NMI request from the interrupt controller. The value
59 attached to the event should be ignored.
64 Maskable interrupt level output port. An event on this output port
65 indicates a maskable interrupt request at the specified level. The
66 event value defines the level being requested.
68 The interrupt controller will generate an event on this port
69 whenever there is a change to the internal state of the interrupt
75 Signal from processor indicating that a maskable interrupt has been
76 accepted and the interrupt controller should latch the IAGR with
77 value of the current highest priority interrupting group.
79 The event value is the interrupt level being accepted by the
80 processor. It should be consistent with the most recent LEVEL sent
81 to the processor from the interrupt controller.
86 Level or edge triggered interrupt input port. Each of the 30
87 groups (0..30) can have up to 4 (0..3) interrupt inputs. The
88 interpretation of a port event/value is determined by the
89 configuration of the corresponding interrupt group.
91 For convenience, numerous aliases to these interrupt inputs are
98 For edge triggered interrupts, the interrupt controller does not
99 differentiate between POSITIVE (rising) and NEGATIVE (falling)
100 edges. Instead any input port event is considered to be an
103 For level sensitive interrupts, the interrupt controller ignores
104 active HIGH/LOW settings and instead always interprets a nonzero
105 port value as an interrupt assertion and a zero port value as a
111 /* The interrupt groups - numbered according to mn103002 convention */
113 enum mn103int_trigger
{
125 struct mn103int_group
{
131 enum mn103int_trigger trigger
;
132 enum mn103int_type type
;
138 FIRST_LEVEL_GROUP
= 2,
139 LAST_LEVEL_GROUP
= 30,
147 /* The interrupt controller register address blocks */
149 struct mn103int_block
{
154 enum { ICR_BLOCK
, IAGR_BLOCK
, EXTMD_BLOCK
, NR_BLOCKS
};
158 struct mn103int_block block
[NR_BLOCKS
];
159 struct mn103int_group group
[NR_GROUPS
];
160 unsigned interrupt_accepted_group
;
165 /* output port ID's */
173 /* input port ID's */
200 IRQ0_PORT
= G23_PORT
,
205 IRQ4_PORT
= G27_PORT
,
213 static const struct hw_port_descriptor mn103int_ports
[] = {
215 /* interrupt outputs */
217 { "nmi", NMI_PORT
, 0, output_port
, },
218 { "level", LEVEL_PORT
, 0, output_port
, },
220 /* interrupt ack (latch) input from cpu */
222 { "ack", ACK_PORT
, 0, input_port
, },
224 /* interrupt inputs (as names) */
226 { "nmirq", G0_PORT
+ 0, 0, input_port
, },
227 { "watchdog", G0_PORT
+ 1, 0, input_port
, },
228 { "syserr", G0_PORT
+ 2, 0, input_port
, },
230 { "timer-0-underflow", G2_PORT
, 0, input_port
, },
231 { "timer-1-underflow", G3_PORT
, 0, input_port
, },
232 { "timer-2-underflow", G4_PORT
, 0, input_port
, },
233 { "timer-3-underflow", G5_PORT
, 0, input_port
, },
234 { "timer-4-underflow", G6_PORT
, 0, input_port
, },
235 { "timer-5-underflow", G7_PORT
, 0, input_port
, },
236 { "timer-6-underflow", G8_PORT
, 0, input_port
, },
238 { "timer-6-compare-a", G9_PORT
, 0, input_port
, },
239 { "timer-6-compare-b", G10_PORT
, 0, input_port
, },
241 { "dma-0-end", G12_PORT
, 0, input_port
, },
242 { "dma-1-end", G13_PORT
, 0, input_port
, },
243 { "dma-2-end", G14_PORT
, 0, input_port
, },
244 { "dma-3-end", G15_PORT
, 0, input_port
, },
246 { "serial-0-receive", G16_PORT
, 0, input_port
, },
247 { "serial-0-transmit", G17_PORT
, 0, input_port
, },
249 { "serial-1-receive", G18_PORT
, 0, input_port
, },
250 { "serial-1-transmit", G19_PORT
, 0, input_port
, },
252 { "serial-2-receive", G20_PORT
, 0, input_port
, },
253 { "serial-2-transmit", G21_PORT
, 0, input_port
, },
255 { "irq-0", G23_PORT
, 0, input_port
, },
256 { "irq-1", G24_PORT
, 0, input_port
, },
257 { "irq-2", G25_PORT
, 0, input_port
, },
258 { "irq-3", G26_PORT
, 0, input_port
, },
259 { "irq-4", G27_PORT
, 0, input_port
, },
260 { "irq-5", G28_PORT
, 0, input_port
, },
261 { "irq-6", G29_PORT
, 0, input_port
, },
262 { "irq-7", G30_PORT
, 0, input_port
, },
264 /* interrupt inputs (as generic numbers) */
266 { "int", 0, NR_G_PORTS
, input_port
, },
272 /* Macros for extracting/restoring the various register bits */
274 #define EXTRACT_ID(X) (LSEXTRACTED8 ((X), 3, 0))
275 #define INSERT_ID(X) (LSINSERTED8 ((X), 3, 0))
277 #define EXTRACT_IR(X) (LSEXTRACTED8 ((X), 7, 4))
278 #define INSERT_IR(X) (LSINSERTED8 ((X), 7, 4))
280 #define EXTRACT_IE(X) (LSEXTRACTED8 ((X), 3, 0))
281 #define INSERT_IE(X) (LSINSERTED8 ((X), 3, 0))
283 #define EXTRACT_LV(X) (LSEXTRACTED8 ((X), 6, 4))
284 #define INSERT_LV(X) (LSINSERTED8 ((X), 6, 4))
288 /* Finish off the partially created hw device. Attach our local
289 callbacks. Wire up our port names etc */
291 static hw_io_read_buffer_method mn103int_io_read_buffer
;
292 static hw_io_write_buffer_method mn103int_io_write_buffer
;
293 static hw_port_event_method mn103int_port_event
;
296 attach_mn103int_regs (struct hw
*me
,
297 struct mn103int
*controller
)
300 if (hw_find_property (me
, "reg") == NULL
)
301 hw_abort (me
, "Missing \"reg\" property");
302 for (i
= 0; i
< NR_BLOCKS
; i
++)
304 unsigned_word attach_address
;
306 unsigned attach_size
;
307 reg_property_spec reg
;
308 if (!hw_find_reg_array_property (me
, "reg", i
, ®
))
309 hw_abort (me
, "\"reg\" property must contain three addr/size entries");
310 hw_unit_address_to_attach_address (hw_parent (me
),
315 controller
->block
[i
].base
= attach_address
;
316 hw_unit_size_to_attach_size (hw_parent (me
),
319 controller
->block
[i
].bound
= attach_address
+ (attach_size
- 1);
320 hw_attach_address (hw_parent (me
),
322 attach_space
, attach_address
, attach_size
,
328 mn103int_finish (struct hw
*me
)
331 struct mn103int
*controller
;
333 controller
= HW_ZALLOC (me
, struct mn103int
);
334 set_hw_data (me
, controller
);
335 set_hw_io_read_buffer (me
, mn103int_io_read_buffer
);
336 set_hw_io_write_buffer (me
, mn103int_io_write_buffer
);
337 set_hw_ports (me
, mn103int_ports
);
338 set_hw_port_event (me
, mn103int_port_event
);
340 /* Attach ourself to our parent bus */
341 attach_mn103int_regs (me
, controller
);
343 /* Initialize all the groups according to their default configuration */
344 for (gid
= 0; gid
< NR_GROUPS
; gid
++)
346 struct mn103int_group
*group
= &controller
->group
[gid
];
348 group
->trigger
= NEGATIVE_EDGE
;
350 if (FIRST_NMI_GROUP
<= gid
&& gid
<= LAST_NMI_GROUP
)
352 group
->type
= NMI_GROUP
;
354 else if (FIRST_LEVEL_GROUP
<= gid
&& gid
<= LAST_LEVEL_GROUP
)
356 group
->type
= LEVEL_GROUP
;
359 hw_abort (me
, "internal error - unknown group id");
365 /* Perform the nasty work of figuring out which of the interrupt
366 groups should have its interrupt delivered. */
369 find_highest_interrupt_group (struct hw
*me
,
370 struct mn103int
*controller
)
375 /* FIRST_NMI_GROUP (group zero) is used as a special default value
376 when searching for an interrupt group.*/
377 selected
= FIRST_NMI_GROUP
;
378 controller
->group
[FIRST_NMI_GROUP
].level
= 7;
380 for (gid
= FIRST_LEVEL_GROUP
; gid
<= LAST_LEVEL_GROUP
; gid
++)
382 struct mn103int_group
*group
= &controller
->group
[gid
];
383 if ((group
->request
& group
->enable
) != 0)
385 /* Remember, lower level, higher priority. */
386 if (group
->level
< controller
->group
[selected
].level
)
396 /* Notify the processor of an interrupt level update */
399 push_interrupt_level (struct hw
*me
,
400 struct mn103int
*controller
)
402 int selected
= find_highest_interrupt_group (me
, controller
);
403 int level
= controller
->group
[selected
].level
;
404 HW_TRACE ((me
, "port-out - selected=%d level=%d", selected
, level
));
405 hw_port_event (me
, LEVEL_PORT
, level
);
409 /* An event arrives on an interrupt port */
412 mn103int_port_event (struct hw
*me
,
418 struct mn103int
*controller
= hw_data (me
);
425 int selected
= find_highest_interrupt_group (me
, controller
);
426 if (controller
->group
[selected
].level
!= level
)
427 hw_abort (me
, "botched level synchronisation");
428 controller
->interrupt_accepted_group
= selected
;
429 HW_TRACE ((me
, "port-event port=ack level=%d - selected=%d",
438 struct mn103int_group
*group
;
440 if (my_port
> NR_G_PORTS
)
441 hw_abort (me
, "Event on unknown port %d", my_port
);
443 /* map the port onto an interrupt group */
444 gid
= (my_port
% NR_G_PORTS
) / 4;
445 group
= &controller
->group
[gid
];
447 interrupt
= 1 << iid
;
449 /* update our cached input */
451 group
->input
|= interrupt
;
453 group
->input
&= ~interrupt
;
455 /* update the request bits */
456 switch (group
->trigger
)
461 group
->request
|= interrupt
;
465 group
->request
|= interrupt
;
468 /* force a corresponding output */
474 /* for NMI's the event is the trigger */
475 HW_TRACE ((me
, "port-in port=%d group=%d interrupt=%d - NMI",
477 if ((group
->request
& group
->enable
) != 0)
479 HW_TRACE ((me
, "port-out NMI"));
480 hw_port_event (me
, NMI_PORT
, 1);
487 /* if an interrupt is now pending */
488 HW_TRACE ((me
, "port-in port=%d group=%d interrupt=%d - INT",
490 push_interrupt_level (me
, controller
);
500 /* Read/write to to an ICR (group control register) */
502 static struct mn103int_group
*
503 decode_group (struct hw
*me
,
504 struct mn103int
*controller
,
506 unsigned_word
*offset
)
508 int gid
= (base
/ 4) % NR_GROUPS
;
509 *offset
= (base
% 4);
510 return &controller
->group
[gid
];
514 read_icr (struct hw
*me
,
515 struct mn103int
*controller
,
518 unsigned_word offset
;
519 struct mn103int_group
*group
= decode_group (me
, controller
, base
, &offset
);
528 val
= INSERT_ID (group
->request
);
529 HW_TRACE ((me
, "read-icr group=%d:0 nmi 0x%02x",
541 val
= (INSERT_IR (group
->request
)
542 | INSERT_ID (group
->request
& group
->enable
));
543 HW_TRACE ((me
, "read-icr group=%d:0 level 0x%02x",
547 val
= (INSERT_LV (group
->level
)
548 | INSERT_IE (group
->enable
));
549 HW_TRACE ((me
, "read-icr level-%d:1 level 0x%02x",
564 write_icr (struct hw
*me
,
565 struct mn103int
*controller
,
569 unsigned_word offset
;
570 struct mn103int_group
*group
= decode_group (me
, controller
, base
, &offset
);
578 HW_TRACE ((me
, "write-icr group=%d:0 nmi 0x%02x",
580 group
->request
&= ~EXTRACT_ID (val
);
590 case 0: /* request/detect */
591 /* Clear any ID bits and then set them according to IR */
592 HW_TRACE ((me
, "write-icr group=%d:0 level 0x%02x %x:%x:%x",
594 group
->request
, EXTRACT_IR (val
), EXTRACT_ID (val
)));
596 ((EXTRACT_IR (val
) & EXTRACT_ID (val
))
597 | (EXTRACT_IR (val
) & group
->request
)
598 | (~EXTRACT_IR (val
) & ~EXTRACT_ID (val
) & group
->request
));
600 case 1: /* level/enable */
601 HW_TRACE ((me
, "write-icr group=%d:1 level 0x%02x",
603 group
->level
= EXTRACT_LV (val
);
604 group
->enable
= EXTRACT_IE (val
);
610 push_interrupt_level (me
, controller
);
620 /* Read the IAGR (Interrupt accepted group register) */
623 read_iagr (struct hw
*me
,
624 struct mn103int
*controller
,
625 unsigned_word offset
)
632 if (!(controller
->group
[controller
->interrupt_accepted_group
].request
633 & controller
->group
[controller
->interrupt_accepted_group
].enable
))
635 /* oops, lost the request */
637 HW_TRACE ((me
, "read-iagr:0 lost-0"));
641 val
= (controller
->interrupt_accepted_group
<< 2);
642 HW_TRACE ((me
, "read-iagr:0 %d", (int) val
));
648 HW_TRACE ((me
, "read-iagr:1 %d", (int) val
));
652 HW_TRACE ((me
, "read-iagr 0x%08lx bad offset", (long) offset
));
659 /* Reads/writes to the EXTMD (external interrupt trigger configuration
662 static struct mn103int_group
*
663 external_group (struct mn103int
*controller
,
664 unsigned_word offset
)
669 return &controller
->group
[IRQ0_PORT
/4];
671 return &controller
->group
[IRQ4_PORT
/4];
678 read_extmd (struct hw
*me
,
679 struct mn103int
*controller
,
680 unsigned_word offset
)
684 struct mn103int_group
*group
= external_group (controller
, offset
);
687 for (gid
= 0; gid
< 4; gid
++)
689 val
|= (group
[gid
].trigger
<< (gid
* 2));
692 HW_TRACE ((me
, "read-extmd 0x%02lx", (long) val
));
697 write_extmd (struct hw
*me
,
698 struct mn103int
*controller
,
699 unsigned_word offset
,
703 struct mn103int_group
*group
= external_group (controller
, offset
);
706 for (gid
= 0; gid
< 4; gid
++)
708 group
[gid
].trigger
= (val
>> (gid
* 2)) & 0x3;
709 /* MAYBE: interrupts already pending? */
712 HW_TRACE ((me
, "write-extmd 0x%02lx", (long) val
));
716 /* generic read/write */
719 decode_addr (struct hw
*me
,
720 struct mn103int
*controller
,
721 unsigned_word address
,
722 unsigned_word
*offset
)
725 for (i
= 0; i
< NR_BLOCKS
; i
++)
727 if (address
>= controller
->block
[i
].base
728 && address
<= controller
->block
[i
].bound
)
730 *offset
= address
- controller
->block
[i
].base
;
734 hw_abort (me
, "bad address");
739 mn103int_io_read_buffer (struct hw
*me
,
745 struct mn103int
*controller
= hw_data (me
);
746 unsigned8
*buf
= dest
;
748 /* HW_TRACE ((me, "read 0x%08lx %d", (long) base, (int) nr_bytes)); */
749 for (byte
= 0; byte
< nr_bytes
; byte
++)
751 unsigned_word address
= base
+ byte
;
752 unsigned_word offset
;
753 switch (decode_addr (me
, controller
, address
, &offset
))
756 buf
[byte
] = read_icr (me
, controller
, offset
);
759 buf
[byte
] = read_iagr (me
, controller
, offset
);
762 buf
[byte
] = read_extmd (me
, controller
, offset
);
765 hw_abort (me
, "bad switch");
772 mn103int_io_write_buffer (struct hw
*me
,
778 struct mn103int
*controller
= hw_data (me
);
779 const unsigned8
*buf
= source
;
781 /* HW_TRACE ((me, "write 0x%08lx %d", (long) base, (int) nr_bytes)); */
782 for (byte
= 0; byte
< nr_bytes
; byte
++)
784 unsigned_word address
= base
+ byte
;
785 unsigned_word offset
;
786 switch (decode_addr (me
, controller
, address
, &offset
))
789 write_icr (me
, controller
, offset
, buf
[byte
]);
795 write_extmd (me
, controller
, offset
, buf
[byte
]);
798 hw_abort (me
, "bad switch");
805 const struct hw_descriptor dv_mn103int_descriptor
[] = {
806 { "mn103int", mn103int_finish
, },