Annotation of 43BSD/sys/vaxuba/npreg.h, revision 1.1

1.1     ! root        1: /*
        !             2:  * Copyright (c) 1986 MICOM-Interlan, Inc., Boxborough Mass
        !             3:  * All rights reserved.  The Berkeley software License Agreement
        !             4:  * specifies the terms and conditions for redistribution.
        !             5:  *
        !             6:  *     @(#)npreg.h     7.1 (Berkeley) 6/5/86
        !             7:  */
        !             8: 
        !             9: /*
        !            10:  *                     NPREG.H
        !            11:  *
        !            12:  * This file contain definitions of specific hardware interest
        !            13:  * to be used when communicating with the NI1510 Network Processor
        !            14:  * Board. More complete information can be found in the NI1510
        !            15:  * Multibus compatible Ethernet Communications Processor Hardware 
        !            16:  * Specification.
        !            17:  */
        !            18: 
        !            19: 
        !            20: #define NNPCNN         4       /* Number of connections per board */
        !            21: #define NPUNIT(a)      ((minor(a) >> 4) & 0x0F)
        !            22: #define NPCONN(a)      ((minor(a)) & 0x03)
        !            23: 
        !            24: #define TRUE           1
        !            25: #define FALSE          0
        !            26: 
        !            27: #define IBOOTADDR      0xF8000l        /* Addr of 80186 Boot ROM */
        !            28: #define        INETBOOT        0xF8087l
        !            29: #define IXEQADDR       0x400           /* Where to begin Board image XEQ */
        !            30: #define DIAGTIME       1200            /* Time for timeout /HZ seconds */
        !            31: 
        !            32: #define        DELAYTIME       1000000L                /* delay count */
        !            33: #define NPDELAY(N)     {register int n = (N) >> 1; while(--n > 0); }
        !            34: 
        !            35: /* Handy macros for talking to the Board */
        !            36: 
        !            37: #define RESET(x)       (WCSR3(x->iobase,0xff))
        !            38: #define CLEARINT(x)    {unsign16 y; y = RCSR2(x->iobase); }
        !            39: #define INTNI(x)       (WCSR1(x->iobase,0xFF))
        !            40: 
        !            41: /* Command and Status Register (CSR) Definitions */
        !            42: 
        !            43: /*
        !            44:  * CSR0 is the only direct means for data transfer between the host processor
        !            45:  * and the 3510. Access is controlled by the 80186 who sets the CSR1 Enable and
        !            46:  * Ready bits to allow writing here. Writing to this register will always
        !            47:  * result in an interrupt to the 80186.
        !            48:  */
        !            49: 
        !            50: /* 
        !            51:  * Bit definitions for CSR1.
        !            52:  */
        !            53: 
        !            54: #define NPRFU  0x01            /* Reserved for Future Use */
        !            55: #define NPHOK  0x02            /* Hardware OK */
        !            56: #define NPLAN  0x04            /* Logic 0 indicates operational LAN exists */
        !            57: #define NP_IP  0x08            /* Interrupt pending from this board */
        !            58: #define NP_IE  0x10            /* Interrupts enabled for this board */
        !            59: #define NPRDR  0x20            /* Set when 80186 writes data into CSR0 */
        !            60: #define NPRDY  0x40            /* CSR0 ready to accept data */
        !            61: #define NPENB  0x80            /* CSR0 available for use by the host */
        !            62: 
        !            63: /*
        !            64:  * Bit defintions for CSR0 Command Block
        !            65:  */
        !            66: 
        !            67: #define NPLST  0x20            /* Last Command */
        !            68: #define NPCMD  0x80            /* Shared Memory Address */
        !            69: #define NPBGN  0x200           /* Begin Execution in On-Board Memory */
        !            70: #define NPCBI  0x800           /* Interrupt at completion of Command Block */
        !            71: #define NPDMP  0x2000          /* Dump 80186 On-Board Memory to Multibus */
        !            72: #define NPLD   0x8000          /* Load 80186 On-board Memory from Multibus */
        !            73: 
        !            74: /*
        !            75:  * CSR0 Count definitions. These are the lengths of the Command Blocks for the
        !            76:  * CSR0 commands above (not counting the Command Word itself).
        !            77:  */
        !            78: 
        !            79: #define LSTCNT 0
        !            80: #define CMDCNT 2
        !            81: #define BGNCNT 2
        !            82: #define CBICNT 1
        !            83: #define DMPCNT 5
        !            84: #define LDCNT  5
        !            85: #define IOCNT  5
        !            86: 
        !            87: /* Macros for reading and writing CSR's (Control and Status Registers) */
        !            88: 
        !            89: #define        WCSR0(x,y)      ((x)->CSR0 = y)
        !            90: #define        WCSR1(x,y)      ((x)->CSR1 = y)
        !            91: #define        WCSR2(x,y)      ((x)->CSR2 = y)
        !            92: #define        WCSR3(x,y)      ((x)->CSR3 = y)
        !            93: 
        !            94: #define        RCSR0(x)        ((x)->CSR0)
        !            95: #define        RCSR1(x)        ((x)->CSR1)
        !            96: #define        RCSR2(x)        ((x)->CSR2)
        !            97: #define        RCSR3(x)        ((x)->CSR3)
        !            98: 
        !            99: #define NPRESET                0x01            /* reset the board */
        !           100: #define        NPSTART         0x04            /* start board execution */
        !           101: #define        NPGPANIC        0x05            /* Get panic message */
        !           102: #define        NPINIT          0x06            /* initialize software on board */
        !           103: #define NPSTATS        0x07
        !           104: #define        NPRCSR0         0x08            /* read CSR0 */
        !           105: #define        NPRCSR1         0x09            /* read CSR1 */
        !           106: #define        NPRCSR2         0x0a            /* read CSR2 */
        !           107: #define        NPRCSR3         0x0b            /* read CSR3 */
        !           108: #define        NPWCSR0         0x0c            /* write CSR0 */
        !           109: #define        NPWCSR1         0x0d            /* write CSR1 */
        !           110: #define        NPWCSR2         0x0e            /* write CSR2 */
        !           111: #define        NPWCSR3         0x0f            /* write CSR3 */
        !           112: #define NPPOLL         0x10
        !           113: #define NPKILL         0x11
        !           114: #define        NPSETPROT       0x12            /* set the protocol to use */
        !           115: #define        NPSETBOARD      0x13            /* set board to use */
        !           116: #define        NPSETNPDEB      0x14            /* set nc debuging level */
        !           117: #define        NPSETADDR       0x15            /* set host address */
        !           118: #define        NPNETBOOT       0x16            /* boot from the network */
        !           119: 
        !           120: /* ICP Board Requests */
        !           121: 
        !           122: #define ICPLOAD  0x02
        !           123: #define ICPDUMP  0x03
        !           124: #define ICPPANIC 0x05
        !           125: #define ICPPOLL  0x10
        !           126: 
        !           127: /*
        !           128:  * Typedefs for the VAX 
        !           129:  */
        !           130: 
        !           131: typedef short  sign16;                 /* 16 bit signed value */
        !           132: typedef unsigned short unsign16;       /* 16 bit unsigned value */
        !           133: typedef unsigned unsign32;             /* 32 bit unsigned value */
        !           134: typedef long paddr_t;                  /* Physical addresses */
        !           135: 
        !           136: 
        !           137: /*
        !           138:  * Tunables
        !           139:  */
        !           140: 
        !           141: 
        !           142: #define NUMCQE         40              /* Number of CQE's per board */
        !           143: 
        !           144: /* Host configuration word in Status Block */
        !           145: 
        !           146: /*
        !           147:  * To disable the lock/unlock internal function calls clear the 0x8000
        !           148:  * bit in the host configuration word (HOSTCONF)
        !           149:  */
        !           150: 
        !           151: #define        HOSTCONF        0x0109  /* See above */
        !           152: #define        LOWBYTE         1
        !           153: #define        HIGHBYTE        0
        !           154: #define BUFFMAPPED     0
        !           155: 
        !           156: /*
        !           157:  * Memory mapping definintions for PM68DUAL hardware.
        !           158:  */
        !           159: 
        !           160: #ifdef PM68DUAL
        !           161: #define        PISHMEM         0x200000
        !           162: #define PISHMEMSIZE    2
        !           163: #define PIOFF          0x8000          /* change this to unique mem add. */
        !           164: #define PIWINDOW       MBUSBUFR + PIOFF
        !           165: #define WINDOWSIZE     2
        !           166: #endif
        !           167: #define        NPMAXXFR        32768           /* Maximum number of bytes / read */ 
        !           168: 
        !           169: /*
        !           170:  * Define the protocols supported by the NP Driver.
        !           171:  */
        !           172: 
        !           173: #define NONE           0x00    /* No protocols active for a process */
        !           174: #define NPMAINT                0x01    /* Maintenance protocol, superusers only */
        !           175: #define NPNTS          0x02    /* NTS Terminal Server */
        !           176: #define NPDLA          0x04    /* Direct Datalink Access */
        !           177: #define NPXNS          0x06    /* Xerox NS ITP */
        !           178: #define NPTCP          0x08    /* TCP/IP */
        !           179: #define NPISO          0x0A    /* ISO */
        !           180: #define NPCLCONN       0xFF    /* Closed connection, i.e. no protocol */
        !           181: 
        !           182: /*
        !           183:  * Convert the protocol to a value used in the Device Protocol Mask field
        !           184:  * of the Shared Memory Status Block.
        !           185:  */
        !           186: 
        !           187: #define PROTOMASK(x)   ( 1 << (x) )
        !           188: 
        !           189: /*
        !           190:  * Special requests handled by the NP Driver
        !           191:  */
        !           192: 
        !           193: #define OS_STP         03400   /* Shut down connection on I Board */
        !           194: #define NPSTOP         3       /* Conversion from above (OS_STP) */
        !           195: #define NPCHNGP                50      /* Change the protocol on a connection */
        !           196: #define NPCHNGB                51      /* Change the Board number */
        !           197: 
        !           198: /*
        !           199:  * Miscellaneous
        !           200:  */
        !           201: 
        !           202: #define ON             0x8000  /* Used for Command Q's scan and change flag */
        !           203: #define UBADDRMASK     0x3FFFF /* 18 bit UNIBUS address */
        !           204: #define INTMASK                0xFFFFFFFC /* Used for address validation */
        !           205: #define CMDMASK                0xFFFF  /* Mask ioctl cmd field (see ioctl.h) */
        !           206: #define NPPSADDR       0x324   /* Pointer to addr of on-board panic string */
        !           207: #define        PANLEN          133             /* length of the panic buffer */
        !           208: 
        !           209: /*
        !           210:  * Map function code from user to I-Board format
        !           211:  */
        !           212: 
        !           213: #define FUNCTMAP(x)    (((x) << 6) | 077) /* Maps user function to NP funcs */
        !           214: 
        !           215: /*
        !           216:  * Round up to a 16 byte boundary
        !           217:  */
        !           218: 
        !           219: #define ROUND16(x)     (((x) + 15) & (~0x0F)) /* Round to 16 byte boundary */
        !           220: #define ADDR24         1 /* Used by iomalloc() to specify 24 bit address */
        !           221: 
        !           222: #define NPERRSHIFT     8       /* Used in function ReqDone() */
        !           223: #define NPOK           0
        !           224: 
        !           225: #define LOWORD(X)      (((ushort *)&(X))[0])
        !           226: #define HIWORD(X)      (((ushort *)&(X))[1])
        !           227: 
        !           228: /* Everyday flag settings */
        !           229: 
        !           230: #define NPSET          1
        !           231: #define NPCLEAR                0
        !           232: 
        !           233: /*
        !           234:  * Command Queue Elements are the primary data structure for passing data
        !           235:  * between the driver and the device.
        !           236:  */
        !           237: 
        !           238: struct CQE {
        !           239: 
        !           240:        struct npreq *cqe_reqid;/* Address of asssociated npreq */
        !           241:        unsign32 cqe_famid;     /* Family ID (Process ID) */
        !           242:        unsign16 cqe_func;      /* I/O function to be performed */
        !           243: #ifdef mc68000
        !           244:        char cqe_prot;          /* Protocol type for I/O request */
        !           245:        char cqe_lenrpb;        /* Length of the RPB in bytes */
        !           246: #else
        !           247:        char cqe_lenrpb;        /* Length of the RPB in bytes */
        !           248:        char cqe_prot;          /* Protocol type for I/O request */
        !           249: #endif
        !           250:        unsign16 cqe_ust0;      /* Protocol status return */
        !           251:        unsign16 cqe_ust1;      /* Protocol status return */
        !           252:        unsign16 cqe_devrsv;    /* Reserved for use by device only! */
        !           253: #ifdef mc68000
        !           254:        char cqe_char;          /* CQE characteristics */
        !           255:        char cqe_sts;           /* Status return from device to user */
        !           256:        char cqe_wind;          /* Buffer mapping window size (page units) */
        !           257:        char cqe_nbuf;          /* Number of data buffers for I/O */
        !           258: #else
        !           259:        char cqe_sts;           /* Status return from device to user */
        !           260:        char cqe_char;          /* CQE characteristics */
        !           261:        char cqe_nbuf;          /* Number of data buffers for I/O */
        !           262:        char cqe_wind;          /* Buffer mapping window size (page units) */
        !           263: #endif
        !           264:        unsign16 cqe_bcnt;      /* Total number of bytes in the data buffer */
        !           265:        unsign16 cqe_unused;    /* Unused */
        !           266:        unsign16 cqe_dma[2];    /* Address of the MULTIBUS data buffer */
        !           267:        unsign16 rpb1;          /* Word 1 of protocol parameters */
        !           268:        unsign16 rpb2;          /* Word 2 of protocol parameters */
        !           269:        unsign16 rpb3;          /* Word 3 of protocol parameters */
        !           270:        unsign16 rpb4;          /* Word 4 of protocol parameters */
        !           271:        unsign16 rpb5;          /* Word 5 of protocol parameters */
        !           272:        unsign16 rpb6;          /* Word 6 of protocol parameters */
        !           273:        unsign16 rpb7;          /* Word 7 of protocol parameters */
        !           274:        unsign16 rpb8;          /* Word 8 of protocol parameters */
        !           275:        unsign16 rpb9;          /* Word 9 of protocol parameters */
        !           276:        unsign16 rpb10;         /* Word 10 of protocol parameters */
        !           277:        unsign16 rpb11;         /* Word 11 of protocol parameters */
        !           278:        unsign16 rpb12;         /* Word 12 of protocol parameters */
        !           279: 
        !           280: };
        !           281: 
        !           282: /*
        !           283:  * NP Driver Request structure contains information about a request
        !           284:  * maintained solely by the driver. One per CQE, plus a header.
        !           285:  */
        !           286: 
        !           287: struct npreq {
        !           288: 
        !           289:        struct npreq *forw;     /* Forward pointer for active list */
        !           290:        struct npreq *back;     /* Backward pointer for active list */
        !           291:        struct npreq *free;     /* Next member on free list */
        !           292:        struct CQE *element;    /* CQE associated with this request */
        !           293:        int flags;              /* Always useful */
        !           294:        int reqcnt;             /* Request count for reqtab */
        !           295:        int bufoffset;          /* Offset into buffer for turns */
        !           296:        int     bytecnt;        /* Number of bytes to transfer */
        !           297:        caddr_t virtmem;        /* Virtual address of buffer */
        !           298:        int     mapbase;        /* Address of the mapping register */
        !           299:        int     mapsize;        /* Size of mapped area */
        !           300:        caddr_t bufaddr;        /* Address of the user buffer */
        !           301:        struct buf buf;         /* Buf structure needed for mem. mgmt */
        !           302:        struct proc *procp;     /* Pointer to process of requestor */
        !           303:        caddr_t user;           /* Structure passed by user from itpuser.h */
        !           304:        int     (*intr)();      /* Ptr to routine to call at interrupt time */
        !           305: };
        !           306: 
        !           307: /*
        !           308:  * Npmaster structure, one per device, is used for boardwise centralization
        !           309:  * of relevant information including queues, I/O addresses and request pools.
        !           310:  */
        !           311: 
        !           312: struct npmaster {
        !           313: 
        !           314:        struct npmaster *next;  /* Linked list of these, NULL terminator */
        !           315:        struct npspace *shmemp; /* Shared memory address (driver <-> device) */
        !           316:        struct uba_device *devp; /* UBA Device for this unit */
        !           317:        struct NPREG   *iobase; /* I/O base address for this board */
        !           318:        struct npreq   *reqtab; /* Header for pool of CQE requests */
        !           319:        int     iomapbase;      /* Base index of I/O map reg's allocated */
        !           320:        int flags;              /* State of the Board */
        !           321:        int unit;               /* Unit number of this device */
        !           322:        int vector;             /* Interrupt vector for this unit */
        !           323: };
        !           324: 
        !           325: struct npconn {
        !           326: 
        !           327:        struct npmaster *unit;  /* Unit number (board) of this connection */
        !           328:        unsign16 protocol;      /* Protocol used on this connection */
        !           329:        struct buf np_wbuf;     /* write buf structure for raw access */
        !           330:        struct buf np_rbuf;     /* read buf structure for raw access */
        !           331: };
        !           332: 
        !           333: struct NPREG {
        !           334:        unsign16 CSR0;          /* Control Status Register 0 */
        !           335:        unsign16 CSR1;          /* Control Status Register 1 */
        !           336:        unsign16 CSR2;          /* Control Status Register 2 */
        !           337:        unsign16 CSR3;          /* Control Status Register 3 */
        !           338: 
        !           339: };
        !           340: 
        !           341: /*
        !           342:  * The following structures are used for communicating with the
        !           343:  * Intelligent Board and are located in Shared Memory.
        !           344:  */
        !           345: 
        !           346: /*
        !           347:  * Status Block
        !           348:  */
        !           349: 
        !           350: struct NpStat{
        !           351: 
        !           352:        unsign16 sb_drw;        /* Device Request Word */
        !           353:        unsign16 sb_hcw;        /* Host Configuration Word */
        !           354:        unsign16 sb_dcw;        /* Device Configuration Word */
        !           355:        unsign16 sb_dpm;        /* Device Protocol Mask */
        !           356:        unsign16 sb_dcq;        /* Offset to Device CQ */
        !           357:        unsign16 sb_hcq;        /* Offset to Host CQ */
        !           358: };
        !           359: 
        !           360: /*
        !           361:  * Command Queue, two per device. One is owned by the driver and the other
        !           362:  * is owned by the device.
        !           363:  */
        !           364: 
        !           365: struct CmdQue {
        !           366: 
        !           367:        unsign16 scanflag;      /* Scan Flag, MSB set if being scanned */
        !           368:        unsign16 chngflag;      /* Change Flag, MSB set by initiator */
        !           369:        unsign16 cq_wrap;       /* Offset to last CQE entry +2 */
        !           370:        unsign16 cq_add;        /* Offset to add a CQE to the queue */
        !           371:        unsign16 cq_rem;        /* Offset to remove a CQE from the queue */
        !           372:        unsign16 cq_cqe[NUMCQE]; /* Command Queue Element Offsets */
        !           373: };
        !           374: 
        !           375: /*
        !           376:  * Structure of the shared memory area per board. Declared this way to avoid
        !           377:  * compiler word alignment vagaries when computing offsets.
        !           378:  */
        !           379: 
        !           380: struct npspace {
        !           381: 
        !           382:        struct NpStat statblock;        /* Status Block */
        !           383:        struct CmdQue devcq;            /* Device's Command Queue */
        !           384:        struct CmdQue hostcq;           /* Host's Command Queue */
        !           385:        struct CQE elements[NUMCQE];    /* Shared Command Queue Elements */
        !           386:        unsign16 filler[8];             /* Here for 16 byte alignment */
        !           387: };
        !           388: 
        !           389: /*
        !           390:  * Structure of array of base addresses of I-Board controllers
        !           391:  * (See global data definitions in np.c)
        !           392:  */
        !           393: 
        !           394: struct npbase {
        !           395:        caddr_t baseaddr;
        !           396: };
        !           397: 
        !           398: /* State of the NP Driver as kept in NpState */
        !           399: 
        !           400: #define ICPAVAIL       0x01    /* ICP is waiting for a request */
        !           401: 
        !           402: /* Tells ICP Process that there are no more requests for this board */
        !           403: 
        !           404: #define BRDDONE 1
        !           405: 
        !           406: /* Flags used by the driver (npreq structure) to monitor status of requests */
        !           407: 
        !           408: #define REQDONE 0x01           /* Request completed */
        !           409: #define IOIFC   0x02           /* Internal Function Code Request */
        !           410: #define IOERR  0x04            /* Error on Request */
        !           411: #define NPPEND 0x08            /* Unused at this time */
        !           412: #define IOABORT 0x10           /* Request aborted by ICP */
        !           413: #define KERNREQ        0x20            /* Request was from the kernel */
        !           414: #define WANTREQ 0x40           /* Process is waiting for a npreq structure */
        !           415: #define NPUIO  0x80            /* Process doing physio */
        !           416: 
        !           417: /* Service Request Commands from the Intelligent Board */
        !           418: 
        !           419: #define NOREQ  0x00            /* No service requested */
        !           420: #define NPLOAD  0x01           /* Dump request */
        !           421: #define NPDUMP 0x02            /* Load request */
        !           422: #define NPPANIC        0x100           /* Panic request */
        !           423: 
        !           424: /* Definitions of Status returned from the I-Board */
        !           425: 
        !           426: #define NPDONE 0x01            /* Normal completion */
        !           427: #define NPIFC  0x00            /* Internal Function Code request */
        !           428: #define NPPERR  0x80           /* Protocol error */
        !           429: #define NPMERR 0x82            /* Memory allocation failure on I-Board */
        !           430: 
        !           431: /* Definitions of IFC type requests from I-Board */
        !           432: 
        !           433: #define NPLOCK 0x64            /* Lock the process's data area */
        !           434: #define NPUNLOCK 0xA4          /* Unlock the process */
        !           435: #define NPREMAP        0x124           /* Window turn */
        !           436: 
        !           437: /* Definition of flags for the Npmaster structure */
        !           438: 
        !           439: #define CSRPEND                0x01            /* CSR0 command pending */
        !           440: #define PANICREQ       0x02            /* Panic request */
        !           441: #define DUMPREQ                0x04            /* Dump request */
        !           442: #define LOADREQ                0x08            /* Load request */
        !           443: #define BOARDREQ       0x10            /* Any request by the board */
        !           444: #define BADBOARD       0x20            /* Board disabled */
        !           445: #define AVAILABLE      0x40            /* Board available */
        !           446: #define BRDRESET       0x80            /* Board is being reset */
        !           447: #define        PANIC1          0x100           /* Driver wants panic address */
        !           448: #define        PANIC2          0x200           /* Driver wants panic string */
        !           449: #define PANIC3         0x400           /* Clear first byte of panic string */
        !           450: 
        !           451: /*
        !           452:  * Debugging Constants
        !           453:  */
        !           454: 
        !           455: #define        DEBENTRY        0x0001          /* debug entry points */
        !           456: #define        DEBMEM          0x0002          /* debug memory */
        !           457: #define        DEBREQ          0x0004          /* debug requests */
        !           458: #define        DEBCQE          0x0008          /* debug cqe's */
        !           459: #define        DEBCQ           0x0010          /* debug cq's */
        !           460: #define        DEBMAINT        0x0020          /* debug maintainance requests */
        !           461: #define        DEBINTR         0x0040          /* debug interrupt routines */
        !           462: #define        DEBINIT         0x0080          /* debug initialization routines */
        !           463: #define        DEBIFC          0x0100          /* debug Internal function codes */
        !           464: #define        DEBIOCTL        0x0200          /* debug ioctl calls */
        !           465: #define        DEBOPEN         0x0400          /* debug open calls */
        !           466: #define        DEBIO           0x0800          /* debug read & write calls */
        !           467: #define        DEBCSR          0x1000          /* debug CSR commands */
        !           468: #define        DEBLOCK         0x2000          /* debug lock / unlock calls */
        !           469: #define NOBOARD                0x4000          /* debug user/host interface */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.