gem5  v21.1.0.2
external_slave.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012-2014 ARM Limited
3  * All rights reserved
4  *
5  * The license below extends only to copyright in the software and shall
6  * not be construed as granting a license to any other intellectual
7  * property including but not limited to intellectual property relating
8  * to a hardware implementation of the functionality of the software
9  * licensed hereunder. You may use the software subject to the license
10  * terms below provided that you ensure that this notice is replicated
11  * unmodified and in its entirety in all distributions of the software,
12  * modified or unmodified, in source code or in binary form.
13  *
14  * Redistribution and use in source and binary forms, with or without
15  * modification, are permitted provided that the following conditions are
16  * met: redistributions of source code must retain the above copyright
17  * notice, this list of conditions and the following disclaimer;
18  * redistributions in binary form must reproduce the above copyright
19  * notice, this list of conditions and the following disclaimer in the
20  * documentation and/or other materials provided with the distribution;
21  * neither the name of the copyright holders nor the names of its
22  * contributors may be used to endorse or promote products derived from
23  * this software without specific prior written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36  */
37 
58 #ifndef __MEM_EXTERNAL_SLAVE_HH__
59 #define __MEM_EXTERNAL_SLAVE_HH__
60 
61 #include "mem/port.hh"
62 #include "params/ExternalSlave.hh"
63 #include "sim/sim_object.hh"
64 
65 namespace gem5
66 {
67 
68 class ExternalSlave : public SimObject
69 {
70  public:
72  class ExternalPort : public SlavePort
73  {
74  protected:
76 
77  public:
78  ExternalPort(const std::string &name_,
79  ExternalSlave &owner_) :
80  SlavePort(name_, &owner_), owner(owner_)
81  { }
82 
84 
89  };
90 
91  /* Handlers are specific to *types* of port not specific port
92  * instantiations. A handler will typically build a bridge to the
93  * external port from gem5 and provide gem5 with a SlavePort that can be
94  * bound to for each call to Handler::getExternalPort.*/
95  class Handler
96  {
97  public:
100  virtual ExternalPort *getExternalPort(
101  const std::string &name, ExternalSlave &owner,
102  const std::string &port_data) = 0;
103  };
104 
105  protected:
108 
110  std::string portName;
111 
113  std::string portType;
114 
116  std::string portData;
117 
121 
126  static std::map<std::string, Handler *> portHandlers;
127 
128  public:
129  ExternalSlave(const ExternalSlaveParams &params);
130 
132  Port &getPort(const std::string &if_name,
133  PortID idx=InvalidPortID) override;
134 
137  static void registerHandler(const std::string &handler_name,
138  Handler *handler);
139 
140  void init() override;
141 };
142 
143 } // namespace gem5
144 
145 #endif //__MEM_EXTERNAL_SLAVE_HH__
gem5::PortID
int16_t PortID
Port index/ID type, and a symbolic name for an invalid port id.
Definition: types.hh:252
gem5::ExternalSlave
Definition: external_slave.hh:68
gem5::ExternalSlave::registerHandler
static void registerHandler(const std::string &handler_name, Handler *handler)
Register a handler which can provide ports with port_type == handler_name.
Definition: external_slave.cc:238
gem5::ExternalSlave::portName
std::string portName
Name of the bound port.
Definition: external_slave.hh:110
gem5::ExternalSlave::portType
std::string portType
Key to select a port handler.
Definition: external_slave.hh:113
gem5::ExternalSlave::portData
std::string portData
Handler-specific port configuration.
Definition: external_slave.hh:116
gem5::ExternalSlave::ExternalPort
Derive from this class to create an external port interface.
Definition: external_slave.hh:72
gem5::InvalidPortID
const PortID InvalidPortID
Definition: types.hh:253
gem5::ExternalSlave::getPort
Port & getPort(const std::string &if_name, PortID idx=InvalidPortID) override
Port interface.
Definition: external_slave.cc:199
gem5::ExternalSlave::ExternalPort::ExternalPort
ExternalPort(const std::string &name_, ExternalSlave &owner_)
Definition: external_slave.hh:78
gem5::ExternalSlave::ExternalPort::owner
ExternalSlave & owner
Definition: external_slave.hh:75
gem5::ExternalSlave::init
void init() override
init() is called after all C++ SimObjects have been created and all ports are connected.
Definition: external_slave.cc:226
gem5::Named::name
virtual std::string name() const
Definition: named.hh:47
gem5::SimObject::params
const Params & params() const
Definition: sim_object.hh:176
sim_object.hh
gem5::SlavePort
Definition: port.hh:455
gem5::ExternalSlave::Handler
Definition: external_slave.hh:95
gem5::ExternalSlave::externalPort
ExternalPort * externalPort
The peer port for the gem5 port "port".
Definition: external_slave.hh:107
port.hh
gem5::ExternalSlave::ExternalPort::~ExternalPort
~ExternalPort()
Definition: external_slave.hh:83
gem5::SimObject
Abstract superclass for simulation objects.
Definition: sim_object.hh:146
gem5::ExternalSlave::portHandlers
static std::map< std::string, Handler * > portHandlers
Registered handlers.
Definition: external_slave.hh:126
gem5::Port
Ports are used to interface objects to each other.
Definition: port.hh:61
gem5::ExternalSlave::ExternalSlave
ExternalSlave(const ExternalSlaveParams &params)
Definition: external_slave.cc:185
gem5::ExternalSlave::ExternalPort::getAddrRanges
AddrRangeList getAddrRanges() const
Any or all of recv...
Definition: external_slave.cc:180
std::list< AddrRange >
gem5::ExternalSlave::addrRanges
AddrRangeList addrRanges
The Range of addresses supported by the devices on the external side of this port.
Definition: external_slave.hh:120
gem5::ExternalSlave::Handler::getExternalPort
virtual ExternalPort * getExternalPort(const std::string &name, ExternalSlave &owner, const std::string &port_data)=0
Create or find an external port which can be bound.
gem5
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
Definition: decoder.cc:40

Generated on Tue Sep 21 2021 12:25:32 for gem5 by doxygen 1.8.17