pl011.cc revision 12237
17584SAli.Saidi@arm.com/* 210718SAndreas.Sandberg@ARM.com * Copyright (c) 2010, 2015 ARM Limited 37584SAli.Saidi@arm.com * All rights reserved 47584SAli.Saidi@arm.com * 57584SAli.Saidi@arm.com * The license below extends only to copyright in the software and shall 67584SAli.Saidi@arm.com * not be construed as granting a license to any other intellectual 77584SAli.Saidi@arm.com * property including but not limited to intellectual property relating 87584SAli.Saidi@arm.com * to a hardware implementation of the functionality of the software 97584SAli.Saidi@arm.com * licensed hereunder. You may use the software subject to the license 107584SAli.Saidi@arm.com * terms below provided that you ensure that this notice is replicated 117584SAli.Saidi@arm.com * unmodified and in its entirety in all distributions of the software, 127584SAli.Saidi@arm.com * modified or unmodified, in source code or in binary form. 137584SAli.Saidi@arm.com * 147584SAli.Saidi@arm.com * Copyright (c) 2005 The Regents of The University of Michigan 157584SAli.Saidi@arm.com * All rights reserved. 167584SAli.Saidi@arm.com * 177584SAli.Saidi@arm.com * Redistribution and use in source and binary forms, with or without 187584SAli.Saidi@arm.com * modification, are permitted provided that the following conditions are 197584SAli.Saidi@arm.com * met: redistributions of source code must retain the above copyright 207584SAli.Saidi@arm.com * notice, this list of conditions and the following disclaimer; 217584SAli.Saidi@arm.com * redistributions in binary form must reproduce the above copyright 227584SAli.Saidi@arm.com * notice, this list of conditions and the following disclaimer in the 237584SAli.Saidi@arm.com * documentation and/or other materials provided with the distribution; 247584SAli.Saidi@arm.com * neither the name of the copyright holders nor the names of its 257584SAli.Saidi@arm.com * contributors may be used to endorse or promote products derived from 267584SAli.Saidi@arm.com * this software without specific prior written permission. 277584SAli.Saidi@arm.com * 287584SAli.Saidi@arm.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 297584SAli.Saidi@arm.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 307584SAli.Saidi@arm.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 317584SAli.Saidi@arm.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 327584SAli.Saidi@arm.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 337584SAli.Saidi@arm.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 347584SAli.Saidi@arm.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 357584SAli.Saidi@arm.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 367584SAli.Saidi@arm.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 377584SAli.Saidi@arm.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 387584SAli.Saidi@arm.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 397584SAli.Saidi@arm.com * 407584SAli.Saidi@arm.com * Authors: Ali Saidi 4110718SAndreas.Sandberg@ARM.com * Andreas Sandberg 427584SAli.Saidi@arm.com */ 437584SAli.Saidi@arm.com 4410718SAndreas.Sandberg@ARM.com#include "dev/arm/pl011.hh" 4510718SAndreas.Sandberg@ARM.com 467584SAli.Saidi@arm.com#include "base/trace.hh" 478245Snate@binkert.org#include "debug/Checkpoint.hh" 488245Snate@binkert.org#include "debug/Uart.hh" 497587SAli.Saidi@arm.com#include "dev/arm/amba_device.hh" 509525SAndreas.Sandberg@ARM.com#include "dev/arm/base_gic.hh" 517584SAli.Saidi@arm.com#include "mem/packet.hh" 527584SAli.Saidi@arm.com#include "mem/packet_access.hh" 5311793Sbrandon.potter@amd.com#include "params/Pl011.hh" 547584SAli.Saidi@arm.com#include "sim/sim_exit.hh" 557584SAli.Saidi@arm.com 5610718SAndreas.Sandberg@ARM.comPl011::Pl011(const Pl011Params *p) 5710718SAndreas.Sandberg@ARM.com : Uart(p, 0xfff), 5812086Sspwilson2@wisc.edu intEvent([this]{ generateInterrupt(); }, name()), 5910718SAndreas.Sandberg@ARM.com control(0x300), fbrd(0), ibrd(0), lcrh(0), ifls(0x12), 6010718SAndreas.Sandberg@ARM.com imsc(0), rawInt(0), 6110718SAndreas.Sandberg@ARM.com gic(p->gic), endOnEOT(p->end_on_eot), intNum(p->int_num), 6210718SAndreas.Sandberg@ARM.com intDelay(p->int_delay) 637584SAli.Saidi@arm.com{ 647584SAli.Saidi@arm.com} 657584SAli.Saidi@arm.com 667584SAli.Saidi@arm.comTick 677584SAli.Saidi@arm.comPl011::read(PacketPtr pkt) 687584SAli.Saidi@arm.com{ 697584SAli.Saidi@arm.com assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize); 707584SAli.Saidi@arm.com 717584SAli.Saidi@arm.com Addr daddr = pkt->getAddr() - pioAddr; 727584SAli.Saidi@arm.com 737584SAli.Saidi@arm.com DPRINTF(Uart, " read register %#x size=%d\n", daddr, pkt->getSize()); 747584SAli.Saidi@arm.com 757584SAli.Saidi@arm.com // use a temporary data since the uart registers are read/written with 767584SAli.Saidi@arm.com // different size operations 777584SAli.Saidi@arm.com // 787584SAli.Saidi@arm.com uint32_t data = 0; 797584SAli.Saidi@arm.com 807584SAli.Saidi@arm.com switch(daddr) { 817584SAli.Saidi@arm.com case UART_DR: 827584SAli.Saidi@arm.com data = 0; 8312237Sandreas.sandberg@arm.com if (device->dataAvailable()) { 8412237Sandreas.sandberg@arm.com data = device->readData(); 8510718SAndreas.Sandberg@ARM.com // Since we don't simulate a FIFO for incoming data, we 8610718SAndreas.Sandberg@ARM.com // assume it's empty and clear RXINTR and RTINTR. 8710718SAndreas.Sandberg@ARM.com clearInterrupts(UART_RXINTR | UART_RTINTR); 8812237Sandreas.sandberg@arm.com if (device->dataAvailable()) { 8911685Sbaz21@cam.ac.uk DPRINTF(Uart, "Re-raising interrupt due to more data " 9011685Sbaz21@cam.ac.uk "after UART_DR read\n"); 9111685Sbaz21@cam.ac.uk dataAvailable(); 9211685Sbaz21@cam.ac.uk } 9310718SAndreas.Sandberg@ARM.com } 947584SAli.Saidi@arm.com break; 957584SAli.Saidi@arm.com case UART_FR: 9610718SAndreas.Sandberg@ARM.com data = 9710718SAndreas.Sandberg@ARM.com UART_FR_CTS | // Clear To Send 9811480Sbaz21@cam.ac.uk // Given we do not simulate a FIFO we are either empty or full. 9912237Sandreas.sandberg@arm.com (!device->dataAvailable() ? UART_FR_RXFE : UART_FR_RXFF) | 10010718SAndreas.Sandberg@ARM.com UART_FR_TXFE; // TX FIFO empty 10110718SAndreas.Sandberg@ARM.com 10210718SAndreas.Sandberg@ARM.com DPRINTF(Uart, 10310718SAndreas.Sandberg@ARM.com "Reading FR register as %#x rawInt=0x%x " 10410718SAndreas.Sandberg@ARM.com "imsc=0x%x maskInt=0x%x\n", 10510718SAndreas.Sandberg@ARM.com data, rawInt, imsc, maskInt()); 1067584SAli.Saidi@arm.com break; 1077584SAli.Saidi@arm.com case UART_CR: 1087584SAli.Saidi@arm.com data = control; 1097584SAli.Saidi@arm.com break; 1107584SAli.Saidi@arm.com case UART_IBRD: 1117584SAli.Saidi@arm.com data = ibrd; 1127584SAli.Saidi@arm.com break; 1137584SAli.Saidi@arm.com case UART_FBRD: 1147584SAli.Saidi@arm.com data = fbrd; 1157584SAli.Saidi@arm.com break; 1167584SAli.Saidi@arm.com case UART_LCRH: 1177584SAli.Saidi@arm.com data = lcrh; 1187584SAli.Saidi@arm.com break; 1197584SAli.Saidi@arm.com case UART_IFLS: 1207584SAli.Saidi@arm.com data = ifls; 1217584SAli.Saidi@arm.com break; 1227584SAli.Saidi@arm.com case UART_IMSC: 1237584SAli.Saidi@arm.com data = imsc; 1247584SAli.Saidi@arm.com break; 1257584SAli.Saidi@arm.com case UART_RIS: 1267584SAli.Saidi@arm.com data = rawInt; 1277584SAli.Saidi@arm.com DPRINTF(Uart, "Reading Raw Int status as 0x%x\n", rawInt); 1287584SAli.Saidi@arm.com break; 1297584SAli.Saidi@arm.com case UART_MIS: 13010718SAndreas.Sandberg@ARM.com DPRINTF(Uart, "Reading Masked Int status as 0x%x\n", maskInt()); 13110718SAndreas.Sandberg@ARM.com data = maskInt(); 1327584SAli.Saidi@arm.com break; 1337584SAli.Saidi@arm.com default: 1349806Sstever@gmail.com if (readId(pkt, AMBA_ID, pioAddr)) { 1357587SAli.Saidi@arm.com // Hack for variable size accesses 1367587SAli.Saidi@arm.com data = pkt->get<uint32_t>(); 1377584SAli.Saidi@arm.com break; 1387584SAli.Saidi@arm.com } 1397587SAli.Saidi@arm.com 1407584SAli.Saidi@arm.com panic("Tried to read PL011 at offset %#x that doesn't exist\n", daddr); 1417584SAli.Saidi@arm.com break; 1427584SAli.Saidi@arm.com } 1437584SAli.Saidi@arm.com 1447584SAli.Saidi@arm.com switch(pkt->getSize()) { 1457584SAli.Saidi@arm.com case 1: 1467584SAli.Saidi@arm.com pkt->set<uint8_t>(data); 1477584SAli.Saidi@arm.com break; 1487584SAli.Saidi@arm.com case 2: 1497584SAli.Saidi@arm.com pkt->set<uint16_t>(data); 1507584SAli.Saidi@arm.com break; 1517584SAli.Saidi@arm.com case 4: 1527584SAli.Saidi@arm.com pkt->set<uint32_t>(data); 1537584SAli.Saidi@arm.com break; 1547584SAli.Saidi@arm.com default: 1557584SAli.Saidi@arm.com panic("Uart read size too big?\n"); 1567584SAli.Saidi@arm.com break; 1577584SAli.Saidi@arm.com } 1587584SAli.Saidi@arm.com 1597584SAli.Saidi@arm.com 1607584SAli.Saidi@arm.com pkt->makeAtomicResponse(); 1617584SAli.Saidi@arm.com return pioDelay; 1627584SAli.Saidi@arm.com} 1637584SAli.Saidi@arm.com 1647584SAli.Saidi@arm.comTick 1657584SAli.Saidi@arm.comPl011::write(PacketPtr pkt) 1667584SAli.Saidi@arm.com{ 1677584SAli.Saidi@arm.com 1687584SAli.Saidi@arm.com assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize); 1697584SAli.Saidi@arm.com 1707584SAli.Saidi@arm.com Addr daddr = pkt->getAddr() - pioAddr; 1717584SAli.Saidi@arm.com 1727584SAli.Saidi@arm.com DPRINTF(Uart, " write register %#x value %#x size=%d\n", daddr, 1737584SAli.Saidi@arm.com pkt->get<uint8_t>(), pkt->getSize()); 1747584SAli.Saidi@arm.com 1757584SAli.Saidi@arm.com // use a temporary data since the uart registers are read/written with 1767584SAli.Saidi@arm.com // different size operations 1777584SAli.Saidi@arm.com // 1787584SAli.Saidi@arm.com uint32_t data = 0; 1797584SAli.Saidi@arm.com 1807584SAli.Saidi@arm.com switch(pkt->getSize()) { 1817584SAli.Saidi@arm.com case 1: 1827584SAli.Saidi@arm.com data = pkt->get<uint8_t>(); 1837584SAli.Saidi@arm.com break; 1847584SAli.Saidi@arm.com case 2: 1857584SAli.Saidi@arm.com data = pkt->get<uint16_t>(); 1867584SAli.Saidi@arm.com break; 1877584SAli.Saidi@arm.com case 4: 1887584SAli.Saidi@arm.com data = pkt->get<uint32_t>(); 1897584SAli.Saidi@arm.com break; 1907584SAli.Saidi@arm.com default: 1917584SAli.Saidi@arm.com panic("Uart write size too big?\n"); 1927584SAli.Saidi@arm.com break; 1937584SAli.Saidi@arm.com } 1947584SAli.Saidi@arm.com 1957584SAli.Saidi@arm.com 1967584SAli.Saidi@arm.com switch (daddr) { 1977584SAli.Saidi@arm.com case UART_DR: 1987584SAli.Saidi@arm.com if ((data & 0xFF) == 0x04 && endOnEOT) 1997584SAli.Saidi@arm.com exitSimLoop("UART received EOT", 0); 2007584SAli.Saidi@arm.com 20112237Sandreas.sandberg@arm.com device->writeData(data & 0xFF); 20210718SAndreas.Sandberg@ARM.com // We're supposed to clear TXINTR when this register is 20310718SAndreas.Sandberg@ARM.com // written to, however. since we're also infinitely fast, we 20410718SAndreas.Sandberg@ARM.com // need to immediately raise it again. 20510718SAndreas.Sandberg@ARM.com clearInterrupts(UART_TXINTR); 20610718SAndreas.Sandberg@ARM.com raiseInterrupts(UART_TXINTR); 2077584SAli.Saidi@arm.com break; 2087584SAli.Saidi@arm.com case UART_CR: 2097584SAli.Saidi@arm.com control = data; 2107584SAli.Saidi@arm.com break; 2117584SAli.Saidi@arm.com case UART_IBRD: 2127584SAli.Saidi@arm.com ibrd = data; 2137584SAli.Saidi@arm.com break; 2147584SAli.Saidi@arm.com case UART_FBRD: 2157584SAli.Saidi@arm.com fbrd = data; 2167584SAli.Saidi@arm.com break; 2177584SAli.Saidi@arm.com case UART_LCRH: 2187584SAli.Saidi@arm.com lcrh = data; 2197584SAli.Saidi@arm.com break; 2207584SAli.Saidi@arm.com case UART_IFLS: 2217584SAli.Saidi@arm.com ifls = data; 2227584SAli.Saidi@arm.com break; 2237584SAli.Saidi@arm.com case UART_IMSC: 22410718SAndreas.Sandberg@ARM.com DPRINTF(Uart, "Setting interrupt mask 0x%x\n", data); 22510718SAndreas.Sandberg@ARM.com setInterruptMask(data); 2267584SAli.Saidi@arm.com break; 2277584SAli.Saidi@arm.com 2287584SAli.Saidi@arm.com case UART_ICR: 2297584SAli.Saidi@arm.com DPRINTF(Uart, "Clearing interrupts 0x%x\n", data); 23010718SAndreas.Sandberg@ARM.com clearInterrupts(data); 23112237Sandreas.sandberg@arm.com if (device->dataAvailable()) { 23211685Sbaz21@cam.ac.uk DPRINTF(Uart, "Re-raising interrupt due to more data after " 23311685Sbaz21@cam.ac.uk "UART_ICR write\n"); 23411685Sbaz21@cam.ac.uk dataAvailable(); 23511685Sbaz21@cam.ac.uk } 2367584SAli.Saidi@arm.com break; 2377584SAli.Saidi@arm.com default: 2387584SAli.Saidi@arm.com panic("Tried to write PL011 at offset %#x that doesn't exist\n", daddr); 2397584SAli.Saidi@arm.com break; 2407584SAli.Saidi@arm.com } 2417584SAli.Saidi@arm.com pkt->makeAtomicResponse(); 2427584SAli.Saidi@arm.com return pioDelay; 2437584SAli.Saidi@arm.com} 2447584SAli.Saidi@arm.com 2457584SAli.Saidi@arm.comvoid 2467584SAli.Saidi@arm.comPl011::dataAvailable() 2477584SAli.Saidi@arm.com{ 2487584SAli.Saidi@arm.com /*@todo ignore the fifo, just say we have data now 2497584SAli.Saidi@arm.com * We might want to fix this, or we might not care */ 2507584SAli.Saidi@arm.com DPRINTF(Uart, "Data available, scheduling interrupt\n"); 25110718SAndreas.Sandberg@ARM.com raiseInterrupts(UART_RXINTR | UART_RTINTR); 2527584SAli.Saidi@arm.com} 2537584SAli.Saidi@arm.com 2547584SAli.Saidi@arm.comvoid 2557584SAli.Saidi@arm.comPl011::generateInterrupt() 2567584SAli.Saidi@arm.com{ 2577584SAli.Saidi@arm.com DPRINTF(Uart, "Generate Interrupt: imsc=0x%x rawInt=0x%x maskInt=0x%x\n", 25810718SAndreas.Sandberg@ARM.com imsc, rawInt, maskInt()); 2597584SAli.Saidi@arm.com 26010718SAndreas.Sandberg@ARM.com if (maskInt()) { 2617584SAli.Saidi@arm.com gic->sendInt(intNum); 2627584SAli.Saidi@arm.com DPRINTF(Uart, " -- Generated\n"); 2637584SAli.Saidi@arm.com } 26410718SAndreas.Sandberg@ARM.com} 2657584SAli.Saidi@arm.com 26610718SAndreas.Sandberg@ARM.comvoid 26710718SAndreas.Sandberg@ARM.comPl011::setInterrupts(uint16_t ints, uint16_t mask) 26810718SAndreas.Sandberg@ARM.com{ 26910718SAndreas.Sandberg@ARM.com const bool old_ints(!!maskInt()); 27010718SAndreas.Sandberg@ARM.com 27110718SAndreas.Sandberg@ARM.com imsc = mask; 27210718SAndreas.Sandberg@ARM.com rawInt = ints; 27310718SAndreas.Sandberg@ARM.com 27410718SAndreas.Sandberg@ARM.com if (!old_ints && maskInt()) { 27510718SAndreas.Sandberg@ARM.com if (!intEvent.scheduled()) 27610718SAndreas.Sandberg@ARM.com schedule(intEvent, curTick() + intDelay); 27710718SAndreas.Sandberg@ARM.com } else if (old_ints && !maskInt()) { 27810718SAndreas.Sandberg@ARM.com gic->clearInt(intNum); 27910718SAndreas.Sandberg@ARM.com } 2807584SAli.Saidi@arm.com} 2817584SAli.Saidi@arm.com 2827584SAli.Saidi@arm.com 2837584SAli.Saidi@arm.com 2847584SAli.Saidi@arm.comvoid 28510905Sandreas.sandberg@arm.comPl011::serialize(CheckpointOut &cp) const 2867584SAli.Saidi@arm.com{ 2877733SAli.Saidi@ARM.com DPRINTF(Checkpoint, "Serializing Arm PL011\n"); 2887733SAli.Saidi@ARM.com SERIALIZE_SCALAR(control); 2897733SAli.Saidi@ARM.com SERIALIZE_SCALAR(fbrd); 2907733SAli.Saidi@ARM.com SERIALIZE_SCALAR(ibrd); 2917733SAli.Saidi@ARM.com SERIALIZE_SCALAR(lcrh); 2927733SAli.Saidi@ARM.com SERIALIZE_SCALAR(ifls); 2937733SAli.Saidi@ARM.com 29410718SAndreas.Sandberg@ARM.com // Preserve backwards compatibility by giving these silly names. 29510905Sandreas.sandberg@arm.com paramOut(cp, "imsc_serial", imsc); 29610905Sandreas.sandberg@arm.com paramOut(cp, "rawInt_serial", rawInt); 2977584SAli.Saidi@arm.com} 2987584SAli.Saidi@arm.com 2997584SAli.Saidi@arm.comvoid 30010905Sandreas.sandberg@arm.comPl011::unserialize(CheckpointIn &cp) 3017584SAli.Saidi@arm.com{ 3027733SAli.Saidi@ARM.com DPRINTF(Checkpoint, "Unserializing Arm PL011\n"); 3037733SAli.Saidi@ARM.com 3047733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(control); 3057733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(fbrd); 3067733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(ibrd); 3077733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(lcrh); 3087733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(ifls); 3097733SAli.Saidi@ARM.com 31010718SAndreas.Sandberg@ARM.com // Preserve backwards compatibility by giving these silly names. 31110905Sandreas.sandberg@arm.com paramIn(cp, "imsc_serial", imsc); 31210905Sandreas.sandberg@arm.com paramIn(cp, "rawInt_serial", rawInt); 3137584SAli.Saidi@arm.com} 3147584SAli.Saidi@arm.com 3157584SAli.Saidi@arm.comPl011 * 3167584SAli.Saidi@arm.comPl011Params::create() 3177584SAli.Saidi@arm.com{ 3187584SAli.Saidi@arm.com return new Pl011(this); 3197584SAli.Saidi@arm.com} 320