derek/gem5
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fastmodel,dev: Replace the reset port with a Signal*Port<bool>.

Browse Source 
The ResetRequestPort and ResetResponsePort have a few problems:

1. A reset signal should happen during the time a reset is asserted,
or in other words the device should stay in reset and not doing
anything while reset is asserted. It should not immediately restart
execution while the reset is still held.

2. These names are misleading, since there is no response. These names
are inherited from other port types where there is an actual response.

There is a new generic SignalSourcePort and SignalSinkPort set of port
classes which are templated on the type of signal they propogate, and
which can be used in place of reset ports in c++. These ports can
still have a specialized role which will ensure that only reset ports
are connected to each other for a form of type checking, although
the underlying c++ instances are more interoperable than that.

Change-Id: Id98bef901ab61ac5b200dbbe49439bb2d2e6c57f
Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/66675
Maintainer: Gabe Black <gabeblack@google.com>
Reviewed-by: Yu-hsin Wang <yuhsingw@google.com>
Tested-by: kokoro <noreply+kokoro@google.com>
This commit is contained in:
Gabe Black
2022-12-13 02:17:22 -08:00
committed by Gabe Black
parent 0aaaa6b4ae
commit fbd0722de4
9 changed files with 33 additions and 188 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
src/dev/SConscript
View File

@@ -36,9 +36,7 @@ Source('dma_device.cc')
Source('dma_virt_device.cc')
SimObject('IntPin.py', sim_objects=[])
SimObject('ResetPort.py', sim_objects=[])
Source('reset_port.cc')
DebugFlag('IsaFake')
DebugFlag('DMA')

57
src/dev/reset_port.cc
View File

@@ -1,57 +0,0 @@
/*
* Copyright 2022 Google, Inc.
*
* 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.
*/
#include "dev/reset_port.hh"
#include "base/logging.hh"
namespace gem5
{
void
ResetRequestPort::bind(Port &p)
{
peer = dynamic_cast<ResetResponsePortBase*>(&p);
fatal_if(peer == nullptr, "Attempt to bind reset request port %s to "
"incompatible port %s.", name(), p.name());
Port::bind(p);
}
void
ResetRequestPort::unbind()
{
peer = nullptr;
Port::unbind();
}
void
ResetRequestPort::requestReset()
{
peer->requestReset();
}
} // namespace gem5

72
src/dev/reset_port.hh
View File

@@ -1,72 +0,0 @@
/*
* Copyright 2022 Google, Inc.
*
* 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_RESET_PORT_HH__
#define __DEV_RESET_PORT_HH__
#include "sim/port.hh"
#include <string>
namespace gem5
{
class ResetResponsePortBase : public Port
{
public:
using Port::Port;
virtual void requestReset() = 0;
};
template <class Device>
class ResetResponsePort : public ResetResponsePortBase
{
public:
ResetResponsePort(const std::string &name, PortID id, Device *dev) :
ResetResponsePortBase(name, id), device(dev) {}
void requestReset() override { device->requestReset(); }
private:
Device *device = nullptr;
};
class ResetRequestPort : public Port
{
public:
ResetRequestPort(const std::string &_name, PortID _id)
: Port(_name, _id) {}
void bind(Port &p) override;
void unbind() override;
void requestReset();
private:
ResetResponsePortBase *peer = nullptr;
};
} // namespace gem5
#endif // __DEV_RESET_PORT_HH__