First Commit of my working state

[simh.git] / PDP10 / pdp10_fe.c

/* pdp10_fe.c: PDP-10 front end (console terminal) simulator\r
\r
   Copyright (c) 1993-2007, Robert M Supnik\r
\r
   Permission is hereby granted, free of charge, to any person obtaining a\r
   copy of this software and associated documentation files (the "Software"),\r
   to deal in the Software without restriction, including without limitation\r
   the rights to use, copy, modify, merge, publish, distribute, sublicense,\r
   and/or sell copies of the Software, and to permit persons to whom the\r
   Software is furnished to do so, subject to the following conditions:\r
\r
   The above copyright notice and this permission notice shall be included in\r
   all copies or substantial portions of the Software.\r
\r
   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r
   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL\r
   ROBERT M SUPNIK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
   IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
   CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
\r
   Except as contained in this notice, the name of Robert M Supnik shall not be\r
   used in advertising or otherwise to promote the sale, use or other dealings\r
   in this Software without prior written authorization from Robert M Supnik.\r
\r
   fe           KS10 console front end\r
\r
   18-Jun-07    RMS     Added UNIT_IDLE flag to console input\r
   17-Oct-06    RMS     Synced keyboard to clock for idling\r
   28-May-04    RMS     Removed SET FE CTRL-C\r
   29-Dec-03    RMS     Added console backpressure support\r
   25-Apr-03    RMS     Revised for extended file support\r
   22-Dec-02    RMS     Added break support\r
   30-May-02    RMS     Widened COUNT to 32b\r
   30-Nov-01    RMS     Added extended SET/SHOW support\r
   23-Oct-01    RMS     New IO page address constants\r
   07-Sep-01    RMS     Moved function prototypes\r
*/\r
\r
#include "pdp10_defs.h"\r
#define UNIT_DUMMY      (1 << UNIT_V_UF)\r
\r
extern d10 *M;\r
extern int32 apr_flg;\r
extern int32 tmxr_poll;\r
t_stat fei_svc (UNIT *uptr);\r
t_stat feo_svc (UNIT *uptr);\r
t_stat fe_reset (DEVICE *dptr);\r
t_stat fe_stop_os (UNIT *uptr, int32 val, char *cptr, void *desc);\r
\r
/* FE data structures\r
\r
   fe_dev       FE device descriptor\r
   fe_unit      FE unit descriptor\r
   fe_reg       FE register list\r
*/\r
\r
#define fei_unit        fe_unit[0]\r
#define feo_unit        fe_unit[1]\r
\r
UNIT fe_unit[] = {\r
    { UDATA (&fei_svc, UNIT_IDLE, 0), 0 },\r
    { UDATA (&feo_svc, 0, 0), SERIAL_OUT_WAIT }\r
    };\r
\r
REG fe_reg[] = {\r
    { ORDATA (IBUF, fei_unit.buf, 8) },\r
    { DRDATA (ICOUNT, fei_unit.pos, T_ADDR_W), REG_RO + PV_LEFT },\r
    { DRDATA (ITIME, fei_unit.wait, 24), PV_LEFT },\r
    { ORDATA (OBUF, feo_unit.buf, 8) },\r
    { DRDATA (OCOUNT, feo_unit.pos, T_ADDR_W), REG_RO + PV_LEFT },\r
    { DRDATA (OTIME, feo_unit.wait, 24), REG_NZ + PV_LEFT },\r
    { NULL }\r
    };\r
\r
MTAB fe_mod[] = {\r
    { UNIT_DUMMY, 0, NULL, "STOP", &fe_stop_os },\r
    { 0 }\r
    };\r
\r
DEVICE fe_dev = {\r
    "FE", fe_unit, fe_reg, fe_mod,\r
    2, 10, 31, 1, 8, 8,\r
    NULL, NULL, &fe_reset,\r
    NULL, NULL, NULL\r
    };\r
\r
/* Front end processor (console terminal)\r
\r
   Communications between the KS10 and its front end is based on an in-memory\r
   status block and two interrupt lines: interrupt-to-control (APR_ITC) and\r
   interrupt-from-console (APR_CON).  When the KS10 wants to print a character\r
   on the terminal,\r
\r
   1. It places a character, plus the valid flag, in FE_CTYOUT.\r
   2. It interrupts the front end processor.\r
   3. The front end processor types the character and then zeroes FE_CTYOUT.\r
   4. The front end procesor interrupts the KS10.\r
\r
   When the front end wants to send an input character to the KS10,\r
\r
   1. It places a character, plus the valid flag, in FE_CTYIN.\r
   2. It interrupts the KS10.\r
   3. It waits for the KS10 to take the character and clear the valid flag.\r
   4. It can then send more input (the KS10 may signal this by interrupting\r
      the front end).\r
\r
   Note that the protocol has both ambiguity (interrupt to the KS10 may mean\r
   character printed, or input character available, or both) and lack of\r
   symmetry (the KS10 does not inform the front end that it has taken an\r
   input character).  \r
*/\r
\r
void fe_intr (void)\r
{\r
if (M[FE_CTYOUT] & FE_CVALID) {                         /* char to print? */\r
    feo_unit.buf = (int32) M[FE_CTYOUT] & 0177;         /* pick it up */\r
    feo_unit.pos = feo_unit.pos + 1;\r
    sim_activate (&feo_unit, feo_unit.wait);            /* sched completion */\r
    }\r
else if ((M[FE_CTYIN] & FE_CVALID) == 0) {              /* input char taken? */\r
    sim_cancel (&fei_unit);                             /* sched immediate */\r
    sim_activate (&fei_unit, 0);                        /* keyboard poll */\r
    }\r
return;\r
}\r
\r
t_stat feo_svc (UNIT *uptr)\r
{\r
t_stat r;\r
\r
if ((r = sim_putchar_s (uptr->buf)) != SCPE_OK) {       /* output; error? */\r
    sim_activate (uptr, uptr->wait);                    /* try again */\r
    return ((r == SCPE_STALL)? SCPE_OK: r);             /* !stall? report */\r
    }\r
M[FE_CTYOUT] = 0;                                       /* clear char */\r
apr_flg = apr_flg | APRF_CON;                           /* interrupt KS10 */\r
return SCPE_OK;\r
}\r
\r
t_stat fei_svc (UNIT *uptr)\r
{\r
int32 temp;\r
\r
sim_activate (uptr, KBD_WAIT (uptr->wait, tmxr_poll));  /* continue poll */\r
if ((temp = sim_poll_kbd ()) < SCPE_KFLAG) return temp; /* no char or error? */\r
if (temp & SCPE_BREAK) return SCPE_OK;                  /* ignore break */\r
uptr->buf = temp & 0177;\r
uptr->pos = uptr->pos + 1;\r
M[FE_CTYIN] = uptr->buf | FE_CVALID;                    /* put char in mem */\r
apr_flg = apr_flg | APRF_CON;                           /* interrupt KS10 */\r
return SCPE_OK;\r
}\r
\r
/* Reset */\r
\r
t_stat fe_reset (DEVICE *dptr)\r
{\r
fei_unit.buf = feo_unit.buf = 0;\r
M[FE_CTYIN] = M[FE_CTYOUT] = 0;\r
apr_flg = apr_flg & ~(APRF_ITC | APRF_CON);\r
sim_activate_abs (&fei_unit, KBD_WAIT (fei_unit.wait, tmxr_poll));\r
return SCPE_OK;\r
}\r
\r
/* Stop operating system */\r
\r
t_stat fe_stop_os (UNIT *uptr, int32 val, char *cptr, void *desc)\r
{\r
M[FE_SWITCH] = IOBA_RP;                                 /* tell OS to stop */\r
return SCPE_OK;\r
}\r