io_device.hh (13892:0182a0601f66) io_device.hh (14218:c83b2bdfc7ee)
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 */
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>
62class PioPort : public SimpleTimingPort
63{
64 protected:
65 /** The device that this port serves. */
63class PioPort : public SimpleTimingPort
64{
65 protected:
66 /** The device that this port serves. */
66 PioDevice *device;
67 Device *device;
67
68
68 virtual Tick recvAtomic(PacketPtr pkt);
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;
69
76
70 virtual AddrRangeList getAddrRanges() const;
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 }
71
82
72 public:
83 AddrRangeList
84 getAddrRanges() const override
85 {
86 return device->getAddrRanges();
87 }
73
88
74 PioPort(PioDevice *dev);
89 public:
90 PioPort(Device *dev) :
91 SimpleTimingPort(dev->name() + ".pio", dev), device(dev)
92 {}
75};
76
77/**
78 * This device is the base class which all devices senstive to an address range
79 * inherit from. There are three pure virtual functions which all devices must
80 * implement getAddrRanges(), read(), and write(). The magic do choose which
81 * mode we are in, etc is handled by the PioPort so the device doesn't have to
82 * bother.
83 */
84class PioDevice : public ClockedObject
85{
86 protected:
87 System *sys;
88
89 /** The pioPort that handles the requests for us and provides us requests
90 * that it sees. */
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. */
91 PioPort pioPort;
109 PioPort<PioDevice> pioPort;
92
93 /**
94 * Every PIO device is obliged to provide an implementation that
95 * returns the address ranges the device responds to.
96 *
97 * @return a list of non-overlapping address ranges
98 */
99 virtual AddrRangeList getAddrRanges() const = 0;

--- 23 unchanged lines hidden (view full) ---

123 return dynamic_cast<const Params *>(_params);
124 }
125
126 void init() override;
127
128 Port &getPort(const std::string &if_name,
129 PortID idx=InvalidPortID) override;
130
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
131 friend class PioPort;
149 friend class PioPort<PioDevice>;
132
133};
134
135class BasicPioDevice : public PioDevice
136{
137 protected:
138 /** Address that the device listens to. */
139 Addr pioAddr;

--- 14 unchanged lines hidden (view full) ---

154 return dynamic_cast<const Params *>(_params);
155 }
156
157 /**
158 * Determine the address ranges that this device responds to.
159 *
160 * @return a list of non-overlapping address ranges
161 */
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 */
162 virtual AddrRangeList getAddrRanges() const;
163
180 AddrRangeList getAddrRanges() const override;
164};
165
166#endif // __DEV_IO_DEVICE_HH__
181};
182
183#endif // __DEV_IO_DEVICE_HH__