From: Giacomo Travaglini Date: Tue, 28 May 2019 14:26:18 +0000 (+0100) Subject: dev-arm: Add doorbell interface class X-Git-Tag: develop-gem5-snapshot~536 X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=c794f566407eb541a9c77216509c8e83a7ef481b;p=gem5.git dev-arm: Add doorbell interface class JIRA: https://gem5.atlassian.net/browse/GEM5-768 Change-Id: I0d264a74cbf8ca0f780314ad01fb0dd0765a0464 Signed-off-by: Giacomo Travaglini Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/34377 Reviewed-by: Andreas Sandberg Maintainer: Andreas Sandberg Tested-by: kokoro --- diff --git a/src/dev/arm/Doorbell.py b/src/dev/arm/Doorbell.py new file mode 100644 index 000000000..9a8e69010 --- /dev/null +++ b/src/dev/arm/Doorbell.py @@ -0,0 +1,44 @@ +# Copyright (c) 2020 ARM Limited +# All rights reserved. +# +# The license below extends only to copyright in the software and shall +# not be construed as granting a license to any other intellectual +# property including but not limited to intellectual property relating +# to a hardware implementation of the functionality of the software +# licensed hereunder. You may use the software subject to the license +# terms below provided that you ensure that this notice is replicated +# unmodified and in its entirety in all distributions of the software, +# modified or unmodified, in source code or in binary form. +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are +# met: redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer; +# redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution; +# neither the name of the copyright holders nor the names of its +# contributors may be used to endorse or promote products derived from +# this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +from m5.SimObject import SimObject +from m5.params import * + +class Doorbell(SimObject): + type = 'Doorbell' + abstract = True + cxx_header = "dev/arm/doorbell.hh" + set_address = Param.Addr("Doorbell set address") + clear_address = Param.Addr("Doorbell clear address") diff --git a/src/dev/arm/SConscript b/src/dev/arm/SConscript index 46ff259ae..cc3efcf64 100644 --- a/src/dev/arm/SConscript +++ b/src/dev/arm/SConscript @@ -40,6 +40,7 @@ Import('*') if env['TARGET_ISA'] == 'arm': SimObject('AbstractNVM.py') SimObject('Display.py') + SimObject('Doorbell.py') SimObject('FlashDevice.py') SimObject('GenericTimer.py') SimObject('Gic.py') diff --git a/src/dev/arm/doorbell.hh b/src/dev/arm/doorbell.hh new file mode 100644 index 000000000..0f786cf06 --- /dev/null +++ b/src/dev/arm/doorbell.hh @@ -0,0 +1,66 @@ +/* + * Copyright (c) 2020 ARM Limited + * All rights reserved + * + * The license below extends only to copyright in the software and shall + * not be construed as granting a license to any other intellectual + * property including but not limited to intellectual property relating + * to a hardware implementation of the functionality of the software + * licensed hereunder. You may use the software subject to the license + * terms below provided that you ensure that this notice is replicated + * unmodified and in its entirety in all distributions of the software, + * modified or unmodified, in source code or in binary form. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer; + * redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution; + * neither the name of the copyright holders nor the names of its + * contributors may be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef __DEV_ARM_DOORBELL_H__ +#define __DEV_ARM_DOORBELL_H__ + +#include "params/Doorbell.hh" +#include "sim/sim_object.hh" + +/** + * Generic doorbell interface. + * A Doorbell implementation will override the set and + * clear methods which are the object interface for raising + * and clearing an interrupt. + */ +class Doorbell : public SimObject +{ + public: + Doorbell(const DoorbellParams &p) + : SimObject(p), _setAddress(p.set_address), + _clearAddress(p.clear_address) + {} + + Addr setAddress() const { return _setAddress; } + Addr clearAddress() const { return _clearAddress; } + + protected: + const Addr _setAddress; + const Addr _clearAddress; +}; + +#endif // __DEV_ARM_DOORBELL_H__