pl111.hh revision 9086
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 "base/range.hh" 527753SWilliam.Wang@arm.com#include "dev/arm/amba_device.hh" 537753SWilliam.Wang@arm.com#include "params/Pl111.hh" 547753SWilliam.Wang@arm.com#include "sim/serialize.hh" 557753SWilliam.Wang@arm.com 567753SWilliam.Wang@arm.comclass Gic; 577950SAli.Saidi@ARM.comclass VncServer; 587950SAli.Saidi@ARM.comclass Bitmap; 597753SWilliam.Wang@arm.com 607753SWilliam.Wang@arm.comclass Pl111: public AmbaDmaDevice 617753SWilliam.Wang@arm.com{ 627753SWilliam.Wang@arm.com protected: 637753SWilliam.Wang@arm.com static const uint64_t AMBA_ID = ULL(0xb105f00d00141111); 647753SWilliam.Wang@arm.com /** ARM PL111 register map*/ 657753SWilliam.Wang@arm.com static const int LcdTiming0 = 0x000; 667753SWilliam.Wang@arm.com static const int LcdTiming1 = 0x004; 677753SWilliam.Wang@arm.com static const int LcdTiming2 = 0x008; 687753SWilliam.Wang@arm.com static const int LcdTiming3 = 0x00C; 697753SWilliam.Wang@arm.com static const int LcdUpBase = 0x010; 707753SWilliam.Wang@arm.com static const int LcdLpBase = 0x014; 717753SWilliam.Wang@arm.com static const int LcdControl = 0x018; 727753SWilliam.Wang@arm.com static const int LcdImsc = 0x01C; 737753SWilliam.Wang@arm.com static const int LcdRis = 0x020; 747753SWilliam.Wang@arm.com static const int LcdMis = 0x024; 757753SWilliam.Wang@arm.com static const int LcdIcr = 0x028; 767753SWilliam.Wang@arm.com static const int LcdUpCurr = 0x02C; 777753SWilliam.Wang@arm.com static const int LcdLpCurr = 0x030; 787753SWilliam.Wang@arm.com static const int LcdPalette = 0x200; 797753SWilliam.Wang@arm.com static const int CrsrImage = 0x800; 807753SWilliam.Wang@arm.com static const int ClcdCrsrCtrl = 0xC00; 817753SWilliam.Wang@arm.com static const int ClcdCrsrConfig = 0xC04; 827753SWilliam.Wang@arm.com static const int ClcdCrsrPalette0 = 0xC08; 837753SWilliam.Wang@arm.com static const int ClcdCrsrPalette1 = 0xC0C; 847753SWilliam.Wang@arm.com static const int ClcdCrsrXY = 0xC10; 857753SWilliam.Wang@arm.com static const int ClcdCrsrClip = 0xC14; 867753SWilliam.Wang@arm.com static const int ClcdCrsrImsc = 0xC20; 877753SWilliam.Wang@arm.com static const int ClcdCrsrIcr = 0xC24; 887753SWilliam.Wang@arm.com static const int ClcdCrsrRis = 0xC28; 897753SWilliam.Wang@arm.com static const int ClcdCrsrMis = 0xC2C; 907753SWilliam.Wang@arm.com 917753SWilliam.Wang@arm.com static const int LcdPaletteSize = 128; 927753SWilliam.Wang@arm.com static const int CrsrImageSize = 256; 937753SWilliam.Wang@arm.com 947753SWilliam.Wang@arm.com static const int LcdMaxWidth = 1024; // pixels per line 957753SWilliam.Wang@arm.com static const int LcdMaxHeight = 768; // lines per panel 967753SWilliam.Wang@arm.com 977753SWilliam.Wang@arm.com static const int dmaSize = 8; // 64 bits 987753SWilliam.Wang@arm.com static const int maxOutstandingDma = 16; // 16 deep FIFO of 64 bits 997753SWilliam.Wang@arm.com 1007950SAli.Saidi@ARM.com enum LcdMode { 1017950SAli.Saidi@ARM.com bpp1 = 0, 1027950SAli.Saidi@ARM.com bpp2, 1037950SAli.Saidi@ARM.com bpp4, 1047950SAli.Saidi@ARM.com bpp8, 1057950SAli.Saidi@ARM.com bpp16, 1067950SAli.Saidi@ARM.com bpp24, 1077950SAli.Saidi@ARM.com bpp16m565, 1087950SAli.Saidi@ARM.com bpp12 1097950SAli.Saidi@ARM.com }; 1107950SAli.Saidi@ARM.com 1117753SWilliam.Wang@arm.com BitUnion8(InterruptReg) 1127950SAli.Saidi@ARM.com Bitfield<1> underflow; 1137950SAli.Saidi@ARM.com Bitfield<2> baseaddr; 1147950SAli.Saidi@ARM.com Bitfield<3> vcomp; 1157950SAli.Saidi@ARM.com Bitfield<4> ahbmaster; 1167753SWilliam.Wang@arm.com EndBitUnion(InterruptReg) 1177753SWilliam.Wang@arm.com 1187753SWilliam.Wang@arm.com BitUnion32(TimingReg0) 1197950SAli.Saidi@ARM.com Bitfield<7,2> ppl; 1207950SAli.Saidi@ARM.com Bitfield<15,8> hsw; 1217950SAli.Saidi@ARM.com Bitfield<23,16> hfp; 1227950SAli.Saidi@ARM.com Bitfield<31,24> hbp; 1237753SWilliam.Wang@arm.com EndBitUnion(TimingReg0) 1247753SWilliam.Wang@arm.com 1257753SWilliam.Wang@arm.com BitUnion32(TimingReg1) 1267950SAli.Saidi@ARM.com Bitfield<9,0> lpp; 1277950SAli.Saidi@ARM.com Bitfield<15,10> vsw; 1287950SAli.Saidi@ARM.com Bitfield<23,16> vfp; 1297950SAli.Saidi@ARM.com Bitfield<31,24> vbp; 1307753SWilliam.Wang@arm.com EndBitUnion(TimingReg1) 1317753SWilliam.Wang@arm.com 1327753SWilliam.Wang@arm.com BitUnion32(TimingReg2) 1337950SAli.Saidi@ARM.com Bitfield<4,0> pcdlo; 1347950SAli.Saidi@ARM.com Bitfield<5> clksel; 1357950SAli.Saidi@ARM.com Bitfield<10,6> acb; 1367950SAli.Saidi@ARM.com Bitfield<11> avs; 1377950SAli.Saidi@ARM.com Bitfield<12> ihs; 1387950SAli.Saidi@ARM.com Bitfield<13> ipc; 1397950SAli.Saidi@ARM.com Bitfield<14> ioe; 1407950SAli.Saidi@ARM.com Bitfield<25,16> cpl; 1417950SAli.Saidi@ARM.com Bitfield<26> bcd; 1427950SAli.Saidi@ARM.com Bitfield<31,27> pcdhi; 1437753SWilliam.Wang@arm.com EndBitUnion(TimingReg2) 1447753SWilliam.Wang@arm.com 1457753SWilliam.Wang@arm.com BitUnion32(TimingReg3) 1467950SAli.Saidi@ARM.com Bitfield<6,0> led; 1477950SAli.Saidi@ARM.com Bitfield<16> lee; 1487753SWilliam.Wang@arm.com EndBitUnion(TimingReg3) 1497753SWilliam.Wang@arm.com 1507753SWilliam.Wang@arm.com BitUnion32(ControlReg) 1517950SAli.Saidi@ARM.com Bitfield<0> lcden; 1527950SAli.Saidi@ARM.com Bitfield<3,1> lcdbpp; 1537950SAli.Saidi@ARM.com Bitfield<4> lcdbw; 1547950SAli.Saidi@ARM.com Bitfield<5> lcdtft; 1557950SAli.Saidi@ARM.com Bitfield<6> lcdmono8; 1567950SAli.Saidi@ARM.com Bitfield<7> lcddual; 1577950SAli.Saidi@ARM.com Bitfield<8> bgr; 1587950SAli.Saidi@ARM.com Bitfield<9> bebo; 1597950SAli.Saidi@ARM.com Bitfield<10> bepo; 1607950SAli.Saidi@ARM.com Bitfield<11> lcdpwr; 1617950SAli.Saidi@ARM.com Bitfield<13,12> lcdvcomp; 1627950SAli.Saidi@ARM.com Bitfield<16> watermark; 1637753SWilliam.Wang@arm.com EndBitUnion(ControlReg) 1647753SWilliam.Wang@arm.com 1657753SWilliam.Wang@arm.com /** Horizontal axis panel control register */ 1667753SWilliam.Wang@arm.com TimingReg0 lcdTiming0; 1677753SWilliam.Wang@arm.com 1687753SWilliam.Wang@arm.com /** Vertical axis panel control register */ 1697753SWilliam.Wang@arm.com TimingReg1 lcdTiming1; 1707753SWilliam.Wang@arm.com 1717753SWilliam.Wang@arm.com /** Clock and signal polarity control register */ 1727753SWilliam.Wang@arm.com TimingReg2 lcdTiming2; 1737753SWilliam.Wang@arm.com 1747753SWilliam.Wang@arm.com /** Line end control register */ 1757753SWilliam.Wang@arm.com TimingReg3 lcdTiming3; 1767753SWilliam.Wang@arm.com 1777753SWilliam.Wang@arm.com /** Upper panel frame base address register */ 1787753SWilliam.Wang@arm.com int lcdUpbase; 1797753SWilliam.Wang@arm.com 1807753SWilliam.Wang@arm.com /** Lower panel frame base address register */ 1817753SWilliam.Wang@arm.com int lcdLpbase; 1827753SWilliam.Wang@arm.com 1837753SWilliam.Wang@arm.com /** Control register */ 1847753SWilliam.Wang@arm.com ControlReg lcdControl; 1857753SWilliam.Wang@arm.com 1867753SWilliam.Wang@arm.com /** Interrupt mask set/clear register */ 1877753SWilliam.Wang@arm.com InterruptReg lcdImsc; 1887753SWilliam.Wang@arm.com 1897753SWilliam.Wang@arm.com /** Raw interrupt status register - const */ 1907753SWilliam.Wang@arm.com InterruptReg lcdRis; 1917753SWilliam.Wang@arm.com 1927753SWilliam.Wang@arm.com /** Masked interrupt status register */ 1937753SWilliam.Wang@arm.com InterruptReg lcdMis; 1947753SWilliam.Wang@arm.com 1957753SWilliam.Wang@arm.com /** 256x16-bit color palette registers 1967753SWilliam.Wang@arm.com * 256 palette entries organized as 128 locations of two entries per word */ 1977753SWilliam.Wang@arm.com int lcdPalette[LcdPaletteSize]; 1987753SWilliam.Wang@arm.com 1997753SWilliam.Wang@arm.com /** Cursor image RAM register 2007753SWilliam.Wang@arm.com * 256-word wide values defining images overlaid by the hw cursor mechanism */ 2017753SWilliam.Wang@arm.com int cursorImage[CrsrImageSize]; 2027753SWilliam.Wang@arm.com 2037753SWilliam.Wang@arm.com /** Cursor control register */ 2047753SWilliam.Wang@arm.com int clcdCrsrCtrl; 2057753SWilliam.Wang@arm.com 2067753SWilliam.Wang@arm.com /** Cursor configuration register */ 2077753SWilliam.Wang@arm.com int clcdCrsrConfig; 2087753SWilliam.Wang@arm.com 2097753SWilliam.Wang@arm.com /** Cursor palette registers */ 2107753SWilliam.Wang@arm.com int clcdCrsrPalette0; 2117753SWilliam.Wang@arm.com int clcdCrsrPalette1; 2127753SWilliam.Wang@arm.com 2137753SWilliam.Wang@arm.com /** Cursor XY position register */ 2147753SWilliam.Wang@arm.com int clcdCrsrXY; 2157753SWilliam.Wang@arm.com 2167753SWilliam.Wang@arm.com /** Cursor clip position register */ 2177753SWilliam.Wang@arm.com int clcdCrsrClip; 2187753SWilliam.Wang@arm.com 2197753SWilliam.Wang@arm.com /** Cursor interrupt mask set/clear register */ 2207753SWilliam.Wang@arm.com InterruptReg clcdCrsrImsc; 2217753SWilliam.Wang@arm.com 2227753SWilliam.Wang@arm.com /** Cursor interrupt clear register */ 2237753SWilliam.Wang@arm.com InterruptReg clcdCrsrIcr; 2247753SWilliam.Wang@arm.com 2257753SWilliam.Wang@arm.com /** Cursor raw interrupt status register - const */ 2267753SWilliam.Wang@arm.com InterruptReg clcdCrsrRis; 2277753SWilliam.Wang@arm.com 2287753SWilliam.Wang@arm.com /** Cursor masked interrupt status register - const */ 2297753SWilliam.Wang@arm.com InterruptReg clcdCrsrMis; 2307753SWilliam.Wang@arm.com 2317753SWilliam.Wang@arm.com /** Clock speed */ 2327753SWilliam.Wang@arm.com Tick clock; 2337753SWilliam.Wang@arm.com 2347950SAli.Saidi@ARM.com /** VNC server */ 2357950SAli.Saidi@ARM.com VncServer *vncserver; 2367950SAli.Saidi@ARM.com 2377950SAli.Saidi@ARM.com /** Helper to write out bitmaps */ 2387950SAli.Saidi@ARM.com Bitmap *bmp; 2397950SAli.Saidi@ARM.com 2407950SAli.Saidi@ARM.com /** Picture of what the current frame buffer looks like */ 2417950SAli.Saidi@ARM.com std::ostream *pic; 2427753SWilliam.Wang@arm.com 2437753SWilliam.Wang@arm.com /** Frame buffer width - pixels per line */ 2447753SWilliam.Wang@arm.com uint16_t width; 2457753SWilliam.Wang@arm.com 2467950SAli.Saidi@ARM.com /** Frame buffer height - lines per panel */ 2477950SAli.Saidi@ARM.com uint16_t height; 2487950SAli.Saidi@ARM.com 2497950SAli.Saidi@ARM.com /** Bytes per pixel */ 2507950SAli.Saidi@ARM.com uint8_t bytesPerPixel; 2517950SAli.Saidi@ARM.com 2527753SWilliam.Wang@arm.com /** CLCDC supports up to 1024x768 */ 2537950SAli.Saidi@ARM.com uint8_t *dmaBuffer; 2547753SWilliam.Wang@arm.com 2557753SWilliam.Wang@arm.com /** Start time for frame buffer dma read */ 2567753SWilliam.Wang@arm.com Tick startTime; 2577753SWilliam.Wang@arm.com 2587753SWilliam.Wang@arm.com /** Frame buffer base address */ 2597753SWilliam.Wang@arm.com Addr startAddr; 2607753SWilliam.Wang@arm.com 2617753SWilliam.Wang@arm.com /** Frame buffer max address */ 2627753SWilliam.Wang@arm.com Addr maxAddr; 2637753SWilliam.Wang@arm.com 2647753SWilliam.Wang@arm.com /** Frame buffer current address */ 2657753SWilliam.Wang@arm.com Addr curAddr; 2667753SWilliam.Wang@arm.com 2677753SWilliam.Wang@arm.com /** DMA FIFO watermark */ 2687753SWilliam.Wang@arm.com int waterMark; 2697753SWilliam.Wang@arm.com 2707753SWilliam.Wang@arm.com /** Number of pending dma reads */ 2717753SWilliam.Wang@arm.com int dmaPendingNum; 2727753SWilliam.Wang@arm.com 2737950SAli.Saidi@ARM.com /** Send updated parameters to the vnc server */ 2747950SAli.Saidi@ARM.com void updateVideoParams(); 2757950SAli.Saidi@ARM.com 2767753SWilliam.Wang@arm.com /** DMA framebuffer read */ 2777753SWilliam.Wang@arm.com void readFramebuffer(); 2787753SWilliam.Wang@arm.com 2797753SWilliam.Wang@arm.com /** Generate dma framebuffer read event */ 2807753SWilliam.Wang@arm.com void generateReadEvent(); 2817753SWilliam.Wang@arm.com 2827753SWilliam.Wang@arm.com /** Function to generate interrupt */ 2837753SWilliam.Wang@arm.com void generateInterrupt(); 2847753SWilliam.Wang@arm.com 2857753SWilliam.Wang@arm.com /** fillFIFO event */ 2867753SWilliam.Wang@arm.com void fillFifo(); 2877753SWilliam.Wang@arm.com 2887950SAli.Saidi@ARM.com /** start the dmas off after power is enabled */ 2897950SAli.Saidi@ARM.com void startDma(); 2907950SAli.Saidi@ARM.com 2917753SWilliam.Wang@arm.com /** DMA done event */ 2927753SWilliam.Wang@arm.com void dmaDone(); 2937753SWilliam.Wang@arm.com 2947753SWilliam.Wang@arm.com /** Next cycle event */ 2957753SWilliam.Wang@arm.com Tick nextCycle(); 2967753SWilliam.Wang@arm.com Tick nextCycle(Tick beginTick); 2977753SWilliam.Wang@arm.com 2987753SWilliam.Wang@arm.com /** DMA framebuffer read event */ 2997753SWilliam.Wang@arm.com EventWrapper<Pl111, &Pl111::readFramebuffer> readEvent; 3007753SWilliam.Wang@arm.com 3017753SWilliam.Wang@arm.com /** Fill fifo */ 3027753SWilliam.Wang@arm.com EventWrapper<Pl111, &Pl111::fillFifo> fillFifoEvent; 3037753SWilliam.Wang@arm.com 3047753SWilliam.Wang@arm.com /** DMA done event */ 3058737Skoansin.tan@gmail.com std::vector<EventWrapper<Pl111, &Pl111::dmaDone> > dmaDoneEvent; 3067753SWilliam.Wang@arm.com 3077950SAli.Saidi@ARM.com /** Wrapper to create an event out of the interrupt */ 3087753SWilliam.Wang@arm.com EventWrapper<Pl111, &Pl111::generateInterrupt> intEvent; 3097753SWilliam.Wang@arm.com 3107753SWilliam.Wang@arm.com public: 3117753SWilliam.Wang@arm.com typedef Pl111Params Params; 3127753SWilliam.Wang@arm.com 3137753SWilliam.Wang@arm.com const Params * 3147753SWilliam.Wang@arm.com params() const 3157753SWilliam.Wang@arm.com { 3167753SWilliam.Wang@arm.com return dynamic_cast<const Params *>(_params); 3177753SWilliam.Wang@arm.com } 3187753SWilliam.Wang@arm.com Pl111(const Params *p); 3199086Sandreas.hansson@arm.com ~Pl111(); 3207753SWilliam.Wang@arm.com 3217753SWilliam.Wang@arm.com virtual Tick read(PacketPtr pkt); 3227753SWilliam.Wang@arm.com virtual Tick write(PacketPtr pkt); 3237753SWilliam.Wang@arm.com 3247753SWilliam.Wang@arm.com virtual void serialize(std::ostream &os); 3257753SWilliam.Wang@arm.com virtual void unserialize(Checkpoint *cp, const std::string §ion); 3267753SWilliam.Wang@arm.com 3278711Sandreas.hansson@arm.com /** 3288711Sandreas.hansson@arm.com * Determine the address ranges that this device responds to. 3298711Sandreas.hansson@arm.com * 3308711Sandreas.hansson@arm.com * @return a list of non-overlapping address ranges 3317753SWilliam.Wang@arm.com */ 3328711Sandreas.hansson@arm.com AddrRangeList getAddrRanges(); 3337753SWilliam.Wang@arm.com}; 3347753SWilliam.Wang@arm.com 3357753SWilliam.Wang@arm.com#endif 336