pl111.hh revision 9394
17753SWilliam.Wang@arm.com/* 27753SWilliam.Wang@arm.com * Copyright (c) 2010 ARM Limited 37753SWilliam.Wang@arm.com * All rights reserved 47753SWilliam.Wang@arm.com * 57753SWilliam.Wang@arm.com * The license below extends only to copyright in the software and shall 67753SWilliam.Wang@arm.com * not be construed as granting a license to any other intellectual 77753SWilliam.Wang@arm.com * property including but not limited to intellectual property relating 87753SWilliam.Wang@arm.com * to a hardware implementation of the functionality of the software 97753SWilliam.Wang@arm.com * licensed hereunder. You may use the software subject to the license 107753SWilliam.Wang@arm.com * terms below provided that you ensure that this notice is replicated 117753SWilliam.Wang@arm.com * unmodified and in its entirety in all distributions of the software, 127753SWilliam.Wang@arm.com * modified or unmodified, in source code or in binary form. 137753SWilliam.Wang@arm.com * 147753SWilliam.Wang@arm.com * Redistribution and use in source and binary forms, with or without 157753SWilliam.Wang@arm.com * modification, are permitted provided that the following conditions are 167753SWilliam.Wang@arm.com * met: redistributions of source code must retain the above copyright 177753SWilliam.Wang@arm.com * notice, this list of conditions and the following disclaimer; 187753SWilliam.Wang@arm.com * redistributions in binary form must reproduce the above copyright 197753SWilliam.Wang@arm.com * notice, this list of conditions and the following disclaimer in the 207753SWilliam.Wang@arm.com * documentation and/or other materials provided with the distribution; 217753SWilliam.Wang@arm.com * neither the name of the copyright holders nor the names of its 227753SWilliam.Wang@arm.com * contributors may be used to endorse or promote products derived from 237753SWilliam.Wang@arm.com * this software without specific prior written permission. 247753SWilliam.Wang@arm.com * 257753SWilliam.Wang@arm.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 267753SWilliam.Wang@arm.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 277753SWilliam.Wang@arm.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 287753SWilliam.Wang@arm.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 297753SWilliam.Wang@arm.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 307753SWilliam.Wang@arm.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 317753SWilliam.Wang@arm.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 327753SWilliam.Wang@arm.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 337753SWilliam.Wang@arm.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 347753SWilliam.Wang@arm.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 357753SWilliam.Wang@arm.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 367753SWilliam.Wang@arm.com * 377753SWilliam.Wang@arm.com * Authors: William Wang 387950SAli.Saidi@ARM.com * Ali Saidi 397753SWilliam.Wang@arm.com */ 407753SWilliam.Wang@arm.com 417753SWilliam.Wang@arm.com 427753SWilliam.Wang@arm.com/** @file 437753SWilliam.Wang@arm.com * Implementiation of a PL111 CLCD controller 447753SWilliam.Wang@arm.com */ 457753SWilliam.Wang@arm.com 467753SWilliam.Wang@arm.com#ifndef __DEV_ARM_PL111_HH__ 477753SWilliam.Wang@arm.com#define __DEV_ARM_PL111_HH__ 487753SWilliam.Wang@arm.com 497753SWilliam.Wang@arm.com#include <fstream> 507753SWilliam.Wang@arm.com 517753SWilliam.Wang@arm.com#include "dev/arm/amba_device.hh" 527753SWilliam.Wang@arm.com#include "params/Pl111.hh" 537753SWilliam.Wang@arm.com#include "sim/serialize.hh" 547753SWilliam.Wang@arm.com 557753SWilliam.Wang@arm.comclass Gic; 569330Schander.sudanthi@arm.comclass VncInput; 577950SAli.Saidi@ARM.comclass Bitmap; 587753SWilliam.Wang@arm.com 597753SWilliam.Wang@arm.comclass Pl111: public AmbaDmaDevice 607753SWilliam.Wang@arm.com{ 617753SWilliam.Wang@arm.com protected: 627753SWilliam.Wang@arm.com static const uint64_t AMBA_ID = ULL(0xb105f00d00141111); 637753SWilliam.Wang@arm.com /** ARM PL111 register map*/ 647753SWilliam.Wang@arm.com static const int LcdTiming0 = 0x000; 657753SWilliam.Wang@arm.com static const int LcdTiming1 = 0x004; 667753SWilliam.Wang@arm.com static const int LcdTiming2 = 0x008; 677753SWilliam.Wang@arm.com static const int LcdTiming3 = 0x00C; 687753SWilliam.Wang@arm.com static const int LcdUpBase = 0x010; 697753SWilliam.Wang@arm.com static const int LcdLpBase = 0x014; 707753SWilliam.Wang@arm.com static const int LcdControl = 0x018; 717753SWilliam.Wang@arm.com static const int LcdImsc = 0x01C; 727753SWilliam.Wang@arm.com static const int LcdRis = 0x020; 737753SWilliam.Wang@arm.com static const int LcdMis = 0x024; 747753SWilliam.Wang@arm.com static const int LcdIcr = 0x028; 757753SWilliam.Wang@arm.com static const int LcdUpCurr = 0x02C; 767753SWilliam.Wang@arm.com static const int LcdLpCurr = 0x030; 777753SWilliam.Wang@arm.com static const int LcdPalette = 0x200; 787753SWilliam.Wang@arm.com static const int CrsrImage = 0x800; 797753SWilliam.Wang@arm.com static const int ClcdCrsrCtrl = 0xC00; 807753SWilliam.Wang@arm.com static const int ClcdCrsrConfig = 0xC04; 817753SWilliam.Wang@arm.com static const int ClcdCrsrPalette0 = 0xC08; 827753SWilliam.Wang@arm.com static const int ClcdCrsrPalette1 = 0xC0C; 837753SWilliam.Wang@arm.com static const int ClcdCrsrXY = 0xC10; 847753SWilliam.Wang@arm.com static const int ClcdCrsrClip = 0xC14; 857753SWilliam.Wang@arm.com static const int ClcdCrsrImsc = 0xC20; 867753SWilliam.Wang@arm.com static const int ClcdCrsrIcr = 0xC24; 877753SWilliam.Wang@arm.com static const int ClcdCrsrRis = 0xC28; 887753SWilliam.Wang@arm.com static const int ClcdCrsrMis = 0xC2C; 897753SWilliam.Wang@arm.com 907753SWilliam.Wang@arm.com static const int LcdPaletteSize = 128; 917753SWilliam.Wang@arm.com static const int CrsrImageSize = 256; 927753SWilliam.Wang@arm.com 937753SWilliam.Wang@arm.com static const int LcdMaxWidth = 1024; // pixels per line 947753SWilliam.Wang@arm.com static const int LcdMaxHeight = 768; // lines per panel 957753SWilliam.Wang@arm.com 967753SWilliam.Wang@arm.com static const int dmaSize = 8; // 64 bits 977753SWilliam.Wang@arm.com static const int maxOutstandingDma = 16; // 16 deep FIFO of 64 bits 987753SWilliam.Wang@arm.com 997950SAli.Saidi@ARM.com enum LcdMode { 1007950SAli.Saidi@ARM.com bpp1 = 0, 1017950SAli.Saidi@ARM.com bpp2, 1027950SAli.Saidi@ARM.com bpp4, 1037950SAli.Saidi@ARM.com bpp8, 1047950SAli.Saidi@ARM.com bpp16, 1057950SAli.Saidi@ARM.com bpp24, 1067950SAli.Saidi@ARM.com bpp16m565, 1077950SAli.Saidi@ARM.com bpp12 1087950SAli.Saidi@ARM.com }; 1097950SAli.Saidi@ARM.com 1107753SWilliam.Wang@arm.com BitUnion8(InterruptReg) 1117950SAli.Saidi@ARM.com Bitfield<1> underflow; 1127950SAli.Saidi@ARM.com Bitfield<2> baseaddr; 1137950SAli.Saidi@ARM.com Bitfield<3> vcomp; 1147950SAli.Saidi@ARM.com Bitfield<4> ahbmaster; 1157753SWilliam.Wang@arm.com EndBitUnion(InterruptReg) 1167753SWilliam.Wang@arm.com 1177753SWilliam.Wang@arm.com BitUnion32(TimingReg0) 1187950SAli.Saidi@ARM.com Bitfield<7,2> ppl; 1197950SAli.Saidi@ARM.com Bitfield<15,8> hsw; 1207950SAli.Saidi@ARM.com Bitfield<23,16> hfp; 1217950SAli.Saidi@ARM.com Bitfield<31,24> hbp; 1227753SWilliam.Wang@arm.com EndBitUnion(TimingReg0) 1237753SWilliam.Wang@arm.com 1247753SWilliam.Wang@arm.com BitUnion32(TimingReg1) 1257950SAli.Saidi@ARM.com Bitfield<9,0> lpp; 1267950SAli.Saidi@ARM.com Bitfield<15,10> vsw; 1277950SAli.Saidi@ARM.com Bitfield<23,16> vfp; 1287950SAli.Saidi@ARM.com Bitfield<31,24> vbp; 1297753SWilliam.Wang@arm.com EndBitUnion(TimingReg1) 1307753SWilliam.Wang@arm.com 1317753SWilliam.Wang@arm.com BitUnion32(TimingReg2) 1327950SAli.Saidi@ARM.com Bitfield<4,0> pcdlo; 1337950SAli.Saidi@ARM.com Bitfield<5> clksel; 1347950SAli.Saidi@ARM.com Bitfield<10,6> acb; 1357950SAli.Saidi@ARM.com Bitfield<11> avs; 1367950SAli.Saidi@ARM.com Bitfield<12> ihs; 1377950SAli.Saidi@ARM.com Bitfield<13> ipc; 1387950SAli.Saidi@ARM.com Bitfield<14> ioe; 1397950SAli.Saidi@ARM.com Bitfield<25,16> cpl; 1407950SAli.Saidi@ARM.com Bitfield<26> bcd; 1417950SAli.Saidi@ARM.com Bitfield<31,27> pcdhi; 1427753SWilliam.Wang@arm.com EndBitUnion(TimingReg2) 1437753SWilliam.Wang@arm.com 1447753SWilliam.Wang@arm.com BitUnion32(TimingReg3) 1457950SAli.Saidi@ARM.com Bitfield<6,0> led; 1467950SAli.Saidi@ARM.com Bitfield<16> lee; 1477753SWilliam.Wang@arm.com EndBitUnion(TimingReg3) 1487753SWilliam.Wang@arm.com 1497753SWilliam.Wang@arm.com BitUnion32(ControlReg) 1507950SAli.Saidi@ARM.com Bitfield<0> lcden; 1517950SAli.Saidi@ARM.com Bitfield<3,1> lcdbpp; 1527950SAli.Saidi@ARM.com Bitfield<4> lcdbw; 1537950SAli.Saidi@ARM.com Bitfield<5> lcdtft; 1547950SAli.Saidi@ARM.com Bitfield<6> lcdmono8; 1557950SAli.Saidi@ARM.com Bitfield<7> lcddual; 1567950SAli.Saidi@ARM.com Bitfield<8> bgr; 1577950SAli.Saidi@ARM.com Bitfield<9> bebo; 1587950SAli.Saidi@ARM.com Bitfield<10> bepo; 1597950SAli.Saidi@ARM.com Bitfield<11> lcdpwr; 1607950SAli.Saidi@ARM.com Bitfield<13,12> lcdvcomp; 1617950SAli.Saidi@ARM.com Bitfield<16> watermark; 1627753SWilliam.Wang@arm.com EndBitUnion(ControlReg) 1637753SWilliam.Wang@arm.com 1647753SWilliam.Wang@arm.com /** Horizontal axis panel control register */ 1657753SWilliam.Wang@arm.com TimingReg0 lcdTiming0; 1667753SWilliam.Wang@arm.com 1677753SWilliam.Wang@arm.com /** Vertical axis panel control register */ 1687753SWilliam.Wang@arm.com TimingReg1 lcdTiming1; 1697753SWilliam.Wang@arm.com 1707753SWilliam.Wang@arm.com /** Clock and signal polarity control register */ 1717753SWilliam.Wang@arm.com TimingReg2 lcdTiming2; 1727753SWilliam.Wang@arm.com 1737753SWilliam.Wang@arm.com /** Line end control register */ 1747753SWilliam.Wang@arm.com TimingReg3 lcdTiming3; 1757753SWilliam.Wang@arm.com 1767753SWilliam.Wang@arm.com /** Upper panel frame base address register */ 1777753SWilliam.Wang@arm.com int lcdUpbase; 1787753SWilliam.Wang@arm.com 1797753SWilliam.Wang@arm.com /** Lower panel frame base address register */ 1807753SWilliam.Wang@arm.com int lcdLpbase; 1817753SWilliam.Wang@arm.com 1827753SWilliam.Wang@arm.com /** Control register */ 1837753SWilliam.Wang@arm.com ControlReg lcdControl; 1847753SWilliam.Wang@arm.com 1857753SWilliam.Wang@arm.com /** Interrupt mask set/clear register */ 1867753SWilliam.Wang@arm.com InterruptReg lcdImsc; 1877753SWilliam.Wang@arm.com 1887753SWilliam.Wang@arm.com /** Raw interrupt status register - const */ 1897753SWilliam.Wang@arm.com InterruptReg lcdRis; 1907753SWilliam.Wang@arm.com 1917753SWilliam.Wang@arm.com /** Masked interrupt status register */ 1927753SWilliam.Wang@arm.com InterruptReg lcdMis; 1937753SWilliam.Wang@arm.com 1947753SWilliam.Wang@arm.com /** 256x16-bit color palette registers 1957753SWilliam.Wang@arm.com * 256 palette entries organized as 128 locations of two entries per word */ 1967753SWilliam.Wang@arm.com int lcdPalette[LcdPaletteSize]; 1977753SWilliam.Wang@arm.com 1987753SWilliam.Wang@arm.com /** Cursor image RAM register 1997753SWilliam.Wang@arm.com * 256-word wide values defining images overlaid by the hw cursor mechanism */ 2007753SWilliam.Wang@arm.com int cursorImage[CrsrImageSize]; 2017753SWilliam.Wang@arm.com 2027753SWilliam.Wang@arm.com /** Cursor control register */ 2037753SWilliam.Wang@arm.com int clcdCrsrCtrl; 2047753SWilliam.Wang@arm.com 2057753SWilliam.Wang@arm.com /** Cursor configuration register */ 2067753SWilliam.Wang@arm.com int clcdCrsrConfig; 2077753SWilliam.Wang@arm.com 2087753SWilliam.Wang@arm.com /** Cursor palette registers */ 2097753SWilliam.Wang@arm.com int clcdCrsrPalette0; 2107753SWilliam.Wang@arm.com int clcdCrsrPalette1; 2117753SWilliam.Wang@arm.com 2127753SWilliam.Wang@arm.com /** Cursor XY position register */ 2137753SWilliam.Wang@arm.com int clcdCrsrXY; 2147753SWilliam.Wang@arm.com 2157753SWilliam.Wang@arm.com /** Cursor clip position register */ 2167753SWilliam.Wang@arm.com int clcdCrsrClip; 2177753SWilliam.Wang@arm.com 2187753SWilliam.Wang@arm.com /** Cursor interrupt mask set/clear register */ 2197753SWilliam.Wang@arm.com InterruptReg clcdCrsrImsc; 2207753SWilliam.Wang@arm.com 2217753SWilliam.Wang@arm.com /** Cursor interrupt clear register */ 2227753SWilliam.Wang@arm.com InterruptReg clcdCrsrIcr; 2237753SWilliam.Wang@arm.com 2247753SWilliam.Wang@arm.com /** Cursor raw interrupt status register - const */ 2257753SWilliam.Wang@arm.com InterruptReg clcdCrsrRis; 2267753SWilliam.Wang@arm.com 2277753SWilliam.Wang@arm.com /** Cursor masked interrupt status register - const */ 2287753SWilliam.Wang@arm.com InterruptReg clcdCrsrMis; 2297753SWilliam.Wang@arm.com 2309394Sandreas.hansson@arm.com /** Pixel clock */ 2319394Sandreas.hansson@arm.com Tick pixelClock; 2329394Sandreas.hansson@arm.com 2337950SAli.Saidi@ARM.com /** VNC server */ 2349330Schander.sudanthi@arm.com VncInput *vnc; 2357950SAli.Saidi@ARM.com 2367950SAli.Saidi@ARM.com /** Helper to write out bitmaps */ 2377950SAli.Saidi@ARM.com Bitmap *bmp; 2387950SAli.Saidi@ARM.com 2397950SAli.Saidi@ARM.com /** Picture of what the current frame buffer looks like */ 2407950SAli.Saidi@ARM.com std::ostream *pic; 2417753SWilliam.Wang@arm.com 2427753SWilliam.Wang@arm.com /** Frame buffer width - pixels per line */ 2437753SWilliam.Wang@arm.com uint16_t width; 2447753SWilliam.Wang@arm.com 2457950SAli.Saidi@ARM.com /** Frame buffer height - lines per panel */ 2467950SAli.Saidi@ARM.com uint16_t height; 2477950SAli.Saidi@ARM.com 2487950SAli.Saidi@ARM.com /** Bytes per pixel */ 2497950SAli.Saidi@ARM.com uint8_t bytesPerPixel; 2507950SAli.Saidi@ARM.com 2517753SWilliam.Wang@arm.com /** CLCDC supports up to 1024x768 */ 2527950SAli.Saidi@ARM.com uint8_t *dmaBuffer; 2537753SWilliam.Wang@arm.com 2547753SWilliam.Wang@arm.com /** Start time for frame buffer dma read */ 2557753SWilliam.Wang@arm.com Tick startTime; 2567753SWilliam.Wang@arm.com 2577753SWilliam.Wang@arm.com /** Frame buffer base address */ 2587753SWilliam.Wang@arm.com Addr startAddr; 2597753SWilliam.Wang@arm.com 2607753SWilliam.Wang@arm.com /** Frame buffer max address */ 2617753SWilliam.Wang@arm.com Addr maxAddr; 2627753SWilliam.Wang@arm.com 2637753SWilliam.Wang@arm.com /** Frame buffer current address */ 2647753SWilliam.Wang@arm.com Addr curAddr; 2657753SWilliam.Wang@arm.com 2667753SWilliam.Wang@arm.com /** DMA FIFO watermark */ 2677753SWilliam.Wang@arm.com int waterMark; 2687753SWilliam.Wang@arm.com 2697753SWilliam.Wang@arm.com /** Number of pending dma reads */ 2707753SWilliam.Wang@arm.com int dmaPendingNum; 2717753SWilliam.Wang@arm.com 2727950SAli.Saidi@ARM.com /** Send updated parameters to the vnc server */ 2737950SAli.Saidi@ARM.com void updateVideoParams(); 2747950SAli.Saidi@ARM.com 2757753SWilliam.Wang@arm.com /** DMA framebuffer read */ 2767753SWilliam.Wang@arm.com void readFramebuffer(); 2777753SWilliam.Wang@arm.com 2787753SWilliam.Wang@arm.com /** Generate dma framebuffer read event */ 2797753SWilliam.Wang@arm.com void generateReadEvent(); 2807753SWilliam.Wang@arm.com 2817753SWilliam.Wang@arm.com /** Function to generate interrupt */ 2827753SWilliam.Wang@arm.com void generateInterrupt(); 2837753SWilliam.Wang@arm.com 2847753SWilliam.Wang@arm.com /** fillFIFO event */ 2857753SWilliam.Wang@arm.com void fillFifo(); 2867753SWilliam.Wang@arm.com 2877950SAli.Saidi@ARM.com /** start the dmas off after power is enabled */ 2887950SAli.Saidi@ARM.com void startDma(); 2897950SAli.Saidi@ARM.com 2907753SWilliam.Wang@arm.com /** DMA done event */ 2917753SWilliam.Wang@arm.com void dmaDone(); 2927753SWilliam.Wang@arm.com 2937753SWilliam.Wang@arm.com /** DMA framebuffer read event */ 2947753SWilliam.Wang@arm.com EventWrapper<Pl111, &Pl111::readFramebuffer> readEvent; 2957753SWilliam.Wang@arm.com 2967753SWilliam.Wang@arm.com /** Fill fifo */ 2977753SWilliam.Wang@arm.com EventWrapper<Pl111, &Pl111::fillFifo> fillFifoEvent; 2987753SWilliam.Wang@arm.com 2997753SWilliam.Wang@arm.com /** DMA done event */ 3008737Skoansin.tan@gmail.com std::vector<EventWrapper<Pl111, &Pl111::dmaDone> > dmaDoneEvent; 3017753SWilliam.Wang@arm.com 3027950SAli.Saidi@ARM.com /** Wrapper to create an event out of the interrupt */ 3037753SWilliam.Wang@arm.com EventWrapper<Pl111, &Pl111::generateInterrupt> intEvent; 3047753SWilliam.Wang@arm.com 3057753SWilliam.Wang@arm.com public: 3067753SWilliam.Wang@arm.com typedef Pl111Params Params; 3077753SWilliam.Wang@arm.com 3087753SWilliam.Wang@arm.com const Params * 3097753SWilliam.Wang@arm.com params() const 3107753SWilliam.Wang@arm.com { 3117753SWilliam.Wang@arm.com return dynamic_cast<const Params *>(_params); 3127753SWilliam.Wang@arm.com } 3137753SWilliam.Wang@arm.com Pl111(const Params *p); 3149086Sandreas.hansson@arm.com ~Pl111(); 3157753SWilliam.Wang@arm.com 3167753SWilliam.Wang@arm.com virtual Tick read(PacketPtr pkt); 3177753SWilliam.Wang@arm.com virtual Tick write(PacketPtr pkt); 3187753SWilliam.Wang@arm.com 3197753SWilliam.Wang@arm.com virtual void serialize(std::ostream &os); 3207753SWilliam.Wang@arm.com virtual void unserialize(Checkpoint *cp, const std::string §ion); 3217753SWilliam.Wang@arm.com 3228711Sandreas.hansson@arm.com /** 3238711Sandreas.hansson@arm.com * Determine the address ranges that this device responds to. 3248711Sandreas.hansson@arm.com * 3258711Sandreas.hansson@arm.com * @return a list of non-overlapping address ranges 3267753SWilliam.Wang@arm.com */ 3279090Sandreas.hansson@arm.com AddrRangeList getAddrRanges() const; 3287753SWilliam.Wang@arm.com}; 3297753SWilliam.Wang@arm.com 3307753SWilliam.Wang@arm.com#endif 331