gpu_nomali.hh revision 11349
110916Sandreas.sandberg@arm.com/* 211349Sandreas.sandberg@arm.com * Copyright (c) 2014-2016 ARM Limited 310916Sandreas.sandberg@arm.com * All rights reserved 410916Sandreas.sandberg@arm.com * 510916Sandreas.sandberg@arm.com * The license below extends only to copyright in the software and shall 610916Sandreas.sandberg@arm.com * not be construed as granting a license to any other intellectual 710916Sandreas.sandberg@arm.com * property including but not limited to intellectual property relating 810916Sandreas.sandberg@arm.com * to a hardware implementation of the functionality of the software 910916Sandreas.sandberg@arm.com * licensed hereunder. You may use the software subject to the license 1010916Sandreas.sandberg@arm.com * terms below provided that you ensure that this notice is replicated 1110916Sandreas.sandberg@arm.com * unmodified and in its entirety in all distributions of the software, 1210916Sandreas.sandberg@arm.com * modified or unmodified, in source code or in binary form. 1310916Sandreas.sandberg@arm.com * 1410916Sandreas.sandberg@arm.com * Redistribution and use in source and binary forms, with or without 1510916Sandreas.sandberg@arm.com * modification, are permitted provided that the following conditions are 1610916Sandreas.sandberg@arm.com * met: redistributions of source code must retain the above copyright 1710916Sandreas.sandberg@arm.com * notice, this list of conditions and the following disclaimer; 1810916Sandreas.sandberg@arm.com * redistributions in binary form must reproduce the above copyright 1910916Sandreas.sandberg@arm.com * notice, this list of conditions and the following disclaimer in the 2010916Sandreas.sandberg@arm.com * documentation and/or other materials provided with the distribution; 2110916Sandreas.sandberg@arm.com * neither the name of the copyright holders nor the names of its 2210916Sandreas.sandberg@arm.com * contributors may be used to endorse or promote products derived from 2310916Sandreas.sandberg@arm.com * this software without specific prior written permission. 2410916Sandreas.sandberg@arm.com * 2510916Sandreas.sandberg@arm.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2610916Sandreas.sandberg@arm.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 2710916Sandreas.sandberg@arm.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 2810916Sandreas.sandberg@arm.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 2910916Sandreas.sandberg@arm.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 3010916Sandreas.sandberg@arm.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 3110916Sandreas.sandberg@arm.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 3210916Sandreas.sandberg@arm.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 3310916Sandreas.sandberg@arm.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 3410916Sandreas.sandberg@arm.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 3510916Sandreas.sandberg@arm.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3610916Sandreas.sandberg@arm.com * 3710916Sandreas.sandberg@arm.com * Authors: Andreas Sandberg 3810916Sandreas.sandberg@arm.com */ 3910916Sandreas.sandberg@arm.com 4010916Sandreas.sandberg@arm.com#ifndef __DEV_ARM_NOMALI_GPU_HH__ 4110916Sandreas.sandberg@arm.com#define __DEV_ARM_NOMALI_GPU_HH__ 4210916Sandreas.sandberg@arm.com 4310916Sandreas.sandberg@arm.com#include <map> 4410916Sandreas.sandberg@arm.com 4510916Sandreas.sandberg@arm.com#include "dev/io_device.hh" 4610916Sandreas.sandberg@arm.com#include "libnomali/nomali.h" 4710916Sandreas.sandberg@arm.com 4810916Sandreas.sandberg@arm.comclass NoMaliGpuParams; 4910916Sandreas.sandberg@arm.comclass RealView; 5010916Sandreas.sandberg@arm.com 5110916Sandreas.sandberg@arm.comclass NoMaliGpu : public PioDevice 5210916Sandreas.sandberg@arm.com{ 5310916Sandreas.sandberg@arm.com public: 5410916Sandreas.sandberg@arm.com NoMaliGpu(const NoMaliGpuParams *p); 5510916Sandreas.sandberg@arm.com virtual ~NoMaliGpu(); 5610916Sandreas.sandberg@arm.com 5710916Sandreas.sandberg@arm.com public: /* Checkpointing */ 5811168Sandreas.hansson@arm.com void serialize(CheckpointOut &cp) const override; 5911168Sandreas.hansson@arm.com void unserialize(CheckpointIn &cp) override; 6010916Sandreas.sandberg@arm.com 6110916Sandreas.sandberg@arm.com public: /* IO device interfaces */ 6211168Sandreas.hansson@arm.com Tick read(PacketPtr pkt) override; 6311168Sandreas.hansson@arm.com Tick write(PacketPtr pkt) override; 6411168Sandreas.hansson@arm.com AddrRangeList getAddrRanges() const override; 6510916Sandreas.sandberg@arm.com 6611349Sandreas.sandberg@arm.com protected: /* API wrappers/helpers */ 6710916Sandreas.sandberg@arm.com /** 6811349Sandreas.sandberg@arm.com * @{ 6911349Sandreas.sandberg@arm.com * @name API wrappers 7010916Sandreas.sandberg@arm.com */ 7110916Sandreas.sandberg@arm.com 7211349Sandreas.sandberg@arm.com /** Wrapper around nomali_reset(). */ 7311349Sandreas.sandberg@arm.com void reset(); 7410916Sandreas.sandberg@arm.com 7510916Sandreas.sandberg@arm.com /** Wrapper around nomali_reg_read(). */ 7610916Sandreas.sandberg@arm.com uint32_t readReg(nomali_addr_t reg); 7710916Sandreas.sandberg@arm.com /** Wrapper around nomali_reg_write(). */ 7810916Sandreas.sandberg@arm.com void writeReg(nomali_addr_t reg, uint32_t value); 7910916Sandreas.sandberg@arm.com 8010916Sandreas.sandberg@arm.com /** Wrapper around nomali_reg_read_raw(). */ 8110916Sandreas.sandberg@arm.com uint32_t readRegRaw(nomali_addr_t reg) const; 8210916Sandreas.sandberg@arm.com /** Wrapper around nomali_reg_write_raw(). */ 8310916Sandreas.sandberg@arm.com void writeRegRaw(nomali_addr_t reg, uint32_t value); 8410916Sandreas.sandberg@arm.com 8510916Sandreas.sandberg@arm.com /** 8611349Sandreas.sandberg@arm.com * Wrapper around nomali_int_state() 8711349Sandreas.sandberg@arm.com * 8811349Sandreas.sandberg@arm.com * @param intno Interrupt number 8911349Sandreas.sandberg@arm.com * @return True if asserted, false otherwise. 9011349Sandreas.sandberg@arm.com */ 9111349Sandreas.sandberg@arm.com bool intState(nomali_int_t intno); 9211349Sandreas.sandberg@arm.com 9311349Sandreas.sandberg@arm.com /** @} */ 9411349Sandreas.sandberg@arm.com 9511349Sandreas.sandberg@arm.com /** 9610916Sandreas.sandberg@arm.com * Format a NoMali error into an error message and panic. 9710916Sandreas.sandberg@arm.com * 9810916Sandreas.sandberg@arm.com * @param err Error code from the NoMali library. 9910916Sandreas.sandberg@arm.com * @param msg Message to print. 10010916Sandreas.sandberg@arm.com */ 10110916Sandreas.sandberg@arm.com static void gpuPanic(nomali_error_t err, const char *msg) M5_ATTR_NORETURN; 10210916Sandreas.sandberg@arm.com /** 10310916Sandreas.sandberg@arm.com * Panic if the NoMali returned an error, do nothing otherwise. 10410916Sandreas.sandberg@arm.com * 10510916Sandreas.sandberg@arm.com * @param err Error code from the NoMali library. 10610916Sandreas.sandberg@arm.com * @param msg Message to print when panicking. 10710916Sandreas.sandberg@arm.com */ 10810916Sandreas.sandberg@arm.com static void panicOnErr(nomali_error_t err, const char *msg) { 10910916Sandreas.sandberg@arm.com if (err != NOMALI_E_OK) 11010916Sandreas.sandberg@arm.com gpuPanic(err, msg); 11110916Sandreas.sandberg@arm.com } 11210916Sandreas.sandberg@arm.com 11311349Sandreas.sandberg@arm.com protected: /* Callbacks */ 11411349Sandreas.sandberg@arm.com /** 11511349Sandreas.sandberg@arm.com * @{ 11611349Sandreas.sandberg@arm.com * @name Callbacks 11711349Sandreas.sandberg@arm.com */ 11811349Sandreas.sandberg@arm.com 11911349Sandreas.sandberg@arm.com /** 12011349Sandreas.sandberg@arm.com * Interrupt callback from the NoMali library 12111349Sandreas.sandberg@arm.com * 12211349Sandreas.sandberg@arm.com * This method is called whenever there is an interrupt state change. 12311349Sandreas.sandberg@arm.com * 12411349Sandreas.sandberg@arm.com * @param intno Interrupt number 12511349Sandreas.sandberg@arm.com * @param set True is the interrupt is being asserted, false otherwise. 12611349Sandreas.sandberg@arm.com */ 12711349Sandreas.sandberg@arm.com virtual void onInterrupt(nomali_int_t intno, bool set); 12811349Sandreas.sandberg@arm.com 12911349Sandreas.sandberg@arm.com /** @} */ 13011349Sandreas.sandberg@arm.com 13111349Sandreas.sandberg@arm.com private: /* Callback helpers */ 13211349Sandreas.sandberg@arm.com /** Wrapper around nomali_set_callback() */ 13311349Sandreas.sandberg@arm.com void setCallback(const nomali_callback_t &callback); 13411349Sandreas.sandberg@arm.com 13511349Sandreas.sandberg@arm.com /** 13611349Sandreas.sandberg@arm.com * Interrupt callback from the NoMali library. 13711349Sandreas.sandberg@arm.com * 13811349Sandreas.sandberg@arm.com * This method calls onInterrupt() on the NoMaliGpu owning this 13911349Sandreas.sandberg@arm.com * device. 14011349Sandreas.sandberg@arm.com * 14111349Sandreas.sandberg@arm.com * @param h NoMali library handle. 14211349Sandreas.sandberg@arm.com * @param usr Pointer to an instance of the NoMaliGpu 14311349Sandreas.sandberg@arm.com * @param intno GPU interrupt type 14411349Sandreas.sandberg@arm.com * @param set Was the interrupt raised (1) or lowered (0)? 14511349Sandreas.sandberg@arm.com */ 14611349Sandreas.sandberg@arm.com static void _interrupt(nomali_handle_t h, void *usr, 14711349Sandreas.sandberg@arm.com nomali_int_t intno, int set); 14811349Sandreas.sandberg@arm.com protected: 14910916Sandreas.sandberg@arm.com /** Device base address */ 15010916Sandreas.sandberg@arm.com const Addr pioAddr; 15110916Sandreas.sandberg@arm.com 15210916Sandreas.sandberg@arm.com /** Platform, used to discover GIC */ 15310916Sandreas.sandberg@arm.com RealView *const platform; 15410916Sandreas.sandberg@arm.com 15510916Sandreas.sandberg@arm.com /** Map between NoMali interrupt types and actual GIC 15610916Sandreas.sandberg@arm.com * interrupts */ 15710916Sandreas.sandberg@arm.com const std::map<nomali_int_t, uint32_t> interruptMap; 15810916Sandreas.sandberg@arm.com 15910916Sandreas.sandberg@arm.com /** Cached information struct from the NoMali library */ 16010916Sandreas.sandberg@arm.com nomali_info_t nomaliInfo; 16110916Sandreas.sandberg@arm.com 16210916Sandreas.sandberg@arm.com /** Handle of a NoMali library instance */ 16310916Sandreas.sandberg@arm.com nomali_handle_t nomali; 16410916Sandreas.sandberg@arm.com}; 16510916Sandreas.sandberg@arm.com 16610916Sandreas.sandberg@arm.com 16710916Sandreas.sandberg@arm.com#endif // __DEV_ARM_NOMALI_GPU_HH__ 168