From 7364acfc758a30f81aa75844f6b96b1e4e19990a Mon Sep 17 00:00:00 2001 From: Gabe Black Date: Sat, 8 Dec 2018 01:58:26 -0800 Subject: systemc: Initial import of TLM headers from Accellera. These headers will need to be cleaned up and have some Accellera specific quirks ironed out of them, but I'll do that in a later change to make it clear what those changes are. Change-Id: Ia4e08633ab552b4c616c66c9b7e2bbd78ebfe7b9 Reviewed-on: https://gem5-review.googlesource.com/c/15055 Reviewed-by: Anthony Gutierrez Maintainer: Anthony Gutierrez --- .../tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h | 149 +++++++++++++++++++++ .../tlm_req_rsp/tlm_1_interfaces/tlm_fifo_ifs.h | 85 ++++++++++++ .../tlm_1_interfaces/tlm_master_slave_ifs.h | 73 ++++++++++ .../tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_tag.h | 31 +++++ 4 files changed, 338 insertions(+) create mode 100644 src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h create mode 100644 src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_fifo_ifs.h create mode 100644 src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_master_slave_ifs.h create mode 100644 src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_tag.h (limited to 'src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces') diff --git a/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h new file mode 100644 index 000000000..4c1340338 --- /dev/null +++ b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h @@ -0,0 +1,149 @@ +/***************************************************************************** + + Licensed to Accellera Systems Initiative Inc. (Accellera) under one or + more contributor license agreements. See the NOTICE file distributed + with this work for additional information regarding copyright ownership. + Accellera licenses this file to you under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with the + License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied. See the License for the specific language governing + permissions and limitations under the License. + + *****************************************************************************/ + +// +// Note to the LRM writer : This is the core of the TLM standard +// + + +#ifndef __TLM_CORE_IFS_H__ +#define __TLM_CORE_IFS_H__ + +//#include + +#include "tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_tag.h" + +namespace tlm { + +// bidirectional blocking interfaces + +template < typename REQ , typename RSP > +class tlm_transport_if : public virtual sc_core::sc_interface +{ +public: + virtual RSP transport( const REQ & ) = 0; + + virtual void transport( const REQ &req , RSP &rsp ) { + rsp = transport( req ); + } + +}; + + +// uni-directional blocking interfaces + +template < typename T > +class tlm_blocking_get_if : public virtual sc_core::sc_interface +{ +public: + virtual T get( tlm_tag *t = 0 ) = 0; + virtual void get( T &t ) { t = get(); } + +}; + +template < typename T > +class tlm_blocking_put_if : public virtual sc_core::sc_interface +{ +public: + virtual void put( const T &t ) = 0; +}; + +// uni-directional non blocking interfaces + +template < typename T > +class tlm_nonblocking_get_if : public virtual sc_core::sc_interface +{ +public: + virtual bool nb_get( T &t ) = 0; + virtual bool nb_can_get( tlm_tag *t = 0 ) const = 0; + virtual const sc_core::sc_event &ok_to_get( tlm_tag *t = 0 ) const = 0; +}; + +template < typename T > +class tlm_nonblocking_put_if : public virtual sc_core::sc_interface +{ +public: + virtual bool nb_put( const T &t ) = 0; + virtual bool nb_can_put( tlm_tag *t = 0 ) const = 0; + virtual const sc_core::sc_event &ok_to_put( tlm_tag *t = 0 ) const = 0; +}; + + +// combined uni-directional blocking and non blocking + +template < typename T > +class tlm_get_if : + public virtual tlm_blocking_get_if< T > , + public virtual tlm_nonblocking_get_if< T > {}; + +template < typename T > +class tlm_put_if : + public virtual tlm_blocking_put_if< T > , + public virtual tlm_nonblocking_put_if< T > {}; + + +// peek interfaces + +template < typename T > +class tlm_blocking_peek_if : public virtual sc_core::sc_interface +{ +public: + virtual T peek( tlm_tag *t = 0 ) const = 0; + virtual void peek( T &t ) const { t = peek(); } + +}; + +template < typename T > +class tlm_nonblocking_peek_if : public virtual sc_core::sc_interface +{ +public: + virtual bool nb_peek( T &t ) const = 0; + virtual bool nb_can_peek( tlm_tag *t = 0 ) const = 0; + virtual const sc_core::sc_event &ok_to_peek( tlm_tag *t = 0 ) const = 0; +}; + +template < typename T > +class tlm_peek_if : + public virtual tlm_blocking_peek_if< T > , + public virtual tlm_nonblocking_peek_if< T > {}; + +// get_peek interfaces + +template < typename T > +class tlm_blocking_get_peek_if : + public virtual tlm_blocking_get_if , + public virtual tlm_blocking_peek_if {}; + +template < typename T > +class tlm_nonblocking_get_peek_if : + public virtual tlm_nonblocking_get_if , + public virtual tlm_nonblocking_peek_if {}; + + +template < typename T > +class tlm_get_peek_if : + public virtual tlm_get_if , + public virtual tlm_peek_if , + public virtual tlm_blocking_get_peek_if , + public virtual tlm_nonblocking_get_peek_if + {}; + +} // namespace tlm + +#endif diff --git a/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_fifo_ifs.h b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_fifo_ifs.h new file mode 100644 index 000000000..d9b2b985b --- /dev/null +++ b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_fifo_ifs.h @@ -0,0 +1,85 @@ +/***************************************************************************** + + Licensed to Accellera Systems Initiative Inc. (Accellera) under one or + more contributor license agreements. See the NOTICE file distributed + with this work for additional information regarding copyright ownership. + Accellera licenses this file to you under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with the + License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied. See the License for the specific language governing + permissions and limitations under the License. + + *****************************************************************************/ + +// +// Note to the LRM writer : These interfaces are channel specific interfaces +// useful in the context of tlm_fifo. +// + +#ifndef __TLM_FIFO_IFS_H__ +#define __TLM_FIFO_IFS_H__ + +#include "tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h" + +namespace tlm { + +// +// Fifo specific interfaces +// + +// Fifo Debug Interface + +template< typename T > +class tlm_fifo_debug_if : public virtual sc_core::sc_interface +{ +public: + virtual int used() const = 0; + virtual int size() const = 0; + virtual void debug() const = 0; + + // + // non blocking peek and poke - no notification + // + // n is index of data : + // 0 <= n < size(), where 0 is most recently written, and size() - 1 + // is oldest ie the one about to be read. + // + + virtual bool nb_peek( T & , int n ) const = 0; + virtual bool nb_poke( const T & , int n = 0 ) = 0; + +}; + +// fifo interfaces = extended + debug + +template < typename T > +class tlm_fifo_put_if : + public virtual tlm_put_if , + public virtual tlm_fifo_debug_if {}; + +template < typename T > +class tlm_fifo_get_if : + public virtual tlm_get_peek_if , + public virtual tlm_fifo_debug_if {}; + +class tlm_fifo_config_size_if : public virtual sc_core::sc_interface +{ +public: + virtual void nb_expand( unsigned int n = 1 ) = 0; + virtual void nb_unbound( unsigned int n = 16 ) = 0; + + virtual bool nb_reduce( unsigned int n = 1 ) = 0; + virtual bool nb_bound( unsigned int n ) = 0; + +}; + +} // namespace tlm + +#endif + diff --git a/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_master_slave_ifs.h b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_master_slave_ifs.h new file mode 100644 index 000000000..5bac3c877 --- /dev/null +++ b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_master_slave_ifs.h @@ -0,0 +1,73 @@ +/***************************************************************************** + + Licensed to Accellera Systems Initiative Inc. (Accellera) under one or + more contributor license agreements. See the NOTICE file distributed + with this work for additional information regarding copyright ownership. + Accellera licenses this file to you under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with the + License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied. See the License for the specific language governing + permissions and limitations under the License. + + *****************************************************************************/ + +#ifndef __TLM_MASTER_SLAVE_IFS_H__ +#define __TLM_MASTER_SLAVE_IFS_H__ + +#include "tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_core_ifs.h" + +namespace tlm { + +// +// req/rsp combined interfaces +// + +// blocking + +template < typename REQ , typename RSP> +class tlm_blocking_master_if : + public virtual tlm_blocking_put_if< REQ > , + public virtual tlm_blocking_get_peek_if< RSP > {}; + +template < typename REQ , typename RSP> +class tlm_blocking_slave_if : + public virtual tlm_blocking_put_if< RSP > , + public virtual tlm_blocking_get_peek_if< REQ > {}; + +// nonblocking + +template < typename REQ , typename RSP > +class tlm_nonblocking_master_if : + public virtual tlm_nonblocking_put_if< REQ > , + public virtual tlm_nonblocking_get_peek_if< RSP > {}; + +template < typename REQ , typename RSP > +class tlm_nonblocking_slave_if : + public virtual tlm_nonblocking_put_if< RSP > , + public virtual tlm_nonblocking_get_peek_if< REQ > {}; + +// combined + +template < typename REQ , typename RSP > +class tlm_master_if : + public virtual tlm_put_if< REQ > , + public virtual tlm_get_peek_if< RSP > , + public virtual tlm_blocking_master_if< REQ , RSP > , + public virtual tlm_nonblocking_master_if< REQ , RSP > {}; + +template < typename REQ , typename RSP > +class tlm_slave_if : + public virtual tlm_put_if< RSP > , + public virtual tlm_get_peek_if< REQ > , + public virtual tlm_blocking_slave_if< REQ , RSP > , + public virtual tlm_nonblocking_slave_if< REQ , RSP > {}; + +} // namespace tlm + +#endif diff --git a/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_tag.h b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_tag.h new file mode 100644 index 000000000..230b77d17 --- /dev/null +++ b/src/systemc/ext/tlm_core/tlm_1/tlm_req_rsp/tlm_1_interfaces/tlm_tag.h @@ -0,0 +1,31 @@ +/***************************************************************************** + + Licensed to Accellera Systems Initiative Inc. (Accellera) under one or + more contributor license agreements. See the NOTICE file distributed + with this work for additional information regarding copyright ownership. + Accellera licenses this file to you under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with the + License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied. See the License for the specific language governing + permissions and limitations under the License. + + *****************************************************************************/ + +// +// Note to the LRM writer : This is part of the core TLM standard +// + +#ifndef __TLM_TAG_H__ +#define __TLM_TAG_H__ + +namespace tlm { +template class tlm_tag {}; +} + +#endif -- cgit v1.2.3