pl011.cc (9525:0587c8983d47) pl011.cc (9806:3f262c18ad5d)
1/*
2 * Copyright (c) 2010 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
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
13 *
14 * Copyright (c) 2005 The Regents of The University of Michigan
15 * All rights reserved.
16 *
17 * Redistribution and use in source and binary forms, with or without
18 * modification, are permitted provided that the following conditions are
19 * met: redistributions of source code must retain the above copyright
20 * notice, this list of conditions and the following disclaimer;
21 * redistributions in binary form must reproduce the above copyright
22 * notice, this list of conditions and the following disclaimer in the
23 * documentation and/or other materials provided with the distribution;
24 * neither the name of the copyright holders nor the names of its
25 * contributors may be used to endorse or promote products derived from
26 * this software without specific prior written permission.
27 *
28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 *
40 * Authors: Ali Saidi
41 */
42
43#include "base/trace.hh"
44#include "debug/Checkpoint.hh"
45#include "debug/Uart.hh"
46#include "dev/arm/amba_device.hh"
47#include "dev/arm/base_gic.hh"
48#include "dev/arm/pl011.hh"
49#include "dev/terminal.hh"
50#include "mem/packet.hh"
51#include "mem/packet_access.hh"
52#include "sim/sim_exit.hh"
53
54Pl011::Pl011(const Params *p)
55 : Uart(p), control(0x300), fbrd(0), ibrd(0), lcrh(0), ifls(0x12), imsc(0),
56 rawInt(0), maskInt(0), intNum(p->int_num), gic(p->gic),
57 endOnEOT(p->end_on_eot), intDelay(p->int_delay), intEvent(this)
58{
59 pioSize = 0xfff;
60}
61
62Tick
63Pl011::read(PacketPtr pkt)
64{
65 assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize);
66
67 Addr daddr = pkt->getAddr() - pioAddr;
68 pkt->allocate();
69
70 DPRINTF(Uart, " read register %#x size=%d\n", daddr, pkt->getSize());
71
72 // use a temporary data since the uart registers are read/written with
73 // different size operations
74 //
75 uint32_t data = 0;
76
77 switch(daddr) {
78 case UART_DR:
79 data = 0;
80 if (term->dataAvailable())
81 data = term->in();
82 break;
83 case UART_FR:
84 // For now we're infintely fast, so TX is never full, always empty,
85 // always clear to send
86 data = UART_FR_TXFE | UART_FR_CTS;
87 if (!term->dataAvailable())
88 data |= UART_FR_RXFE;
89 DPRINTF(Uart, "Reading FR register as %#x rawInt=0x%x imsc=0x%x maskInt=0x%x\n",
90 data, rawInt, imsc, maskInt);
91 break;
92 case UART_CR:
93 data = control;
94 break;
95 case UART_IBRD:
96 data = ibrd;
97 break;
98 case UART_FBRD:
99 data = fbrd;
100 break;
101 case UART_LCRH:
102 data = lcrh;
103 break;
104 case UART_IFLS:
105 data = ifls;
106 break;
107 case UART_IMSC:
108 data = imsc;
109 break;
110 case UART_RIS:
111 data = rawInt;
112 DPRINTF(Uart, "Reading Raw Int status as 0x%x\n", rawInt);
113 break;
114 case UART_MIS:
115 DPRINTF(Uart, "Reading Masked Int status as 0x%x\n", rawInt);
116 data = maskInt;
117 break;
118 default:
1/*
2 * Copyright (c) 2010 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
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
13 *
14 * Copyright (c) 2005 The Regents of The University of Michigan
15 * All rights reserved.
16 *
17 * Redistribution and use in source and binary forms, with or without
18 * modification, are permitted provided that the following conditions are
19 * met: redistributions of source code must retain the above copyright
20 * notice, this list of conditions and the following disclaimer;
21 * redistributions in binary form must reproduce the above copyright
22 * notice, this list of conditions and the following disclaimer in the
23 * documentation and/or other materials provided with the distribution;
24 * neither the name of the copyright holders nor the names of its
25 * contributors may be used to endorse or promote products derived from
26 * this software without specific prior written permission.
27 *
28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 *
40 * Authors: Ali Saidi
41 */
42
43#include "base/trace.hh"
44#include "debug/Checkpoint.hh"
45#include "debug/Uart.hh"
46#include "dev/arm/amba_device.hh"
47#include "dev/arm/base_gic.hh"
48#include "dev/arm/pl011.hh"
49#include "dev/terminal.hh"
50#include "mem/packet.hh"
51#include "mem/packet_access.hh"
52#include "sim/sim_exit.hh"
53
54Pl011::Pl011(const Params *p)
55 : Uart(p), control(0x300), fbrd(0), ibrd(0), lcrh(0), ifls(0x12), imsc(0),
56 rawInt(0), maskInt(0), intNum(p->int_num), gic(p->gic),
57 endOnEOT(p->end_on_eot), intDelay(p->int_delay), intEvent(this)
58{
59 pioSize = 0xfff;
60}
61
62Tick
63Pl011::read(PacketPtr pkt)
64{
65 assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize);
66
67 Addr daddr = pkt->getAddr() - pioAddr;
68 pkt->allocate();
69
70 DPRINTF(Uart, " read register %#x size=%d\n", daddr, pkt->getSize());
71
72 // use a temporary data since the uart registers are read/written with
73 // different size operations
74 //
75 uint32_t data = 0;
76
77 switch(daddr) {
78 case UART_DR:
79 data = 0;
80 if (term->dataAvailable())
81 data = term->in();
82 break;
83 case UART_FR:
84 // For now we're infintely fast, so TX is never full, always empty,
85 // always clear to send
86 data = UART_FR_TXFE | UART_FR_CTS;
87 if (!term->dataAvailable())
88 data |= UART_FR_RXFE;
89 DPRINTF(Uart, "Reading FR register as %#x rawInt=0x%x imsc=0x%x maskInt=0x%x\n",
90 data, rawInt, imsc, maskInt);
91 break;
92 case UART_CR:
93 data = control;
94 break;
95 case UART_IBRD:
96 data = ibrd;
97 break;
98 case UART_FBRD:
99 data = fbrd;
100 break;
101 case UART_LCRH:
102 data = lcrh;
103 break;
104 case UART_IFLS:
105 data = ifls;
106 break;
107 case UART_IMSC:
108 data = imsc;
109 break;
110 case UART_RIS:
111 data = rawInt;
112 DPRINTF(Uart, "Reading Raw Int status as 0x%x\n", rawInt);
113 break;
114 case UART_MIS:
115 DPRINTF(Uart, "Reading Masked Int status as 0x%x\n", rawInt);
116 data = maskInt;
117 break;
118 default:
119 if (AmbaDev::readId(pkt, AMBA_ID, pioAddr)) {
119 if (readId(pkt, AMBA_ID, pioAddr)) {
120 // Hack for variable size accesses
121 data = pkt->get<uint32_t>();
122 break;
123 }
124
125 panic("Tried to read PL011 at offset %#x that doesn't exist\n", daddr);
126 break;
127 }
128
129 switch(pkt->getSize()) {
130 case 1:
131 pkt->set<uint8_t>(data);
132 break;
133 case 2:
134 pkt->set<uint16_t>(data);
135 break;
136 case 4:
137 pkt->set<uint32_t>(data);
138 break;
139 default:
140 panic("Uart read size too big?\n");
141 break;
142 }
143
144
145 pkt->makeAtomicResponse();
146 return pioDelay;
147}
148
149Tick
150Pl011::write(PacketPtr pkt)
151{
152
153 assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize);
154
155 Addr daddr = pkt->getAddr() - pioAddr;
156
157 DPRINTF(Uart, " write register %#x value %#x size=%d\n", daddr,
158 pkt->get<uint8_t>(), pkt->getSize());
159
160 // use a temporary data since the uart registers are read/written with
161 // different size operations
162 //
163 uint32_t data = 0;
164
165 switch(pkt->getSize()) {
166 case 1:
167 data = pkt->get<uint8_t>();
168 break;
169 case 2:
170 data = pkt->get<uint16_t>();
171 break;
172 case 4:
173 data = pkt->get<uint32_t>();
174 break;
175 default:
176 panic("Uart write size too big?\n");
177 break;
178 }
179
180
181 switch (daddr) {
182 case UART_DR:
183 if ((data & 0xFF) == 0x04 && endOnEOT)
184 exitSimLoop("UART received EOT", 0);
185
186 term->out(data & 0xFF);
187
188 //raw interrupt is set regardless of imsc.txim
189 rawInt.txim = 1;
190 if (imsc.txim) {
191 DPRINTF(Uart, "TX int enabled, scheduling interruptt\n");
192 if (!intEvent.scheduled())
193 schedule(intEvent, curTick() + intDelay);
194 }
195
196 break;
197 case UART_CR:
198 control = data;
199 break;
200 case UART_IBRD:
201 ibrd = data;
202 break;
203 case UART_FBRD:
204 fbrd = data;
205 break;
206 case UART_LCRH:
207 lcrh = data;
208 break;
209 case UART_IFLS:
210 ifls = data;
211 break;
212 case UART_IMSC:
213 imsc = data;
214
215 if (imsc.rimim || imsc.ctsmim || imsc.dcdmim || imsc.dsrmim
216 || imsc.feim || imsc.peim || imsc.beim || imsc.oeim || imsc.rsvd)
217 panic("Unknown interrupt enabled\n");
218
219 if (imsc.txim) {
220 DPRINTF(Uart, "Writing to IMSC: TX int enabled, scheduling interruptt\n");
221 rawInt.txim = 1;
222 if (!intEvent.scheduled())
223 schedule(intEvent, curTick() + intDelay);
224 }
225
226 break;
227
228 case UART_ICR:
229 DPRINTF(Uart, "Clearing interrupts 0x%x\n", data);
230 rawInt = rawInt & ~data;
231 maskInt = rawInt & imsc;
232
233 DPRINTF(Uart, " -- Masked interrupts 0x%x\n", maskInt);
234
235 if (!maskInt)
236 gic->clearInt(intNum);
237
238 break;
239 default:
240 panic("Tried to write PL011 at offset %#x that doesn't exist\n", daddr);
241 break;
242 }
243 pkt->makeAtomicResponse();
244 return pioDelay;
245}
246
247void
248Pl011::dataAvailable()
249{
250 /*@todo ignore the fifo, just say we have data now
251 * We might want to fix this, or we might not care */
252 rawInt.rxim = 1;
253 rawInt.rtim = 1;
254
255 DPRINTF(Uart, "Data available, scheduling interrupt\n");
256
257 if (!intEvent.scheduled())
258 schedule(intEvent, curTick() + intDelay);
259}
260
261void
262Pl011::generateInterrupt()
263{
264 DPRINTF(Uart, "Generate Interrupt: imsc=0x%x rawInt=0x%x maskInt=0x%x\n",
265 imsc, rawInt, maskInt);
266 maskInt = imsc & rawInt;
267
268 if (maskInt.rxim || maskInt.rtim || maskInt.txim) {
269 gic->sendInt(intNum);
270 DPRINTF(Uart, " -- Generated\n");
271 }
272
273}
274
275
276
277void
278Pl011::serialize(std::ostream &os)
279{
280 DPRINTF(Checkpoint, "Serializing Arm PL011\n");
281 SERIALIZE_SCALAR(control);
282 SERIALIZE_SCALAR(fbrd);
283 SERIALIZE_SCALAR(ibrd);
284 SERIALIZE_SCALAR(lcrh);
285 SERIALIZE_SCALAR(ifls);
286
287 uint16_t imsc_serial = imsc;
288 SERIALIZE_SCALAR(imsc_serial);
289
290 uint16_t rawInt_serial = rawInt;
291 SERIALIZE_SCALAR(rawInt_serial);
292
293 uint16_t maskInt_serial = maskInt;
294 SERIALIZE_SCALAR(maskInt_serial);
295
296 SERIALIZE_SCALAR(endOnEOT);
297 SERIALIZE_SCALAR(intDelay);
298}
299
300void
301Pl011::unserialize(Checkpoint *cp, const std::string &section)
302{
303 DPRINTF(Checkpoint, "Unserializing Arm PL011\n");
304
305 UNSERIALIZE_SCALAR(control);
306 UNSERIALIZE_SCALAR(fbrd);
307 UNSERIALIZE_SCALAR(ibrd);
308 UNSERIALIZE_SCALAR(lcrh);
309 UNSERIALIZE_SCALAR(ifls);
310
311 uint16_t imsc_serial;
312 UNSERIALIZE_SCALAR(imsc_serial);
313 imsc = imsc_serial;
314
315 uint16_t rawInt_serial;
316 UNSERIALIZE_SCALAR(rawInt_serial);
317 rawInt = rawInt_serial;
318
319 uint16_t maskInt_serial;
320 UNSERIALIZE_SCALAR(maskInt_serial);
321 maskInt = maskInt_serial;
322
323 UNSERIALIZE_SCALAR(endOnEOT);
324 UNSERIALIZE_SCALAR(intDelay);
325}
326
327Pl011 *
328Pl011Params::create()
329{
330 return new Pl011(this);
331}
120 // Hack for variable size accesses
121 data = pkt->get<uint32_t>();
122 break;
123 }
124
125 panic("Tried to read PL011 at offset %#x that doesn't exist\n", daddr);
126 break;
127 }
128
129 switch(pkt->getSize()) {
130 case 1:
131 pkt->set<uint8_t>(data);
132 break;
133 case 2:
134 pkt->set<uint16_t>(data);
135 break;
136 case 4:
137 pkt->set<uint32_t>(data);
138 break;
139 default:
140 panic("Uart read size too big?\n");
141 break;
142 }
143
144
145 pkt->makeAtomicResponse();
146 return pioDelay;
147}
148
149Tick
150Pl011::write(PacketPtr pkt)
151{
152
153 assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize);
154
155 Addr daddr = pkt->getAddr() - pioAddr;
156
157 DPRINTF(Uart, " write register %#x value %#x size=%d\n", daddr,
158 pkt->get<uint8_t>(), pkt->getSize());
159
160 // use a temporary data since the uart registers are read/written with
161 // different size operations
162 //
163 uint32_t data = 0;
164
165 switch(pkt->getSize()) {
166 case 1:
167 data = pkt->get<uint8_t>();
168 break;
169 case 2:
170 data = pkt->get<uint16_t>();
171 break;
172 case 4:
173 data = pkt->get<uint32_t>();
174 break;
175 default:
176 panic("Uart write size too big?\n");
177 break;
178 }
179
180
181 switch (daddr) {
182 case UART_DR:
183 if ((data & 0xFF) == 0x04 && endOnEOT)
184 exitSimLoop("UART received EOT", 0);
185
186 term->out(data & 0xFF);
187
188 //raw interrupt is set regardless of imsc.txim
189 rawInt.txim = 1;
190 if (imsc.txim) {
191 DPRINTF(Uart, "TX int enabled, scheduling interruptt\n");
192 if (!intEvent.scheduled())
193 schedule(intEvent, curTick() + intDelay);
194 }
195
196 break;
197 case UART_CR:
198 control = data;
199 break;
200 case UART_IBRD:
201 ibrd = data;
202 break;
203 case UART_FBRD:
204 fbrd = data;
205 break;
206 case UART_LCRH:
207 lcrh = data;
208 break;
209 case UART_IFLS:
210 ifls = data;
211 break;
212 case UART_IMSC:
213 imsc = data;
214
215 if (imsc.rimim || imsc.ctsmim || imsc.dcdmim || imsc.dsrmim
216 || imsc.feim || imsc.peim || imsc.beim || imsc.oeim || imsc.rsvd)
217 panic("Unknown interrupt enabled\n");
218
219 if (imsc.txim) {
220 DPRINTF(Uart, "Writing to IMSC: TX int enabled, scheduling interruptt\n");
221 rawInt.txim = 1;
222 if (!intEvent.scheduled())
223 schedule(intEvent, curTick() + intDelay);
224 }
225
226 break;
227
228 case UART_ICR:
229 DPRINTF(Uart, "Clearing interrupts 0x%x\n", data);
230 rawInt = rawInt & ~data;
231 maskInt = rawInt & imsc;
232
233 DPRINTF(Uart, " -- Masked interrupts 0x%x\n", maskInt);
234
235 if (!maskInt)
236 gic->clearInt(intNum);
237
238 break;
239 default:
240 panic("Tried to write PL011 at offset %#x that doesn't exist\n", daddr);
241 break;
242 }
243 pkt->makeAtomicResponse();
244 return pioDelay;
245}
246
247void
248Pl011::dataAvailable()
249{
250 /*@todo ignore the fifo, just say we have data now
251 * We might want to fix this, or we might not care */
252 rawInt.rxim = 1;
253 rawInt.rtim = 1;
254
255 DPRINTF(Uart, "Data available, scheduling interrupt\n");
256
257 if (!intEvent.scheduled())
258 schedule(intEvent, curTick() + intDelay);
259}
260
261void
262Pl011::generateInterrupt()
263{
264 DPRINTF(Uart, "Generate Interrupt: imsc=0x%x rawInt=0x%x maskInt=0x%x\n",
265 imsc, rawInt, maskInt);
266 maskInt = imsc & rawInt;
267
268 if (maskInt.rxim || maskInt.rtim || maskInt.txim) {
269 gic->sendInt(intNum);
270 DPRINTF(Uart, " -- Generated\n");
271 }
272
273}
274
275
276
277void
278Pl011::serialize(std::ostream &os)
279{
280 DPRINTF(Checkpoint, "Serializing Arm PL011\n");
281 SERIALIZE_SCALAR(control);
282 SERIALIZE_SCALAR(fbrd);
283 SERIALIZE_SCALAR(ibrd);
284 SERIALIZE_SCALAR(lcrh);
285 SERIALIZE_SCALAR(ifls);
286
287 uint16_t imsc_serial = imsc;
288 SERIALIZE_SCALAR(imsc_serial);
289
290 uint16_t rawInt_serial = rawInt;
291 SERIALIZE_SCALAR(rawInt_serial);
292
293 uint16_t maskInt_serial = maskInt;
294 SERIALIZE_SCALAR(maskInt_serial);
295
296 SERIALIZE_SCALAR(endOnEOT);
297 SERIALIZE_SCALAR(intDelay);
298}
299
300void
301Pl011::unserialize(Checkpoint *cp, const std::string &section)
302{
303 DPRINTF(Checkpoint, "Unserializing Arm PL011\n");
304
305 UNSERIALIZE_SCALAR(control);
306 UNSERIALIZE_SCALAR(fbrd);
307 UNSERIALIZE_SCALAR(ibrd);
308 UNSERIALIZE_SCALAR(lcrh);
309 UNSERIALIZE_SCALAR(ifls);
310
311 uint16_t imsc_serial;
312 UNSERIALIZE_SCALAR(imsc_serial);
313 imsc = imsc_serial;
314
315 uint16_t rawInt_serial;
316 UNSERIALIZE_SCALAR(rawInt_serial);
317 rawInt = rawInt_serial;
318
319 uint16_t maskInt_serial;
320 UNSERIALIZE_SCALAR(maskInt_serial);
321 maskInt = maskInt_serial;
322
323 UNSERIALIZE_SCALAR(endOnEOT);
324 UNSERIALIZE_SCALAR(intDelay);
325}
326
327Pl011 *
328Pl011Params::create()
329{
330 return new Pl011(this);
331}