//
//----------------------------------------------------------------------
//   Copyright 2007-2011 Mentor Graphics Corporation
//   Copyright 2007-2010 Cadence Design Systems, Inc. 
//   Copyright 2010 Synopsys, Inc.
//   Copyright 2010 Paradigm-works, Inc.
//   All Rights Reserved Worldwide
//
//   Licensed 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 UVM_NO_DEPRECATED

//------------------------------------------------------------------------------
// Title- Predefined Sequences
//
// This section defines several sequences that ship with the UVM library.
//------------------------------------------------------------------------------

//------------------------------------------------------------------------------
//
// CLASS- uvm_random_sequence
//
// This sequence randomly selects and executes a sequence from the sequencer's
// sequence library, excluding uvm_random_sequence itself, and
// uvm_exhaustive_sequence. 
//
// The uvm_random_sequence class is a built-in sequence that is preloaded into
// every sequencer's sequence library with the name "uvm_random_sequence".
//
// The number of selections and executions is determined by the count property
// of the sequencer (or virtual sequencer) on which uvm_random_sequence is
// operating. See <uvm_sequencer_base> for more information.
//
//------------------------------------------------------------------------------

class [docs]uvm_random_sequence extends uvm_sequence #(uvm_sequence_item);

  rand protected int unsigned l_count=-1;
  local int unsigned l_exhaustive_seq_kind;
  local int unsigned max_kind;
  rand local int unsigned l_kind;
  protected bit m_success;

// Function- get_count
//
// Returns the count of the number of sub-sequences which are randomly generated.
// By default, count is equal to the value from the sequencer's count variable.
// However, if the sequencer's count variable is -1, then a random value between
// 0 and sequencer.max_random_count (exclusive) is chosen. The sequencer's
// count variable is subsequently reset to the random value that was used. If
// get_count() is call before the sequence has started, the return value will
// be sequencer.count, which may be -1.

function int unsigned [docs]get_count();
  if(l_count == -1)
    return m_sequencer.count;
  return l_count;
endfunction

// new
// ---

function [docs]new(string name="uvm_random_sequence");
  super.new(name);
endfunction


// body
// ----

task [docs]body();
  pick_sequence.constraint_mode(0);
  if (m_sequencer.count == -1) begin
    if (!randomize(l_count) with { l_count > 0 &&
                                   l_count < m_sequencer.max_random_count; })
      uvm_report_fatal("RANDSEQ", "Randomization for l_count failed in random sequence body", UVM_NONE);
    m_sequencer.count = l_count;
  end
  else
    l_count = m_sequencer.count;
  max_kind = m_sequencer.sequences.size();
  l_exhaustive_seq_kind = m_sequencer.get_seq_kind("uvm_exhaustive_sequence");
  repeat (l_count) begin
    if (!randomize(l_kind) with { l_kind > l_exhaustive_seq_kind && 
      l_kind < max_kind; })
      uvm_report_fatal("RANDSEQ", "Randomization for l_kind failed in random sequence body", UVM_NONE);
    do_sequence_kind(l_kind);
  end
  m_sequencer.m_random_count++;
  pick_sequence.constraint_mode(1);
endtask 


//Implement data functions
function void [docs]do_copy (uvm_object rhs);
  uvm_random_sequence seq;
  if(rhs==null) return;
  if(!$cast(seq, rhs)) return;
  l_count = seq.l_count;
endfunction

function bit [docs]do_compare (uvm_object rhs, uvm_comparer comparer);
  uvm_random_sequence seq;
  do_compare = 1;
  if(rhs==null) return 0;
  if(!$cast(seq, rhs)) return 0;
  do_compare &= comparer.compare_field_int("l_count", l_count, seq.l_count, 
    $bits(l_count));
endfunction

function void [docs]do_print (uvm_printer printer);
  printer.print_field_int("l_count", l_count, $bits(l_count));
endfunction

function void [docs]do_record (uvm_recorder recorder);
  recorder.record_field_int("l_count", l_count, $bits(l_count));
endfunction // void

  function uvm_object [docs]create (string name="");
    uvm_random_sequence i; i=new(name);
    return i;
  endfunction

  virtual function string [docs]get_type_name();
     return "uvm_random_sequence";
  endfunction

  // Macro for factory creation
  `uvm_object_registry(uvm_random_sequence, "uvm_random_sequence")

endclass


//------------------------------------------------------------------------------
//
// CLASS- uvm_exhaustive_sequence
//
// This sequence randomly selects and executes each sequence from the
// sequencer's sequence library once, excluding itself and uvm_random_sequence.
//
// The uvm_exhaustive_sequence class is a built-in sequence that is preloaded 
// into every sequencer's sequence library with the name
// "uvm_exaustive_sequence".
//
//------------------------------------------------------------------------------

class [docs]uvm_exhaustive_sequence extends uvm_sequence #(uvm_sequence_item);

  rand protected int unsigned l_count;
  local int unsigned l_exhaustive_seq_kind;
  local int unsigned max_kind;
  randc local bit[9:0] l_kind;
  protected bit m_success;

// new
// ---

function [docs]new(string name="uvm_exhaustive_sequence");
  super.new(name);
endfunction


// body
// ----

task [docs]body();
    int i;
    
  pick_sequence.constraint_mode(0);
    //$display("In exhaustive sequence body, num_sequences: %0d", m_sequencer.num_sequences());


    //for (i = 0; i < m_sequencer.num_sequences(); i++ ) begin
    //  $display("seq: %0d: %s", i, m_sequencer.sequences[i]);
    //  $display("get_seq_kind[%s]: %0d", m_sequencer.sequences[i], get_seq_kind(m_sequencer.sequences[i]));
    //end
    
    
  l_count = m_sequencer.sequences.size() - 2;
  max_kind = m_sequencer.sequences.size();
  l_exhaustive_seq_kind = m_sequencer.get_seq_kind("uvm_exhaustive_sequence");
  repeat (l_count) begin
    if (!randomize(l_kind) with { l_kind > l_exhaustive_seq_kind; 
      l_kind < max_kind; }) // l_kind is randc
      uvm_report_fatal("RANDSEQ", "Randomization for l_kind failed in exhaustive sequence body", UVM_NONE);

    //$display ("Chosen l_kind: %0d", l_kind);
    do_sequence_kind(l_kind);
  end
  m_sequencer.m_exhaustive_count++;
  pick_sequence.constraint_mode(1);
endtask 


//Implement data functions
function void [docs]do_copy (uvm_object rhs);
  uvm_exhaustive_sequence seq;
  if(rhs==null) return;
  if(!$cast(seq, rhs)) return;
  l_count = seq.l_count;
endfunction

function bit [docs]do_compare (uvm_object rhs, uvm_comparer comparer);
  uvm_exhaustive_sequence seq;
  do_compare = 1;
  if(rhs==null) return 0;
  if(!$cast(seq, rhs)) return 0;
  do_compare &= comparer.compare_field_int("l_count", l_count, seq.l_count, 
    $bits(l_count));
endfunction

function void [docs]do_print (uvm_printer printer);
  printer.print_field_int("l_count", l_count, $bits(l_count));
endfunction

function void [docs]do_record (uvm_recorder recorder);
  recorder.record_field_int("l_count", l_count, $bits(l_count));
endfunction // void

function uvm_object [docs]create (string name="");
  uvm_exhaustive_sequence i; i=new(name);
  return i;
endfunction

virtual function string [docs]get_type_name();
   return "uvm_exhaustive_sequence";
endfunction

// Macro for factory creation
`uvm_object_registry(uvm_exhaustive_sequence, "uvm_exhaustive_sequence")

endclass


//------------------------------------------------------------------------------
//
// CLASS- uvm_simple_sequence
//
// This sequence simply executes a single sequence item. 
//
// The item parameterization of the sequencer on which the uvm_simple_sequence
// is executed defines the actual type of the item executed.
//
// The uvm_simple_sequence class is a built-in sequence that is preloaded into
// every sequencer's sequence library with the name "uvm_simple_sequence". 
//
// See <uvm_sequencer #(REQ,RSP)> for more information on running sequences.
//
//------------------------------------------------------------------------------

class [docs]uvm_simple_sequence extends uvm_sequence #(uvm_sequence_item);

  protected rand uvm_sequence_item item;

  // new
  // ---
  function [docs]new (string name="uvm_simple_sequence");
    super.new(name);
    // Initialized to avoid potential warnings if this class instance 
    // is randomized without calling its body()
    item = new;
  endfunction

  // body
  // ----
  task [docs]body();
    `uvm_do(item)
    m_sequencer.m_simple_count++;
  endtask

  function uvm_object [docs]create (string name="");
    uvm_simple_sequence i;
    i=new(name);
    return i;
  endfunction

  virtual function string [docs]get_type_name();
     return "uvm_simple_sequence";
  endfunction

  // Macro for factory creation
  `uvm_object_registry(uvm_simple_sequence, "uvm_simple_sequence")

endclass

`endif // UVM_NO_DEPRECATED