2 * Copyright (c) 2004 The Regents of The University of Michigan
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.
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.
30 * Device module for modelling the National Semiconductor
31 * DP83820 ethernet controller
34 #ifndef __NS_GIGE_HH__
35 #define __NS_GIGE_HH__
37 //#include "base/range.hh"
38 #include "dev/etherint.hh"
39 #include "dev/etherpkt.hh"
40 #include "sim/eventq.hh"
41 #include "dev/ns_gige_reg.h"
42 #include "base/statistics.hh"
43 #include "dev/pcidev.hh"
44 #include "dev/tsunami.hh"
45 #include "dev/io_device.hh"
46 #include "mem/bus/bus.hh"
48 /** defined by the NS83820 data sheet */
49 #define MAX_TX_FIFO_SIZE 8192
50 #define MAX_RX_FIFO_SIZE 32768
52 /** length of ethernet address in bytes */
56 * Ethernet device registers
94 /** for perfect match memory. the linux driver doesn't use any other ROM */
95 uint8_t perfectMatch[EADDR_LEN];
100 class PhysicalMemory;
107 * NS DP82830 Ethernet device model
109 class NSGigE : public PciDev
112 /** Transmit State Machine states */
124 /** Receive State Machine States */
146 /** pointer to the chipset */
151 static const Addr size = sizeof(dp_regs);
154 typedef std::deque<PacketPtr> pktbuf_t;
155 typedef pktbuf_t::iterator pktiter_t;
157 /** device register file */
168 /*** BASIC STRUCTURES FOR TX/RX ***/
173 /** various helper vars */
176 uint8_t *txPacketBufPtr;
177 uint8_t *rxPacketBufPtr;
180 uint32_t txPktXmitted;
188 /* tx State Machine */
190 /** Current Transmit Descriptor Done */
192 /** amt of data in the txDataFifo in bytes (logical) */
194 /** current amt of free space in txDataFifo in bytes */
195 uint32_t txFifoAvail;
196 /** halt the tx state machine after next packet */
198 /** ptr to the next byte in the current fragment */
200 /** count of bytes remaining in the current descriptor */
204 /** rx State Machine */
206 /** Current Receive Descriptor Done */
208 /** num of bytes in the current packet being drained from rxDataFifo */
210 /** number of bytes in the rxFifo */
212 /** halt the rx state machine after current packet */
214 /** ptr to the next byte in current fragment */
216 /** count of bytes remaining in the current descriptor */
234 void rxDmaReadCopy();
235 void rxDmaWriteCopy();
242 void txDmaReadCopy();
243 void txDmaWriteCopy();
245 void rxDmaReadDone();
246 friend class EventWrapper<NSGigE, &NSGigE::rxDmaReadDone>;
247 EventWrapper<NSGigE, &NSGigE::rxDmaReadDone> rxDmaReadEvent;
249 void rxDmaWriteDone();
250 friend class EventWrapper<NSGigE, &NSGigE::rxDmaWriteDone>;
251 EventWrapper<NSGigE, &NSGigE::rxDmaWriteDone> rxDmaWriteEvent;
253 void txDmaReadDone();
254 friend class EventWrapper<NSGigE, &NSGigE::txDmaReadDone>;
255 EventWrapper<NSGigE, &NSGigE::txDmaReadDone> txDmaReadEvent;
257 void txDmaWriteDone();
258 friend class EventWrapper<NSGigE, &NSGigE::txDmaWriteDone>;
259 EventWrapper<NSGigE, &NSGigE::txDmaWriteDone> txDmaWriteEvent;
275 typedef EventWrapper<NSGigE, &NSGigE::rxKick> RxKickEvent;
276 friend class RxKickEvent;
280 typedef EventWrapper<NSGigE, &NSGigE::txKick> TxKickEvent;
281 friend class TxKickEvent;
287 typedef EventWrapper<NSGigE, &NSGigE::transmit> TxEvent;
288 friend class TxEvent;
295 * receive address filter
298 bool rxFilter(PacketPtr packet);
299 bool acceptBroadcast;
300 bool acceptMulticast;
305 PhysicalMemory *physmem;
308 * Interrupt management
310 IntrControl *intctrl;
311 void devIntrPost(uint32_t interrupts);
312 void devIntrClear(uint32_t interrupts);
313 void devIntrChangeMask();
318 void cpuIntrPost(Tick when);
322 typedef EventWrapper<NSGigE, &NSGigE::cpuInterrupt> IntrEvent;
323 friend class IntrEvent;
324 IntrEvent *intrEvent;
327 * Hardware checksum support
329 bool udpChecksum(PacketPtr packet, bool gen);
330 bool tcpChecksum(PacketPtr packet, bool gen);
331 bool ipChecksum(PacketPtr packet, bool gen);
332 uint16_t checksumCalc(uint16_t *pseudo, uint16_t *buf, uint32_t len);
334 NSGigEInt *interface;
337 NSGigE(const std::string &name, IntrControl *i, Tick intr_delay,
338 PhysicalMemory *pmem, Tick tx_delay, Tick rx_delay,
339 MemoryController *mmu, HierParams *hier, Bus *header_bus,
340 Bus *payload_bus, Tick pio_latency, bool dma_desc_free,
341 bool dma_data_free, Tick dma_read_delay, Tick dma_write_delay,
342 Tick dma_read_factor, Tick dma_write_factor, PciConfigAll *cf,
343 PciConfigData *cd, Tsunami *t, uint32_t bus, uint32_t dev,
344 uint32_t func, bool rx_filter, const int eaddr[6]);
347 virtual void WriteConfig(int offset, int size, uint32_t data);
348 virtual void ReadConfig(int offset, int size, uint8_t *data);
350 virtual Fault read(MemReqPtr &req, uint8_t *data);
351 virtual Fault write(MemReqPtr &req, const uint8_t *data);
353 bool cpuIntrPending() const;
354 void cpuIntrAck() { cpuIntrClear(); }
356 bool recvPacket(PacketPtr packet);
359 void setInterface(NSGigEInt *i) { assert(!interface); interface = i; }
361 virtual void serialize(std::ostream &os);
362 virtual void unserialize(Checkpoint *cp, const std::string §ion);
368 Stats::Scalar<> txBytes;
369 Stats::Scalar<> rxBytes;
370 Stats::Scalar<> txPackets;
371 Stats::Scalar<> rxPackets;
372 Stats::Formula txBandwidth;
373 Stats::Formula rxBandwidth;
374 Stats::Formula txPacketRate;
375 Stats::Formula rxPacketRate;
381 Tick cacheAccess(MemReqPtr &req);
385 * Ethernet Interface for an Ethernet Device
387 class NSGigEInt : public EtherInt
393 NSGigEInt(const std::string &name, NSGigE *d)
394 : EtherInt(name), dev(d) { dev->setInterface(this); }
396 virtual bool recvPacket(PacketPtr &pkt) { return dev->recvPacket(pkt); }
397 virtual void sendDone() { dev->transferDone(); }
400 #endif // __NS_GIGE_HH__