ns_gige.hh revision 11169 
1/*
2 * Copyright (c) 2004-2005 The Regents of The University of Michigan
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are
7 * met: redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer;
9 * redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution;
12 * neither the name of the copyright holders nor the names of its
13 * contributors may be used to endorse or promote products derived from
14 * this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 * Authors: Nathan Binkert
29 *          Lisa Hsu
30 */
31
32/** @file
33 * Device module for modelling the National Semiconductor
34 * DP83820 ethernet controller
35 */
36
37#ifndef __DEV_NS_GIGE_HH__
38#define __DEV_NS_GIGE_HH__
39
40#include "base/inet.hh"
41#include "dev/etherdevice.hh"
42#include "dev/etherint.hh"
43#include "dev/etherpkt.hh"
44#include "dev/io_device.hh"
45#include "dev/ns_gige_reg.h"
46#include "dev/pktfifo.hh"
47#include "params/NSGigE.hh"
48#include "sim/eventq.hh"
49
50// Hash filtering constants
51const uint16_t FHASH_ADDR  = 0x100;
52const uint16_t FHASH_SIZE  = 0x100;
53
54// EEPROM constants
55const uint8_t  EEPROM_READ = 0x2;
56const uint8_t  EEPROM_SIZE = 64; // Size in words of NSC93C46 EEPROM
57const uint8_t  EEPROM_PMATCH2_ADDR = 0xA; // EEPROM Address of PMATCH word 2
58const uint8_t  EEPROM_PMATCH1_ADDR = 0xB; // EEPROM Address of PMATCH word 1
59const uint8_t  EEPROM_PMATCH0_ADDR = 0xC; // EEPROM Address of PMATCH word 0
60
61/**
62 * Ethernet device registers
63 */
64struct dp_regs {
65    uint32_t    command;
66    uint32_t    config;
67    uint32_t    mear;
68    uint32_t    ptscr;
69    uint32_t    isr;
70    uint32_t    imr;
71    uint32_t    ier;
72    uint32_t    ihr;
73    uint32_t    txdp;
74    uint32_t    txdp_hi;
75    uint32_t    txcfg;
76    uint32_t    gpior;
77    uint32_t    rxdp;
78    uint32_t    rxdp_hi;
79    uint32_t    rxcfg;
80    uint32_t    pqcr;
81    uint32_t    wcsr;
82    uint32_t    pcr;
83    uint32_t    rfcr;
84    uint32_t    rfdr;
85    uint32_t    brar;
86    uint32_t    brdr;
87    uint32_t    srr;
88    uint32_t    mibc;
89    uint32_t    vrcr;
90    uint32_t    vtcr;
91    uint32_t    vdr;
92    uint32_t    ccsr;
93    uint32_t    tbicr;
94    uint32_t    tbisr;
95    uint32_t    tanar;
96    uint32_t    tanlpar;
97    uint32_t    taner;
98    uint32_t    tesr;
99};
100
101struct dp_rom {
102    /**
103     * for perfect match memory.
104     * the linux driver doesn't use any other ROM
105     */
106    uint8_t perfectMatch[ETH_ADDR_LEN];
107
108    /**
109     * for hash table memory.
110     * used by the freebsd driver
111     */
112    uint8_t filterHash[FHASH_SIZE];
113};
114
115class NSGigEInt;
116class Packet;
117
118/**
119 * NS DP83820 Ethernet device model
120 */
121class NSGigE : public EtherDevBase
122{
123  public:
124    /** Transmit State Machine states */
125    enum TxState
126    {
127        txIdle,
128        txDescRefr,
129        txDescRead,
130        txFifoBlock,
131        txFragRead,
132        txDescWrite,
133        txAdvance
134    };
135
136    /** Receive State Machine States */
137    enum RxState
138    {
139        rxIdle,
140        rxDescRefr,
141        rxDescRead,
142        rxFifoBlock,
143        rxFragWrite,
144        rxDescWrite,
145        rxAdvance
146    };
147
148    enum DmaState
149    {
150        dmaIdle,
151        dmaReading,
152        dmaWriting,
153        dmaReadWaiting,
154        dmaWriteWaiting
155    };
156
157    /** EEPROM State Machine States */
158    enum EEPROMState
159    {
160        eepromStart,
161        eepromGetOpcode,
162        eepromGetAddress,
163        eepromRead
164    };
165
166  protected:
167    /** device register file */
168    dp_regs regs;
169    dp_rom rom;
170
171    /** pci settings */
172    bool ioEnable;
173#if 0
174    bool memEnable;
175    bool bmEnable;
176#endif
177
178    /*** BASIC STRUCTURES FOR TX/RX ***/
179    /* Data FIFOs */
180    PacketFifo txFifo;
181    PacketFifo rxFifo;
182
183    /** various helper vars */
184    EthPacketPtr txPacket;
185    EthPacketPtr rxPacket;
186    uint8_t *txPacketBufPtr;
187    uint8_t *rxPacketBufPtr;
188    uint32_t txXferLen;
189    uint32_t rxXferLen;
190    bool rxDmaFree;
191    bool txDmaFree;
192
193    /** DescCaches */
194    ns_desc32 txDesc32;
195    ns_desc32 rxDesc32;
196    ns_desc64 txDesc64;
197    ns_desc64 rxDesc64;
198
199    /* tx State Machine */
200    TxState txState;
201    bool txEnable;
202
203    /** Current Transmit Descriptor Done */
204    bool CTDD;
205    /** halt the tx state machine after next packet */
206    bool txHalt;
207    /** ptr to the next byte in the current fragment */
208    Addr txFragPtr;
209    /** count of bytes remaining in the current descriptor */
210    uint32_t txDescCnt;
211    DmaState txDmaState;
212
213    /** rx State Machine */
214    RxState rxState;
215    bool rxEnable;
216
217    /** Current Receive Descriptor Done */
218    bool CRDD;
219    /** num of bytes in the current packet being drained from rxDataFifo */
220    uint32_t rxPktBytes;
221    /** halt the rx state machine after current packet */
222    bool rxHalt;
223    /** ptr to the next byte in current fragment */
224    Addr rxFragPtr;
225    /** count of bytes remaining in the current descriptor */
226    uint32_t rxDescCnt;
227    DmaState rxDmaState;
228
229    bool extstsEnable;
230
231    /** EEPROM State Machine */
232    EEPROMState eepromState;
233    bool eepromClk;
234    uint8_t eepromBitsToRx;
235    uint8_t eepromOpcode;
236    uint8_t eepromAddress;
237    uint16_t eepromData;
238
239  protected:
240    Tick dmaReadDelay;
241    Tick dmaWriteDelay;
242
243    Tick dmaReadFactor;
244    Tick dmaWriteFactor;
245
246    void *rxDmaData;
247    Addr  rxDmaAddr;
248    int   rxDmaLen;
249    bool  doRxDmaRead();
250    bool  doRxDmaWrite();
251
252    void *txDmaData;
253    Addr  txDmaAddr;
254    int   txDmaLen;
255    bool  doTxDmaRead();
256    bool  doTxDmaWrite();
257
258    void rxDmaReadDone();
259    friend class EventWrapper<NSGigE, &NSGigE::rxDmaReadDone>;
260    EventWrapper<NSGigE, &NSGigE::rxDmaReadDone> rxDmaReadEvent;
261
262    void rxDmaWriteDone();
263    friend class EventWrapper<NSGigE, &NSGigE::rxDmaWriteDone>;
264    EventWrapper<NSGigE, &NSGigE::rxDmaWriteDone> rxDmaWriteEvent;
265
266    void txDmaReadDone();
267    friend class EventWrapper<NSGigE, &NSGigE::txDmaReadDone>;
268    EventWrapper<NSGigE, &NSGigE::txDmaReadDone> txDmaReadEvent;
269
270    void txDmaWriteDone();
271    friend class EventWrapper<NSGigE, &NSGigE::txDmaWriteDone>;
272    EventWrapper<NSGigE, &NSGigE::txDmaWriteDone> txDmaWriteEvent;
273
274    bool dmaDescFree;
275    bool dmaDataFree;
276
277  protected:
278    Tick txDelay;
279    Tick rxDelay;
280
281    void txReset();
282    void rxReset();
283    void regsReset();
284
285    void rxKick();
286    Tick rxKickTick;
287    typedef EventWrapper<NSGigE, &NSGigE::rxKick> RxKickEvent;
288    friend void RxKickEvent::process();
289    RxKickEvent rxKickEvent;
290
291    void txKick();
292    Tick txKickTick;
293    typedef EventWrapper<NSGigE, &NSGigE::txKick> TxKickEvent;
294    friend void TxKickEvent::process();
295    TxKickEvent txKickEvent;
296
297    void eepromKick();
298
299    /**
300     * Retransmit event
301     */
302    void transmit();
303    void txEventTransmit()
304    {
305        transmit();
306        if (txState == txFifoBlock)
307            txKick();
308    }
309    typedef EventWrapper<NSGigE, &NSGigE::txEventTransmit> TxEvent;
310    friend void TxEvent::process();
311    TxEvent txEvent;
312
313    void txDump() const;
314    void rxDump() const;
315
316    /**
317     * receive address filter
318     */
319    bool rxFilterEnable;
320    bool rxFilter(const EthPacketPtr &packet);
321    bool acceptBroadcast;
322    bool acceptMulticast;
323    bool acceptUnicast;
324    bool acceptPerfect;
325    bool acceptArp;
326    bool multicastHashEnable;
327
328    /**
329     * Interrupt management
330     */
331    void devIntrPost(uint32_t interrupts);
332    void devIntrClear(uint32_t interrupts);
333    void devIntrChangeMask();
334
335    Tick intrDelay;
336    Tick intrTick;
337    bool cpuPendingIntr;
338    void cpuIntrPost(Tick when);
339    void cpuInterrupt();
340    void cpuIntrClear();
341
342    typedef EventWrapper<NSGigE, &NSGigE::cpuInterrupt> IntrEvent;
343    friend void IntrEvent::process();
344    IntrEvent *intrEvent;
345    NSGigEInt *interface;
346
347  public:
348    typedef NSGigEParams Params;
349    const Params *params() const {
350        return dynamic_cast<const Params *>(_params);
351    }
352
353    NSGigE(Params *params);
354    ~NSGigE();
355
356    EtherInt *getEthPort(const std::string &if_name, int idx) override;
357
358    Tick writeConfig(PacketPtr pkt) override;
359
360    Tick read(PacketPtr pkt) override;
361    Tick write(PacketPtr pkt) override;
362
363    bool cpuIntrPending() const;
364    void cpuIntrAck() { cpuIntrClear(); }
365
366    bool recvPacket(EthPacketPtr packet);
367    void transferDone();
368
369    void serialize(CheckpointOut &cp) const override;
370    void unserialize(CheckpointIn &cp) override;
371
372    void drainResume() override;
373};
374
375/*
376 * Ethernet Interface for an Ethernet Device
377 */
378class NSGigEInt : public EtherInt
379{
380  private:
381    NSGigE *dev;
382
383  public:
384    NSGigEInt(const std::string &name, NSGigE *d)
385        : EtherInt(name), dev(d)
386    { }
387
388    virtual bool recvPacket(EthPacketPtr pkt) { return dev->recvPacket(pkt); }
389    virtual void sendDone() { dev->transferDone(); }
390};
391
392#endif // __DEV_NS_GIGE_HH__
393