pl011.cc revision 11685
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 "dev/terminal.hh" 527584SAli.Saidi@arm.com#include "mem/packet.hh" 537584SAli.Saidi@arm.com#include "mem/packet_access.hh" 547584SAli.Saidi@arm.com#include "sim/sim_exit.hh" 5510718SAndreas.Sandberg@ARM.com#include "params/Pl011.hh" 567584SAli.Saidi@arm.com 5710718SAndreas.Sandberg@ARM.comPl011::Pl011(const Pl011Params *p) 5810718SAndreas.Sandberg@ARM.com : Uart(p, 0xfff), 5910718SAndreas.Sandberg@ARM.com intEvent(this), 6010718SAndreas.Sandberg@ARM.com control(0x300), fbrd(0), ibrd(0), lcrh(0), ifls(0x12), 6110718SAndreas.Sandberg@ARM.com imsc(0), rawInt(0), 6210718SAndreas.Sandberg@ARM.com gic(p->gic), endOnEOT(p->end_on_eot), intNum(p->int_num), 6310718SAndreas.Sandberg@ARM.com intDelay(p->int_delay) 647584SAli.Saidi@arm.com{ 657584SAli.Saidi@arm.com} 667584SAli.Saidi@arm.com 677584SAli.Saidi@arm.comTick 687584SAli.Saidi@arm.comPl011::read(PacketPtr pkt) 697584SAli.Saidi@arm.com{ 707584SAli.Saidi@arm.com assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize); 717584SAli.Saidi@arm.com 727584SAli.Saidi@arm.com Addr daddr = pkt->getAddr() - pioAddr; 737584SAli.Saidi@arm.com 747584SAli.Saidi@arm.com DPRINTF(Uart, " read register %#x size=%d\n", daddr, pkt->getSize()); 757584SAli.Saidi@arm.com 767584SAli.Saidi@arm.com // use a temporary data since the uart registers are read/written with 777584SAli.Saidi@arm.com // different size operations 787584SAli.Saidi@arm.com // 797584SAli.Saidi@arm.com uint32_t data = 0; 807584SAli.Saidi@arm.com 817584SAli.Saidi@arm.com switch(daddr) { 827584SAli.Saidi@arm.com case UART_DR: 837584SAli.Saidi@arm.com data = 0; 8410718SAndreas.Sandberg@ARM.com if (term->dataAvailable()) { 857584SAli.Saidi@arm.com data = term->in(); 8610718SAndreas.Sandberg@ARM.com // Since we don't simulate a FIFO for incoming data, we 8710718SAndreas.Sandberg@ARM.com // assume it's empty and clear RXINTR and RTINTR. 8810718SAndreas.Sandberg@ARM.com clearInterrupts(UART_RXINTR | UART_RTINTR); 8911685Sbaz21@cam.ac.uk if (term->dataAvailable()) { 9011685Sbaz21@cam.ac.uk DPRINTF(Uart, "Re-raising interrupt due to more data " 9111685Sbaz21@cam.ac.uk "after UART_DR read\n"); 9211685Sbaz21@cam.ac.uk dataAvailable(); 9311685Sbaz21@cam.ac.uk } 9410718SAndreas.Sandberg@ARM.com } 957584SAli.Saidi@arm.com break; 967584SAli.Saidi@arm.com case UART_FR: 9710718SAndreas.Sandberg@ARM.com data = 9810718SAndreas.Sandberg@ARM.com UART_FR_CTS | // Clear To Send 9911480Sbaz21@cam.ac.uk // Given we do not simulate a FIFO we are either empty or full. 10011480Sbaz21@cam.ac.uk (!term->dataAvailable() ? UART_FR_RXFE : UART_FR_RXFF) | 10110718SAndreas.Sandberg@ARM.com UART_FR_TXFE; // TX FIFO empty 10210718SAndreas.Sandberg@ARM.com 10310718SAndreas.Sandberg@ARM.com DPRINTF(Uart, 10410718SAndreas.Sandberg@ARM.com "Reading FR register as %#x rawInt=0x%x " 10510718SAndreas.Sandberg@ARM.com "imsc=0x%x maskInt=0x%x\n", 10610718SAndreas.Sandberg@ARM.com data, rawInt, imsc, maskInt()); 1077584SAli.Saidi@arm.com break; 1087584SAli.Saidi@arm.com case UART_CR: 1097584SAli.Saidi@arm.com data = control; 1107584SAli.Saidi@arm.com break; 1117584SAli.Saidi@arm.com case UART_IBRD: 1127584SAli.Saidi@arm.com data = ibrd; 1137584SAli.Saidi@arm.com break; 1147584SAli.Saidi@arm.com case UART_FBRD: 1157584SAli.Saidi@arm.com data = fbrd; 1167584SAli.Saidi@arm.com break; 1177584SAli.Saidi@arm.com case UART_LCRH: 1187584SAli.Saidi@arm.com data = lcrh; 1197584SAli.Saidi@arm.com break; 1207584SAli.Saidi@arm.com case UART_IFLS: 1217584SAli.Saidi@arm.com data = ifls; 1227584SAli.Saidi@arm.com break; 1237584SAli.Saidi@arm.com case UART_IMSC: 1247584SAli.Saidi@arm.com data = imsc; 1257584SAli.Saidi@arm.com break; 1267584SAli.Saidi@arm.com case UART_RIS: 1277584SAli.Saidi@arm.com data = rawInt; 1287584SAli.Saidi@arm.com DPRINTF(Uart, "Reading Raw Int status as 0x%x\n", rawInt); 1297584SAli.Saidi@arm.com break; 1307584SAli.Saidi@arm.com case UART_MIS: 13110718SAndreas.Sandberg@ARM.com DPRINTF(Uart, "Reading Masked Int status as 0x%x\n", maskInt()); 13210718SAndreas.Sandberg@ARM.com data = maskInt(); 1337584SAli.Saidi@arm.com break; 1347584SAli.Saidi@arm.com default: 1359806Sstever@gmail.com if (readId(pkt, AMBA_ID, pioAddr)) { 1367587SAli.Saidi@arm.com // Hack for variable size accesses 1377587SAli.Saidi@arm.com data = pkt->get<uint32_t>(); 1387584SAli.Saidi@arm.com break; 1397584SAli.Saidi@arm.com } 1407587SAli.Saidi@arm.com 1417584SAli.Saidi@arm.com panic("Tried to read PL011 at offset %#x that doesn't exist\n", daddr); 1427584SAli.Saidi@arm.com break; 1437584SAli.Saidi@arm.com } 1447584SAli.Saidi@arm.com 1457584SAli.Saidi@arm.com switch(pkt->getSize()) { 1467584SAli.Saidi@arm.com case 1: 1477584SAli.Saidi@arm.com pkt->set<uint8_t>(data); 1487584SAli.Saidi@arm.com break; 1497584SAli.Saidi@arm.com case 2: 1507584SAli.Saidi@arm.com pkt->set<uint16_t>(data); 1517584SAli.Saidi@arm.com break; 1527584SAli.Saidi@arm.com case 4: 1537584SAli.Saidi@arm.com pkt->set<uint32_t>(data); 1547584SAli.Saidi@arm.com break; 1557584SAli.Saidi@arm.com default: 1567584SAli.Saidi@arm.com panic("Uart read size too big?\n"); 1577584SAli.Saidi@arm.com break; 1587584SAli.Saidi@arm.com } 1597584SAli.Saidi@arm.com 1607584SAli.Saidi@arm.com 1617584SAli.Saidi@arm.com pkt->makeAtomicResponse(); 1627584SAli.Saidi@arm.com return pioDelay; 1637584SAli.Saidi@arm.com} 1647584SAli.Saidi@arm.com 1657584SAli.Saidi@arm.comTick 1667584SAli.Saidi@arm.comPl011::write(PacketPtr pkt) 1677584SAli.Saidi@arm.com{ 1687584SAli.Saidi@arm.com 1697584SAli.Saidi@arm.com assert(pkt->getAddr() >= pioAddr && pkt->getAddr() < pioAddr + pioSize); 1707584SAli.Saidi@arm.com 1717584SAli.Saidi@arm.com Addr daddr = pkt->getAddr() - pioAddr; 1727584SAli.Saidi@arm.com 1737584SAli.Saidi@arm.com DPRINTF(Uart, " write register %#x value %#x size=%d\n", daddr, 1747584SAli.Saidi@arm.com pkt->get<uint8_t>(), pkt->getSize()); 1757584SAli.Saidi@arm.com 1767584SAli.Saidi@arm.com // use a temporary data since the uart registers are read/written with 1777584SAli.Saidi@arm.com // different size operations 1787584SAli.Saidi@arm.com // 1797584SAli.Saidi@arm.com uint32_t data = 0; 1807584SAli.Saidi@arm.com 1817584SAli.Saidi@arm.com switch(pkt->getSize()) { 1827584SAli.Saidi@arm.com case 1: 1837584SAli.Saidi@arm.com data = pkt->get<uint8_t>(); 1847584SAli.Saidi@arm.com break; 1857584SAli.Saidi@arm.com case 2: 1867584SAli.Saidi@arm.com data = pkt->get<uint16_t>(); 1877584SAli.Saidi@arm.com break; 1887584SAli.Saidi@arm.com case 4: 1897584SAli.Saidi@arm.com data = pkt->get<uint32_t>(); 1907584SAli.Saidi@arm.com break; 1917584SAli.Saidi@arm.com default: 1927584SAli.Saidi@arm.com panic("Uart write size too big?\n"); 1937584SAli.Saidi@arm.com break; 1947584SAli.Saidi@arm.com } 1957584SAli.Saidi@arm.com 1967584SAli.Saidi@arm.com 1977584SAli.Saidi@arm.com switch (daddr) { 1987584SAli.Saidi@arm.com case UART_DR: 1997584SAli.Saidi@arm.com if ((data & 0xFF) == 0x04 && endOnEOT) 2007584SAli.Saidi@arm.com exitSimLoop("UART received EOT", 0); 2017584SAli.Saidi@arm.com 2027584SAli.Saidi@arm.com term->out(data & 0xFF); 20310718SAndreas.Sandberg@ARM.com // We're supposed to clear TXINTR when this register is 20410718SAndreas.Sandberg@ARM.com // written to, however. since we're also infinitely fast, we 20510718SAndreas.Sandberg@ARM.com // need to immediately raise it again. 20610718SAndreas.Sandberg@ARM.com clearInterrupts(UART_TXINTR); 20710718SAndreas.Sandberg@ARM.com raiseInterrupts(UART_TXINTR); 2087584SAli.Saidi@arm.com break; 2097584SAli.Saidi@arm.com case UART_CR: 2107584SAli.Saidi@arm.com control = data; 2117584SAli.Saidi@arm.com break; 2127584SAli.Saidi@arm.com case UART_IBRD: 2137584SAli.Saidi@arm.com ibrd = data; 2147584SAli.Saidi@arm.com break; 2157584SAli.Saidi@arm.com case UART_FBRD: 2167584SAli.Saidi@arm.com fbrd = data; 2177584SAli.Saidi@arm.com break; 2187584SAli.Saidi@arm.com case UART_LCRH: 2197584SAli.Saidi@arm.com lcrh = data; 2207584SAli.Saidi@arm.com break; 2217584SAli.Saidi@arm.com case UART_IFLS: 2227584SAli.Saidi@arm.com ifls = data; 2237584SAli.Saidi@arm.com break; 2247584SAli.Saidi@arm.com case UART_IMSC: 22510718SAndreas.Sandberg@ARM.com DPRINTF(Uart, "Setting interrupt mask 0x%x\n", data); 22610718SAndreas.Sandberg@ARM.com setInterruptMask(data); 2277584SAli.Saidi@arm.com break; 2287584SAli.Saidi@arm.com 2297584SAli.Saidi@arm.com case UART_ICR: 2307584SAli.Saidi@arm.com DPRINTF(Uart, "Clearing interrupts 0x%x\n", data); 23110718SAndreas.Sandberg@ARM.com clearInterrupts(data); 23211685Sbaz21@cam.ac.uk if (term->dataAvailable()) { 23311685Sbaz21@cam.ac.uk DPRINTF(Uart, "Re-raising interrupt due to more data after " 23411685Sbaz21@cam.ac.uk "UART_ICR write\n"); 23511685Sbaz21@cam.ac.uk dataAvailable(); 23611685Sbaz21@cam.ac.uk } 2377584SAli.Saidi@arm.com break; 2387584SAli.Saidi@arm.com default: 2397584SAli.Saidi@arm.com panic("Tried to write PL011 at offset %#x that doesn't exist\n", daddr); 2407584SAli.Saidi@arm.com break; 2417584SAli.Saidi@arm.com } 2427584SAli.Saidi@arm.com pkt->makeAtomicResponse(); 2437584SAli.Saidi@arm.com return pioDelay; 2447584SAli.Saidi@arm.com} 2457584SAli.Saidi@arm.com 2467584SAli.Saidi@arm.comvoid 2477584SAli.Saidi@arm.comPl011::dataAvailable() 2487584SAli.Saidi@arm.com{ 2497584SAli.Saidi@arm.com /*@todo ignore the fifo, just say we have data now 2507584SAli.Saidi@arm.com * We might want to fix this, or we might not care */ 2517584SAli.Saidi@arm.com DPRINTF(Uart, "Data available, scheduling interrupt\n"); 25210718SAndreas.Sandberg@ARM.com raiseInterrupts(UART_RXINTR | UART_RTINTR); 2537584SAli.Saidi@arm.com} 2547584SAli.Saidi@arm.com 2557584SAli.Saidi@arm.comvoid 2567584SAli.Saidi@arm.comPl011::generateInterrupt() 2577584SAli.Saidi@arm.com{ 2587584SAli.Saidi@arm.com DPRINTF(Uart, "Generate Interrupt: imsc=0x%x rawInt=0x%x maskInt=0x%x\n", 25910718SAndreas.Sandberg@ARM.com imsc, rawInt, maskInt()); 2607584SAli.Saidi@arm.com 26110718SAndreas.Sandberg@ARM.com if (maskInt()) { 2627584SAli.Saidi@arm.com gic->sendInt(intNum); 2637584SAli.Saidi@arm.com DPRINTF(Uart, " -- Generated\n"); 2647584SAli.Saidi@arm.com } 26510718SAndreas.Sandberg@ARM.com} 2667584SAli.Saidi@arm.com 26710718SAndreas.Sandberg@ARM.comvoid 26810718SAndreas.Sandberg@ARM.comPl011::setInterrupts(uint16_t ints, uint16_t mask) 26910718SAndreas.Sandberg@ARM.com{ 27010718SAndreas.Sandberg@ARM.com const bool old_ints(!!maskInt()); 27110718SAndreas.Sandberg@ARM.com 27210718SAndreas.Sandberg@ARM.com imsc = mask; 27310718SAndreas.Sandberg@ARM.com rawInt = ints; 27410718SAndreas.Sandberg@ARM.com 27510718SAndreas.Sandberg@ARM.com if (!old_ints && maskInt()) { 27610718SAndreas.Sandberg@ARM.com if (!intEvent.scheduled()) 27710718SAndreas.Sandberg@ARM.com schedule(intEvent, curTick() + intDelay); 27810718SAndreas.Sandberg@ARM.com } else if (old_ints && !maskInt()) { 27910718SAndreas.Sandberg@ARM.com gic->clearInt(intNum); 28010718SAndreas.Sandberg@ARM.com } 2817584SAli.Saidi@arm.com} 2827584SAli.Saidi@arm.com 2837584SAli.Saidi@arm.com 2847584SAli.Saidi@arm.com 2857584SAli.Saidi@arm.comvoid 28610905Sandreas.sandberg@arm.comPl011::serialize(CheckpointOut &cp) const 2877584SAli.Saidi@arm.com{ 2887733SAli.Saidi@ARM.com DPRINTF(Checkpoint, "Serializing Arm PL011\n"); 2897733SAli.Saidi@ARM.com SERIALIZE_SCALAR(control); 2907733SAli.Saidi@ARM.com SERIALIZE_SCALAR(fbrd); 2917733SAli.Saidi@ARM.com SERIALIZE_SCALAR(ibrd); 2927733SAli.Saidi@ARM.com SERIALIZE_SCALAR(lcrh); 2937733SAli.Saidi@ARM.com SERIALIZE_SCALAR(ifls); 2947733SAli.Saidi@ARM.com 29510718SAndreas.Sandberg@ARM.com // Preserve backwards compatibility by giving these silly names. 29610905Sandreas.sandberg@arm.com paramOut(cp, "imsc_serial", imsc); 29710905Sandreas.sandberg@arm.com paramOut(cp, "rawInt_serial", rawInt); 2987584SAli.Saidi@arm.com} 2997584SAli.Saidi@arm.com 3007584SAli.Saidi@arm.comvoid 30110905Sandreas.sandberg@arm.comPl011::unserialize(CheckpointIn &cp) 3027584SAli.Saidi@arm.com{ 3037733SAli.Saidi@ARM.com DPRINTF(Checkpoint, "Unserializing Arm PL011\n"); 3047733SAli.Saidi@ARM.com 3057733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(control); 3067733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(fbrd); 3077733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(ibrd); 3087733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(lcrh); 3097733SAli.Saidi@ARM.com UNSERIALIZE_SCALAR(ifls); 3107733SAli.Saidi@ARM.com 31110718SAndreas.Sandberg@ARM.com // Preserve backwards compatibility by giving these silly names. 31210905Sandreas.sandberg@arm.com paramIn(cp, "imsc_serial", imsc); 31310905Sandreas.sandberg@arm.com paramIn(cp, "rawInt_serial", rawInt); 3147584SAli.Saidi@arm.com} 3157584SAli.Saidi@arm.com 3167584SAli.Saidi@arm.comPl011 * 3177584SAli.Saidi@arm.comPl011Params::create() 3187584SAli.Saidi@arm.com{ 3197584SAli.Saidi@arm.com return new Pl011(this); 3207584SAli.Saidi@arm.com} 321