| /***************************************************************************** |
| |
| 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. |
| |
| *****************************************************************************/ |
| |
| /***************************************************************************** |
| |
| sc_thread_process.cpp -- Thread process implementation |
| |
| Original Author: Andy Goodrich, Forte Design Systems, 4 August 2005 |
| |
| CHANGE LOG AT THE END OF THE FILE |
| *****************************************************************************/ |
| |
| #include "sysc/kernel/sc_cmnhdr.h" |
| #include "sysc/kernel/sc_constants.h" |
| #include "sysc/kernel/sc_thread_process.h" |
| #include "sysc/kernel/sc_process_handle.h" |
| #include "sysc/kernel/sc_simcontext_int.h" |
| #include "sysc/kernel/sc_module.h" |
| #include "sysc/utils/sc_machine.h" |
| |
| // DEBUGGING MACROS: |
| // |
| // DEBUG_MSG(NAME,P,MSG) |
| // MSG = message to print |
| // NAME = name that must match the process for the message to print, or |
| // null if the message should be printed unconditionally. |
| // P = pointer to process message is for, or NULL in which case the |
| // message will not print. |
| #if 0 |
| # define DEBUG_NAME "" |
| # define DEBUG_MSG(NAME,P,MSG) \ |
| { \ |
| if ( P && ( (strlen(NAME)==0) || !strcmp(NAME,P->name())) ) \ |
| std::cout << "**** " << sc_time_stamp() << " (" \ |
| << sc_get_current_process_name() << "): " << MSG \ |
| << " - " << P->name() << std::endl; \ |
| } |
| #else |
| # define DEBUG_MSG(NAME,P,MSG) |
| #endif |
| |
| |
| //------------------------------------------------------------------------------ |
| // user-defined default stack-size |
| //------------------------------------------------------------------------------ |
| #if defined(SC_OVERRIDE_DEFAULT_STACK_SIZE) |
| # define SC_DEFAULT_STACK_SIZE_ SC_OVERRIDE_DEFAULT_STACK_SIZE |
| |
| //------------------------------------------------------------------------------ |
| // architecture-specific default stack sizes |
| //------------------------------------------------------------------------------ |
| #elif !defined(SC_USE_PTHREADS) && (defined(__CYGWIN32__) || defined(__CYGWIN32)) |
| # define SC_DEFAULT_STACK_SIZE_ 0x50000 |
| |
| #elif defined(SC_LONG_64) || defined(__x86_64__) || defined(__LP64__) || \ |
| defined(_M_X64) || defined(_M_AMD64) |
| # define SC_DEFAULT_STACK_SIZE_ 0x40000 |
| |
| #else |
| # define SC_DEFAULT_STACK_SIZE_ 0x20000 |
| |
| #endif // SC_DEFAULT_STACK_SIZE_ |
| |
| |
| //------------------------------------------------------------------------------ |
| // force 16-byte alignment on coroutine entry functions, needed for |
| // QuickThreads (32-bit, see also fixes in qt/md/{i386,iX86_64}.[hs]), |
| // and MinGW32 / Cygwin32 compilers on Windows platforms |
| #if defined(__GNUC__) && !defined(__ICC) && !defined(__x86_64__) && \ |
| (__GNUC__ > 4 || __GNUC__ == 4 && __GNUC_MINOR__ > 1 ) |
| # define SC_ALIGNED_STACK_ \ |
| __attribute__((force_align_arg_pointer)) |
| #else |
| # define SC_ALIGNED_STACK_ /* empty */ |
| #endif |
| |
| |
| namespace sc_core { |
| |
| const int SC_DEFAULT_STACK_SIZE = SC_DEFAULT_STACK_SIZE_; |
| #undef SC_DEFAULT_STACK_SIZE_ |
| #undef SC_OVERRIDE_DEFAULT_STACK_SIZE |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_cor_fn" |
| // |
| // This function invokes the coroutine for the supplied object instance. |
| //------------------------------------------------------------------------------ |
| SC_ALIGNED_STACK_ |
| void sc_thread_cor_fn( void* arg ) |
| { |
| sc_simcontext* simc_p = sc_get_curr_simcontext(); |
| sc_thread_handle thread_h = RCAST<sc_thread_handle>( arg ); |
| |
| // PROCESS THE THREAD AND PROCESS ANY EXCEPTIONS THAT ARE THROWN: |
| |
| while( true ) { |
| |
| try { |
| thread_h->semantics(); |
| } |
| catch( sc_user ) { |
| continue; |
| } |
| catch( sc_halt ) { |
| ::std::cout << "Terminating process " |
| << thread_h->name() << ::std::endl; |
| } |
| catch( const sc_unwind_exception& ex ) { |
| ex.clear(); |
| if ( ex.is_reset() ) continue; |
| } |
| catch( ... ) { |
| sc_report* err_p = sc_handle_exception(); |
| thread_h->simcontext()->set_error( err_p ); |
| } |
| break; |
| } |
| |
| sc_process_b* active_p = sc_get_current_process_b(); |
| |
| // REMOVE ALL TRACES OF OUR THREAD FROM THE SIMULATORS DATA STRUCTURES: |
| |
| thread_h->disconnect_process(); |
| |
| // IF WE AREN'T ACTIVE MAKE SURE WE WON'T EXECUTE: |
| |
| if ( thread_h->next_runnable() != 0 ) |
| { |
| simc_p->remove_runnable_thread(thread_h); |
| } |
| |
| // IF WE ARE THE ACTIVE PROCESS ABORT OUR EXECUTION: |
| |
| |
| if ( active_p == (sc_process_b*)thread_h ) |
| { |
| |
| sc_core::sc_cor* x = simc_p->next_cor(); |
| simc_p->cor_pkg()->abort( x ); |
| } |
| |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::disable_process" |
| // |
| // This virtual method suspends this process and its children if requested to. |
| // descendants = indicator of whether this process' children should also |
| // be suspended |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::disable_process( |
| sc_descendant_inclusion_info descendants ) |
| { |
| |
| // IF NEEDED PROPOGATE THE DISABLE REQUEST THROUGH OUR DESCENDANTS: |
| |
| if ( descendants == SC_INCLUDE_DESCENDANTS ) |
| { |
| const std::vector<sc_object*>& children = get_child_objects(); |
| int child_n = children.size(); |
| |
| for ( int child_i = 0; child_i < child_n; child_i++ ) |
| { |
| sc_process_b* child_p = DCAST<sc_process_b*>(children[child_i]); |
| if ( child_p ) child_p->disable_process(descendants); |
| } |
| } |
| |
| // DON'T ALLOW CORNER CASE BY DEFAULT: |
| |
| if ( !sc_allow_process_control_corners ) |
| { |
| switch( m_trigger_type ) |
| { |
| case AND_LIST_TIMEOUT: |
| case EVENT_TIMEOUT: |
| case OR_LIST_TIMEOUT: |
| case TIMEOUT: |
| report_error(SC_ID_PROCESS_CONTROL_CORNER_CASE_, |
| "attempt to disable a thread with timeout wait"); |
| break; |
| default: |
| break; |
| } |
| } |
| |
| // DISABLE OUR OBJECT INSTANCE: |
| |
| m_state = m_state | ps_bit_disabled; |
| |
| // IF THIS CALL IS BEFORE THE SIMULATION DON'T RUN THE THREAD: |
| |
| if ( !sc_is_running() ) |
| { |
| m_state = m_state | ps_bit_ready_to_run; |
| simcontext()->remove_runnable_thread(this); |
| } |
| } |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::enable_process" |
| // |
| // This method resumes the execution of this process, and if requested, its |
| // descendants. If the process was suspended and has a resumption pending it |
| // will be dispatched in the next delta cycle. Otherwise the state will be |
| // adjusted to indicate it is no longer suspended, but no immediate execution |
| // will occur. |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::enable_process( |
| sc_descendant_inclusion_info descendants ) |
| { |
| |
| // IF NEEDED PROPOGATE THE ENABLE REQUEST THROUGH OUR DESCENDANTS: |
| |
| if ( descendants == SC_INCLUDE_DESCENDANTS ) |
| { |
| const std::vector<sc_object*>& children = get_child_objects(); |
| int child_n = children.size(); |
| |
| for ( int child_i = 0; child_i < child_n; child_i++ ) |
| { |
| sc_process_b* child_p = DCAST<sc_process_b*>(children[child_i]); |
| if ( child_p ) child_p->enable_process(descendants); |
| } |
| } |
| |
| // ENABLE THIS OBJECT INSTANCE: |
| // |
| // If it was disabled and ready to run then put it on the run queue. |
| |
| m_state = m_state & ~ps_bit_disabled; |
| if ( m_state == ps_bit_ready_to_run && sc_allow_process_control_corners ) |
| { |
| m_state = ps_normal; |
| if ( next_runnable() == 0 ) |
| simcontext()->push_runnable_thread(this); |
| } |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::kill_process" |
| // |
| // This method removes this object instance from use. It calls the |
| // sc_process_b::kill_process() method to perform low level clean up. Then |
| // it aborts this process if it is the active process. |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::kill_process(sc_descendant_inclusion_info descendants ) |
| { |
| |
| // IF THE SIMULATION HAS NOT BEEN INITIALIZED YET THAT IS AN ERROR: |
| |
| if ( !sc_is_running() ) |
| { |
| report_error( SC_ID_KILL_PROCESS_WHILE_UNITIALIZED_ ); |
| } |
| |
| // IF NEEDED PROPOGATE THE KILL REQUEST THROUGH OUR DESCENDANTS: |
| |
| if ( descendants == SC_INCLUDE_DESCENDANTS ) |
| { |
| const std::vector<sc_object*> children = get_child_objects(); |
| int child_n = children.size(); |
| |
| for ( int child_i = 0; child_i < child_n; child_i++ ) |
| { |
| sc_process_b* child_p = DCAST<sc_process_b*>(children[child_i]); |
| if ( child_p ) child_p->kill_process(descendants); |
| } |
| } |
| |
| // IF THE PROCESS IS CURRENTLY UNWINDING OR IS ALREADY A ZOMBIE |
| // IGNORE THE KILL: |
| |
| if ( m_unwinding ) |
| { |
| SC_REPORT_WARNING( SC_ID_PROCESS_ALREADY_UNWINDING_, name() ); |
| return; |
| } |
| |
| if ( m_state & ps_bit_zombie ) |
| return; |
| |
| // SET UP TO KILL THE PROCESS IF SIMULATION HAS STARTED: |
| // |
| // If the thread does not have a stack don't try the throw! |
| |
| if ( sc_is_running() && m_has_stack ) |
| { |
| m_throw_status = THROW_KILL; |
| m_wait_cycle_n = 0; |
| simcontext()->preempt_with(this); |
| } |
| |
| // IF THE SIMULATION HAS NOT STARTED REMOVE TRACES OF OUR PROCESS FROM |
| // EVENT QUEUES, ETC.: |
| |
| else |
| { |
| disconnect_process(); |
| } |
| } |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::prepare_for_simulation" |
| // |
| // This method prepares this object instance for simulation. It calls the |
| // coroutine package to create the actual thread. |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::prepare_for_simulation() |
| { |
| m_cor_p = simcontext()->cor_pkg()->create( m_stack_size, |
| sc_thread_cor_fn, this ); |
| m_cor_p->stack_protect( true ); |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::resume_process" |
| // |
| // This method resumes the execution of this process, and if requested, its |
| // descendants. If the process was suspended and has a resumption pending it |
| // will be dispatched in the next delta cycle. Otherwise the state will be |
| // adjusted to indicate it is no longer suspended, but no immediate execution |
| // will occur. |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::resume_process( |
| sc_descendant_inclusion_info descendants ) |
| { |
| |
| // IF NEEDED PROPOGATE THE RESUME REQUEST THROUGH OUR DESCENDANTS: |
| |
| if ( descendants == SC_INCLUDE_DESCENDANTS ) |
| { |
| const std::vector<sc_object*>& children = get_child_objects(); |
| int child_n = children.size(); |
| |
| for ( int child_i = 0; child_i < child_n; child_i++ ) |
| { |
| sc_process_b* child_p = DCAST<sc_process_b*>(children[child_i]); |
| if ( child_p ) child_p->resume_process(descendants); |
| } |
| } |
| |
| // BY DEFAULT THE CORNER CASE IS AN ERROR: |
| |
| if ( !sc_allow_process_control_corners && (m_state & ps_bit_disabled) && |
| (m_state & ps_bit_suspended) ) |
| { |
| m_state = m_state & ~ps_bit_suspended; |
| report_error(SC_ID_PROCESS_CONTROL_CORNER_CASE_, |
| "call to resume() on a disabled suspended thread"); |
| } |
| |
| // CLEAR THE SUSPENDED BIT: |
| |
| m_state = m_state & ~ps_bit_suspended; |
| |
| // RESUME OBJECT INSTANCE IF IT IS READY TO RUN: |
| |
| if ( m_state & ps_bit_ready_to_run ) |
| { |
| m_state = m_state & ~ps_bit_ready_to_run; |
| if ( next_runnable() == 0 ) |
| simcontext()->push_runnable_thread(this); |
| remove_dynamic_events(); // order important. |
| } |
| } |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::sc_thread_process" |
| // |
| // This is the object instance constructor for this class. |
| //------------------------------------------------------------------------------ |
| sc_thread_process::sc_thread_process( const char* name_p, bool free_host, |
| SC_ENTRY_FUNC method_p, sc_process_host* host_p, |
| const sc_spawn_options* opt_p |
| ): |
| sc_process_b( |
| name_p ? name_p : sc_gen_unique_name("thread_p"), |
| true, free_host, method_p, host_p, opt_p), |
| m_cor_p(0), m_monitor_q(), m_stack_size(SC_DEFAULT_STACK_SIZE), |
| m_wait_cycle_n(0) |
| { |
| |
| // CHECK IF THIS IS AN sc_module-BASED PROCESS AND SIMULATION HAS STARTED: |
| |
| if ( DCAST<sc_module*>(host_p) != 0 && sc_is_running() ) |
| { |
| report_error( SC_ID_MODULE_THREAD_AFTER_START_ ); |
| } |
| |
| // INITIALIZE VALUES: |
| // |
| // If there are spawn options use them. |
| |
| m_process_kind = SC_THREAD_PROC_; |
| |
| if (opt_p) { |
| m_dont_init = opt_p->m_dont_initialize; |
| if ( opt_p->m_stack_size ) m_stack_size = opt_p->m_stack_size; |
| |
| // traverse event sensitivity list |
| for (unsigned int i = 0; i < opt_p->m_sensitive_events.size(); i++) { |
| sc_sensitive::make_static_sensitivity( |
| this, *opt_p->m_sensitive_events[i]); |
| } |
| |
| // traverse port base sensitivity list |
| for ( unsigned int i = 0; i < opt_p->m_sensitive_port_bases.size(); i++) |
| { |
| sc_sensitive::make_static_sensitivity( |
| this, *opt_p->m_sensitive_port_bases[i]); |
| } |
| |
| // traverse interface sensitivity list |
| for ( unsigned int i = 0; i < opt_p->m_sensitive_interfaces.size(); i++) |
| { |
| sc_sensitive::make_static_sensitivity( |
| this, *opt_p->m_sensitive_interfaces[i]); |
| } |
| |
| // traverse event finder sensitivity list |
| for ( unsigned int i = 0; i < opt_p->m_sensitive_event_finders.size(); |
| i++) |
| { |
| sc_sensitive::make_static_sensitivity( |
| this, *opt_p->m_sensitive_event_finders[i]); |
| } |
| |
| // process any reset signal specification: |
| |
| opt_p->specify_resets(); |
| |
| } |
| |
| else |
| { |
| m_dont_init = false; |
| } |
| |
| } |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::~sc_thread_process" |
| // |
| // This is the object instance constructor for this class. |
| //------------------------------------------------------------------------------ |
| sc_thread_process::~sc_thread_process() |
| { |
| |
| // DESTROY THE COROUTINE FOR THIS THREAD: |
| |
| if( m_cor_p != 0 ) { |
| m_cor_p->stack_protect( false ); |
| delete m_cor_p; |
| m_cor_p = 0; |
| } |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::signal_monitors" |
| // |
| // This methods signals the list of monitors for this object instance. |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::signal_monitors(int type) |
| { |
| int mon_n; // # of monitors present. |
| |
| mon_n = m_monitor_q.size(); |
| for ( int mon_i = 0; mon_i < mon_n; mon_i++ ) |
| m_monitor_q[mon_i]->signal(this, type); |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::suspend_process" |
| // |
| // This virtual method suspends this process and its children if requested to. |
| // descendants = indicator of whether this process' children should also |
| // be suspended |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::suspend_process( |
| sc_descendant_inclusion_info descendants ) |
| { |
| |
| // IF NEEDED PROPOGATE THE SUSPEND REQUEST THROUGH OUR DESCENDANTS: |
| |
| if ( descendants == SC_INCLUDE_DESCENDANTS ) |
| { |
| const std::vector<sc_object*>& children = get_child_objects(); |
| int child_n = children.size(); |
| |
| for ( int child_i = 0; child_i < child_n; child_i++ ) |
| { |
| sc_process_b* child_p = DCAST<sc_process_b*>(children[child_i]); |
| if ( child_p ) child_p->suspend_process(descendants); |
| } |
| } |
| |
| // CORNER CASE CHECKS, THE FOLLOWING ARE ERRORS: |
| // (a) if this thread has a reset_signal_is specification |
| // (b) if this thread is in synchronous reset |
| |
| if ( !sc_allow_process_control_corners && m_has_reset_signal ) |
| { |
| report_error(SC_ID_PROCESS_CONTROL_CORNER_CASE_, |
| "attempt to suspend a thread that has a reset signal"); |
| } |
| else if ( !sc_allow_process_control_corners && m_sticky_reset ) |
| { |
| report_error(SC_ID_PROCESS_CONTROL_CORNER_CASE_, |
| "attempt to suspend a thread in synchronous reset"); |
| } |
| |
| // SUSPEND OUR OBJECT INSTANCE: |
| // |
| // (1) If we are on the runnable queue then set suspended and ready_to_run, |
| // and remove ourselves from the run queue. |
| // (2) If this is a self-suspension then a resume should cause immediate |
| // scheduling of the process, and we need to call suspend_me() here. |
| |
| m_state = m_state | ps_bit_suspended; |
| if ( next_runnable() != 0 ) |
| { |
| m_state = m_state | ps_bit_ready_to_run; |
| simcontext()->remove_runnable_thread( this ); |
| } |
| if ( sc_get_current_process_b() == DCAST<sc_process_b*>(this) ) |
| { |
| m_state = m_state | ps_bit_ready_to_run; |
| suspend_me(); |
| } |
| } |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::throw_reset" |
| // |
| // This virtual method is invoked when an reset is to be thrown. The |
| // method will cancel any dynamic waits. If the reset is asynchronous it will |
| // queue this object instance to be executed. |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::throw_reset( bool async ) |
| { |
| // IF THE PROCESS IS CURRENTLY UNWINDING OR IS ALREADY A ZOMBIE |
| // IGNORE THE RESET: |
| |
| if ( m_unwinding ) |
| { |
| SC_REPORT_WARNING( SC_ID_PROCESS_ALREADY_UNWINDING_, name() ); |
| return; |
| } |
| |
| if ( m_state & ps_bit_zombie ) |
| return; |
| |
| |
| // Set the throw type and clear any pending dynamic events: |
| |
| m_throw_status = async ? THROW_ASYNC_RESET : THROW_SYNC_RESET; |
| m_wait_cycle_n = 0; |
| |
| // If this is an asynchronous reset: |
| // |
| // (a) Cancel any dynamic events |
| // (b) Set the thread up for execution: |
| // (i) If we are in the execution phase do it now. |
| // (ii) If we are not queue it to execute next when we hit |
| // the execution phase. |
| |
| if ( async ) |
| { |
| m_state = m_state & ~ps_bit_ready_to_run; |
| remove_dynamic_events(); |
| if ( simcontext()->evaluation_phase() ) |
| { |
| simcontext()->preempt_with( this ); |
| } |
| else |
| { |
| if ( is_runnable() ) |
| simcontext()->remove_runnable_thread(this); |
| simcontext()->execute_thread_next(this); |
| } |
| } |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::throw_user" |
| // |
| // This virtual method is invoked when a user exception is to be thrown. |
| // If requested it will also throw the exception to the children of this |
| // object instance. The order of dispatch for the processes that are |
| // thrown the exception is from youngest child to oldest child and then |
| // this process instance. This means that this instance will be pushed onto |
| // the front of the simulator's runnable queue and then the children will |
| // be processed recursively. |
| // helper_p = helper object to use to throw the exception. |
| // descendants = indicator of whether this process' children should also |
| // be suspended |
| //------------------------------------------------------------------------------ |
| void sc_thread_process::throw_user( const sc_throw_it_helper& helper, |
| sc_descendant_inclusion_info descendants ) |
| { |
| |
| // IF THE SIMULATION IS NOT ACTAULLY RUNNING THIS IS AN ERROR: |
| |
| if ( sc_get_status() != SC_RUNNING ) |
| { |
| report_error( SC_ID_THROW_IT_WHILE_NOT_RUNNING_ ); |
| } |
| |
| // IF NEEDED PROPOGATE THE THROW REQUEST THROUGH OUR DESCENDANTS: |
| |
| if ( descendants == SC_INCLUDE_DESCENDANTS ) |
| { |
| const std::vector<sc_object*> children = get_child_objects(); |
| int child_n = children.size(); |
| |
| for ( int child_i = 0; child_i < child_n; child_i++ ) |
| { |
| sc_process_b* child_p = DCAST<sc_process_b*>(children[child_i]); |
| if ( child_p ) |
| { |
| DEBUG_MSG(DEBUG_NAME,child_p,"about to throw user on"); |
| child_p->throw_user(helper, descendants); |
| } |
| } |
| } |
| |
| // IF THE PROCESS IS CURRENTLY UNWINDING IGNORE THE THROW: |
| |
| if ( m_unwinding ) |
| { |
| SC_REPORT_WARNING( SC_ID_PROCESS_ALREADY_UNWINDING_, name() ); |
| return; |
| } |
| |
| // SET UP THE THROW REQUEST FOR THIS OBJECT INSTANCE AND QUEUE IT FOR |
| // EXECUTION: |
| |
| if( m_has_stack ) |
| { |
| remove_dynamic_events(); |
| DEBUG_MSG(DEBUG_NAME,this,"throwing user exception to"); |
| m_throw_status = THROW_USER; |
| if ( m_throw_helper_p != 0 ) delete m_throw_helper_p; |
| m_throw_helper_p = helper.clone(); |
| simcontext()->preempt_with( this ); |
| } |
| else |
| { |
| SC_REPORT_WARNING( SC_ID_THROW_IT_IGNORED_, name() ); |
| } |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_thread_process::trigger_dynamic" |
| // |
| // This method sets up a dynamic trigger on an event. |
| // |
| // Notes: |
| // (1) This method is identical to sc_method_process::trigger_dynamic(), |
| // but they cannot be combined as sc_process_b::trigger_dynamic() |
| // because the signatures things like sc_event::remove_dynamic() |
| // have different overloads for sc_thread_process* and sc_method_process*. |
| // So if you change code here you'll also need to change it in |
| // sc_method_process.cpp. |
| // |
| // Result is true if this process should be removed from the event's list, |
| // false if not. |
| //------------------------------------------------------------------------------ |
| bool sc_thread_process::trigger_dynamic( sc_event* e ) |
| { |
| // No time outs yet, and keep gcc happy. |
| |
| m_timed_out = false; |
| |
| // Escape cases: |
| // (a) If this thread issued the notify() don't schedule it for |
| // execution, but leave the sensitivity in place. |
| // (b) If this thread is already runnable can't trigger an event. |
| |
| // not possible for thread processes! |
| #if 0 // ! defined( SC_ENABLE_IMMEDIATE_SELF_NOTIFICATIONS ) |
| if ( sc_get_current_process_b() == (sc_process_b*)this ) |
| { |
| report_immediate_self_notification(); |
| return false; |
| } |
| #endif // SC_ENABLE_IMMEDIATE_SELF_NOTIFICATIONS |
| |
| if( is_runnable() ) |
| return true; |
| |
| // If a process is disabled then we ignore any events, leaving them enabled: |
| // |
| // But if this is a time out event we need to remove both it and the |
| // event that was being waited for. |
| |
| if ( m_state & ps_bit_disabled ) |
| { |
| if ( e == m_timeout_event_p ) |
| { |
| remove_dynamic_events( true ); |
| return true; |
| } |
| else |
| { |
| return false; |
| } |
| } |
| |
| |
| // Process based on the event type and current process state: |
| // |
| // Every case needs to set 'rc' and continue on to the end of |
| // this method to allow suspend processing to work correctly. |
| |
| switch( m_trigger_type ) |
| { |
| case EVENT: |
| m_event_p = 0; |
| m_trigger_type = STATIC; |
| break; |
| |
| case AND_LIST: |
| -- m_event_count; |
| if ( m_event_count == 0 ) |
| { |
| m_event_list_p->auto_delete(); |
| m_event_list_p = 0; |
| m_trigger_type = STATIC; |
| } |
| else |
| { |
| return true; |
| } |
| break; |
| |
| case OR_LIST: |
| m_event_list_p->remove_dynamic( this, e ); |
| m_event_list_p->auto_delete(); |
| m_event_list_p = 0; |
| m_trigger_type = STATIC; |
| break; |
| |
| case TIMEOUT: |
| m_trigger_type = STATIC; |
| break; |
| |
| case EVENT_TIMEOUT: |
| if ( e == m_timeout_event_p ) |
| { |
| m_timed_out = true; |
| m_event_p->remove_dynamic( this ); |
| m_event_p = 0; |
| m_trigger_type = STATIC; |
| } |
| else |
| { |
| m_timeout_event_p->cancel(); |
| m_timeout_event_p->reset(); |
| m_event_p = 0; |
| m_trigger_type = STATIC; |
| } |
| break; |
| |
| case OR_LIST_TIMEOUT: |
| if ( e == m_timeout_event_p ) |
| { |
| m_timed_out = true; |
| m_event_list_p->remove_dynamic( this, e ); |
| m_event_list_p->auto_delete(); |
| m_event_list_p = 0; |
| m_trigger_type = STATIC; |
| } |
| |
| else |
| { |
| m_timeout_event_p->cancel(); |
| m_timeout_event_p->reset(); |
| m_event_list_p->remove_dynamic( this, e ); |
| m_event_list_p->auto_delete(); |
| m_event_list_p = 0; |
| m_trigger_type = STATIC; |
| } |
| break; |
| |
| case AND_LIST_TIMEOUT: |
| if ( e == m_timeout_event_p ) |
| { |
| m_timed_out = true; |
| m_event_list_p->remove_dynamic( this, e ); |
| m_event_list_p->auto_delete(); |
| m_event_list_p = 0; |
| m_trigger_type = STATIC; |
| } |
| |
| else |
| { |
| -- m_event_count; |
| if ( m_event_count == 0 ) |
| { |
| m_timeout_event_p->cancel(); |
| m_timeout_event_p->reset(); |
| // no need to remove_dynamic |
| m_event_list_p->auto_delete(); |
| m_event_list_p = 0; |
| m_trigger_type = STATIC; |
| } |
| else |
| { |
| return true; |
| } |
| } |
| break; |
| |
| case STATIC: { |
| // we should never get here, but throw_it() can make it happen. |
| SC_REPORT_WARNING(SC_ID_NOT_EXPECTING_DYNAMIC_EVENT_NOTIFY_, name()); |
| return true; |
| } |
| } |
| |
| // If we get here then the thread is has satisfied its wait criteria, if |
| // its suspended mark its state as ready to run. If its not suspended then |
| // push it onto the runnable queue. |
| |
| if ( (m_state & ps_bit_suspended) ) |
| { |
| m_state = m_state | ps_bit_ready_to_run; |
| } |
| else |
| { |
| simcontext()->push_runnable_thread(this); |
| } |
| |
| return true; |
| } |
| |
| |
| //------------------------------------------------------------------------------ |
| //"sc_set_stack_size" |
| // |
| //------------------------------------------------------------------------------ |
| void |
| sc_set_stack_size( sc_thread_handle thread_h, std::size_t size ) |
| { |
| thread_h->set_stack_size( size ); |
| } |
| |
| #undef DEBUG_MSG |
| #undef DEBUG_NAME |
| |
| } // namespace sc_core |
| |
| |
| /***************************************************************************** |
| |
| MODIFICATION LOG - modifiers, enter your name, affiliation, date and |
| changes you are making here. |
| |
| Name, Affiliation, Date: |
| Description of Modification: |
| |
| *****************************************************************************/ |
| |
| // $Log: sc_thread_process.cpp,v $ |
| // Revision 1.57 2011/08/24 22:05:51 acg |
| // Torsten Maehne: initialization changes to remove warnings. |
| // |
| // Revision 1.56 2011/08/07 19:08:04 acg |
| // Andy Goodrich: moved logs to end of file so line number synching works |
| // better between versions. |
| // |
| // Revision 1.55 2011/08/04 17:16:22 acg |
| // Philipp A. Hartmann: fix handling of child objects in kill routine, need |
| // to use a copy rather than a reference. |
| // |
| // Revision 1.53 2011/07/29 22:45:38 acg |
| // Philipp A. Hartmann: changes to handle case where a process control |
| // invocation on a child process causes the list of child processes to change. |
| // |
| // Revision 1.52 2011/07/24 11:27:04 acg |
| // Andy Goodrich: moved the check for unwinding processes until after the |
| // descendants have been processed in throw_user and kill. |
| // |
| // Revision 1.51 2011/07/24 11:20:03 acg |
| // Philipp A. Hartmann: process control error message improvements: |
| // (1) Downgrade error to warning for re-kills of processes. |
| // (2) Add process name to process messages. |
| // (3) drop some superfluous colons in messages. |
| // |
| // Revision 1.50 2011/05/09 04:07:49 acg |
| // Philipp A. Hartmann: |
| // (1) Restore hierarchy in all phase callbacks. |
| // (2) Ensure calls to before_end_of_elaboration. |
| // |
| // Revision 1.49 2011/05/05 17:45:27 acg |
| // Philip A. Hartmann: changes in WIN64 support. |
| // Andy Goodrich: additional DEBUG_MSG instances to trace process handling. |
| // |
| // Revision 1.48 2011/04/19 15:04:27 acg |
| // Philipp A. Hartmann: clean up SC_ID messages. |
| // |
| // Revision 1.47 2011/04/19 02:39:09 acg |
| // Philipp A. Hartmann: added checks for additional throws during stack unwinds. |
| // |
| // Revision 1.46 2011/04/14 22:33:43 acg |
| // Andy Goodrich: added missing checks for a process being a zombie. |
| // |
| // Revision 1.45 2011/04/13 02:45:11 acg |
| // Andy Goodrich: eliminated warning message that occurred if the DEBUG_MSG |
| // macro was used. |
| // |
| // Revision 1.44 2011/04/11 22:04:33 acg |
| // Andy Goodrich: use the DEBUG_NAME macro for DEBUG_MSG messages. |
| // |
| // Revision 1.43 2011/04/10 22:12:32 acg |
| // Andy Goodrich: adding debugging macros. |
| // |
| // Revision 1.42 2011/04/08 22:40:26 acg |
| // Andy Goodrich: moved the reset event notification code out of throw_reset() |
| // and into suspend_me. |
| // |
| // Revision 1.41 2011/04/08 18:24:07 acg |
| // Andy Goodrich: fix asynchronous reset dispatch and when the reset_event() |
| // is fired. |
| // |
| // Revision 1.40 2011/04/05 20:50:57 acg |
| // Andy Goodrich: |
| // (1) changes to make sure that event(), posedge() and negedge() only |
| // return true if the clock has not moved. |
| // (2) fixes for method self-resumes. |
| // (3) added SC_PRERELEASE_VERSION |
| // (4) removed kernel events from the object hierarchy, added |
| // sc_hierarchy_name_exists(). |
| // |
| // Revision 1.39 2011/04/01 22:30:39 acg |
| // Andy Goodrich: change hard assertion to warning for trigger_dynamic() |
| // getting called when there is only STATIC sensitivity. This can result |
| // because of sc_process_handle::throw_it(). |
| // |
| // Revision 1.38 2011/03/23 16:17:52 acg |
| // Andy Goodrich: don't emit an error message for a resume on a disabled |
| // process that is not suspended. |
| // |
| // Revision 1.37 2011/03/20 13:43:23 acg |
| // Andy Goodrich: added async_signal_is() plus suspend() as a corner case. |
| // |
| // Revision 1.36 2011/03/08 20:49:31 acg |
| // Andy Goodrich: implement coarse checking for synchronous reset - suspend |
| // interaction. |
| // |
| // Revision 1.35 2011/03/08 20:32:28 acg |
| // Andy Goodrich: implemented "coarse" checking for undefined process |
| // control interactions. |
| // |
| // Revision 1.34 2011/03/07 18:25:19 acg |
| // Andy Goodrich: tightening of check for resume on a disabled process to |
| // only produce an error if it is ready to run. |
| // |
| // Revision 1.33 2011/03/07 17:38:44 acg |
| // Andy Goodrich: tightening up of checks for undefined interaction between |
| // synchronous reset and suspend. |
| // |
| // Revision 1.32 2011/03/06 23:30:13 acg |
| // Andy Goodrich: refining suspend - sync reset corner case checking so that |
| // the following are error situations: |
| // (1) Calling suspend on a process with a reset_signal_is() specification |
| // or sync_reset_on() is active. |
| // (2) Calling sync_reset_on() on a suspended process. |
| // |
| // Revision 1.31 2011/03/06 19:57:11 acg |
| // Andy Goodrich: refinements for the illegal suspend - synchronous reset |
| // interaction. |
| // |
| // Revision 1.30 2011/03/06 16:47:09 acg |
| // Andy Goodrich: changes for testing sync_reset - suspend corner cases. |
| // |
| // Revision 1.29 2011/03/06 15:59:23 acg |
| // Andy Goodrich: added process control corner case checks. |
| // |
| // Revision 1.28 2011/03/05 19:44:20 acg |
| // Andy Goodrich: changes for object and event naming and structures. |
| // |
| // Revision 1.27 2011/02/19 08:30:53 acg |
| // Andy Goodrich: Moved process queueing into trigger_static from |
| // sc_event::notify. |
| // |
| // Revision 1.26 2011/02/18 20:27:14 acg |
| // Andy Goodrich: Updated Copyrights. |
| // |
| // Revision 1.25 2011/02/17 19:54:33 acg |
| // Andy Goodrich: |
| // (1) Changed signature of trigger_dynamic() back to bool, and moved |
| // run queue processing into trigger_dynamic. |
| // (2) Simplified process control usage. |
| // |
| // Revision 1.24 2011/02/16 22:37:31 acg |
| // Andy Goodrich: clean up to remove need for ps_disable_pending. |
| // |
| // Revision 1.23 2011/02/14 17:51:40 acg |
| // Andy Goodrich: proper pushing an poppping of the module hierarchy for |
| // start_of_simulation() and end_of_simulation. |
| // |
| // Revision 1.22 2011/02/13 23:09:58 acg |
| // Andy Goodrich: only remove dynamic events for asynchronous resets. |
| // |
| // Revision 1.21 2011/02/13 21:47:38 acg |
| // Andy Goodrich: update copyright notice. |
| // |
| // Revision 1.20 2011/02/13 21:37:13 acg |
| // Andy Goodrich: removed temporary diagnostic. Also there is |
| // remove_dynamic_events() call in reset code. |
| // |
| // Revision 1.19 2011/02/13 21:35:09 acg |
| // Andy Goodrich: added error messages for throws before the simulator is |
| // initialized. |
| // |
| // Revision 1.18 2011/02/11 13:25:24 acg |
| // Andy Goodrich: Philipp A. Hartmann's changes: |
| // (1) Removal of SC_CTHREAD method overloads. |
| // (2) New exception processing code. |
| // |
| // Revision 1.17 2011/02/08 08:18:16 acg |
| // Andy Goodrich: removed obsolete code. |
| // |
| // Revision 1.16 2011/02/07 19:17:20 acg |
| // Andy Goodrich: changes for IEEE 1666 compatibility. |
| // |
| // Revision 1.15 2011/02/04 15:27:36 acg |
| // Andy Goodrich: changes for suspend-resume semantics. |
| // |
| // Revision 1.14 2011/02/01 23:01:53 acg |
| // Andy Goodrich: removed dead code. |
| // |
| // Revision 1.13 2011/02/01 21:16:36 acg |
| // Andy Goodrich: |
| // (1) New version of trigger_dynamic() to implement new return codes and |
| // proper processing of events with new dynamic process rules. |
| // (2) Recoding of kill_process(), throw_user() and reset support to |
| // consolidate preemptive thread execution in sc_simcontext::preempt_with(). |
| // |
| // Revision 1.12 2011/01/25 20:50:37 acg |
| // Andy Goodrich: changes for IEEE 1666 2011. |
| // |
| // Revision 1.11 2011/01/20 16:52:20 acg |
| // Andy Goodrich: changes for IEEE 1666 2011. |
| // |
| // Revision 1.10 2011/01/19 23:21:50 acg |
| // Andy Goodrich: changes for IEEE 1666 2011 |
| // |
| // Revision 1.9 2011/01/18 20:10:45 acg |
| // Andy Goodrich: changes for IEEE1666_2011 semantics. |
| // |
| // Revision 1.8 2011/01/06 18:02:16 acg |
| // Andy Goodrich: added check for disabled thread to trigger_dynamic(). |
| // |
| // Revision 1.7 2010/11/20 17:10:57 acg |
| // Andy Goodrich: reset processing changes for new IEEE 1666 standard. |
| // |
| // Revision 1.6 2010/07/22 20:02:33 acg |
| // Andy Goodrich: bug fixes. |
| // |
| // Revision 1.5 2009/07/28 01:10:53 acg |
| // Andy Goodrich: updates for 2.3 release candidate. |
| // |
| // Revision 1.4 2009/05/22 16:06:29 acg |
| // Andy Goodrich: process control updates. |
| // |
| // Revision 1.3 2008/05/22 17:06:06 acg |
| // Andy Goodrich: formatting and comments. |
| // |
| // Revision 1.2 2007/09/20 20:32:35 acg |
| // Andy Goodrich: changes to the semantics of throw_it() to match the |
| // specification. A call to throw_it() will immediately suspend the calling |
| // thread until all the throwees have executed. At that point the calling |
| // thread will be restarted before the execution of any other threads. |
| // |
| // Revision 1.1.1.1 2006/12/15 20:20:05 acg |
| // SystemC 2.3 |
| // |
| // Revision 1.8 2006/04/20 17:08:17 acg |
| // Andy Goodrich: 3.0 style process changes. |
| // |
| // Revision 1.7 2006/04/11 23:13:21 acg |
| // Andy Goodrich: Changes for reduced reset support that only includes |
| // sc_cthread, but has preliminary hooks for expanding to method and thread |
| // processes also. |
| // |
| // Revision 1.6 2006/03/21 00:00:34 acg |
| // Andy Goodrich: changed name of sc_get_current_process_base() to be |
| // sc_get_current_process_b() since its returning an sc_process_b instance. |
| // |
| // Revision 1.5 2006/01/26 21:04:55 acg |
| // Andy Goodrich: deprecation message changes and additional messages. |
| // |
| // Revision 1.4 2006/01/24 20:49:05 acg |
| // Andy Goodrich: changes to remove the use of deprecated features within the |
| // simulator, and to issue warning messages when deprecated features are used. |
| // |
| // Revision 1.3 2006/01/13 18:44:30 acg |
| // Added $Log to record CVS changes into the source. |
| // |