Annotation of sys/dev/pci/hifn7751var.h, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: hifn7751var.h,v 1.52 2004/01/20 21:01:55 jason Exp $ */
! 2:
! 3: /*
! 4: * Invertex AEON / Hifn 7751 driver
! 5: * Copyright (c) 1999 Invertex Inc. All rights reserved.
! 6: * Copyright (c) 1999 Theo de Raadt
! 7: * Copyright (c) 2000-2001 Network Security Technologies, Inc.
! 8: * http://www.netsec.net
! 9: *
! 10: * Please send any comments, feedback, bug-fixes, or feature requests to
! 11: * software@invertex.com.
! 12: *
! 13: * Redistribution and use in source and binary forms, with or without
! 14: * modification, are permitted provided that the following conditions
! 15: * are met:
! 16: *
! 17: * 1. Redistributions of source code must retain the above copyright
! 18: * notice, this list of conditions and the following disclaimer.
! 19: * 2. Redistributions in binary form must reproduce the above copyright
! 20: * notice, this list of conditions and the following disclaimer in the
! 21: * documentation and/or other materials provided with the distribution.
! 22: * 3. The name of the author may not be used to endorse or promote products
! 23: * derived from this software without specific prior written permission.
! 24: *
! 25: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
! 26: * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
! 27: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
! 28: * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
! 29: * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
! 30: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
! 31: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
! 32: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
! 33: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
! 34: * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
! 35: *
! 36: * Effort sponsored in part by the Defense Advanced Research Projects
! 37: * Agency (DARPA) and Air Force Research Laboratory, Air Force
! 38: * Materiel Command, USAF, under agreement number F30602-01-2-0537.
! 39: *
! 40: */
! 41:
! 42: #ifndef __HIFN7751VAR_H__
! 43: #define __HIFN7751VAR_H__
! 44:
! 45: #ifdef _KERNEL
! 46:
! 47: /*
! 48: * Some configurable values for the driver
! 49: */
! 50: #define HIFN_D_CMD_RSIZE 24 /* command descriptors */
! 51: #define HIFN_D_SRC_RSIZE 80 /* source descriptors */
! 52: #define HIFN_D_DST_RSIZE 80 /* destination descriptors */
! 53: #define HIFN_D_RES_RSIZE 24 /* result descriptors */
! 54:
! 55: /*
! 56: * Length values for cryptography
! 57: */
! 58: #define HIFN_DES_KEY_LENGTH 8
! 59: #define HIFN_3DES_KEY_LENGTH 24
! 60: #define HIFN_MAX_CRYPT_KEY_LENGTH HIFN_3DES_KEY_LENGTH
! 61: #define HIFN_IV_LENGTH 8
! 62: #define HIFN_AES_IV_LENGTH 16
! 63: #define HIFN_MAX_IV_LENGTH HIFN_AES_IV_LENGTH
! 64:
! 65: /*
! 66: * Length values for authentication
! 67: */
! 68: #define HIFN_MAC_KEY_LENGTH 64
! 69: #define HIFN_MD5_LENGTH 16
! 70: #define HIFN_SHA1_LENGTH 20
! 71: #define HIFN_MAC_TRUNC_LENGTH 12
! 72:
! 73: #define MAX_SCATTER 64
! 74:
! 75: /*
! 76: * Data structure to hold all 4 rings and any other ring related data.
! 77: */
! 78: struct hifn_dma {
! 79: /*
! 80: * Descriptor rings. We add +1 to the size to accommodate the
! 81: * jump descriptor.
! 82: */
! 83: struct hifn_desc cmdr[HIFN_D_CMD_RSIZE+1];
! 84: struct hifn_desc srcr[HIFN_D_SRC_RSIZE+1];
! 85: struct hifn_desc dstr[HIFN_D_DST_RSIZE+1];
! 86: struct hifn_desc resr[HIFN_D_RES_RSIZE+1];
! 87:
! 88: struct hifn_command *hifn_commands[HIFN_D_RES_RSIZE];
! 89:
! 90: u_char command_bufs[HIFN_D_CMD_RSIZE][HIFN_MAX_COMMAND];
! 91: u_char result_bufs[HIFN_D_CMD_RSIZE][HIFN_MAX_RESULT];
! 92: u_int32_t slop[HIFN_D_CMD_RSIZE];
! 93:
! 94: u_int64_t test_src, test_dst;
! 95:
! 96: /*
! 97: * Our current positions for insertion and removal from the descriptor
! 98: * rings.
! 99: */
! 100: int cmdi, srci, dsti, resi;
! 101: volatile int cmdu, srcu, dstu, resu;
! 102: int cmdk, srck, dstk, resk;
! 103: };
! 104:
! 105: struct hifn_session {
! 106: int hs_used;
! 107: u_int8_t hs_iv[HIFN_MAX_IV_LENGTH];
! 108: };
! 109:
! 110: #define HIFN_RING_SYNC(sc, r, i, f) \
! 111: bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_dmamap, \
! 112: offsetof(struct hifn_dma, r[i]), sizeof(struct hifn_desc), (f))
! 113:
! 114: #define HIFN_CMDR_SYNC(sc, i, f) HIFN_RING_SYNC((sc), cmdr, (i), (f))
! 115: #define HIFN_RESR_SYNC(sc, i, f) HIFN_RING_SYNC((sc), resr, (i), (f))
! 116: #define HIFN_SRCR_SYNC(sc, i, f) HIFN_RING_SYNC((sc), srcr, (i), (f))
! 117: #define HIFN_DSTR_SYNC(sc, i, f) HIFN_RING_SYNC((sc), dstr, (i), (f))
! 118:
! 119: #define HIFN_CMD_SYNC(sc, i, f) \
! 120: bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_dmamap, \
! 121: offsetof(struct hifn_dma, command_bufs[(i)][0]), \
! 122: HIFN_MAX_COMMAND, (f))
! 123:
! 124: #define HIFN_RES_SYNC(sc, i, f) \
! 125: bus_dmamap_sync((sc)->sc_dmat, (sc)->sc_dmamap, \
! 126: offsetof(struct hifn_dma, result_bufs[(i)][0]), \
! 127: HIFN_MAX_RESULT, (f))
! 128:
! 129: /*
! 130: * Holds data specific to a single HIFN board.
! 131: */
! 132: struct hifn_softc {
! 133: struct device sc_dv; /* generic device */
! 134: void * sc_ih; /* interrupt handler cookie */
! 135: u_int32_t sc_dmaier;
! 136: u_int32_t sc_drammodel; /* 1=dram, 0=sram */
! 137:
! 138: bus_space_handle_t sc_sh0, sc_sh1;
! 139: bus_space_tag_t sc_st0, sc_st1;
! 140: bus_dma_tag_t sc_dmat;
! 141:
! 142: struct hifn_dma *sc_dma;
! 143: bus_dmamap_t sc_dmamap;
! 144: bus_dma_segment_t sc_dmasegs[1];
! 145: int sc_dmansegs;
! 146: int32_t sc_cid;
! 147: int sc_maxses;
! 148: int sc_nsessions;
! 149: int sc_ramsize;
! 150: int sc_flags;
! 151: #define HIFN_HAS_RNG 0x01 /* includes random number generator */
! 152: #define HIFN_HAS_PUBLIC 0x02 /* includes public key support */
! 153: #define HIFN_IS_7811 0x04 /* Hifn 7811 part */
! 154: #define HIFN_NO_BURSTWRITE 0x08 /* can't handle PCI burst writes */
! 155: #define HIFN_HAS_LEDS 0x10 /* Has LEDs to blink */
! 156: #define HIFN_HAS_AES 0x20 /* includes AES support */
! 157: #define HIFN_IS_7956 0x40 /* Hifn 7955/7956 part */
! 158: struct timeout sc_rngto, sc_tickto;
! 159: int sc_rngfirst;
! 160: int sc_rnghz;
! 161: int sc_c_busy, sc_s_busy, sc_d_busy, sc_r_busy, sc_active;
! 162: struct hifn_session *sc_sessions;
! 163: pci_chipset_tag_t sc_pci_pc;
! 164: pcitag_t sc_pci_tag;
! 165: bus_size_t sc_waw_lastreg;
! 166: int sc_waw_lastgroup;
! 167: };
! 168:
! 169: #define WRITE_REG_0(sc,reg,val) hifn_write_4((sc), 0, (reg), (val))
! 170: #define WRITE_REG_1(sc,reg,val) hifn_write_4((sc), 1, (reg), (val))
! 171: #define READ_REG_0(sc,reg) hifn_read_4((sc), 0, (reg))
! 172: #define READ_REG_1(sc,reg) hifn_read_4((sc), 1, (reg))
! 173:
! 174: #define SET_LED(sc,v) \
! 175: if (sc->sc_flags & HIFN_HAS_LEDS) \
! 176: WRITE_REG_1(sc, HIFN_1_7811_MIPSRST, \
! 177: READ_REG_1(sc, HIFN_1_7811_MIPSRST) | (v))
! 178: #define CLR_LED(sc,v) \
! 179: if (sc->sc_flags & HIFN_HAS_LEDS) \
! 180: WRITE_REG_1(sc, HIFN_1_7811_MIPSRST, \
! 181: READ_REG_1(sc, HIFN_1_7811_MIPSRST) & ~(v))
! 182:
! 183: /*
! 184: * struct hifn_command
! 185: *
! 186: * This is the control structure used to pass commands to hifn_encrypt().
! 187: *
! 188: * flags
! 189: * -----
! 190: * Flags is the bitwise "or" values for command configuration. A single
! 191: * encrypt direction needs to be set:
! 192: *
! 193: * HIFN_ENCODE or HIFN_DECODE
! 194: *
! 195: * To use cryptography, a single crypto algorithm must be included:
! 196: *
! 197: * HIFN_CRYPT_3DES or HIFN_CRYPT_DES
! 198: *
! 199: * To use authentication, a single MAC algorithm must be included:
! 200: *
! 201: * HIFN_MAC_MD5 or HIFN_MAC_SHA1
! 202: *
! 203: * By default MD5 uses a 16 byte hash and SHA-1 uses a 20 byte hash.
! 204: * If the value below is set, hash values are truncated or assumed
! 205: * truncated to 12 bytes:
! 206: *
! 207: * HIFN_MAC_TRUNC
! 208: *
! 209: * Keys for encryption and authentication can be sent as part of a command,
! 210: * or the last key value used with a particular session can be retrieved
! 211: * and used again if either of these flags are not specified.
! 212: *
! 213: * HIFN_CRYPT_NEW_KEY, HIFN_MAC_NEW_KEY
! 214: *
! 215: * session_num
! 216: * -----------
! 217: * A number between 0 and 2048 (for DRAM models) or a number between
! 218: * 0 and 768 (for SRAM models). Those who don't want to use session
! 219: * numbers should leave value at zero and send a new crypt key and/or
! 220: * new MAC key on every command. If you use session numbers and
! 221: * don't send a key with a command, the last key sent for that same
! 222: * session number will be used.
! 223: *
! 224: * Warning: Using session numbers and multiboard at the same time
! 225: * is currently broken.
! 226: *
! 227: * mbuf
! 228: * ----
! 229: * Either fill in the mbuf pointer and npa=0 or
! 230: * fill packp[] and packl[] and set npa to > 0
! 231: *
! 232: * mac_header_skip
! 233: * ---------------
! 234: * The number of bytes of the source_buf that are skipped over before
! 235: * authentication begins. This must be a number between 0 and 2^16-1
! 236: * and can be used by IPsec implementers to skip over IP headers.
! 237: * *** Value ignored if authentication not used ***
! 238: *
! 239: * crypt_header_skip
! 240: * -----------------
! 241: * The number of bytes of the source_buf that are skipped over before
! 242: * the cryptographic operation begins. This must be a number between 0
! 243: * and 2^16-1. For IPsec, this number will always be 8 bytes larger
! 244: * than the auth_header_skip (to skip over the ESP header).
! 245: * *** Value ignored if cryptography not used ***
! 246: *
! 247: */
! 248: struct hifn_command {
! 249: u_int16_t session_num;
! 250: u_int16_t base_masks, cry_masks, mac_masks, comp_masks;
! 251: u_int8_t iv[HIFN_MAX_IV_LENGTH], *ck, mac[HIFN_MAC_KEY_LENGTH];
! 252: int cklen;
! 253: int sloplen, slopidx;
! 254:
! 255: union {
! 256: struct mbuf *src_m;
! 257: struct uio *src_io;
! 258: } srcu;
! 259: bus_dmamap_t src_map;
! 260:
! 261: union {
! 262: struct mbuf *dst_m;
! 263: struct uio *dst_io;
! 264: } dstu;
! 265: bus_dmamap_t dst_map;
! 266:
! 267: struct hifn_softc *softc;
! 268: struct cryptop *crp;
! 269: struct cryptodesc *enccrd, *maccrd, *compcrd;
! 270: void (*cmd_callback)(struct hifn_softc *, struct hifn_command *,
! 271: u_int8_t *);
! 272: };
! 273:
! 274: /*
! 275: * Return values for hifn_crypto()
! 276: */
! 277: #define HIFN_CRYPTO_SUCCESS 0
! 278: #define HIFN_CRYPTO_BAD_INPUT (-1)
! 279: #define HIFN_CRYPTO_RINGS_FULL (-2)
! 280:
! 281: /**************************************************************************
! 282: *
! 283: * Function: hifn_crypto
! 284: *
! 285: * Purpose: Called by external drivers to begin an encryption on the
! 286: * HIFN board.
! 287: *
! 288: * Blocking/Non-blocking Issues
! 289: * ============================
! 290: * The driver cannot block in hifn_crypto (no calls to tsleep) currently.
! 291: * hifn_crypto() returns HIFN_CRYPTO_RINGS_FULL if there is not enough
! 292: * room in any of the rings for the request to proceed.
! 293: *
! 294: * Return Values
! 295: * =============
! 296: * 0 for success, negative values on error
! 297: *
! 298: * Defines for negative error codes are:
! 299: *
! 300: * HIFN_CRYPTO_BAD_INPUT : The passed in command had invalid settings.
! 301: * HIFN_CRYPTO_RINGS_FULL : All DMA rings were full and non-blocking
! 302: * behaviour was requested.
! 303: *
! 304: *************************************************************************/
! 305:
! 306: /*
! 307: * Convert back and forth from 'sid' to 'card' and 'session'
! 308: */
! 309: #define HIFN_CARD(sid) (((sid) & 0xf0000000) >> 28)
! 310: #define HIFN_SESSION(sid) ((sid) & 0x000007ff)
! 311: #define HIFN_SID(crd,ses) (((crd) << 28) | ((ses) & 0x7ff))
! 312:
! 313: #endif /* _KERNEL */
! 314:
! 315: struct hifn_stats {
! 316: u_int64_t hst_ibytes;
! 317: u_int64_t hst_obytes;
! 318: u_int32_t hst_ipackets;
! 319: u_int32_t hst_opackets;
! 320: u_int32_t hst_invalid;
! 321: u_int32_t hst_nomem;
! 322: u_int32_t hst_abort;
! 323: };
! 324:
! 325: #endif /* __HIFN7751VAR_H__ */
CVSweb