Class: Origen::Pins::Timing::Wave

Inherits:
Object
  • Object
show all
Defined in:
lib/origen/pins/timing/wave.rb

Constant Summary collapse

VALID_DRIVE_DATA = 
[0, 1, :data]
VALID_COMPARE_DATA = 
[0, 1, :data]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(timeset, options = {}) ⇒ Wave

Returns a new instance of Wave.

[View source]

14
15
16
17
18
19
 
# File 'lib/origen/pins/timing/wave.rb', line 14

def initialize(timeset, options = {})
  @code = options[:code]
  @code = nil if [0, 1, 'H', 'L', :H, :L].include?(@code)
  @timeset = timeset
  @events = []
end

Instance Attribute Details

#code ⇒ Object (readonly)

Returns the pattern code value associated with the wave. By default this will return nil if no code was given at the time the wave was defined, which means it is the wave that will be applied for the conventional code values of 0, 1, H, L.


9
10
11
 
# File 'lib/origen/pins/timing/wave.rb', line 9

def code
  @code
end

#events ⇒ Object (readonly)

Returns the value of attribute events.


5
6
7
 
# File 'lib/origen/pins/timing/wave.rb', line 5

def events
  @events
end

#index ⇒ Object

Returns the value of attribute index.


5
6
7
 
# File 'lib/origen/pins/timing/wave.rb', line 5

def index
  @index
end

#timeset ⇒ Object (readonly)

Returns the value of attribute timeset.


5
6
7
 
# File 'lib/origen/pins/timing/wave.rb', line 5

def timeset
  @timeset
end

Instance Method Details

#compare(data, options) ⇒ Object Also known as: compare_edge

[View source]

55
56
57
58
59
60
61
62
 
# File 'lib/origen/pins/timing/wave.rb', line 55

def compare(data, options)
  self.type = :compare
  validate_data(data) do |d|
    validate_time(options) do |t|
      events << [t, d]
    end
  end
end

#compare? ⇒ Boolean

Returns:

  • (Boolean)
[View source]

81
82
83
 
# File 'lib/origen/pins/timing/wave.rb', line 81

def compare?
  @type == :compare
end

#dont_care(options) ⇒ Object Also known as: highz

[View source]

65
66
67
68
69
70
 
# File 'lib/origen/pins/timing/wave.rb', line 65

def dont_care(options)
  self.type = :drive
  validate_time(options) do |t|
    events << [t, :x]
  end
end

#drive(data, options) ⇒ Object

[View source]

46
47
48
49
50
51
52
53
 
# File 'lib/origen/pins/timing/wave.rb', line 46

def drive(data, options)
  self.type = :drive
  validate_data(data) do |d|
    validate_time(options) do |t|
      events << [t, d]
    end
  end
end

#drive? ⇒ Boolean

Returns:

  • (Boolean)
[View source]

77
78
79
 
# File 'lib/origen/pins/timing/wave.rb', line 77

def drive?
  @type == :drive
end

#evaluated_events ⇒ Object

Returns the events array but with any formula based times evaluated. Note that this does not raise an error if the period is not currently set, in that case any events that reference it will have nil for their time.

[View source]

26
27
28
29
30
31
32
 
# File 'lib/origen/pins/timing/wave.rb', line 26

def evaluated_events
  if dut.current_timeset_period
    events.map { |e| [calc.evaluate(e[0], period: dut.current_timeset_period).ceil, e[1]] }
  else
    fail 'The current timeset period has not been set'
  end
end

#pin_ids ⇒ Object

Returns an array containing all dut pin_ids that are assigned to this wave by the parent timeset

[View source]

36
37
38
 
# File 'lib/origen/pins/timing/wave.rb', line 36

def pin_ids
  @pins_ids ||= timeset.send(:pin_ids_for, self)
end

#pins ⇒ Object

Returns an array containing all dut pin objects that are assigned to this wave by the parent timeset

[View source]

42
43
44
 
# File 'lib/origen/pins/timing/wave.rb', line 42

def pins
  @pins ||= pin_ids.map { |id| dut.pin(id) }
end

#type ⇒ Object

[View source]

73
74
75
 
# File 'lib/origen/pins/timing/wave.rb', line 73

def type
  @type ||= :drive
end