1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef _FORE200E_H 3 #define _FORE200E_H 4 5 #ifdef __KERNEL__ 6 7 /* rx buffer sizes */ 8 9 #define SMALL_BUFFER_SIZE 384 /* size of small buffers (multiple of 48 (PCA) and 64 (SBA) bytes) */ 10 #define LARGE_BUFFER_SIZE 4032 /* size of large buffers (multiple of 48 (PCA) and 64 (SBA) bytes) */ 11 12 13 #define RBD_BLK_SIZE 32 /* nbr of supplied rx buffers per rbd */ 14 15 16 #define MAX_PDU_SIZE 65535 /* maximum PDU size supported by AALs */ 17 18 19 #define BUFFER_S1_SIZE SMALL_BUFFER_SIZE /* size of small buffers, scheme 1 */ 20 #define BUFFER_L1_SIZE LARGE_BUFFER_SIZE /* size of large buffers, scheme 1 */ 21 22 #define BUFFER_S2_SIZE SMALL_BUFFER_SIZE /* size of small buffers, scheme 2 */ 23 #define BUFFER_L2_SIZE LARGE_BUFFER_SIZE /* size of large buffers, scheme 2 */ 24 25 #define BUFFER_S1_NBR (RBD_BLK_SIZE * 6) 26 #define BUFFER_L1_NBR (RBD_BLK_SIZE * 4) 27 28 #define BUFFER_S2_NBR (RBD_BLK_SIZE * 6) 29 #define BUFFER_L2_NBR (RBD_BLK_SIZE * 4) 30 31 32 #define QUEUE_SIZE_CMD 16 /* command queue capacity */ 33 #define QUEUE_SIZE_RX 64 /* receive queue capacity */ 34 #define QUEUE_SIZE_TX 256 /* transmit queue capacity */ 35 #define QUEUE_SIZE_BS 32 /* buffer supply queue capacity */ 36 37 #define FORE200E_VPI_BITS 0 38 #define FORE200E_VCI_BITS 10 39 #define NBR_CONNECT (1 << (FORE200E_VPI_BITS + FORE200E_VCI_BITS)) /* number of connections */ 40 41 42 #define TSD_FIXED 2 43 #define TSD_EXTENSION 0 44 #define TSD_NBR (TSD_FIXED + TSD_EXTENSION) 45 46 47 /* the cp starts putting a received PDU into one *small* buffer, 48 then it uses a number of *large* buffers for the trailing data. 49 we compute here the total number of receive segment descriptors 50 required to hold the largest possible PDU */ 51 52 #define RSD_REQUIRED (((MAX_PDU_SIZE - SMALL_BUFFER_SIZE + LARGE_BUFFER_SIZE) / LARGE_BUFFER_SIZE) + 1) 53 54 #define RSD_FIXED 3 55 56 /* RSD_REQUIRED receive segment descriptors are enough to describe a max-sized PDU, 57 but we have to keep the size of the receive PDU descriptor multiple of 32 bytes, 58 so we add one extra RSD to RSD_EXTENSION 59 (WARNING: THIS MAY CHANGE IF BUFFER SIZES ARE MODIFIED) */ 60 61 #define RSD_EXTENSION ((RSD_REQUIRED - RSD_FIXED) + 1) 62 #define RSD_NBR (RSD_FIXED + RSD_EXTENSION) 63 64 65 #define FORE200E_DEV(d) ((struct fore200e*)((d)->dev_data)) 66 #define FORE200E_VCC(d) ((struct fore200e_vcc*)((d)->dev_data)) 67 68 /* bitfields endian games */ 69 70 #if defined(__LITTLE_ENDIAN_BITFIELD) 71 #define BITFIELD2(b1, b2) b1; b2; 72 #define BITFIELD3(b1, b2, b3) b1; b2; b3; 73 #define BITFIELD4(b1, b2, b3, b4) b1; b2; b3; b4; 74 #define BITFIELD5(b1, b2, b3, b4, b5) b1; b2; b3; b4; b5; 75 #define BITFIELD6(b1, b2, b3, b4, b5, b6) b1; b2; b3; b4; b5; b6; 76 #elif defined(__BIG_ENDIAN_BITFIELD) 77 #define BITFIELD2(b1, b2) b2; b1; 78 #define BITFIELD3(b1, b2, b3) b3; b2; b1; 79 #define BITFIELD4(b1, b2, b3, b4) b4; b3; b2; b1; 80 #define BITFIELD5(b1, b2, b3, b4, b5) b5; b4; b3; b2; b1; 81 #define BITFIELD6(b1, b2, b3, b4, b5, b6) b6; b5; b4; b3; b2; b1; 82 #else 83 #error unknown bitfield endianess 84 #endif 85 86 87 /* ATM cell header (minus HEC byte) */ 88 89 typedef struct atm_header { 90 BITFIELD5( 91 u32 clp : 1, /* cell loss priority */ 92 u32 plt : 3, /* payload type */ 93 u32 vci : 16, /* virtual channel identifier */ 94 u32 vpi : 8, /* virtual path identifier */ 95 u32 gfc : 4 /* generic flow control */ 96 ) 97 } atm_header_t; 98 99 100 /* ATM adaptation layer id */ 101 102 typedef enum fore200e_aal { 103 FORE200E_AAL0 = 0, 104 FORE200E_AAL34 = 4, 105 FORE200E_AAL5 = 5, 106 } fore200e_aal_t; 107 108 109 /* transmit PDU descriptor specification */ 110 111 typedef struct tpd_spec { 112 BITFIELD4( 113 u32 length : 16, /* total PDU length */ 114 u32 nseg : 8, /* number of transmit segments */ 115 enum fore200e_aal aal : 4, /* adaptation layer */ 116 u32 intr : 4 /* interrupt requested */ 117 ) 118 } tpd_spec_t; 119 120 121 /* transmit PDU rate control */ 122 123 typedef struct tpd_rate 124 { 125 BITFIELD2( 126 u32 idle_cells : 16, /* number of idle cells to insert */ 127 u32 data_cells : 16 /* number of data cells to transmit */ 128 ) 129 } tpd_rate_t; 130 131 132 /* transmit segment descriptor */ 133 134 typedef struct tsd { 135 u32 buffer; /* transmit buffer DMA address */ 136 u32 length; /* number of bytes in buffer */ 137 } tsd_t; 138 139 140 /* transmit PDU descriptor */ 141 142 typedef struct tpd { 143 struct atm_header atm_header; /* ATM header minus HEC byte */ 144 struct tpd_spec spec; /* tpd specification */ 145 struct tpd_rate rate; /* tpd rate control */ 146 u32 pad; /* reserved */ 147 struct tsd tsd[ TSD_NBR ]; /* transmit segment descriptors */ 148 } tpd_t; 149 150 151 /* receive segment descriptor */ 152 153 typedef struct rsd { 154 u32 handle; /* host supplied receive buffer handle */ 155 u32 length; /* number of bytes in buffer */ 156 } rsd_t; 157 158 159 /* receive PDU descriptor */ 160 161 typedef struct rpd { 162 struct atm_header atm_header; /* ATM header minus HEC byte */ 163 u32 nseg; /* number of receive segments */ 164 struct rsd rsd[ RSD_NBR ]; /* receive segment descriptors */ 165 } rpd_t; 166 167 168 /* buffer scheme */ 169 170 typedef enum buffer_scheme { 171 BUFFER_SCHEME_ONE, 172 BUFFER_SCHEME_TWO, 173 BUFFER_SCHEME_NBR /* always last */ 174 } buffer_scheme_t; 175 176 177 /* buffer magnitude */ 178 179 typedef enum buffer_magn { 180 BUFFER_MAGN_SMALL, 181 BUFFER_MAGN_LARGE, 182 BUFFER_MAGN_NBR /* always last */ 183 } buffer_magn_t; 184 185 186 /* receive buffer descriptor */ 187 188 typedef struct rbd { 189 u32 handle; /* host supplied handle */ 190 u32 buffer_haddr; /* host DMA address of host buffer */ 191 } rbd_t; 192 193 194 /* receive buffer descriptor block */ 195 196 typedef struct rbd_block { 197 struct rbd rbd[ RBD_BLK_SIZE ]; /* receive buffer descriptor */ 198 } rbd_block_t; 199 200 201 /* tpd DMA address */ 202 203 typedef struct tpd_haddr { 204 BITFIELD3( 205 u32 size : 4, /* tpd size expressed in 32 byte blocks */ 206 u32 pad : 1, /* reserved */ 207 u32 haddr : 27 /* tpd DMA addr aligned on 32 byte boundary */ 208 ) 209 } tpd_haddr_t; 210 211 #define TPD_HADDR_SHIFT 5 /* addr aligned on 32 byte boundary */ 212 213 /* cp resident transmit queue entry */ 214 215 typedef struct cp_txq_entry { 216 struct tpd_haddr tpd_haddr; /* host DMA address of tpd */ 217 u32 status_haddr; /* host DMA address of completion status */ 218 } cp_txq_entry_t; 219 220 221 /* cp resident receive queue entry */ 222 223 typedef struct cp_rxq_entry { 224 u32 rpd_haddr; /* host DMA address of rpd */ 225 u32 status_haddr; /* host DMA address of completion status */ 226 } cp_rxq_entry_t; 227 228 229 /* cp resident buffer supply queue entry */ 230 231 typedef struct cp_bsq_entry { 232 u32 rbd_block_haddr; /* host DMA address of rbd block */ 233 u32 status_haddr; /* host DMA address of completion status */ 234 } cp_bsq_entry_t; 235 236 237 /* completion status */ 238 239 typedef volatile enum status { 240 STATUS_PENDING = (1<<0), /* initial status (written by host) */ 241 STATUS_COMPLETE = (1<<1), /* completion status (written by cp) */ 242 STATUS_FREE = (1<<2), /* initial status (written by host) */ 243 STATUS_ERROR = (1<<3) /* completion status (written by cp) */ 244 } status_t; 245 246 247 /* cp operation code */ 248 249 typedef enum opcode { 250 OPCODE_INITIALIZE = 1, /* initialize board */ 251 OPCODE_ACTIVATE_VCIN, /* activate incoming VCI */ 252 OPCODE_ACTIVATE_VCOUT, /* activate outgoing VCI */ 253 OPCODE_DEACTIVATE_VCIN, /* deactivate incoming VCI */ 254 OPCODE_DEACTIVATE_VCOUT, /* deactivate incoing VCI */ 255 OPCODE_GET_STATS, /* get board statistics */ 256 OPCODE_SET_OC3, /* set OC-3 registers */ 257 OPCODE_GET_OC3, /* get OC-3 registers */ 258 OPCODE_RESET_STATS, /* reset board statistics */ 259 OPCODE_GET_PROM, /* get expansion PROM data (PCI specific) */ 260 OPCODE_SET_VPI_BITS, /* set x bits of those decoded by the 261 firmware to be low order bits from 262 the VPI field of the ATM cell header */ 263 OPCODE_REQUEST_INTR = (1<<7) /* request interrupt */ 264 } opcode_t; 265 266 267 /* virtual path / virtual channel identifiers */ 268 269 typedef struct vpvc { 270 BITFIELD3( 271 u32 vci : 16, /* virtual channel identifier */ 272 u32 vpi : 8, /* virtual path identifier */ 273 u32 pad : 8 /* reserved */ 274 ) 275 } vpvc_t; 276 277 278 /* activate VC command opcode */ 279 280 typedef struct activate_opcode { 281 BITFIELD4( 282 enum opcode opcode : 8, /* cp opcode */ 283 enum fore200e_aal aal : 8, /* adaptation layer */ 284 enum buffer_scheme scheme : 8, /* buffer scheme */ 285 u32 pad : 8 /* reserved */ 286 ) 287 } activate_opcode_t; 288 289 290 /* activate VC command block */ 291 292 typedef struct activate_block { 293 struct activate_opcode opcode; /* activate VC command opcode */ 294 struct vpvc vpvc; /* VPI/VCI */ 295 u32 mtu; /* for AAL0 only */ 296 297 } activate_block_t; 298 299 300 /* deactivate VC command opcode */ 301 302 typedef struct deactivate_opcode { 303 BITFIELD2( 304 enum opcode opcode : 8, /* cp opcode */ 305 u32 pad : 24 /* reserved */ 306 ) 307 } deactivate_opcode_t; 308 309 310 /* deactivate VC command block */ 311 312 typedef struct deactivate_block { 313 struct deactivate_opcode opcode; /* deactivate VC command opcode */ 314 struct vpvc vpvc; /* VPI/VCI */ 315 } deactivate_block_t; 316 317 318 /* OC-3 registers */ 319 320 typedef struct oc3_regs { 321 u32 reg[ 128 ]; /* see the PMC Sierra PC5346 S/UNI-155-Lite 322 Saturn User Network Interface documentation 323 for a description of the OC-3 chip registers */ 324 } oc3_regs_t; 325 326 327 /* set/get OC-3 regs command opcode */ 328 329 typedef struct oc3_opcode { 330 BITFIELD4( 331 enum opcode opcode : 8, /* cp opcode */ 332 u32 reg : 8, /* register index */ 333 u32 value : 8, /* register value */ 334 u32 mask : 8 /* register mask that specifies which 335 bits of the register value field 336 are significant */ 337 ) 338 } oc3_opcode_t; 339 340 341 /* set/get OC-3 regs command block */ 342 343 typedef struct oc3_block { 344 struct oc3_opcode opcode; /* set/get OC-3 regs command opcode */ 345 u32 regs_haddr; /* host DMA address of OC-3 regs buffer */ 346 } oc3_block_t; 347 348 349 /* physical encoding statistics */ 350 351 typedef struct stats_phy { 352 __be32 crc_header_errors; /* cells received with bad header CRC */ 353 __be32 framing_errors; /* cells received with bad framing */ 354 __be32 pad[ 2 ]; /* i960 padding */ 355 } stats_phy_t; 356 357 358 /* OC-3 statistics */ 359 360 typedef struct stats_oc3 { 361 __be32 section_bip8_errors; /* section 8 bit interleaved parity */ 362 __be32 path_bip8_errors; /* path 8 bit interleaved parity */ 363 __be32 line_bip24_errors; /* line 24 bit interleaved parity */ 364 __be32 line_febe_errors; /* line far end block errors */ 365 __be32 path_febe_errors; /* path far end block errors */ 366 __be32 corr_hcs_errors; /* correctable header check sequence */ 367 __be32 ucorr_hcs_errors; /* uncorrectable header check sequence */ 368 __be32 pad[ 1 ]; /* i960 padding */ 369 } stats_oc3_t; 370 371 372 /* ATM statistics */ 373 374 typedef struct stats_atm { 375 __be32 cells_transmitted; /* cells transmitted */ 376 __be32 cells_received; /* cells received */ 377 __be32 vpi_bad_range; /* cell drops: VPI out of range */ 378 __be32 vpi_no_conn; /* cell drops: no connection for VPI */ 379 __be32 vci_bad_range; /* cell drops: VCI out of range */ 380 __be32 vci_no_conn; /* cell drops: no connection for VCI */ 381 __be32 pad[ 2 ]; /* i960 padding */ 382 } stats_atm_t; 383 384 /* AAL0 statistics */ 385 386 typedef struct stats_aal0 { 387 __be32 cells_transmitted; /* cells transmitted */ 388 __be32 cells_received; /* cells received */ 389 __be32 cells_dropped; /* cells dropped */ 390 __be32 pad[ 1 ]; /* i960 padding */ 391 } stats_aal0_t; 392 393 394 /* AAL3/4 statistics */ 395 396 typedef struct stats_aal34 { 397 __be32 cells_transmitted; /* cells transmitted from segmented PDUs */ 398 __be32 cells_received; /* cells reassembled into PDUs */ 399 __be32 cells_crc_errors; /* payload CRC error count */ 400 __be32 cells_protocol_errors; /* SAR or CS layer protocol errors */ 401 __be32 cells_dropped; /* cells dropped: partial reassembly */ 402 __be32 cspdus_transmitted; /* CS PDUs transmitted */ 403 __be32 cspdus_received; /* CS PDUs received */ 404 __be32 cspdus_protocol_errors; /* CS layer protocol errors */ 405 __be32 cspdus_dropped; /* reassembled PDUs drop'd (in cells) */ 406 __be32 pad[ 3 ]; /* i960 padding */ 407 } stats_aal34_t; 408 409 410 /* AAL5 statistics */ 411 412 typedef struct stats_aal5 { 413 __be32 cells_transmitted; /* cells transmitted from segmented SDUs */ 414 __be32 cells_received; /* cells reassembled into SDUs */ 415 __be32 cells_dropped; /* reassembled PDUs dropped (in cells) */ 416 __be32 congestion_experienced; /* CRC error and length wrong */ 417 __be32 cspdus_transmitted; /* CS PDUs transmitted */ 418 __be32 cspdus_received; /* CS PDUs received */ 419 __be32 cspdus_crc_errors; /* CS PDUs CRC errors */ 420 __be32 cspdus_protocol_errors; /* CS layer protocol errors */ 421 __be32 cspdus_dropped; /* reassembled PDUs dropped */ 422 __be32 pad[ 3 ]; /* i960 padding */ 423 } stats_aal5_t; 424 425 426 /* auxiliary statistics */ 427 428 typedef struct stats_aux { 429 __be32 small_b1_failed; /* receive BD allocation failures */ 430 __be32 large_b1_failed; /* receive BD allocation failures */ 431 __be32 small_b2_failed; /* receive BD allocation failures */ 432 __be32 large_b2_failed; /* receive BD allocation failures */ 433 __be32 rpd_alloc_failed; /* receive PDU allocation failures */ 434 __be32 receive_carrier; /* no carrier = 0, carrier = 1 */ 435 __be32 pad[ 2 ]; /* i960 padding */ 436 } stats_aux_t; 437 438 439 /* whole statistics buffer */ 440 441 typedef struct stats { 442 struct stats_phy phy; /* physical encoding statistics */ 443 struct stats_oc3 oc3; /* OC-3 statistics */ 444 struct stats_atm atm; /* ATM statistics */ 445 struct stats_aal0 aal0; /* AAL0 statistics */ 446 struct stats_aal34 aal34; /* AAL3/4 statistics */ 447 struct stats_aal5 aal5; /* AAL5 statistics */ 448 struct stats_aux aux; /* auxiliary statistics */ 449 } stats_t; 450 451 452 /* get statistics command opcode */ 453 454 typedef struct stats_opcode { 455 BITFIELD2( 456 enum opcode opcode : 8, /* cp opcode */ 457 u32 pad : 24 /* reserved */ 458 ) 459 } stats_opcode_t; 460 461 462 /* get statistics command block */ 463 464 typedef struct stats_block { 465 struct stats_opcode opcode; /* get statistics command opcode */ 466 u32 stats_haddr; /* host DMA address of stats buffer */ 467 } stats_block_t; 468 469 470 /* expansion PROM data (PCI specific) */ 471 472 typedef struct prom_data { 473 u32 hw_revision; /* hardware revision */ 474 u32 serial_number; /* board serial number */ 475 u8 mac_addr[ 8 ]; /* board MAC address */ 476 } prom_data_t; 477 478 479 /* get expansion PROM data command opcode */ 480 481 typedef struct prom_opcode { 482 BITFIELD2( 483 enum opcode opcode : 8, /* cp opcode */ 484 u32 pad : 24 /* reserved */ 485 ) 486 } prom_opcode_t; 487 488 489 /* get expansion PROM data command block */ 490 491 typedef struct prom_block { 492 struct prom_opcode opcode; /* get PROM data command opcode */ 493 u32 prom_haddr; /* host DMA address of PROM buffer */ 494 } prom_block_t; 495 496 497 /* cp command */ 498 499 typedef union cmd { 500 enum opcode opcode; /* operation code */ 501 struct activate_block activate_block; /* activate VC */ 502 struct deactivate_block deactivate_block; /* deactivate VC */ 503 struct stats_block stats_block; /* get statistics */ 504 struct prom_block prom_block; /* get expansion PROM data */ 505 struct oc3_block oc3_block; /* get/set OC-3 registers */ 506 u32 pad[ 4 ]; /* i960 padding */ 507 } cmd_t; 508 509 510 /* cp resident command queue */ 511 512 typedef struct cp_cmdq_entry { 513 union cmd cmd; /* command */ 514 u32 status_haddr; /* host DMA address of completion status */ 515 u32 pad[ 3 ]; /* i960 padding */ 516 } cp_cmdq_entry_t; 517 518 519 /* host resident transmit queue entry */ 520 521 typedef struct host_txq_entry { 522 struct cp_txq_entry __iomem *cp_entry; /* addr of cp resident tx queue entry */ 523 enum status* status; /* addr of host resident status */ 524 struct tpd* tpd; /* addr of transmit PDU descriptor */ 525 u32 tpd_dma; /* DMA address of tpd */ 526 struct sk_buff* skb; /* related skb */ 527 void* data; /* copy of misaligned data */ 528 unsigned long incarn; /* vc_map incarnation when submitted for tx */ 529 struct fore200e_vc_map* vc_map; 530 531 } host_txq_entry_t; 532 533 534 /* host resident receive queue entry */ 535 536 typedef struct host_rxq_entry { 537 struct cp_rxq_entry __iomem *cp_entry; /* addr of cp resident rx queue entry */ 538 enum status* status; /* addr of host resident status */ 539 struct rpd* rpd; /* addr of receive PDU descriptor */ 540 u32 rpd_dma; /* DMA address of rpd */ 541 } host_rxq_entry_t; 542 543 544 /* host resident buffer supply queue entry */ 545 546 typedef struct host_bsq_entry { 547 struct cp_bsq_entry __iomem *cp_entry; /* addr of cp resident buffer supply queue entry */ 548 enum status* status; /* addr of host resident status */ 549 struct rbd_block* rbd_block; /* addr of receive buffer descriptor block */ 550 u32 rbd_block_dma; /* DMA address od rdb */ 551 } host_bsq_entry_t; 552 553 554 /* host resident command queue entry */ 555 556 typedef struct host_cmdq_entry { 557 struct cp_cmdq_entry __iomem *cp_entry; /* addr of cp resident cmd queue entry */ 558 enum status *status; /* addr of host resident status */ 559 } host_cmdq_entry_t; 560 561 562 /* chunk of memory */ 563 564 typedef struct chunk { 565 void* alloc_addr; /* base address of allocated chunk */ 566 void* align_addr; /* base address of aligned chunk */ 567 dma_addr_t dma_addr; /* DMA address of aligned chunk */ 568 int direction; /* direction of DMA mapping */ 569 u32 alloc_size; /* length of allocated chunk */ 570 u32 align_size; /* length of aligned chunk */ 571 } chunk_t; 572 573 #define dma_size align_size /* DMA useable size */ 574 575 576 /* host resident receive buffer */ 577 578 typedef struct buffer { 579 struct buffer* next; /* next receive buffer */ 580 enum buffer_scheme scheme; /* buffer scheme */ 581 enum buffer_magn magn; /* buffer magnitude */ 582 struct chunk data; /* data buffer */ 583 #ifdef FORE200E_BSQ_DEBUG 584 unsigned long index; /* buffer # in queue */ 585 int supplied; /* 'buffer supplied' flag */ 586 #endif 587 } buffer_t; 588 589 590 #if (BITS_PER_LONG == 32) 591 #define FORE200E_BUF2HDL(buffer) ((u32)(buffer)) 592 #define FORE200E_HDL2BUF(handle) ((struct buffer*)(handle)) 593 #else /* deal with 64 bit pointers */ 594 #define FORE200E_BUF2HDL(buffer) ((u32)((u64)(buffer))) 595 #define FORE200E_HDL2BUF(handle) ((struct buffer*)(((u64)(handle)) | PAGE_OFFSET)) 596 #endif 597 598 599 /* host resident command queue */ 600 601 typedef struct host_cmdq { 602 struct host_cmdq_entry host_entry[ QUEUE_SIZE_CMD ]; /* host resident cmd queue entries */ 603 int head; /* head of cmd queue */ 604 struct chunk status; /* array of completion status */ 605 } host_cmdq_t; 606 607 608 /* host resident transmit queue */ 609 610 typedef struct host_txq { 611 struct host_txq_entry host_entry[ QUEUE_SIZE_TX ]; /* host resident tx queue entries */ 612 int head; /* head of tx queue */ 613 int tail; /* tail of tx queue */ 614 struct chunk tpd; /* array of tpds */ 615 struct chunk status; /* arry of completion status */ 616 int txing; /* number of pending PDUs in tx queue */ 617 } host_txq_t; 618 619 620 /* host resident receive queue */ 621 622 typedef struct host_rxq { 623 struct host_rxq_entry host_entry[ QUEUE_SIZE_RX ]; /* host resident rx queue entries */ 624 int head; /* head of rx queue */ 625 struct chunk rpd; /* array of rpds */ 626 struct chunk status; /* array of completion status */ 627 } host_rxq_t; 628 629 630 /* host resident buffer supply queues */ 631 632 typedef struct host_bsq { 633 struct host_bsq_entry host_entry[ QUEUE_SIZE_BS ]; /* host resident buffer supply queue entries */ 634 int head; /* head of buffer supply queue */ 635 struct chunk rbd_block; /* array of rbds */ 636 struct chunk status; /* array of completion status */ 637 struct buffer* buffer; /* array of rx buffers */ 638 struct buffer* freebuf; /* list of free rx buffers */ 639 volatile int freebuf_count; /* count of free rx buffers */ 640 } host_bsq_t; 641 642 643 /* header of the firmware image */ 644 645 typedef struct fw_header { 646 __le32 magic; /* magic number */ 647 __le32 version; /* firmware version id */ 648 __le32 load_offset; /* fw load offset in board memory */ 649 __le32 start_offset; /* fw execution start address in board memory */ 650 } fw_header_t; 651 652 #define FW_HEADER_MAGIC 0x65726f66 /* 'fore' */ 653 654 655 /* receive buffer supply queues scheme specification */ 656 657 typedef struct bs_spec { 658 u32 queue_length; /* queue capacity */ 659 u32 buffer_size; /* host buffer size */ 660 u32 pool_size; /* number of rbds */ 661 u32 supply_blksize; /* num of rbds in I/O block (multiple 662 of 4 between 4 and 124 inclusive) */ 663 } bs_spec_t; 664 665 666 /* initialization command block (one-time command, not in cmd queue) */ 667 668 typedef struct init_block { 669 enum opcode opcode; /* initialize command */ 670 enum status status; /* related status word */ 671 u32 receive_threshold; /* not used */ 672 u32 num_connect; /* ATM connections */ 673 u32 cmd_queue_len; /* length of command queue */ 674 u32 tx_queue_len; /* length of transmit queue */ 675 u32 rx_queue_len; /* length of receive queue */ 676 u32 rsd_extension; /* number of extra 32 byte blocks */ 677 u32 tsd_extension; /* number of extra 32 byte blocks */ 678 u32 conless_vpvc; /* not used */ 679 u32 pad[ 2 ]; /* force quad alignment */ 680 struct bs_spec bs_spec[ BUFFER_SCHEME_NBR ][ BUFFER_MAGN_NBR ]; /* buffer supply queues spec */ 681 } init_block_t; 682 683 684 typedef enum media_type { 685 MEDIA_TYPE_CAT5_UTP = 0x06, /* unshielded twisted pair */ 686 MEDIA_TYPE_MM_OC3_ST = 0x16, /* multimode fiber ST */ 687 MEDIA_TYPE_MM_OC3_SC = 0x26, /* multimode fiber SC */ 688 MEDIA_TYPE_SM_OC3_ST = 0x36, /* single-mode fiber ST */ 689 MEDIA_TYPE_SM_OC3_SC = 0x46 /* single-mode fiber SC */ 690 } media_type_t; 691 692 #define FORE200E_MEDIA_INDEX(media_type) ((media_type)>>4) 693 694 695 /* cp resident queues */ 696 697 typedef struct cp_queues { 698 u32 cp_cmdq; /* command queue */ 699 u32 cp_txq; /* transmit queue */ 700 u32 cp_rxq; /* receive queue */ 701 u32 cp_bsq[ BUFFER_SCHEME_NBR ][ BUFFER_MAGN_NBR ]; /* buffer supply queues */ 702 u32 imask; /* 1 enables cp to host interrupts */ 703 u32 istat; /* 1 for interrupt posted */ 704 u32 heap_base; /* offset form beginning of ram */ 705 u32 heap_size; /* space available for queues */ 706 u32 hlogger; /* non zero for host logging */ 707 u32 heartbeat; /* cp heartbeat */ 708 u32 fw_release; /* firmware version */ 709 u32 mon960_release; /* i960 monitor version */ 710 u32 tq_plen; /* transmit throughput measurements */ 711 /* make sure the init block remains on a quad word boundary */ 712 struct init_block init; /* one time cmd, not in cmd queue */ 713 enum media_type media_type; /* media type id */ 714 u32 oc3_revision; /* OC-3 revision number */ 715 } cp_queues_t; 716 717 718 /* boot status */ 719 720 typedef enum boot_status { 721 BSTAT_COLD_START = (u32) 0xc01dc01d, /* cold start */ 722 BSTAT_SELFTEST_OK = (u32) 0x02201958, /* self-test ok */ 723 BSTAT_SELFTEST_FAIL = (u32) 0xadbadbad, /* self-test failed */ 724 BSTAT_CP_RUNNING = (u32) 0xce11feed, /* cp is running */ 725 BSTAT_MON_TOO_BIG = (u32) 0x10aded00 /* i960 monitor is too big */ 726 } boot_status_t; 727 728 729 /* software UART */ 730 731 typedef struct soft_uart { 732 u32 send; /* write register */ 733 u32 recv; /* read register */ 734 } soft_uart_t; 735 736 #define FORE200E_CP_MONITOR_UART_FREE 0x00000000 737 #define FORE200E_CP_MONITOR_UART_AVAIL 0x01000000 738 739 740 /* i960 monitor */ 741 742 typedef struct cp_monitor { 743 struct soft_uart soft_uart; /* software UART */ 744 enum boot_status bstat; /* boot status */ 745 u32 app_base; /* application base offset */ 746 u32 mon_version; /* i960 monitor version */ 747 } cp_monitor_t; 748 749 750 /* device state */ 751 752 typedef enum fore200e_state { 753 FORE200E_STATE_BLANK, /* initial state */ 754 FORE200E_STATE_REGISTER, /* device registered */ 755 FORE200E_STATE_CONFIGURE, /* bus interface configured */ 756 FORE200E_STATE_MAP, /* board space mapped in host memory */ 757 FORE200E_STATE_RESET, /* board resetted */ 758 FORE200E_STATE_START_FW, /* firmware started */ 759 FORE200E_STATE_INITIALIZE, /* initialize command successful */ 760 FORE200E_STATE_INIT_CMDQ, /* command queue initialized */ 761 FORE200E_STATE_INIT_TXQ, /* transmit queue initialized */ 762 FORE200E_STATE_INIT_RXQ, /* receive queue initialized */ 763 FORE200E_STATE_INIT_BSQ, /* buffer supply queue initialized */ 764 FORE200E_STATE_ALLOC_BUF, /* receive buffers allocated */ 765 FORE200E_STATE_IRQ, /* host interrupt requested */ 766 FORE200E_STATE_COMPLETE /* initialization completed */ 767 } fore200e_state; 768 769 770 /* PCA-200E registers */ 771 772 typedef struct fore200e_pca_regs { 773 volatile u32 __iomem * hcr; /* address of host control register */ 774 volatile u32 __iomem * imr; /* address of host interrupt mask register */ 775 volatile u32 __iomem * psr; /* address of PCI specific register */ 776 } fore200e_pca_regs_t; 777 778 779 /* SBA-200E registers */ 780 781 typedef struct fore200e_sba_regs { 782 u32 __iomem *hcr; /* address of host control register */ 783 u32 __iomem *bsr; /* address of burst transfer size register */ 784 u32 __iomem *isr; /* address of interrupt level selection register */ 785 } fore200e_sba_regs_t; 786 787 788 /* model-specific registers */ 789 790 typedef union fore200e_regs { 791 struct fore200e_pca_regs pca; /* PCA-200E registers */ 792 struct fore200e_sba_regs sba; /* SBA-200E registers */ 793 } fore200e_regs; 794 795 796 struct fore200e; 797 798 /* bus-dependent data */ 799 800 typedef struct fore200e_bus { 801 char* model_name; /* board model name */ 802 char* proc_name; /* board name under /proc/atm */ 803 int descr_alignment; /* tpd/rpd/rbd DMA alignment requirement */ 804 int buffer_alignment; /* rx buffers DMA alignment requirement */ 805 int status_alignment; /* status words DMA alignment requirement */ 806 u32 (*read)(volatile u32 __iomem *); 807 void (*write)(u32, volatile u32 __iomem *); 808 int (*configure)(struct fore200e*); 809 int (*map)(struct fore200e*); 810 void (*reset)(struct fore200e*); 811 int (*prom_read)(struct fore200e*, struct prom_data*); 812 void (*unmap)(struct fore200e*); 813 void (*irq_enable)(struct fore200e*); 814 int (*irq_check)(struct fore200e*); 815 void (*irq_ack)(struct fore200e*); 816 int (*proc_read)(struct fore200e*, char*); 817 } fore200e_bus_t; 818 819 /* vc mapping */ 820 821 typedef struct fore200e_vc_map { 822 struct atm_vcc* vcc; /* vcc entry */ 823 unsigned long incarn; /* vcc incarnation number */ 824 } fore200e_vc_map_t; 825 826 #define FORE200E_VC_MAP(fore200e, vpi, vci) \ 827 (& (fore200e)->vc_map[ ((vpi) << FORE200E_VCI_BITS) | (vci) ]) 828 829 830 /* per-device data */ 831 832 typedef struct fore200e { 833 const struct fore200e_bus* bus; /* bus-dependent code and data */ 834 union fore200e_regs regs; /* bus-dependent registers */ 835 struct atm_dev* atm_dev; /* ATM device */ 836 837 enum fore200e_state state; /* device state */ 838 839 char name[16]; /* device name */ 840 struct device *dev; 841 int irq; /* irq number */ 842 unsigned long phys_base; /* physical base address */ 843 void __iomem * virt_base; /* virtual base address */ 844 845 unsigned char esi[ ESI_LEN ]; /* end system identifier */ 846 847 struct cp_monitor __iomem * cp_monitor; /* i960 monitor address */ 848 struct cp_queues __iomem * cp_queues; /* cp resident queues */ 849 struct host_cmdq host_cmdq; /* host resident cmd queue */ 850 struct host_txq host_txq; /* host resident tx queue */ 851 struct host_rxq host_rxq; /* host resident rx queue */ 852 /* host resident buffer supply queues */ 853 struct host_bsq host_bsq[ BUFFER_SCHEME_NBR ][ BUFFER_MAGN_NBR ]; 854 855 u32 available_cell_rate; /* remaining pseudo-CBR bw on link */ 856 857 int loop_mode; /* S/UNI loopback mode */ 858 859 struct stats* stats; /* last snapshot of the stats */ 860 861 struct mutex rate_mtx; /* protects rate reservation ops */ 862 spinlock_t q_lock; /* protects queue ops */ 863 #ifdef FORE200E_USE_TASKLET 864 struct tasklet_struct tx_tasklet; /* performs tx interrupt work */ 865 struct tasklet_struct rx_tasklet; /* performs rx interrupt work */ 866 #endif 867 unsigned long tx_sat; /* tx queue saturation count */ 868 869 unsigned long incarn_count; 870 struct fore200e_vc_map vc_map[ NBR_CONNECT ]; /* vc mapping */ 871 } fore200e_t; 872 873 874 /* per-vcc data */ 875 876 typedef struct fore200e_vcc { 877 enum buffer_scheme scheme; /* rx buffer scheme */ 878 struct tpd_rate rate; /* tx rate control data */ 879 int rx_min_pdu; /* size of smallest PDU received */ 880 int rx_max_pdu; /* size of largest PDU received */ 881 int tx_min_pdu; /* size of smallest PDU transmitted */ 882 int tx_max_pdu; /* size of largest PDU transmitted */ 883 unsigned long tx_pdu; /* nbr of tx pdus */ 884 unsigned long rx_pdu; /* nbr of rx pdus */ 885 } fore200e_vcc_t; 886 887 888 889 /* 200E-series common memory layout */ 890 891 #define FORE200E_CP_MONITOR_OFFSET 0x00000400 /* i960 monitor interface */ 892 #define FORE200E_CP_QUEUES_OFFSET 0x00004d40 /* cp resident queues */ 893 894 895 /* PCA-200E memory layout */ 896 897 #define PCA200E_IOSPACE_LENGTH 0x00200000 898 899 #define PCA200E_HCR_OFFSET 0x00100000 /* board control register */ 900 #define PCA200E_IMR_OFFSET 0x00100004 /* host IRQ mask register */ 901 #define PCA200E_PSR_OFFSET 0x00100008 /* PCI specific register */ 902 903 904 /* PCA-200E host control register */ 905 906 #define PCA200E_HCR_RESET (1<<0) /* read / write */ 907 #define PCA200E_HCR_HOLD_LOCK (1<<1) /* read / write */ 908 #define PCA200E_HCR_I960FAIL (1<<2) /* read */ 909 #define PCA200E_HCR_INTRB (1<<2) /* write */ 910 #define PCA200E_HCR_HOLD_ACK (1<<3) /* read */ 911 #define PCA200E_HCR_INTRA (1<<3) /* write */ 912 #define PCA200E_HCR_OUTFULL (1<<4) /* read */ 913 #define PCA200E_HCR_CLRINTR (1<<4) /* write */ 914 #define PCA200E_HCR_ESPHOLD (1<<5) /* read */ 915 #define PCA200E_HCR_INFULL (1<<6) /* read */ 916 #define PCA200E_HCR_TESTMODE (1<<7) /* read */ 917 918 919 /* PCA-200E PCI bus interface regs (offsets in PCI config space) */ 920 921 #define PCA200E_PCI_LATENCY 0x40 /* maximum slave latenty */ 922 #define PCA200E_PCI_MASTER_CTRL 0x41 /* master control */ 923 #define PCA200E_PCI_THRESHOLD 0x42 /* burst / continuous req threshold */ 924 925 /* PBI master control register */ 926 927 #define PCA200E_CTRL_DIS_CACHE_RD (1<<0) /* disable cache-line reads */ 928 #define PCA200E_CTRL_DIS_WRT_INVAL (1<<1) /* disable writes and invalidates */ 929 #define PCA200E_CTRL_2_CACHE_WRT_INVAL (1<<2) /* require 2 cache-lines for writes and invalidates */ 930 #define PCA200E_CTRL_IGN_LAT_TIMER (1<<3) /* ignore the latency timer */ 931 #define PCA200E_CTRL_ENA_CONT_REQ_MODE (1<<4) /* enable continuous request mode */ 932 #define PCA200E_CTRL_LARGE_PCI_BURSTS (1<<5) /* force large PCI bus bursts */ 933 #define PCA200E_CTRL_CONVERT_ENDIAN (1<<6) /* convert endianess of slave RAM accesses */ 934 935 936 937 #define SBA200E_PROM_NAME "FORE,sba-200e" /* device name in openprom tree */ 938 939 940 /* size of SBA-200E registers */ 941 942 #define SBA200E_HCR_LENGTH 4 943 #define SBA200E_BSR_LENGTH 4 944 #define SBA200E_ISR_LENGTH 4 945 #define SBA200E_RAM_LENGTH 0x40000 946 947 948 /* SBA-200E SBUS burst transfer size register */ 949 950 #define SBA200E_BSR_BURST4 0x04 951 #define SBA200E_BSR_BURST8 0x08 952 #define SBA200E_BSR_BURST16 0x10 953 954 955 /* SBA-200E host control register */ 956 957 #define SBA200E_HCR_RESET (1<<0) /* read / write (sticky) */ 958 #define SBA200E_HCR_HOLD_LOCK (1<<1) /* read / write (sticky) */ 959 #define SBA200E_HCR_I960FAIL (1<<2) /* read */ 960 #define SBA200E_HCR_I960SETINTR (1<<2) /* write */ 961 #define SBA200E_HCR_OUTFULL (1<<3) /* read */ 962 #define SBA200E_HCR_INTR_CLR (1<<3) /* write */ 963 #define SBA200E_HCR_INTR_ENA (1<<4) /* read / write (sticky) */ 964 #define SBA200E_HCR_ESPHOLD (1<<5) /* read */ 965 #define SBA200E_HCR_INFULL (1<<6) /* read */ 966 #define SBA200E_HCR_TESTMODE (1<<7) /* read */ 967 #define SBA200E_HCR_INTR_REQ (1<<8) /* read */ 968 969 #define SBA200E_HCR_STICKY (SBA200E_HCR_RESET | SBA200E_HCR_HOLD_LOCK | SBA200E_HCR_INTR_ENA) 970 971 972 #endif /* __KERNEL__ */ 973 #endif /* _FORE200E_H */ 974