/* This file is part of the program GDB, the GNU debugger.
Copyright (C) 1998-2019 Free Software Foundation, Inc.
Contributed by Cygnus Solutions.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#include "sim-main.h"
#include "hw-main.h"
#include "sim-hw.h"
/* DEVICE
mn103int - mn103002 interrupt controller
DESCRIPTION
Implements the mn103002 interrupt controller described in the
mn103002 user guide.
PROPERTIES
reg = <icr-adr> <icr-siz> <iagr-adr> <iadr-siz> <extmd-adr> <extmd-siz>
Specify the address of the ICR (total of 30 registers), IAGR and
EXTMD registers (within the parent bus).
The reg property value `0x34000100 0x7C 0x34000200 0x8 0x3400280
0x8' locates the interrupt controller at the addresses specified in
the mn103002 interrupt controller user guide.
PORTS
nmi (output)
Non-maskable interrupt output port. An event on this output ports
indicates a NMI request from the interrupt controller. The value
attached to the event should be ignored.
level (output)
Maskable interrupt level output port. An event on this output port
indicates a maskable interrupt request at the specified level. The
event value defines the level being requested.
The interrupt controller will generate an event on this port
whenever there is a change to the internal state of the interrupt
controller.
ack (input)
Signal from processor indicating that a maskable interrupt has been
accepted and the interrupt controller should latch the IAGR with
value of the current highest priority interrupting group.
The event value is the interrupt level being accepted by the
processor. It should be consistent with the most recent LEVEL sent
to the processor from the interrupt controller.
int[0..100] (input)
Level or edge triggered interrupt input port. Each of the 30
groups (0..30) can have up to 4 (0..3) interrupt inputs. The
interpretation of a port event/value is determined by the
configuration of the corresponding interrupt group.
For convenience, numerous aliases to these interrupt inputs are
provided.
BUGS
For edge triggered interrupts, the interrupt controller does not
differentiate between POSITIVE (rising) and NEGATIVE (falling)
edges. Instead any input port event is considered to be an
interrupt trigger.
For level sensitive interrupts, the interrupt controller ignores
active HIGH/LOW settings and instead always interprets a nonzero
port value as an interrupt assertion and a zero port value as a
negation.
*/
/* The interrupt groups - numbered according to mn103002 convention */
enum mn103int_trigger {
ACTIVE_LOW,
ACTIVE_HIGH,
POSITIVE_EDGE,
NEGATIVE_EDGE,
};
enum mn103int_type {
NMI_GROUP,
LEVEL_GROUP,
};
struct mn103int_group {
int gid;
int level;
unsigned enable;
unsigned request;
unsigned input;
enum mn103int_trigger trigger;
enum mn103int_type type;
};
enum {
FIRST_NMI_GROUP = 0,
LAST_NMI_GROUP = 1,
FIRST_LEVEL_GROUP = 2,
LAST_LEVEL_GROUP = 30,
NR_GROUPS,
};
enum {
LOWEST_LEVEL = 7,
};
/* The interrupt controller register address blocks */
struct mn103int_block {
unsigned_word base;
unsigned_word bound;
};
enum { ICR_BLOCK, IAGR_BLOCK, EXTMD_BLOCK, NR_BLOCKS };
struct mn103int {
struct mn103int_block block[NR_BLOCKS];
struct mn103int_group group[NR_GROUPS];
unsigned interrupt_accepted_group;
};
/* output port ID's */
enum {
NMI_PORT,
LEVEL_PORT,
};
/* input port ID's */
enum {
G0_PORT = 0,
G1_PORT = 4,
G2_PORT = 8,
G3_PORT = 12,
G4_PORT = 16,
G5_PORT = 20,
G6_PORT = 24,
G7_PORT = 28,
G8_PORT = 32,
G9_PORT = 36,
G10_PORT = 40,
G11_PORT = 44,
G12_PORT = 48,
G13_PORT = 52,
G14_PORT = 56,
G15_PORT = 60,
G16_PORT = 64,
G17_PORT = 68,
G18_PORT = 72,
G19_PORT = 76,
G20_PORT = 80,
G21_PORT = 84,
G22_PORT = 88,
G23_PORT = 92,
IRQ0_PORT = G23_PORT,
G24_PORT = 96,
G25_PORT = 100,
G26_PORT = 104,
G27_PORT = 108,
IRQ4_PORT = G27_PORT,
G28_PORT = 112,
G29_PORT = 116,
G30_PORT = 120,
NR_G_PORTS = 124,
ACK_PORT,
};
static const struct hw_port_descriptor mn103int_ports[] = {
/* interrupt outputs */
{ "nmi", NMI_PORT, 0, output_port, },
{ "level", LEVEL_PORT, 0, output_port, },
/* interrupt ack (latch) input from cpu */
{ "ack", ACK_PORT, 0, input_port, },
/* interrupt inputs (as names) */
{ "nmirq", G0_PORT + 0, 0, input_port, },
{ "watchdog", G0_PORT + 1, 0, input_port, },
{ "syserr", G0_PORT + 2, 0, input_port, },
{ "timer-0-underflow", G2_PORT, 0, input_port, },
{ "timer-1-underflow", G3_PORT, 0, input_port, },
{ "timer-2-underflow", G4_PORT, 0, input_port, },
{ "timer-3-underflow", G5_PORT, 0, input_port, },
{ "timer-4-underflow", G6_PORT, 0, input_port, },
{ "timer-5-underflow", G7_PORT, 0, input_port, },
{ "timer-6-underflow", G8_PORT, 0, input_port, },
{ "timer-6-compare-a", G9_PORT, 0, input_port, },
{ "timer-6-compare-b", G10_PORT, 0, input_port, },
{ "dma-0-end", G12_PORT, 0, input_port, },
{ "dma-1-end", G13_PORT, 0, input_port, },
{ "dma-2-end", G14_PORT, 0, input_port, },
{ "dma-3-end", G15_PORT, 0, input_port, },
{ "serial-0-receive", G16_PORT, 0, input_port, },
{ "serial-0-transmit", G17_PORT, 0, input_port, },
{ "serial-1-receive", G18_PORT, 0, input_port, },
{ "serial-1-transmit", G19_PORT, 0, input_port, },
{ "serial-2-receive", G20_PORT, 0, input_port, },
{ "serial-2-transmit", G21_PORT, 0, input_port, },
{ "irq-0", G23_PORT, 0, input_port, },
{ "irq-1", G24_PORT, 0, input_port, },
{ "irq-2", G25_PORT, 0, input_port, },
{ "irq-3", G26_PORT, 0, input_port, },
{ "irq-4", G27_PORT, 0, input_port, },
{ "irq-5", G28_PORT, 0, input_port, },
{ "irq-6", G29_PORT, 0, input_port, },
{ "irq-7", G30_PORT, 0, input_port, },
/* interrupt inputs (as generic numbers) */
{ "int", 0, NR_G_PORTS, input_port, },
{ NULL, },
};
/* Macros for extracting/restoring the various register bits */
#define EXTRACT_ID(X) (LSEXTRACTED8 ((X), 3, 0))
#define INSERT_ID(X) (LSINSERTED8 ((X), 3, 0))
#define EXTRACT_IR(X) (LSEXTRACTED8 ((X), 7, 4))
#define INSERT_IR(X) (LSINSERTED8 ((X), 7, 4))
#define EXTRACT_IE(X) (LSEXTRACTED8 ((X), 3, 0))
#define INSERT_IE(X) (LSINSERTED8 ((X), 3, 0))
#define EXTRACT_LV(X) (LSEXTRACTED8 ((X), 6, 4))
#define INSERT_LV(X) (LSINSERTED8 ((X), 6, 4))
/* Finish off the partially created hw device. Attach our local
callbacks. Wire up our port names etc */
static hw_io_read_buffer_method mn103int_io_read_buffer;
static hw_io_write_buffer_method mn103int_io_write_buffer;
static hw_port_event_method mn103int_port_event;
static hw_ioctl_method mn103int_ioctl;
static void
attach_mn103int_regs (struct hw *me,
struct mn103int *controller)
{
int i;
if (hw_find_property (me, "reg") == NULL)
hw_abort (me, "Missing \"reg\" property");
for (i = 0; i < NR_BLOCKS; i++)
{
unsigned_word attach_address;
int attach_space;
unsigned attach_size;
reg_property_spec reg;
if (!hw_find_reg_array_property (me, "reg", i, ®))
hw_abort (me, "\"reg\" property must contain three addr/size entries");
hw_unit_address_to_attach_address (hw_parent (me),
®.address,
&attach_space,
&attach_address,
me);
controller->block[i].base = attach_address;
hw_unit_size_to_attach_size (hw_parent (me),
®.size,
&attach_size, me);
controller->block[i].bound = attach_address + (attach_size - 1);
hw_attach_address (hw_parent (me),
0,
attach_space, attach_address, attach_size,
me);
}
}
static void
mn103int_finish (struct hw *me)
{
int gid;
struct mn103int *controller;
controller = HW_ZALLOC (me, struct mn103int);
set_hw_data (me, controller);
set_hw_io_read_buffer (me, mn103int_io_read_buffer);
set_hw_io_write_buffer (me, mn103int_io_write_buffer);
set_hw_ports (me, mn103int_ports);
set_hw_port_event (me, mn103int_port_event);
me->to_ioctl = mn103int_ioctl;
/* Attach ourself to our parent bus */
attach_mn103int_regs (me, controller);
/* Initialize all the groups according to their default configuration */
for (gid = 0; gid < NR_GROUPS; gid++)
{
struct mn103int_group *group = &controller->group[gid];
group->trigger = NEGATIVE_EDGE;
group->gid = gid;
if (FIRST_NMI_GROUP <= gid && gid <= LAST_NMI_GROUP)
{
group->enable = 0xf;
group->type = NMI_GROUP;
}
else if (FIRST_LEVEL_GROUP <= gid && gid <= LAST_LEVEL_GROUP)
{
group->enable = 0x0;
group->type = LEVEL_GROUP;
}
else
hw_abort (me, "internal error - unknown group id");
}
}
/* Perform the nasty work of figuring out which of the interrupt
groups should have its interrupt delivered. */
static int
find_highest_interrupt_group (struct hw *me,
struct mn103int *controller)
{
int gid;
int selected;
/* FIRST_NMI_GROUP (group zero) is used as a special default value
when searching for an interrupt group.*/
selected = FIRST_NMI_GROUP;
controller->group[FIRST_NMI_GROUP].level = 7;
for (gid = FIRST_LEVEL_GROUP; gid <= LAST_LEVEL_GROUP; gid++)
{
struct mn103int_group *group = &controller->group[gid];
if ((group->request & group->enable) != 0)
{
/* Remember, lower level, higher priority. */
if (group->level < controller->group[selected].level)
{
selected = gid;
}
}
}
return selected;
}
/* Notify the processor of an interrupt level update */
static void
push_interrupt_level (struct hw *me,
struct mn103int *controller)
{
int selected = find_highest_interrupt_group (me, controller);
int level = controller->group[selected].level;
HW_TRACE ((me, "port-out - selected=%d level=%d", selected, level));
hw_port_event (me, LEVEL_PORT, level);
}
/* An event arrives on an interrupt port */
static void
mn103int_port_event (struct hw *me,
int my_port,
struct hw *source,
int source_port,
int level)
{
struct mn103int *controller = hw_data (me);
switch (my_port)
{
case ACK_PORT:
{
int selected = find_highest_interrupt_group (me, controller);
if (controller->group[selected].level != level)
hw_abort (me, "botched level synchronisation");
controller->interrupt_accepted_group = selected;
HW_TRACE ((me, "port-event port=ack level=%d - selected=%d",
level, selected));
break;
}
default:
{
int gid;
int iid;
struct mn103int_group *group;
unsigned interrupt;
if (my_port > NR_G_PORTS)
hw_abort (me, "Event on unknown port %d", my_port);
/* map the port onto an interrupt group */
gid = (my_port % NR_G_PORTS) / 4;
group = &controller->group[gid];
iid = (my_port % 4);
interrupt = 1 << iid;
/* update our cached input */
if (level)
group->input |= interrupt;
else
group->input &= ~interrupt;
/* update the request bits */
switch (group->trigger)
{
case ACTIVE_LOW:
case ACTIVE_HIGH:
if (level)
group->request |= interrupt;
break;
case NEGATIVE_EDGE:
case POSITIVE_EDGE:
group->request |= interrupt;
}
/* force a corresponding output */
switch (group->type)
{
case NMI_GROUP:
{
/* for NMI's the event is the trigger */
HW_TRACE ((me, "port-in port=%d group=%d interrupt=%d - NMI",
my_port, gid, iid));
if ((group->request & group->enable) != 0)
{
HW_TRACE ((me, "port-out NMI"));
hw_port_event (me, NMI_PORT, 1);
}
break;
}
case LEVEL_GROUP:
{
/* if an interrupt is now pending */
HW_TRACE ((me, "port-in port=%d group=%d interrupt=%d - INT",
my_port, gid, iid));
push_interrupt_level (me, controller);
break;
}
}
break;
}
}
}
/* Read/write to to an ICR (group control register) */
static struct mn103int_group *
decode_group (struct hw *me,
struct mn103int *controller,
unsigned_word base,
unsigned_word *offset)
{
int gid = (base / 4) % NR_GROUPS;
*offset = (base % 4);
return &controller->group[gid];
}
static unsigned8
read_icr (struct hw *me,
struct mn103int *controller,
unsigned_word base)
{
unsigned_word offset;
struct mn103int_group *group = decode_group (me, controller, base, &offset);
unsigned8 val = 0;
switch (group->type)
{
case NMI_GROUP:
switch (offset)
{
case 0:
val = INSERT_ID (group->request);
HW_TRACE ((me, "read-icr group=%d:0 nmi 0x%02x",
group->gid, val));
break;
default:
break;
}
break;
case LEVEL_GROUP:
switch (offset)
{
case 0:
val = (INSERT_IR (group->request)
| INSERT_ID (group->request & group->enable));
HW_TRACE ((me, "read-icr group=%d:0 level 0x%02x",
group->gid, val));
break;
case 1:
val = (INSERT_LV (group->level)
| INSERT_IE (group->enable));
HW_TRACE ((me, "read-icr level-%d:1 level 0x%02x",
group->gid, val));
break;
}
break;
default:
break;
}
return val;
}
static void
write_icr (struct hw *me,
struct mn103int *controller,
unsigned_word base,
unsigned8 val)
{
unsigned_word offset;
struct mn103int_group *group = decode_group (me, controller, base, &offset);
switch (group->type)
{
case NMI_GROUP:
switch (offset)
{
case 0:
HW_TRACE ((me, "write-icr group=%d:0 nmi 0x%02x",
group->gid, val));
group->request &= ~EXTRACT_ID (val);
break;
/* Special backdoor access to SYSEF flag from CPU. See
interp.c:program_interrupt(). */
case 3:
HW_TRACE ((me, "write-icr-special group=%d:0 nmi 0x%02x",
group->gid, val));
group->request |= EXTRACT_ID (val);
default:
break;
}
break;
case LEVEL_GROUP:
switch (offset)
{
case 0: /* request/detect */
/* Clear any ID bits and then set them according to IR */
HW_TRACE ((me, "write-icr group=%d:0 level 0x%02x %x:%x:%x",
group->gid, val,
group->request, EXTRACT_IR (val), EXTRACT_ID (val)));
group->request =
((EXTRACT_IR (val) & EXTRACT_ID (val))
| (EXTRACT_IR (val) & group->request)
| (~EXTRACT_IR (val) & ~EXTRACT_ID (val) & group->request));
break;
case 1: /* level/enable */
HW_TRACE ((me, "write-icr group=%d:1 level 0x%02x",
group->gid, val));
group->level = EXTRACT_LV (val);
group->enable = EXTRACT_IE (val);
break;
default:
/* ignore */
break;
}
push_interrupt_level (me, controller);
break;
default:
break;
}
}
/* Read the IAGR (Interrupt accepted group register) */
static unsigned8
read_iagr (struct hw *me,
struct mn103int *controller,
unsigned_word offset)
{
unsigned8 val;
switch (offset)
{
case 0:
{
if (!(controller->group[controller->interrupt_accepted_group].request
& controller->group[controller->interrupt_accepted_group].enable))
{
/* oops, lost the request */
val = 0;
HW_TRACE ((me, "read-iagr:0 lost-0"));
}
else
{
val = (controller->interrupt_accepted_group << 2);
HW_TRACE ((me, "read-iagr:0 %d", (int) val));
}
break;
}
case 1:
val = 0;
HW_TRACE ((me, "read-iagr:1 %d", (int) val));
break;
default:
val = 0;
HW_TRACE ((me, "read-iagr 0x%08lx bad offset", (long) offset));
break;
}
return val;
}
/* Reads/writes to the EXTMD (external interrupt trigger configuration
register) */
static struct mn103int_group *
external_group (struct mn103int *controller,
unsigned_word offset)
{
switch (offset)
{
case 0:
return &controller->group[IRQ0_PORT/4];
case 1:
return &controller->group[IRQ4_PORT/4];
default:
return NULL;
}
}
static unsigned8
read_extmd (struct hw *me,
struct mn103int *controller,
unsigned_word offset)
{
int gid;
unsigned8 val = 0;
struct mn103int_group *group = external_group (controller, offset);
if (group != NULL)
{
for (gid = 0; gid < 4; gid++)
{
val |= (group[gid].trigger << (gid * 2));
}
}
HW_TRACE ((me, "read-extmd 0x%02lx", (long) val));
return val;
}
static void
write_extmd (struct hw *me,
struct mn103int *controller,
unsigned_word offset,
unsigned8 val)
{
int gid;
struct mn103int_group *group = external_group (controller, offset);
if (group != NULL)
{
for (gid = 0; gid < 4; gid++)
{
group[gid].trigger = (val >> (gid * 2)) & 0x3;
/* MAYBE: interrupts already pending? */
}
}
HW_TRACE ((me, "write-extmd 0x%02lx", (long) val));
}
/* generic read/write */
static int
decode_addr (struct hw *me,
struct mn103int *controller,
unsigned_word address,
unsigned_word *offset)
{
int i;
for (i = 0; i < NR_BLOCKS; i++)
{
if (address >= controller->block[i].base
&& address <= controller->block[i].bound)
{
*offset = address - controller->block[i].base;
return i;
}
}
hw_abort (me, "bad address");
return -1;
}
static unsigned
mn103int_io_read_buffer (struct hw *me,
void *dest,
int space,
unsigned_word base,
unsigned nr_bytes)
{
struct mn103int *controller = hw_data (me);
unsigned8 *buf = dest;
unsigned byte;
/* HW_TRACE ((me, "read 0x%08lx %d", (long) base, (int) nr_bytes)); */
for (byte = 0; byte < nr_bytes; byte++)
{
unsigned_word address = base + byte;
unsigned_word offset;
switch (decode_addr (me, controller, address, &offset))
{
case ICR_BLOCK:
buf[byte] = read_icr (me, controller, offset);
break;
case IAGR_BLOCK:
buf[byte] = read_iagr (me, controller, offset);
break;
case EXTMD_BLOCK:
buf[byte] = read_extmd (me, controller, offset);
break;
default:
hw_abort (me, "bad switch");
}
}
return nr_bytes;
}
static unsigned
mn103int_io_write_buffer (struct hw *me,
const void *source,
int space,
unsigned_word base,
unsigned nr_bytes)
{
struct mn103int *controller = hw_data (me);
const unsigned8 *buf = source;
unsigned byte;
/* HW_TRACE ((me, "write 0x%08lx %d", (long) base, (int) nr_bytes)); */
for (byte = 0; byte < nr_bytes; byte++)
{
unsigned_word address = base + byte;
unsigned_word offset;
switch (decode_addr (me, controller, address, &offset))
{
case ICR_BLOCK:
write_icr (me, controller, offset, buf[byte]);
break;
case IAGR_BLOCK:
/* not allowed */
break;
case EXTMD_BLOCK:
write_extmd (me, controller, offset, buf[byte]);
break;
default:
hw_abort (me, "bad switch");
}
}
return nr_bytes;
}
static int
mn103int_ioctl(struct hw *me,
hw_ioctl_request request,
va_list ap)
{
struct mn103int *controller = (struct mn103int *)hw_data(me);
controller->group[0].request = EXTRACT_ID(4);
mn103int_port_event(me, 2 /* nmi_port(syserr) */, NULL, 0, 0);
return 0;
}
const struct hw_descriptor dv_mn103int_descriptor[] = {
{ "mn103int", mn103int_finish, },
{ NULL },
};