112027Sjungma@eit.uni-kl.de/***************************************************************************** 212027Sjungma@eit.uni-kl.de 312027Sjungma@eit.uni-kl.de Licensed to Accellera Systems Initiative Inc. (Accellera) under one or 412027Sjungma@eit.uni-kl.de more contributor license agreements. See the NOTICE file distributed 512027Sjungma@eit.uni-kl.de with this work for additional information regarding copyright ownership. 612027Sjungma@eit.uni-kl.de Accellera licenses this file to you under the Apache License, Version 2.0 712027Sjungma@eit.uni-kl.de (the "License"); you may not use this file except in compliance with the 812027Sjungma@eit.uni-kl.de License. You may obtain a copy of the License at 912027Sjungma@eit.uni-kl.de 1012027Sjungma@eit.uni-kl.de http://www.apache.org/licenses/LICENSE-2.0 1112027Sjungma@eit.uni-kl.de 1212027Sjungma@eit.uni-kl.de Unless required by applicable law or agreed to in writing, software 1312027Sjungma@eit.uni-kl.de distributed under the License is distributed on an "AS IS" BASIS, 1412027Sjungma@eit.uni-kl.de WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 1512027Sjungma@eit.uni-kl.de implied. See the License for the specific language governing 1612027Sjungma@eit.uni-kl.de permissions and limitations under the License. 1712027Sjungma@eit.uni-kl.de 1812027Sjungma@eit.uni-kl.de *****************************************************************************/ 1912027Sjungma@eit.uni-kl.de 2012027Sjungma@eit.uni-kl.de/***************************************************************************** 2112027Sjungma@eit.uni-kl.de 2212027Sjungma@eit.uni-kl.de sc_semaphore.h -- The sc_semaphore primitive channel class. 2312027Sjungma@eit.uni-kl.de 2412027Sjungma@eit.uni-kl.de Original Author: Martin Janssen, Synopsys, Inc., 2001-05-21 2512027Sjungma@eit.uni-kl.de 2612027Sjungma@eit.uni-kl.de CHANGE LOG IS AT THE END OF THE FILE 2712027Sjungma@eit.uni-kl.de *****************************************************************************/ 2812027Sjungma@eit.uni-kl.de 2912027Sjungma@eit.uni-kl.de#ifndef SC_SEMAPHORE_H 3012027Sjungma@eit.uni-kl.de#define SC_SEMAPHORE_H 3112027Sjungma@eit.uni-kl.de 3212027Sjungma@eit.uni-kl.de 3312027Sjungma@eit.uni-kl.de#include "sysc/kernel/sc_event.h" 3412027Sjungma@eit.uni-kl.de#include "sysc/kernel/sc_object.h" 3512027Sjungma@eit.uni-kl.de#include "sysc/communication/sc_semaphore_if.h" 3612027Sjungma@eit.uni-kl.de 3712027Sjungma@eit.uni-kl.denamespace sc_core { 3812027Sjungma@eit.uni-kl.de 3912027Sjungma@eit.uni-kl.de// ---------------------------------------------------------------------------- 4012027Sjungma@eit.uni-kl.de// CLASS : sc_semaphore 4112027Sjungma@eit.uni-kl.de// 4212027Sjungma@eit.uni-kl.de// The sc_semaphore primitive channel class. 4312027Sjungma@eit.uni-kl.de// ---------------------------------------------------------------------------- 4412027Sjungma@eit.uni-kl.de 4512027Sjungma@eit.uni-kl.declass sc_semaphore 4612027Sjungma@eit.uni-kl.de: public sc_semaphore_if, 4712027Sjungma@eit.uni-kl.de public sc_object 4812027Sjungma@eit.uni-kl.de{ 4912027Sjungma@eit.uni-kl.depublic: 5012027Sjungma@eit.uni-kl.de 5112027Sjungma@eit.uni-kl.de // constructors 5212027Sjungma@eit.uni-kl.de 5312027Sjungma@eit.uni-kl.de explicit sc_semaphore( int init_value_ ); 5412027Sjungma@eit.uni-kl.de sc_semaphore( const char* name_, int init_value_ ); 5512027Sjungma@eit.uni-kl.de 5612027Sjungma@eit.uni-kl.de 5712027Sjungma@eit.uni-kl.de // interface methods 5812027Sjungma@eit.uni-kl.de 5912027Sjungma@eit.uni-kl.de // lock (take) the semaphore, block if not available 6012027Sjungma@eit.uni-kl.de virtual int wait(); 6112027Sjungma@eit.uni-kl.de 6212027Sjungma@eit.uni-kl.de // lock (take) the semaphore, return -1 if not available 6312027Sjungma@eit.uni-kl.de virtual int trywait(); 6412027Sjungma@eit.uni-kl.de 6512027Sjungma@eit.uni-kl.de // unlock (give) the semaphore 6612027Sjungma@eit.uni-kl.de virtual int post(); 6712027Sjungma@eit.uni-kl.de 6812027Sjungma@eit.uni-kl.de // get the value of the semaphore 6912027Sjungma@eit.uni-kl.de virtual int get_value() const 7012027Sjungma@eit.uni-kl.de { return m_value; } 7112027Sjungma@eit.uni-kl.de 7212027Sjungma@eit.uni-kl.de virtual const char* kind() const 7312027Sjungma@eit.uni-kl.de { return "sc_semaphore"; } 7412027Sjungma@eit.uni-kl.de 7512027Sjungma@eit.uni-kl.deprotected: 7612027Sjungma@eit.uni-kl.de 7712027Sjungma@eit.uni-kl.de // support methods 7812027Sjungma@eit.uni-kl.de 7912027Sjungma@eit.uni-kl.de bool in_use() const 8012027Sjungma@eit.uni-kl.de { return ( m_value <= 0 ); } 8112027Sjungma@eit.uni-kl.de 8212027Sjungma@eit.uni-kl.de 8312027Sjungma@eit.uni-kl.de // error reporting 8412027Sjungma@eit.uni-kl.de void report_error( const char* id, const char* add_msg = 0 ) const; 8512027Sjungma@eit.uni-kl.de 8612027Sjungma@eit.uni-kl.deprotected: 8712027Sjungma@eit.uni-kl.de 8812027Sjungma@eit.uni-kl.de sc_event m_free; // event to block on when m_value is negative 8912027Sjungma@eit.uni-kl.de int m_value; // current value of the semaphore 9012027Sjungma@eit.uni-kl.de 9112027Sjungma@eit.uni-kl.deprivate: 9212027Sjungma@eit.uni-kl.de 9312027Sjungma@eit.uni-kl.de // disabled 9412027Sjungma@eit.uni-kl.de sc_semaphore( const sc_semaphore& ); 9512027Sjungma@eit.uni-kl.de sc_semaphore& operator = ( const sc_semaphore& ); 9612027Sjungma@eit.uni-kl.de}; 9712027Sjungma@eit.uni-kl.de 9812027Sjungma@eit.uni-kl.de} // namespace sc_core 9912027Sjungma@eit.uni-kl.de 10012027Sjungma@eit.uni-kl.de//$Log: sc_semaphore.h,v $ 10112027Sjungma@eit.uni-kl.de//Revision 1.4 2011/08/26 20:45:42 acg 10212027Sjungma@eit.uni-kl.de// Andy Goodrich: moved the modification log to the end of the file to 10312027Sjungma@eit.uni-kl.de// eliminate source line number skew when check-ins are done. 10412027Sjungma@eit.uni-kl.de// 10512027Sjungma@eit.uni-kl.de//Revision 1.3 2011/02/18 20:23:45 acg 10612027Sjungma@eit.uni-kl.de// Andy Goodrich: Copyright update. 10712027Sjungma@eit.uni-kl.de// 10812027Sjungma@eit.uni-kl.de//Revision 1.2 2010/11/02 16:31:01 acg 10912027Sjungma@eit.uni-kl.de// Andy Goodrich: changed object derivation to use sc_object rather than 11012027Sjungma@eit.uni-kl.de// sc_prim_channel as the parent class. 11112027Sjungma@eit.uni-kl.de// 11212027Sjungma@eit.uni-kl.de//Revision 1.1.1.1 2006/12/15 20:20:04 acg 11312027Sjungma@eit.uni-kl.de//SystemC 2.3 11412027Sjungma@eit.uni-kl.de// 11512027Sjungma@eit.uni-kl.de//Revision 1.4 2006/11/28 20:30:49 acg 11612027Sjungma@eit.uni-kl.de// Andy Goodrich: updated from 2.2 source. sc_event_queue constructors 11712027Sjungma@eit.uni-kl.de// collapsed into a single constructor with an optional argument to get 11812027Sjungma@eit.uni-kl.de// the sc_module_name stack done correctly. Class name prefixing added 11912027Sjungma@eit.uni-kl.de// to sc_semaphore calls to wait() to keep gcc 4.x happy. 12012027Sjungma@eit.uni-kl.de// 12112027Sjungma@eit.uni-kl.de//Revision 1.2 2006/01/03 23:18:26 acg 12212027Sjungma@eit.uni-kl.de//Changed copyright to include 2006. 12312027Sjungma@eit.uni-kl.de// 12412027Sjungma@eit.uni-kl.de//Revision 1.1.1.1 2005/12/19 23:16:43 acg 12512027Sjungma@eit.uni-kl.de//First check in of SystemC 2.1 into its own archive. 12612027Sjungma@eit.uni-kl.de// 12712027Sjungma@eit.uni-kl.de//Revision 1.9 2005/06/10 22:43:55 acg 12812027Sjungma@eit.uni-kl.de//Added CVS change log annotation. 12912027Sjungma@eit.uni-kl.de// 13012027Sjungma@eit.uni-kl.de 13112027Sjungma@eit.uni-kl.de#endif 13212027Sjungma@eit.uni-kl.de 13312027Sjungma@eit.uni-kl.de// Taf! 134