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