Parent class of all APIs modeled as 'services'. More...

#include <Services.h>

Inheritance diagram for esi::services::Service:

[legend]

Collaboration diagram for esi::services::Service:

[legend]

Public Types
using	Type = const std::type_info &

Public Member Functions
	Service (AcceleratorConnection &conn)

virtual	~Service ()=default

virtual std::string	getServiceSymbol () const =0

virtual Service *	getChildService (Service::Type service, AppIDPath id={}, std::string implName={}, ServiceImplDetails details={}, HWClientDetails clients={})
	Create a "child" service of this service.

virtual BundlePort *	getPort (AppIDPath id, const BundleType *type) const
	Get specialized port for this service to attach to the given appid path.

AcceleratorConnection &	getConnection () const

Protected Attributes
AcceleratorConnection &	conn

Detailed Description

Parent class of all APIs modeled as 'services'.

May or may not map to a hardware side 'service'.

Definition at line 46 of file Services.h.

Member Typedef Documentation

◆ Type

using esi::services::Service::Type = const std::type_info &

Definition at line 48 of file Services.h.

Constructor & Destructor Documentation

◆ Service()

esi::services::Service::Service ( AcceleratorConnection & conn )

inline

Definition at line 49 of file Services.h.

◆ ~Service()

virtual esi::services::Service::~Service ( )

virtualdefault

Member Function Documentation

◆ getChildService()

Service * Service::getChildService	(	Service::Type	service,
		AppIDPath	id = `{}`,
		std::string	implName = `{}`,
		ServiceImplDetails	details = `{}`,
		HWClientDetails	clients = `{}`
	)

virtual

Create a "child" service of this service.

Does not have to be the same service type, but typically is. Used when a service already exists in the active services table, but a new one wants to replace it. Useful for cases where the child service needs to use the parent service. Defaults to calling the getService method on AcceleratorConnection to get the global service, implying that the child service does not need to use the service it is replacing.

Reimplemented in esi::services::MMIO.

Definition at line 28 of file Services.cpp.

References conn, and esi::AcceleratorConnection::getService().

Referenced by esi::services::MMIO::getChildService().

◆ getConnection()

AcceleratorConnection & esi::services::Service::getConnection ( ) const

inline

Definition at line 72 of file Services.h.

References conn.

◆ getPort()

virtual BundlePort * esi::services::Service::getPort	(	AppIDPath	id,
		const BundleType *	type
	)		const

inlinevirtual

Get specialized port for this service to attach to the given appid path.

Null returns mean nothing to attach.

Reimplemented in esi::services::CustomService, esi::services::MMIO, esi::services::FuncService, and esi::services::CallService.

Definition at line 68 of file Services.h.

◆ getServiceSymbol()

virtual std::string esi::services::Service::getServiceSymbol ( ) const

pure virtual

Implemented in esi::services::CustomService, esi::services::SysInfo, esi::services::MMIO, esi::services::HostMem, esi::services::FuncService, and esi::services::CallService.

Member Data Documentation

◆ conn

AcceleratorConnection& esi::services::Service::conn

protected

Definition at line 75 of file Services.h.

Referenced by getChildService(), getConnection(), esi::services::CustomService::getPort(), esi::services::FuncService::getPort(), and esi::services::CallService::getPort().

The documentation for this class was generated from the following files:

/home/runner/work/circt-www/circt-www/circt_src/lib/Dialect/ESI/runtime/cpp/include/esi/Services.h
/home/runner/work/circt-www/circt-www/circt_src/lib/Dialect/ESI/runtime/cpp/lib/Services.cpp

Public Types

Public Member Functions

Protected Attributes