sys/arch/sun3/dev/xyreg.h

   1 /* $NetBSD: xyreg.h,v 1.2.2.3 2004/09/21 13:23:20 skrll Exp $ */
   2
   3 /*
   4  *
   5  * Copyright (c) 1995 Charles D. Cranor
   6  * All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  * 3. All advertising materials mentioning features or use of this software
  17  *    must display the following acknowledgement:
  18  *      This product includes software developed by Charles D. Cranor.
  19  * 4. The name of the author may not be used to endorse or promote products
  20  *    derived from this software without specific prior written permission.
  21  *
  22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  31  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32  */
  33
  34 /*
  35  * x y r e g . h
  36  *
  37  * this file contains the description of the Xylogics 450/451's hardware
  38  * data structures.
  39  *
  40  * author: Chuck Cranor <chuck@ccrc.wustl.edu>
  41  */
  42
  43 #define XYC_MAXDEV    2       /* max devices per controller */
  44 #define XYC_CTLIOPB   XYC_MAXDEV /* controller's iopb */
  45 #define XYC_RESETUSEC 1000000 /* max time for xyc reset (same as xdc?) */
  46 #define XYC_MAXIOPB   (XYC_MAXDEV+1)
  47                               /* max number of iopbs that can be active */
  48 #define XYC_MAXTIME   4*1000000 /* four seconds before we give up and reset */
  49 #define XYC_MAXTRIES  4       /* max number of times to retry an operation */
  50 #define XYC_INTERLEAVE 1      /* interleave (from disk label?) */
  51 #define XYFM_BPS        0x200 /* must be 512! */
  52
  53 /*
  54  * xyc device interface
  55  * (lives in VME address space)   [note: bytes are swapped!]
  56  */
  57
  58 struct xyc {
  59   volatile u_char xyc_reloc_hi;        /* iopb relocation (low byte) */
  60   volatile u_char xyc_reloc_lo;        /* iopb relocation (high byte) */
  61   volatile u_char xyc_addr_hi;         /* iopb address (low byte) */
  62   volatile u_char xyc_addr_lo;         /* iopb address (high byte) */
  63   volatile u_char xyc_rsetup;          /* reset/update reg */
  64   volatile u_char xyc_csr;             /* control and status register */
  65 };
  66
  67 /*
  68  * xyc_csr
  69  */
  70
  71 #define XYC_GBSY     0x80     /* go/busy */
  72 #define XYC_ERR      0x40     /* error */
  73 #define XYC_DERR     0x20     /* double error! */
  74 #define XYC_IPND     0x10     /* interrupt pending */
  75 #define XYC_ADRM     0x08     /* 24-bit addressing */
  76 #define XYC_AREQ     0x04     /* attention request */
  77 #define XYC_AACK     0x02     /* attention ack. */
  78 #define XYC_DRDY     0x01     /* drive ready */
  79
  80 /*
  81  * Input/Output Parameter Block (iopb)
  82  *
  83  * all controller commands are done via iopb's.   to start a command you
  84  * must do this:
  85  * [1] allocate space in DVMA space for the iopb
  86  * [2] fill out all the fields of the iopb
  87  * [3] if the controller isn't busy, start the iopb by loading the address
  88  *     and reloc in the xyc's registers and setting the "go" bit [done]
  89  * [4] controller busy: set AREQ bit, and wait for AACK bit.
  90  *     add iopb to the chain, and clear AREQ to resume I/O
  91  *
  92  * when the controller is done with a command it may interrupt (if you
  93  * ask it to) and it will set the XYC_IPND bit in the csr.   clear
  94  * the interrupt by writing one to this bit.
  95  *
  96  * the format of the iopb is described in section 2.4 of the manual.
  97  * note that it is byte-swapped on the sun.
  98  */
  99
 100 struct xy_iopb {
 101                                  /* section 2.4.2: byte 1 */
 102   volatile u_char resv1:1;       /* reserved */
 103   volatile u_char iei:1;         /* interrupt on each IOPB done */
 104   volatile u_char ierr:1;        /* interrupt on error (no effect on 450) */
 105   volatile u_char hdp:1;         /* hold dual port drive */
 106   volatile u_char asr:1;         /* autoseek retry */
 107   volatile u_char eef:1;         /* enable extended fn. (overlap seek) */
 108   volatile u_char ecm:2;         /* ECC correction mode */
 109 #define XY_ECM 2                 /* use mode 2 (see section 2.4.2) */
 110                                  /* section 2.4.1: byte 0 */
 111   volatile u_char aud:1;         /* auto-update iopb */
 112   volatile u_char relo:1;        /* enable multibus relocation (>16bit addrs)*/
 113   volatile u_char chen:1;        /* chain enable, "next iopb" is valid */
 114   volatile u_char ien:1;         /* interrupt enable */
 115   volatile u_char com:4;         /* command */
 116 #define XYCMD_NOP 0x0            /* no-op */
 117 #define XYCMD_WR  0x1            /* write */
 118 #define XYCMD_RD  0x2            /* read */
 119 #define XYCMD_WTH 0x3            /* write track headers */
 120 #define XYCMD_RTH 0x4            /* read track headers */
 121 #define XYCMD_SK  0x5            /* seek */
 122 #define XYCMD_RST 0x6            /* drive reset */
 123 #define XYCMD_WFM 0x7            /* write format */
 124 #define XYCMD_RDH 0x8            /* read header, data, and ECC */
 125 #define XYCMD_RDS 0x9            /* read drive status */
 126 #define XYCMD_WRH 0xa            /* write header, data, and ECC */
 127 #define XYCMD_SDS 0xb            /* set drive size */
 128 #define XYCMD_ST  0xc            /* self test */
 129 #define XYCMD_R   0xd            /* reserved */
 130 #define XYCMD_MBL 0xe            /* maint. buffer load */
 131 #define XYCMD_MBD 0xf            /* main. buffer dump */
 132                                  /* section 2.4.4: byte 3 */
 133   volatile u_char errno;         /* error or completion code */
 134                                  /* section 2.4.3: byte 2 */
 135   volatile u_char errs:1;        /* error summary bit */
 136   volatile u_char resv2:2;       /* reserved */
 137   volatile u_char ctyp:3;        /* controller type */
 138 #define XYCT_450 1               /* the 450 controller */
 139   volatile u_char resv3:1;       /* reserved */
 140   volatile u_char done:1;        /* done! */
 141                                  /* section 2.4.6: byte 5 */
 142   volatile u_char dt:2;          /* drive type */
 143 #define XYC_MAXDT 3              /* largest drive type possible */
 144   volatile u_char resv4:4;       /* reserved */
 145   volatile u_char unit:2;        /* unit # */
 146                                  /* section 2.4.5: byte 4 */
 147   volatile u_char bw:1;          /* byte(1)/word(0) xfer size */
 148   volatile u_char intlv:4;       /* interleave factor (0=1:1, 1=2:1, etc.) */
 149   volatile u_char thro:3;        /* DMA throttle (0=2,1=4,2=8, etc...) */
 150 #define XY_THRO 4                /* 4 == 32 DMA cycles */
 151                                  /* section 2.4.8: byte 7 */
 152   volatile u_char sect;          /* sector # */
 153                                  /* section 2.4.7: byte 6 */
 154   volatile u_char head;          /* head # */
 155                                  /* section 2.4.9: byte 8,9 */
 156   volatile u_short cyl;          /* cyl # */
 157                                  /* section 2.4.10: byte a,b */
 158   volatile u_short scnt;         /* sector count, also drive status */
 159 #define xy_dr_status scnt
 160 #define XYS_ONCL 0x80            /* on-cylinder (active LOW) */
 161 #define XYS_DRDY 0x40            /* drive ready (active LOW) */
 162 #define XYS_WRPT 0x20            /* write protect */
 163 #define XYS_DPB  0x10            /* dual-port busy */
 164 #define XYS_SKER 0x08            /* hard seek error */
 165 #define XYS_DFLT 0x04            /* disk fault */
 166                                  /* section 2.4.11: byte c,d */
 167   volatile u_short dataa;        /* data address */
 168                                  /* section 2.4.12: byte e,f */
 169   volatile u_short datar;        /* data relocation pointer */
 170                                  /* section 2.4.14: byte 11 */
 171   volatile u_char subfn;         /* sub-function */
 172                                  /* section 2.4.13: byte 10 */
 173   volatile u_char hoff;          /* head offset for fixed/removable drives */
 174                                  /* section 2.4.15: byte 12,13 */
 175   volatile u_short nxtiopb;      /* next iopb address (same relocation) */
 176                                  /* section 2.4.16: byte 14,15 */
 177   volatile u_short eccpat;       /* ecc pattern */
 178                                  /* section 2.4.17: byte 16,17 */
 179   volatile u_short eccaddr;      /* ecc address */
 180 };
 181
 182
 183 /*
 184  * errors (section 2.4.4.1)
 185  */
 186
 187 /* software error codes */
 188 #define XY_ERR_FAIL 0xff         /* general total failure */
 189 #define XY_ERR_DERR 0xfe         /* double error */
 190 /* no error */
 191 #define XY_ERR_AOK  0x00         /* success */
 192
 193 #define XY_ERR_IPEN 0x01         /* interrupt pending */
 194 #define XY_ERR_BCFL 0x03         /* busy conflict */
 195 #define XY_ERR_TIMO 0x04         /* operation timeout */
 196 #define XY_ERR_NHDR 0x05         /* header not found */
 197 #define XY_ERR_HARD 0x06         /* hard ECC error */
 198 #define XY_ERR_ICYL 0x07         /* illegal cylinder address */
 199 #define XY_ERR_ISEC 0x0a         /* illegal sector address */
 200 #define XY_ERR_SMAL 0x0d         /* last sector too small */
 201 #define XY_ERR_SACK 0x0e         /* slave ACK error (non-existent memory) */
 202 #define XY_ERR_CHER 0x12         /* cylinder and head/header error */
 203 #define XY_ERR_SRTR 0x13         /* auto-seek retry successful */
 204 #define XY_ERR_WPRO 0x14         /* write-protect error */
 205 #define XY_ERR_UIMP 0x15         /* unimplemented command */
 206 #define XY_ERR_DNRY 0x16         /* drive not ready */
 207 #define XY_ERR_SZER 0x17         /* sector count zero */
 208 #define XY_ERR_DFLT 0x18         /* drive faulted */
 209 #define XY_ERR_ISSZ 0x19         /* illegal sector size */
 210 #define XY_ERR_SLTA 0x1a         /* self test a */
 211 #define XY_ERR_SLTB 0x1b         /* self test b */
 212 #define XY_ERR_SLTC 0x1c         /* self test c */
 213 #define XY_ERR_SOFT 0x1e         /* soft ECC error */
 214 #define XY_ERR_SFOK 0x1f         /* soft ECC error recovered */
 215 #define XY_ERR_IHED 0x20         /* illegal head */
 216 #define XY_ERR_DSEQ 0x21         /* disk sequencer error */
 217 #define XY_ERR_SEEK 0x25         /* seek error */
 218
 219
 220 /* error actions */
 221 #define XY_ERA_PROG 0x10         /* program error: quit */
 222 #define XY_ERA_SOFT 0x30         /* soft error: we recovered */
 223 #define XY_ERA_HARD 0x40         /* hard error: retry */
 224 #define XY_ERA_RSET 0x60         /* hard error: reset, then retry */
 225 #define XY_ERA_WPRO 0x90         /* write protected */
 226
 227