2 * Copyright (c) 2010, 2015 ARM Limited
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.
14 * Copyright (c) 2005 The Regents of The University of Michigan
15 * All rights reserved.
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.
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.
41 #include "dev/arm/pl011.hh"
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 "mem/packet.hh"
49 #include "mem/packet_access.hh"
50 #include "params/Pl011.hh"
51 #include "sim/sim_exit.hh"
53 Pl011::Pl011(const Pl011Params
*p
)
55 intEvent([this]{ generateInterrupt(); }, name()),
56 control(0x300), fbrd(0), ibrd(0), lcrh(0), ifls(0x12),
58 endOnEOT(p
->end_on_eot
), interrupt(p
->interrupt
->get()),
59 intDelay(p
->int_delay
)
64 Pl011::read(PacketPtr pkt
)
66 assert(pkt
->getAddr() >= pioAddr
&& pkt
->getAddr() < pioAddr
+ pioSize
);
68 Addr daddr
= pkt
->getAddr() - pioAddr
;
70 DPRINTF(Uart
, " read register %#x size=%d\n", daddr
, pkt
->getSize());
72 // use a temporary data since the uart registers are read/written with
73 // different size operations
80 if (device
->dataAvailable()) {
81 data
= device
->readData();
82 // Since we don't simulate a FIFO for incoming data, we
83 // assume it's empty and clear RXINTR and RTINTR.
84 clearInterrupts(UART_RXINTR
| UART_RTINTR
);
85 if (device
->dataAvailable()) {
86 DPRINTF(Uart
, "Re-raising interrupt due to more data "
87 "after UART_DR read\n");
93 data
= 0x0; // We never have errors
97 UART_FR_CTS
| // Clear To Send
98 // Given we do not simulate a FIFO we are either empty or full.
99 (!device
->dataAvailable() ? UART_FR_RXFE
: UART_FR_RXFF
) |
100 UART_FR_TXFE
; // TX FIFO empty
103 "Reading FR register as %#x rawInt=0x%x "
104 "imsc=0x%x maskInt=0x%x\n",
105 data
, rawInt
, imsc
, maskInt());
127 DPRINTF(Uart
, "Reading Raw Int status as 0x%x\n", rawInt
);
130 DPRINTF(Uart
, "Reading Masked Int status as 0x%x\n", maskInt());
134 warn("PL011: DMA not supported\n");
135 data
= 0x0; // DMA never enabled
138 if (readId(pkt
, AMBA_ID
, pioAddr
)) {
139 // Hack for variable size accesses
140 data
= pkt
->getUintX(LittleEndianByteOrder
);
144 panic("Tried to read PL011 at offset %#x that doesn't exist\n", daddr
);
148 switch(pkt
->getSize()) {
150 pkt
->setLE
<uint8_t>(data
);
153 pkt
->setLE
<uint16_t>(data
);
156 pkt
->setLE
<uint32_t>(data
);
159 panic("Uart read size too big?\n");
164 pkt
->makeAtomicResponse();
169 Pl011::write(PacketPtr pkt
)
172 assert(pkt
->getAddr() >= pioAddr
&& pkt
->getAddr() < pioAddr
+ pioSize
);
174 Addr daddr
= pkt
->getAddr() - pioAddr
;
176 DPRINTF(Uart
, " write register %#x value %#x size=%d\n", daddr
,
177 pkt
->getLE
<uint8_t>(), pkt
->getSize());
179 // use a temporary data since the uart registers are read/written with
180 // different size operations
184 switch(pkt
->getSize()) {
186 data
= pkt
->getLE
<uint8_t>();
189 data
= pkt
->getLE
<uint16_t>();
192 data
= pkt
->getLE
<uint32_t>();
195 panic("Uart write size too big?\n");
202 if ((data
& 0xFF) == 0x04 && endOnEOT
)
203 exitSimLoop("UART received EOT", 0);
205 device
->writeData(data
& 0xFF);
206 // We're supposed to clear TXINTR when this register is
207 // written to, however. since we're also infinitely fast, we
208 // need to immediately raise it again.
209 clearInterrupts(UART_TXINTR
);
210 raiseInterrupts(UART_TXINTR
);
212 case UART_ECR
: // clears errors, ignore
230 DPRINTF(Uart
, "Setting interrupt mask 0x%x\n", data
);
231 setInterruptMask(data
);
235 DPRINTF(Uart
, "Clearing interrupts 0x%x\n", data
);
236 clearInterrupts(data
);
237 if (device
->dataAvailable()) {
238 DPRINTF(Uart
, "Re-raising interrupt due to more data after "
244 // DMA is not supported, so panic if anyome tries to enable it.
245 // Bits 0, 1, 2 enables DMA on RX, TX, ERR respectively, others res0.
247 panic("Tried to enable DMA on PL011\n");
249 warn("PL011: DMA not supported\n");
252 panic("Tried to write PL011 at offset %#x that doesn't exist\n", daddr
);
255 pkt
->makeAtomicResponse();
260 Pl011::dataAvailable()
262 /*@todo ignore the fifo, just say we have data now
263 * We might want to fix this, or we might not care */
264 DPRINTF(Uart
, "Data available, scheduling interrupt\n");
265 raiseInterrupts(UART_RXINTR
| UART_RTINTR
);
269 Pl011::generateInterrupt()
271 DPRINTF(Uart
, "Generate Interrupt: imsc=0x%x rawInt=0x%x maskInt=0x%x\n",
272 imsc
, rawInt
, maskInt());
276 DPRINTF(Uart
, " -- Generated\n");
281 Pl011::setInterrupts(uint16_t ints
, uint16_t mask
)
283 const bool old_ints(!!maskInt());
288 if (!old_ints
&& maskInt()) {
289 if (!intEvent
.scheduled())
290 schedule(intEvent
, curTick() + intDelay
);
291 } else if (old_ints
&& !maskInt()) {
299 Pl011::serialize(CheckpointOut
&cp
) const
301 DPRINTF(Checkpoint
, "Serializing Arm PL011\n");
302 SERIALIZE_SCALAR(control
);
303 SERIALIZE_SCALAR(fbrd
);
304 SERIALIZE_SCALAR(ibrd
);
305 SERIALIZE_SCALAR(lcrh
);
306 SERIALIZE_SCALAR(ifls
);
308 // Preserve backwards compatibility by giving these silly names.
309 paramOut(cp
, "imsc_serial", imsc
);
310 paramOut(cp
, "rawInt_serial", rawInt
);
314 Pl011::unserialize(CheckpointIn
&cp
)
316 DPRINTF(Checkpoint
, "Unserializing Arm PL011\n");
318 UNSERIALIZE_SCALAR(control
);
319 UNSERIALIZE_SCALAR(fbrd
);
320 UNSERIALIZE_SCALAR(ibrd
);
321 UNSERIALIZE_SCALAR(lcrh
);
322 UNSERIALIZE_SCALAR(ifls
);
324 // Preserve backwards compatibility by giving these silly names.
325 paramIn(cp
, "imsc_serial", imsc
);
326 paramIn(cp
, "rawInt_serial", rawInt
);
330 Pl011Params::create()
332 return new Pl011(this);