sim_tape.h

   1 /* sim_tape.h: simulator tape support library definitions
   2
   3    Copyright (c) 1993-2006, Robert M Supnik
   4
   5    Permission is hereby granted, free of charge, to any person obtaining a
   6    copy of this software and associated documentation files (the "Software"),
   7    to deal in the Software without restriction, including without limitation
   8    the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9    and/or sell copies of the Software, and to permit persons to whom the
  10    Software is furnished to do so, subject to the following conditions:
  11
  12    The above copyright notice and this permission notice shall be included in
  13    all copies or substantial portions of the Software.
  14
  15    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18    ROBERT M SUPNIK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  19    IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  20    CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  21
  22    Except as contained in this notice, the name of Robert M Supnik shall not be
  23    used in advertising or otherwise to promote the sale, use or other dealings
  24    in this Software without prior written authorization from Robert M Supnik.
  25
  26    30-Aug-06    JDB     Added erase gap support
  27    14-Feb-06    RMS     Added variable tape capacity
  28    17-Dec-05    RMS     Added write support for Paul Pierce 7b format
  29    02-May-05    RMS     Added support for Paul Pierce 7b format
  30 */
  31
  32 #ifndef _SIM_TAPE_H_
  33 #define _SIM_TAPE_H_    0
  34
  35 /* SIMH/E11 tape format */
  36
  37 typedef uint32          t_mtrlnt;                       /* magtape rec lnt */
  38
  39 #define MTR_TMK         0x00000000                      /* tape mark */
  40 #define MTR_EOM         0xFFFFFFFF                      /* end of medium */
  41 #define MTR_GAP         0xFFFFFFFE                      /* primary gap */
  42 #define MTR_FHGAP       0xFFFEFFFF                      /* fwd half gap (overwrite) */
  43 #define MTR_RHGAP       0xFFFF0000                      /* rev half gap (overwrite) */
  44 #define MTR_M_RHGAP     (~0x000080FF)                   /* range mask for rev gap */
  45 #define MTR_MAXLEN      0x00FFFFFF                      /* max len is 24b */
  46 #define MTR_ERF         0x80000000                      /* error flag */
  47 #define MTR_F(x)        ((x) & MTR_ERF)                 /* record error flg */
  48 #define MTR_L(x)        ((x) & ~MTR_ERF)                /* record length */
  49
  50 /* TPC tape format */
  51
  52 typedef uint16          t_tpclnt;                       /* magtape rec lnt */
  53
  54 /* P7B tape format */
  55
  56 #define P7B_SOR         0x80                            /* start of record */
  57 #define P7B_PAR         0x40                            /* parity */
  58 #define P7B_DATA        0x3F                            /* data */
  59 #define P7B_DPAR        (P7B_PAR|P7B_DATA)              /* data and parity */
  60 #define P7B_EOF         0x0F                            /* eof character */
  61
  62 #define TPC_TMK         0x0000                          /* tape mark */
  63
  64 /* Unit flags */
  65
  66 #define MTUF_V_PNU      (UNIT_V_UF + 0)                 /* position not upd */
  67 #define MTUF_V_WLK      (UNIT_V_UF + 1)                 /* write locked */
  68 #define MTUF_V_FMT      (UNIT_V_UF + 2)                 /* tape file format */
  69 #define MTUF_W_FMT      3                               /* 3b of formats */
  70 #define MTUF_N_FMT      (1u << MTUF_W_FMT)              /* number of formats */
  71 #define MTUF_M_FMT      ((1u << MTUF_W_FMT) - 1)
  72 #define MTUF_F_STD       0                              /* SIMH format */
  73 #define MTUF_F_E11       1                              /* E11 format */
  74 #define MTUF_F_TPC       2                              /* TPC format */
  75 #define MTUF_F_P7B       3                              /* P7B format */
  76 #define MUTF_F_TDF       4                              /* TDF format */
  77 #define MTUF_V_UF       (MTUF_V_FMT + MTUF_W_FMT)
  78 #define MTUF_PNU        (1u << MTUF_V_PNU)
  79 #define MTUF_WLK        (1u << MTUF_V_WLK)
  80 #define MTUF_FMT        (MTUF_M_FMT << MTUF_V_FMT)
  81 #define MTUF_WRP        (MTUF_WLK | UNIT_RO)
  82
  83 #define MT_F_STD        (MTUF_F_STD << MTUF_V_FMT)
  84 #define MT_F_E11        (MTUF_F_E11 << MTUF_V_FMT)
  85 #define MT_F_TPC        (MTUF_F_TPC << MTUF_V_FMT)
  86 #define MT_F_P7B        (MTUF_F_P7B << MTUF_V_FMT)
  87 #define MT_F_TDF        (MTUF_F_TDF << MTUF_V_FMT)
  88
  89 #define MT_SET_PNU(u)   (u)->flags = (u)->flags | MTUF_PNU
  90 #define MT_CLR_PNU(u)   (u)->flags = (u)->flags & ~MTUF_PNU
  91 #define MT_TST_PNU(u)   ((u)->flags & MTUF_PNU)
  92 #define MT_GET_FMT(u)   (((u)->flags >> MTUF_V_FMT) & MTUF_M_FMT)
  93
  94 /* Return status codes */
  95
  96 #define MTSE_OK         0                               /* no error */
  97 #define MTSE_TMK        1                               /* tape mark */
  98 #define MTSE_UNATT      2                               /* unattached */
  99 #define MTSE_IOERR      3                               /* IO error */
 100 #define MTSE_INVRL      4                               /* invalid rec lnt */
 101 #define MTSE_FMT        5                               /* invalid format */
 102 #define MTSE_BOT        6                               /* beginning of tape */
 103 #define MTSE_EOM        7                               /* end of medium */
 104 #define MTSE_RECE       8                               /* error in record */
 105 #define MTSE_WRP        9                               /* write protected */
 106
 107 /* Prototypes */
 108
 109 t_stat sim_tape_attach (UNIT *uptr, char *cptr);
 110 t_stat sim_tape_detach (UNIT *uptr);
 111 t_stat sim_tape_rdrecf (UNIT *uptr, uint8 *buf, t_mtrlnt *bc, t_mtrlnt max);
 112 t_stat sim_tape_rdrecr (UNIT *uptr, uint8 *buf, t_mtrlnt *bc, t_mtrlnt max);
 113 t_stat sim_tape_wrrecf (UNIT *uptr, uint8 *buf, t_mtrlnt bc);
 114 t_stat sim_tape_wrtmk (UNIT *uptr);
 115 t_stat sim_tape_wreom (UNIT *uptr);
 116 t_stat sim_tape_wrgap (UNIT *uptr, uint32 gaplen, uint32 bpi);
 117 t_stat sim_tape_sprecf (UNIT *uptr, t_mtrlnt *bc);
 118 t_stat sim_tape_sprecr (UNIT *uptr, t_mtrlnt *bc);
 119 t_stat sim_tape_rewind (UNIT *uptr);
 120 t_stat sim_tape_reset (UNIT *uptr);
 121 t_bool sim_tape_bot (UNIT *uptr);
 122 t_bool sim_tape_wrp (UNIT *uptr);
 123 t_bool sim_tape_eot (UNIT *uptr);
 124 t_stat sim_tape_set_fmt (UNIT *uptr, int32 val, char *cptr, void *desc);
 125 t_stat sim_tape_show_fmt (FILE *st, UNIT *uptr, int32 val, void *desc);
 126 t_stat sim_tape_set_capac (UNIT *uptr, int32 val, char *cptr, void *desc);
 127 t_stat sim_tape_show_capac (FILE *st, UNIT *uptr, int32 val, void *desc);
 128
 129 #endif