external_slave.hh (12492:4e76959883a6) external_slave.hh (13784:1941dc118243)
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

--- 53 unchanged lines hidden (view full) ---

62
63#include "mem/mem_object.hh"
64#include "params/ExternalSlave.hh"
65
66class ExternalSlave : public MemObject
67{
68 public:
69 /** Derive from this class to create an external port interface */
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

--- 53 unchanged lines hidden (view full) ---

62
63#include "mem/mem_object.hh"
64#include "params/ExternalSlave.hh"
65
66class ExternalSlave : public MemObject
67{
68 public:
69 /** Derive from this class to create an external port interface */
70 class Port : public SlavePort
70 class ExternalPort : public SlavePort
71 {
72 protected:
73 ExternalSlave &owner;
74
75 public:
71 {
72 protected:
73 ExternalSlave &owner;
74
75 public:
76 Port(const std::string &name_,
76 ExternalPort(const std::string &name_,
77 ExternalSlave &owner_) :
78 SlavePort(name_, &owner_), owner(owner_)
79 { }
80
77 ExternalSlave &owner_) :
78 SlavePort(name_, &owner_), owner(owner_)
79 { }
80
81 ~Port() { }
81 ~ExternalPort() { }
82
83 /** Any or all of recv... can be overloaded to provide the port's
84 * functionality */
85
86 AddrRangeList getAddrRanges() const;
87 };
88
89 /* Handlers are specific to *types* of port not specific port
90 * instantiations. A handler will typically build a bridge to the
91 * external port from gem5 and provide gem5 with a SlavePort that can be
92 * bound to for each call to Handler::getExternalPort.*/
93 class Handler
94 {
95 public:
96 /** Create or find an external port which can be bound. Returns
97 * NULL on failure */
82
83 /** Any or all of recv... can be overloaded to provide the port's
84 * functionality */
85
86 AddrRangeList getAddrRanges() const;
87 };
88
89 /* Handlers are specific to *types* of port not specific port
90 * instantiations. A handler will typically build a bridge to the
91 * external port from gem5 and provide gem5 with a SlavePort that can be
92 * bound to for each call to Handler::getExternalPort.*/
93 class Handler
94 {
95 public:
96 /** Create or find an external port which can be bound. Returns
97 * NULL on failure */
98 virtual Port *getExternalPort(
98 virtual ExternalPort *getExternalPort(
99 const std::string &name, ExternalSlave &owner,
100 const std::string &port_data) = 0;
101 };
102
103 protected:
104 /** The peer port for the gem5 port "port" */
99 const std::string &name, ExternalSlave &owner,
100 const std::string &port_data) = 0;
101 };
102
103 protected:
104 /** The peer port for the gem5 port "port" */
105 Port *externalPort;
105 ExternalPort *externalPort;
106
107 /** Name of the bound port. This will be name() + ".port" */
108 std::string portName;
109
110 /** Key to select a port handler */
111 std::string portType;
112
113 /** Handler-specific port configuration */

--- 7 unchanged lines hidden (view full) ---

121 * parameter on ExternalSlaves. port_types form a global namespace
122 * across the simulation and so handlers are registered into a global
123 * structure */
124 static std::map<std::string, Handler *> portHandlers;
125
126 public:
127 ExternalSlave(ExternalSlaveParams *params);
128
106
107 /** Name of the bound port. This will be name() + ".port" */
108 std::string portName;
109
110 /** Key to select a port handler */
111 std::string portType;
112
113 /** Handler-specific port configuration */

--- 7 unchanged lines hidden (view full) ---

121 * parameter on ExternalSlaves. port_types form a global namespace
122 * across the simulation and so handlers are registered into a global
123 * structure */
124 static std::map<std::string, Handler *> portHandlers;
125
126 public:
127 ExternalSlave(ExternalSlaveParams *params);
128
129 /** SlavePort interface. Responds only to port "port" */
130 BaseSlavePort &getSlavePort(const std::string &if_name,
131 PortID idx = InvalidPortID);
129 /** Port interface. Responds only to port "port" */
130 Port &getPort(const std::string &if_name,
131 PortID idx=InvalidPortID) override;
132
133 /** Register a handler which can provide ports with port_type ==
134 * handler_name */
135 static void registerHandler(const std::string &handler_name,
136 Handler *handler);
137
138 void init();
139};
140
141
142#endif //__MEM_EXTERNAL_SLAVE_HH__
132
133 /** Register a handler which can provide ports with port_type ==
134 * handler_name */
135 static void registerHandler(const std::string &handler_name,
136 Handler *handler);
137
138 void init();
139};
140
141
142#endif //__MEM_EXTERNAL_SLAVE_HH__