Subversion Repositories HelenOS

Rev

Rev 4743 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
4163 mejdrech 1
/*
2
 * Copyright (c) 1987,1997, 2006, Vrije Universiteit, Amsterdam, The Netherlands All rights reserved. Redistribution and use of the MINIX 3 operating system in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
3
 *
4
 * * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
5
 * * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
6
 * * Neither the name of the Vrije Universiteit nor the names of the software authors or contributors may be used to endorse or promote products derived from this software without specific prior written permission.
7
 * * Any deviations from these conditions require written permission from the copyright holder in advance
8
 *
9
 *
10
 * Disclaimer
11
 *
12
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS, AUTHORS, AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
13
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
14
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
15
 * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR ANY AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
16
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
17
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
18
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
19
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
20
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
21
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
22
 *
23
 * Changes:
4756 mejdrech 24
 *  2009 ported to HelenOS, Lukas Mejdrech
4163 mejdrech 25
 */
26
 
27
/** @addtogroup dp8390
28
 *  @{
29
 */
30
 
4723 mejdrech 31
/** @file
4756 mejdrech 32
 *  DP8390 network interface definitions.
4163 mejdrech 33
 */
34
 
35
#ifndef __NET_NETIF_DP8390_H__
36
#define __NET_NETIF_DP8390_H__
37
 
4192 mejdrech 38
#include "../../structures/packet/packet.h"
39
 
4163 mejdrech 40
#include "dp8390_port.h"
41
#include "local.h"
42
 
4756 mejdrech 43
/** Input/output size.
44
 */
4261 mejdrech 45
#define DP8390_IO_SIZE  0x01f
46
 
4163 mejdrech 47
/*
48
dp8390.h
49
 
50
Created:    before Dec 28, 1992 by Philip Homburg
51
*/
52
 
53
/* National Semiconductor DP8390 Network Interface Controller. */
54
 
55
                /* Page 0, for reading ------------- */
56
#define DP_CR       0x0 /* Read side of Command Register     */
57
#define DP_CLDA0    0x1 /* Current Local Dma Address 0       */
58
#define DP_CLDA1    0x2 /* Current Local Dma Address 1       */
59
#define DP_BNRY     0x3 /* Boundary Pointer                  */
60
#define DP_TSR      0x4 /* Transmit Status Register          */
61
#define DP_NCR      0x5 /* Number of Collisions Register     */
62
#define DP_FIFO     0x6 /* Fifo ??                           */
63
#define DP_ISR      0x7 /* Interrupt Status Register         */
64
#define DP_CRDA0    0x8 /* Current Remote Dma Address 0      */
65
#define DP_CRDA1    0x9 /* Current Remote Dma Address 1      */
66
#define DP_DUM1     0xA /* unused                            */
67
#define DP_DUM2     0xB /* unused                            */
68
#define DP_RSR      0xC /* Receive Status Register           */
69
#define DP_CNTR0    0xD /* Tally Counter 0                   */
70
#define DP_CNTR1    0xE /* Tally Counter 1                   */
71
#define DP_CNTR2    0xF /* Tally Counter 2                   */
72
 
73
                /* Page 0, for writing ------------- */
74
#define DP_CR       0x0 /* Write side of Command Register    */
75
#define DP_PSTART   0x1 /* Page Start Register               */
76
#define DP_PSTOP    0x2 /* Page Stop Register                */
77
#define DP_BNRY     0x3 /* Boundary Pointer                  */
78
#define DP_TPSR     0x4 /* Transmit Page Start Register      */
79
#define DP_TBCR0    0x5 /* Transmit Byte Count Register 0    */
80
#define DP_TBCR1    0x6 /* Transmit Byte Count Register 1    */
81
#define DP_ISR      0x7 /* Interrupt Status Register         */
82
#define DP_RSAR0    0x8 /* Remote Start Address Register 0   */
83
#define DP_RSAR1    0x9 /* Remote Start Address Register 1   */
84
#define DP_RBCR0    0xA /* Remote Byte Count Register 0      */
85
#define DP_RBCR1    0xB /* Remote Byte Count Register 1      */
86
#define DP_RCR      0xC /* Receive Configuration Register    */
87
#define DP_TCR      0xD /* Transmit Configuration Register   */
88
#define DP_DCR      0xE /* Data Configuration Register       */
89
#define DP_IMR      0xF /* Interrupt Mask Register           */
90
 
91
                /* Page 1, read/write -------------- */
92
#define DP_CR       0x0 /* Command Register                  */
93
#define DP_PAR0     0x1 /* Physical Address Register 0       */
94
#define DP_PAR1     0x2 /* Physical Address Register 1       */
95
#define DP_PAR2     0x3 /* Physical Address Register 2       */
96
#define DP_PAR3     0x4 /* Physical Address Register 3       */
97
#define DP_PAR4     0x5 /* Physical Address Register 4       */
98
#define DP_PAR5     0x6 /* Physical Address Register 5       */
99
#define DP_CURR     0x7 /* Current Page Register             */
100
#define DP_MAR0     0x8 /* Multicast Address Register 0      */
101
#define DP_MAR1     0x9 /* Multicast Address Register 1      */
102
#define DP_MAR2     0xA /* Multicast Address Register 2      */
103
#define DP_MAR3     0xB /* Multicast Address Register 3      */
104
#define DP_MAR4     0xC /* Multicast Address Register 4      */
105
#define DP_MAR5     0xD /* Multicast Address Register 5      */
106
#define DP_MAR6     0xE /* Multicast Address Register 6      */
107
#define DP_MAR7     0xF /* Multicast Address Register 7      */
108
 
109
/* Bits in dp_cr */
110
#define CR_STP      0x01    /* Stop: software reset              */
111
#define CR_STA      0x02    /* Start: activate NIC               */
112
#define CR_TXP      0x04    /* Transmit Packet                   */
113
#define CR_DMA      0x38    /* Mask for DMA control              */
114
#define CR_DM_NOP   0x00    /* DMA: No Operation                 */
115
#define CR_DM_RR    0x08    /* DMA: Remote Read                  */
116
#define CR_DM_RW    0x10    /* DMA: Remote Write                 */
117
#define CR_DM_SP    0x18    /* DMA: Send Packet                  */
118
#define CR_DM_ABORT 0x20    /* DMA: Abort Remote DMA Operation   */
119
#define CR_PS       0xC0    /* Mask for Page Select              */
120
#define CR_PS_P0    0x00    /* Register Page 0                   */
121
#define CR_PS_P1    0x40    /* Register Page 1                   */
122
#define CR_PS_P2    0x80    /* Register Page 2                   */
123
#define CR_PS_T1    0xC0    /* Test Mode Register Map            */
124
 
125
/* Bits in dp_isr */
126
#define ISR_PRX     0x01    /* Packet Received with no errors    */
127
#define ISR_PTX     0x02    /* Packet Transmitted with no errors */
128
#define ISR_RXE     0x04    /* Receive Error                     */
129
#define ISR_TXE     0x08    /* Transmit Error                    */
130
#define ISR_OVW     0x10    /* Overwrite Warning                 */
131
#define ISR_CNT     0x20    /* Counter Overflow                  */
132
#define ISR_RDC     0x40    /* Remote DMA Complete               */
133
#define ISR_RST     0x80    /* Reset Status                      */
134
 
135
/* Bits in dp_imr */
136
#define IMR_PRXE    0x01    /* Packet Received iEnable           */
137
#define IMR_PTXE    0x02    /* Packet Transmitted iEnable        */
138
#define IMR_RXEE    0x04    /* Receive Error iEnable             */
139
#define IMR_TXEE    0x08    /* Transmit Error iEnable            */
140
#define IMR_OVWE    0x10    /* Overwrite Warning iEnable         */
141
#define IMR_CNTE    0x20    /* Counter Overflow iEnable          */
142
#define IMR_RDCE    0x40    /* DMA Complete iEnable              */
143
 
144
/* Bits in dp_dcr */
145
#define DCR_WTS     0x01    /* Word Transfer Select              */
146
#define DCR_BYTEWIDE    0x00    /* WTS: byte wide transfers          */
147
#define DCR_WORDWIDE    0x01    /* WTS: word wide transfers          */
148
#define DCR_BOS     0x02    /* Byte Order Select                 */
149
#define DCR_LTLENDIAN   0x00    /* BOS: Little Endian                */
150
#define DCR_BIGENDIAN   0x02    /* BOS: Big Endian                   */
151
#define DCR_LAS     0x04    /* Long Address Select               */
152
#define DCR_BMS     0x08    /* Burst Mode Select
153
                 * Called Loopback Select (LS) in
154
                 * later manuals. Should be set.     */
155
#define DCR_AR      0x10    /* Autoinitialize Remote             */
156
#define DCR_FTS     0x60    /* Fifo Threshold Select             */
157
#define DCR_2BYTES  0x00    /* 2 bytes                           */
158
#define DCR_4BYTES  0x40    /* 4 bytes                           */
159
#define DCR_8BYTES  0x20    /* 8 bytes                           */
160
#define DCR_12BYTES 0x60    /* 12 bytes                          */
161
 
162
/* Bits in dp_tcr */
163
#define TCR_CRC     0x01    /* Inhibit CRC                       */
164
#define TCR_ELC     0x06    /* Encoded Loopback Control          */
165
#define TCR_NORMAL  0x00    /* ELC: Normal Operation             */
166
#define TCR_INTERNAL    0x02    /* ELC: Internal Loopback            */
167
#define TCR_0EXTERNAL   0x04    /* ELC: External Loopback LPBK=0     */
168
#define TCR_1EXTERNAL   0x06    /* ELC: External Loopback LPBK=1     */
169
#define TCR_ATD     0x08    /* Auto Transmit Disable             */
170
#define TCR_OFST    0x10    /* Collision Offset Enable (be nice) */
171
 
172
/* Bits in dp_tsr */
173
#define TSR_PTX     0x01    /* Packet Transmitted (without error)*/
174
#define TSR_DFR     0x02    /* Transmit Deferred, reserved in
175
                 * later manuals.            */
176
#define TSR_COL     0x04    /* Transmit Collided                 */
177
#define TSR_ABT     0x08    /* Transmit Aborted                  */
178
#define TSR_CRS     0x10    /* Carrier Sense Lost                */
179
#define TSR_FU      0x20    /* FIFO Underrun                     */
180
#define TSR_CDH     0x40    /* CD Heartbeat                      */
181
#define TSR_OWC     0x80    /* Out of Window Collision           */
182
 
183
/* Bits in tp_rcr */
184
#define RCR_SEP     0x01    /* Save Errored Packets              */
185
#define RCR_AR      0x02    /* Accept Runt Packets               */
186
#define RCR_AB      0x04    /* Accept Broadcast                  */
187
#define RCR_AM      0x08    /* Accept Multicast                  */
188
#define RCR_PRO     0x10    /* Physical Promiscuous              */
189
#define RCR_MON     0x20    /* Monitor Mode                      */
190
 
191
/* Bits in dp_rsr */
192
#define RSR_PRX     0x01    /* Packet Received Intact            */
193
#define RSR_CRC     0x02    /* CRC Error                         */
194
#define RSR_FAE     0x04    /* Frame Alignment Error             */
195
#define RSR_FO      0x08    /* FIFO Overrun                      */
196
#define RSR_MPA     0x10    /* Missed Packet                     */
197
#define RSR_PHY     0x20    /* Multicast Address Match           */
198
#define RSR_DIS     0x40    /* Receiver Disabled                 */
199
#define RSR_DFR     0x80    /* In later manuals: Deferring       */
200
 
4756 mejdrech 201
/** Type definition of the receive header.
202
 */
4163 mejdrech 203
typedef struct dp_rcvhdr
204
{
4756 mejdrech 205
    /** Copy of rsr.
206
     */
207
    u8_t dr_status;
208
    /** Pointer to next packet.
209
     */
210
    u8_t dr_next;
211
    /** Receive Byte Count Low.
212
     */
213
    u8_t dr_rbcl;
214
    /** Receive Byte Count High.
215
     */
216
    u8_t dr_rbch;
4163 mejdrech 217
} dp_rcvhdr_t;
218
 
4756 mejdrech 219
/** Page size.
220
 */
4163 mejdrech 221
#define DP_PAGESIZE 256
222
 
223
/* Some macros to simplify accessing the dp8390 */
4756 mejdrech 224
/** Reads 1 byte from the zero page register.
225
 *  @param[in] dep The network interface structure.
226
 *  @param[in] reg The register offset.
227
 *  @returns The read value.
228
 */
4163 mejdrech 229
#define inb_reg0(dep, reg)      (inb(dep->de_dp8390_port+reg))
4756 mejdrech 230
 
231
/** Writes 1 byte zero page register.
232
 *  @param[in] dep The network interface structure.
233
 *  @param[in] reg The register offset.
234
 *  @param[in] data The value to be written.
235
 */
4163 mejdrech 236
#define outb_reg0(dep, reg, data)   (outb(dep->de_dp8390_port+reg, data))
4756 mejdrech 237
 
238
/** Reads 1 byte from the first page register.
239
 *  @param[in] dep The network interface structure.
240
 *  @param[in] reg The register offset.
241
 *  @returns The read value.
242
 */
4163 mejdrech 243
#define inb_reg1(dep, reg)      (inb(dep->de_dp8390_port+reg))
4756 mejdrech 244
 
245
/** Writes 1 byte first page register.
246
 *  @param[in] dep The network interface structure.
247
 *  @param[in] reg The register offset.
248
 *  @param[in] data The value to be written.
249
 */
4163 mejdrech 250
#define outb_reg1(dep, reg, data)   (outb(dep->de_dp8390_port+reg, data))
251
 
252
/* Software interface to the dp8390 driver */
253
 
254
struct dpeth;
255
struct iovec_dat;
256
//struct iovec_dat_s;
257
_PROTOTYPE( typedef void (*dp_initf_t), (struct dpeth *dep)     );
258
_PROTOTYPE( typedef void (*dp_stopf_t), (struct dpeth *dep)     );
4192 mejdrech 259
_PROTOTYPE( typedef void (*dp_user2nicf_t), (struct dpeth *dep,
260
            struct iovec_dat *iovp, vir_bytes offset,
261
            int nic_addr, vir_bytes count)          );
4163 mejdrech 262
//_PROTOTYPE( typedef void (*dp_user2nicf_s_t), (struct dpeth *dep,
263
//          struct iovec_dat_s *iovp, vir_bytes offset,
264
//          int nic_addr, vir_bytes count)          );
265
_PROTOTYPE( typedef void (*dp_nic2userf_t), (struct dpeth *dep,
266
            int nic_addr, struct iovec_dat *iovp,
267
            vir_bytes offset, vir_bytes count)      );
268
//_PROTOTYPE( typedef void (*dp_nic2userf_s_t), (struct dpeth *dep,
269
//          int nic_addr, struct iovec_dat_s *iovp,
270
//          vir_bytes offset, vir_bytes count)      );
271
//#if 0
272
//_PROTOTYPE( typedef void (*dp_getheaderf_t), (struct dpeth *dep,
273
//          int page, struct dp_rcvhdr *h, u16_t *eth_type) );
274
//#endif
275
_PROTOTYPE( typedef void (*dp_getblock_t), (struct dpeth *dep,
276
        int page, size_t offset, size_t size, void *dst)    );
277
 
278
/* iovectors are handled IOVEC_NR entries at a time. */
4192 mejdrech 279
//#define IOVEC_NR  16
280
// no vectors allowed
281
#define IOVEC_NR    1
4163 mejdrech 282
 
283
/*
284
typedef int irq_hook_t;
285
*/
286
typedef struct iovec_dat
287
{
288
  iovec_t iod_iovec[IOVEC_NR];
289
  int iod_iovec_s;
4192 mejdrech 290
  // no direct process access
4163 mejdrech 291
  int iod_proc_nr;
292
  vir_bytes iod_iovec_addr;
293
} iovec_dat_t;
294
/*
295
typedef struct iovec_dat_s
296
{
297
  iovec_s_t iod_iovec[IOVEC_NR];
298
  int iod_iovec_s;
299
  int iod_proc_nr;
300
  cp_grant_id_t iod_grant;
301
  vir_bytes iod_iovec_offset;
302
} iovec_dat_s_t;
303
*/
4498 mejdrech 304
#define SENDQ_NR    1   /* Maximum size of the send queue */
4163 mejdrech 305
#define SENDQ_PAGES 6   /* 6 * DP_PAGESIZE >= 1514 bytes */
306
 
4743 mejdrech 307
/** Maximum number of waiting packets to be sent or received.
308
 */
309
#define MAX_PACKETS 4
310
 
4163 mejdrech 311
typedef struct dpeth
312
{
4756 mejdrech 313
    /** Outgoing packets queue.
314
     */
4192 mejdrech 315
    packet_t    packet_queue;
4756 mejdrech 316
    /** Outgoing packets count.
317
     */
4192 mejdrech 318
    int         packet_count;
319
 
4756 mejdrech 320
    /** Received packets queue.
321
     */
4261 mejdrech 322
    packet_t    received_queue;
4756 mejdrech 323
    /** Received packets count.
324
     */
4743 mejdrech 325
    int         received_count;
4261 mejdrech 326
 
4163 mejdrech 327
    /* The de_base_port field is the starting point of the probe.
328
     * The conf routine also fills de_linmem and de_irq. If the probe
329
     * routine knows the irq and/or memory address because they are
330
     * hardwired in the board, the probe should modify these fields.
331
     * Futhermore, the probe routine should also fill in de_initf and
332
     * de_stopf fields with the appropriate function pointers and set
333
     * de_prog_IO iff programmed I/O is to be used.
334
     */
335
    port_t de_base_port;
336
    phys_bytes de_linmem;
337
    char *de_locmem;
338
    int de_irq;
339
    int de_int_pending;
340
//  irq_hook_t de_hook;
341
    dp_initf_t de_initf;
342
    dp_stopf_t de_stopf;
343
    int de_prog_IO;
344
    char de_name[sizeof("dp8390#n")];
345
 
346
    /* The initf function fills the following fields. Only cards that do
347
     * programmed I/O fill in the de_pata_port field.
348
     * In addition, the init routine has to fill in the sendq data
349
     * structures.
350
     */
351
    ether_addr_t de_address;
352
    port_t de_dp8390_port;
353
    port_t de_data_port;
354
    int de_16bit;
355
    int de_ramsize;
356
    int de_offset_page;
357
    int de_startpage;
358
    int de_stoppage;
359
 
360
    /* should be here - read even for ne2k isa init... */
361
    char de_pci;            /* TRUE iff PCI device */
362
 
363
#if ENABLE_PCI
364
    /* PCI config */
365
//  char de_pci;            /* TRUE iff PCI device */
366
//  u8_t de_pcibus; 
367
//  u8_t de_pcidev; 
368
//  u8_t de_pcifunc;    
369
#endif
370
 
371
    /* Do it yourself send queue */
372
    struct sendq
373
    {
374
        int sq_filled;      /* this buffer contains a packet */
375
        int sq_size;        /* with this size */
376
        int sq_sendpage;    /* starting page of the buffer */
377
    } de_sendq[SENDQ_NR];
378
    int de_sendq_nr;
379
    int de_sendq_head;      /* Enqueue at the head */
380
    int de_sendq_tail;      /* Dequeue at the tail */
381
 
382
    /* Fields for internal use by the dp8390 driver. */
383
    int de_flags;
384
    int de_mode;
385
    eth_stat_t de_stat;
386
    iovec_dat_t de_read_iovec;
387
//  iovec_dat_s_t de_read_iovec_s;
388
//  int de_safecopy_read;
4192 mejdrech 389
    iovec_dat_t de_write_iovec;
4163 mejdrech 390
//  iovec_dat_s_t de_write_iovec_s;
391
    iovec_dat_t de_tmp_iovec;
392
//  iovec_dat_s_t de_tmp_iovec_s;
393
    vir_bytes de_read_s;
394
//  int de_client;
395
//  message de_sendmsg;
4192 mejdrech 396
    dp_user2nicf_t de_user2nicf;
4163 mejdrech 397
//  dp_user2nicf_s_t de_user2nicf_s; 
398
    dp_nic2userf_t de_nic2userf;
399
//  dp_nic2userf_s_t de_nic2userf_s; 
400
    dp_getblock_t de_getblockf;
401
} dpeth_t;
402
 
403
#define DEI_DEFAULT 0x8000
404
 
405
#define DEF_EMPTY   0x000
406
#define DEF_PACK_SEND   0x001
407
#define DEF_PACK_RECV   0x002
408
#define DEF_SEND_AVAIL  0x004
409
#define DEF_READING 0x010
410
#define DEF_PROMISC 0x040
411
#define DEF_MULTI   0x080
412
#define DEF_BROAD   0x100
413
#define DEF_ENABLED 0x200
414
#define DEF_STOPPED 0x400
415
 
416
#define DEM_DISABLED    0x0
417
#define DEM_SINK    0x1
418
#define DEM_ENABLED 0x2
419
 
420
//#if !__minix_vmd
421
#define debug       1   /* Standard Minix lacks debug variable */
422
//#endif
423
 
424
/*
425
 * $PchId: dp8390.h,v 1.10 2005/02/10 17:26:06 philip Exp $
426
 */
427
 
428
#endif
429
 
430
/** @}
431
 */