357 lines
12 KiB
C
357 lines
12 KiB
C
/* i8251.c: Intel i8251 UART adapter
|
|
|
|
Copyright (c) 2010, William A. Beech
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files (the "Software"),
|
|
to deal in the Software without restriction, including without limitation
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
|
Software is furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
WILLIAM A. BEECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
Except as contained in this notice, the name of William A. Beech shall not be
|
|
used in advertising or otherwise to promote the sale, use or other dealings
|
|
in this Software without prior written authorization from William A. Beech.
|
|
|
|
MODIFICATIONS:
|
|
|
|
?? ??? 10 - Original file.
|
|
16 Dec 12 - Modified to use isbc_80_10.cfg file to set i8251_baseport and size.
|
|
24 Apr 15 -- Modified to use simh_debug
|
|
|
|
NOTES:
|
|
|
|
These functions support a simulated i8251 interface device on an iSBC.
|
|
The device had one physical I/O port which could be connected
|
|
to any serial I/O device that would connect to a current loop,
|
|
RS232, or TTY interface. Available baud rates were jumper
|
|
selectable for each port from 110 to 9600.
|
|
|
|
All I/O is via programmed I/O. The i8251 has a status port
|
|
and a data port.
|
|
|
|
The simulated device does not support synchronous mode. The simulated device
|
|
supports a select from I/O space and one address line. The data port is at the
|
|
lower address and the status/command port is at the higher.
|
|
|
|
A write to the status port can select some options for the device:
|
|
|
|
Asynchronous Mode Instruction
|
|
7 6 5 4 3 2 1 0
|
|
+---+---+---+---+---+---+---+---+
|
|
| S2 S1 EP PEN L2 L1 B2 B1|
|
|
+---+---+---+---+---+---+---+---+
|
|
|
|
Baud Rate Factor
|
|
B2 0 1 0 1
|
|
B1 0 0 1 1
|
|
sync 1X 16X 64X
|
|
mode
|
|
|
|
Character Length
|
|
L2 0 1 0 1
|
|
L1 0 0 1 1
|
|
5 6 7 8
|
|
bits bits bits bits
|
|
|
|
EP - A 1 in this bit position selects even parity.
|
|
PEN - A 1 in this bit position enables parity.
|
|
|
|
Number of Stop Bits
|
|
S2 0 1 0 1
|
|
S1 0 0 1 1
|
|
invalid 1 1.5 2
|
|
bit bits bits
|
|
|
|
Command Instruction Format
|
|
7 6 5 4 3 2 1 0
|
|
+---+---+---+---+---+---+---+---+
|
|
| EH IR RTS ER SBRK RxE DTR TxE|
|
|
+---+---+---+---+---+---+---+---+
|
|
|
|
TxE - A 1 in this bit position enables transmit.
|
|
DTR - A 1 in this bit position forces *DTR to zero.
|
|
RxE - A 1 in this bit position enables receive.
|
|
SBRK - A 1 in this bit position forces TxD to zero.
|
|
ER - A 1 in this bit position resets the error bits
|
|
RTS - A 1 in this bit position forces *RTS to zero.
|
|
IR - A 1 in this bit position returns the 8251 to Mode Instruction Format.
|
|
EH - A 1 in this bit position enables search for sync characters.
|
|
|
|
A read of the status port gets the port status:
|
|
|
|
Status Read Format
|
|
7 6 5 4 3 2 1 0
|
|
+---+---+---+---+---+---+---+---+
|
|
|DSR SD FE OE PE TxE RxR TxR|
|
|
+---+---+---+---+---+---+---+---+
|
|
|
|
TxR - A 1 in this bit position signals transmit ready to receive a character.
|
|
RxR - A 1 in this bit position signals receiver has a character.
|
|
TxE - A 1 in this bit position signals transmitter has no more characters to transmit.
|
|
PE - A 1 in this bit signals a parity error.
|
|
OE - A 1 in this bit signals an transmit overrun error.
|
|
FE - A 1 in this bit signals a framing error.
|
|
SD - A 1 in this bit position returns the 8251 to Mode Instruction Format.
|
|
DSR - A 1 in this bit position signals *DSR is at zero.
|
|
|
|
A read from the data port gets the typed character, a write
|
|
to the data port writes the character to the device.
|
|
*/
|
|
|
|
#include "system_defs.h"
|
|
|
|
#define UNIT_V_ANSI (UNIT_V_UF + 0) /* ANSI mode */
|
|
#define UNIT_ANSI (1 << UNIT_V_ANSI)
|
|
|
|
// 8251 status bits
|
|
|
|
#define TXR 0x01
|
|
#define RXR 0x02
|
|
#define TXE 0x04
|
|
#define SD 0x40
|
|
|
|
#define i8251_NAME "Intel i8251 UART Chip"
|
|
|
|
/* external globals */
|
|
|
|
/* external function prototypes */
|
|
|
|
extern uint8 reg_dev(uint8 (*routine)(t_bool, uint8, uint8), uint16, uint16, uint8);
|
|
extern uint8 unreg_dev(uint16);
|
|
|
|
/* globals */
|
|
|
|
static const char* i8251_desc(DEVICE *dptr) {
|
|
return i8251_NAME;
|
|
}
|
|
int i8251_num = 0;
|
|
int i8251_baseport[4] = { -1, -1, -1, -1 }; //base port
|
|
uint8 i8251_intnum[4] = { 0, 0, 0, 0 }; //interrupt number
|
|
uint8 i8251_verb[4] = { 0, 0, 0, 0 }; //verbose flag
|
|
|
|
/* function prototypes */
|
|
|
|
t_stat i8251_cfg(uint16 base, uint16 devnum, uint8 dummy);
|
|
t_stat i8251_clr(void);
|
|
t_stat i8251_show_param (FILE *st, UNIT *uptr, int32 val, CONST void *desc);
|
|
t_stat i8251_svc (UNIT *uptr);
|
|
t_stat i8251_reset (DEVICE *dptr);
|
|
uint8 i8251s(t_bool io, uint8 data, uint8 devnum);
|
|
uint8 i8251d(t_bool io, uint8 data, uint8 devnum);
|
|
void i8251_reset_dev(uint8 devnum);
|
|
|
|
/* i8251 Standard I/O Data Structures */
|
|
/* up to 4 i8251 devices */
|
|
|
|
UNIT i8251_unit[4] = {
|
|
{ UDATA (&i8251_svc, 0, 0), KBD_POLL_WAIT },
|
|
{ UDATA (&i8251_svc, 0, 0), KBD_POLL_WAIT },
|
|
{ UDATA (&i8251_svc, 0, 0), KBD_POLL_WAIT },
|
|
{ UDATA (&i8251_svc, 0, 0), KBD_POLL_WAIT }
|
|
};
|
|
|
|
REG i8251_reg[] = {
|
|
{ HRDATA (DATA0, i8251_unit[0].buf, 8) },
|
|
{ HRDATA (STAT0, i8251_unit[0].u3, 8) },
|
|
{ HRDATA (MODE0, i8251_unit[0].u4, 8) },
|
|
{ HRDATA (CMD0, i8251_unit[0].u5, 8) },
|
|
{ HRDATA (DATA1, i8251_unit[1].buf, 8) },
|
|
{ HRDATA (STAT1, i8251_unit[1].u3, 8) },
|
|
{ HRDATA (MODE1, i8251_unit[1].u4, 8) },
|
|
{ HRDATA (CMD1, i8251_unit[1].u5, 8) },
|
|
{ HRDATA (DATA2, i8251_unit[2].buf, 8) },
|
|
{ HRDATA (STAT2, i8251_unit[2].u3, 8) },
|
|
{ HRDATA (MODE2, i8251_unit[2].u4, 8) },
|
|
{ HRDATA (CMD2, i8251_unit[2].u5, 8) },
|
|
{ HRDATA (DATA3, i8251_unit[3].buf, 8) },
|
|
{ HRDATA (STAT3, i8251_unit[3].u3, 8) },
|
|
{ HRDATA (MODE3, i8251_unit[3].u4, 8) },
|
|
{ HRDATA (CMD3, i8251_unit[3].u5, 8) },
|
|
{ NULL }
|
|
};
|
|
|
|
DEBTAB i8251_debug[] = {
|
|
{ "ALL", DEBUG_all },
|
|
{ "FLOW", DEBUG_flow },
|
|
{ "READ", DEBUG_read },
|
|
{ "WRITE", DEBUG_write },
|
|
{ "XACK", DEBUG_xack },
|
|
{ "LEV1", DEBUG_level1 },
|
|
{ "LEV2", DEBUG_level2 },
|
|
{ NULL }
|
|
};
|
|
|
|
MTAB i8251_mod[] = {
|
|
{ UNIT_ANSI, 0, "ANSI", "ANSI", NULL },
|
|
{ UNIT_ANSI, UNIT_ANSI, "TTY", "TTY", NULL },
|
|
{ MTAB_XTD | MTAB_VDV, 0, "PARAM", NULL, NULL, i8251_show_param, NULL,
|
|
"show configured parametes for i8251" },
|
|
{ 0 }
|
|
};
|
|
|
|
/* address width is set to 16 bits to use devices in 8086/8088 implementations */
|
|
|
|
DEVICE i8251_dev = {
|
|
"I8251", //name
|
|
i8251_unit, //units
|
|
i8251_reg, //registers
|
|
i8251_mod, //modifiers
|
|
I8251_NUM, //numunits
|
|
16, //aradix
|
|
16, //awidth
|
|
1, //aincr
|
|
16, //dradix
|
|
8, //dwidth
|
|
NULL, //examine
|
|
NULL, //deposit
|
|
&i8251_reset, //reset
|
|
NULL, //boot
|
|
NULL, //attach
|
|
NULL, //detach
|
|
NULL, //ctxt
|
|
DEV_DEBUG+DEV_DISABLE+DEV_DIS, //flags
|
|
0, //dctrl
|
|
i8251_debug, //debflags
|
|
NULL, //memeory size change
|
|
NULL, //lname
|
|
NULL, //help routine
|
|
NULL, //attach help routine
|
|
NULL, //help context
|
|
&i8251_desc //device description
|
|
};
|
|
|
|
// i8251 configuration
|
|
|
|
t_stat i8251_cfg(uint16 base, uint16 devnum, uint8 dummy)
|
|
{
|
|
i8251_baseport[devnum] = base & 0xff;
|
|
sim_printf(" i8251%d: installed at base port 0%02XH\n",
|
|
devnum, i8251_baseport[devnum]);
|
|
reg_dev(i8251d, i8251_baseport[devnum], devnum, 0);
|
|
reg_dev(i8251s, i8251_baseport[devnum] + 1, devnum, 0);
|
|
i8251_num++; //next device
|
|
return SCPE_OK;
|
|
}
|
|
|
|
t_stat i8251_clr(void)
|
|
{
|
|
int i;
|
|
|
|
for (i=0; i<i8251_num; i++) {
|
|
unreg_dev(i8251_baseport[i]);
|
|
unreg_dev(i8251_baseport[i] + 1);
|
|
i8251_baseport[i] = -1;
|
|
i8251_intnum[i] = 0;
|
|
i8251_verb[i] = 0;
|
|
}
|
|
i8251_num = 0;
|
|
return SCPE_OK;
|
|
}
|
|
|
|
// show configuration parameters
|
|
|
|
t_stat i8251_show_param (FILE *st, UNIT *uptr, int32 val, CONST void *desc)
|
|
{
|
|
int i;
|
|
|
|
if (uptr == NULL)
|
|
return SCPE_ARG;
|
|
fprintf(st, "Device %s\n", ((i8251_dev.flags & DEV_DIS) == 0) ? "Enabled" : "Disabled");
|
|
for (i=0; i<i8251_num; i++) {
|
|
fprintf(st, "Unit %d at Base port ", i);
|
|
fprintf(st, "0%02XH, ", i8251_baseport[i]);
|
|
fprintf(st, "Interrupt # is ");
|
|
fprintf(st, "%d, ", i8251_intnum[i]);
|
|
fprintf(st, "Mode ");
|
|
fprintf(st, "%s", i8251_verb[i] ? "Verbose" : "Quiet");
|
|
if (i<i8251_num && i8251_num != 1) fprintf(st, "\n");
|
|
}
|
|
return SCPE_OK;
|
|
}
|
|
|
|
/* Service routines to handled simulator functions */
|
|
|
|
/* i8251_svc - actually gets char & places in buffer */
|
|
|
|
t_stat i8251_svc (UNIT *uptr)
|
|
{
|
|
int32 temp;
|
|
|
|
sim_activate (uptr, uptr->wait); /* continue poll */
|
|
if ((temp = sim_poll_kbd ()) < SCPE_KFLAG)
|
|
return temp; /* no char or error? */
|
|
uptr->buf = temp & 0x7F; /* Save char */
|
|
if (uptr->flags & UNIT_ANSI)
|
|
uptr->buf = toupper(uptr->buf);
|
|
uptr->u3 |= RXR; /* Set status */
|
|
return SCPE_OK;
|
|
}
|
|
|
|
/* Reset routine */
|
|
|
|
t_stat i8251_reset (DEVICE *dptr)
|
|
{
|
|
uint8 devnum;
|
|
|
|
for (devnum=0; devnum<I8251_NUM; devnum++) {
|
|
i8251_reset_dev(devnum);
|
|
if (devnum == 0)
|
|
sim_activate (&i8251_unit[devnum], i8251_unit[devnum].wait); /* activate unit */
|
|
}
|
|
return SCPE_OK;
|
|
}
|
|
|
|
void i8251_reset_dev(uint8 devnum)
|
|
{
|
|
i8251_unit[devnum].u3 = TXR + TXE; /* status */
|
|
i8251_unit[devnum].u4 = 0; /* mode instruction */
|
|
i8251_unit[devnum].u5 = 0; /* command instruction */
|
|
i8251_unit[devnum].u6 = 0;
|
|
i8251_unit[devnum].buf = 0;
|
|
i8251_unit[devnum].pos = 0;
|
|
}
|
|
|
|
/* I/O instruction handlers, called from the CPU module when an
|
|
IN or OUT instruction is issued.
|
|
*/
|
|
|
|
uint8 i8251s(t_bool io, uint8 data, uint8 devnum)
|
|
{
|
|
if (io == 0) { /* read status port */
|
|
return i8251_unit[devnum].u3;
|
|
} else { /* write status port */
|
|
if (i8251_unit[devnum].u4) { /* if mode, set cmd */
|
|
i8251_unit[devnum].u5 = data;
|
|
if (data & SD) /* reset port! */
|
|
i8251_reset_dev(devnum);
|
|
} else { /* set mode */
|
|
i8251_unit[devnum].u4 = data;
|
|
i8251_unit[devnum].u6 = 1; /* set cmd received */
|
|
}
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
uint8 i8251d(t_bool io, uint8 data, uint8 devnum)
|
|
{
|
|
if (io == 0) { /* read data port */
|
|
i8251_unit[devnum].u3 &= ~RXR;
|
|
return (i8251_unit[devnum].buf);
|
|
} else { /* write data port */
|
|
sim_putchar(data);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
/* end of i8251.c */
|