1/* 2 * Copyright (c) 2012 ARM Limited 3 * All rights reserved. 4 * 5 * The license below extends only to copyright in the software and shall 6 * not be construed as granting a license to any other intellectual 7 * property including but not limited to intellectual property relating 8 * to a hardware implementation of the functionality of the software --- 45 unchanged lines hidden (view full) --- 54 55/** 56 * The PioPort class is a programmed i/o port that all devices that are 57 * sensitive to an address range use. The port takes all the memory 58 * access types and roles them into one read() and write() call that the device 59 * must respond to. The device must also provide getAddrRanges() function 60 * with which it returns the address ranges it is interested in. 61 */ |
62template <class Device> |
63class PioPort : public SimpleTimingPort 64{ 65 protected: 66 /** The device that this port serves. */ |
67 Device *device; |
68 |
69 Tick 70 recvAtomic(PacketPtr pkt) override 71 { 72 // Technically the packet only reaches us after the header delay, 73 // and typically we also need to deserialise any payload. 74 Tick receive_delay = pkt->headerDelay + pkt->payloadDelay; 75 pkt->headerDelay = pkt->payloadDelay = 0; |
76 |
77 const Tick delay = 78 pkt->isRead() ? device->read(pkt) : device->write(pkt); 79 assert(pkt->isResponse() || pkt->isError()); 80 return delay + receive_delay; 81 } |
82 |
83 AddrRangeList 84 getAddrRanges() const override 85 { 86 return device->getAddrRanges(); 87 } |
88 |
89 public: 90 PioPort(Device *dev) : 91 SimpleTimingPort(dev->name() + ".pio", dev), device(dev) 92 {} |
93}; 94 95/** 96 * This device is the base class which all devices senstive to an address range 97 * inherit from. There are three pure virtual functions which all devices must 98 * implement getAddrRanges(), read(), and write(). The magic do choose which 99 * mode we are in, etc is handled by the PioPort so the device doesn't have to 100 * bother. 101 */ 102class PioDevice : public ClockedObject 103{ 104 protected: 105 System *sys; 106 107 /** The pioPort that handles the requests for us and provides us requests 108 * that it sees. */ |
109 PioPort<PioDevice> pioPort; |
110 111 /** 112 * Every PIO device is obliged to provide an implementation that 113 * returns the address ranges the device responds to. 114 * 115 * @return a list of non-overlapping address ranges 116 */ 117 virtual AddrRangeList getAddrRanges() const = 0; --- 23 unchanged lines hidden (view full) --- 141 return dynamic_cast<const Params *>(_params); 142 } 143 144 void init() override; 145 146 Port &getPort(const std::string &if_name, 147 PortID idx=InvalidPortID) override; 148 |
149 friend class PioPort<PioDevice>; |
150 151}; 152 153class BasicPioDevice : public PioDevice 154{ 155 protected: 156 /** Address that the device listens to. */ 157 Addr pioAddr; --- 14 unchanged lines hidden (view full) --- 172 return dynamic_cast<const Params *>(_params); 173 } 174 175 /** 176 * Determine the address ranges that this device responds to. 177 * 178 * @return a list of non-overlapping address ranges 179 */ |
180 AddrRangeList getAddrRanges() const override; |
181}; 182 183#endif // __DEV_IO_DEVICE_HH__ |