Class: HDLRuby::High::SignalI

Inherits:
Low::SignalI show all
Includes:
HRef
Defined in:
lib/HDLRuby/hruby_high.rb

Overview

Describes a high-level signal.

Constant Summary collapse

High = 
HDLRuby::High
DIRS =

The valid bounding directions.

[ :no, :input, :output, :inout, :inner ]

Constants included from Low::Low2Symbol

Low::Low2Symbol::Low2SymbolPrefix, Low::Low2Symbol::Low2SymbolTable, Low::Low2Symbol::Symbol2LowTable

Instance Attribute Summary collapse

Attributes inherited from Low::SignalI

#name, #type, #value

Attributes included from Low::Hparent

#parent

Instance Method Summary collapse

Methods included from HRef

#each, included, #to_event

Methods inherited from Low::SignalI

#clone, #each_deep, #eql?, #explicit_types!, #hash, #immutable?, #replace_names!, #set_name!, #set_type!, #set_value!, #to_c, #to_c_alias, #to_c_signal, #to_ch, #to_hdr, #to_high, #to_verilog, #to_vhdl, #width

Methods included from Low::Low2Symbol

#to_sym

Methods included from Low::Hparent

#hierarchy, #scope

Constructor Details

#initialize(name, type, dir, value = nil) ⇒ SignalI

Creates a new signal named +name+ typed as +type+ with +dir+ as bounding direction and possible +value+.

NOTE: +dir+ can be :input, :output, :inout or :inner



3574
3575
3576
3577
3578
3579
3580
3581
3582
3583
3584
3585
3586
3587
3588
3589
3590
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
 
# File 'lib/HDLRuby/hruby_high.rb', line 3574

def initialize(name,type,dir,value =  nil)
    # Check the value.
    value = value.to_expr.match_type(type) if value
    # Initialize the type structure.
    super(name,type,value)

    unless name.empty? then
        # Named signal, set the hdl-like access to the signal.
        obj = self # For using the right self within the proc
        High.space_reg(name) { obj }
    end

    # Hierarchical type allows access to sub references, so generate
    # the corresponding methods.
    if type.struct? then
        type.each_name do |name|
            self.define_singleton_method(name) do
                RefObject.new(self.to_ref,
                            SignalI.new(name,type.get_type(name),dir))
            end
        end
    end

    # Check and set the bound.
    self.dir = dir

    # Set the read and write authorisations.
    @can_read = 1.to_expr
    @can_write = 1.to_expr
end

Instance Attribute Details

#can_read ⇒ Object

Tells if the signal can be read.



3565
3566
3567
 
# File 'lib/HDLRuby/hruby_high.rb', line 3565

def can_read
  @can_read
end

#can_write ⇒ Object

Tells if the signal can be written.



3568
3569
3570
 
# File 'lib/HDLRuby/hruby_high.rb', line 3568

def can_write
  @can_write
end

#dir ⇒ Object

The bounding direction.



3562
3563
3564
 
# File 'lib/HDLRuby/hruby_high.rb', line 3562

def dir
  @dir
end

Instance Method Details

#coerce(obj) ⇒ Object

Coerce by converting signal to an expression.



3649
3650
3651
 
# File 'lib/HDLRuby/hruby_high.rb', line 3649

def coerce(obj)
    return [obj,self.to_expr]
end

#edge ⇒ Object

Creates an edge event from the signal.



3634
3635
3636
 
# File 'lib/HDLRuby/hruby_high.rb', line 3634

def edge
    return Event.new(:edge,self.to_ref)
end

#negedge ⇒ Object

Creates a negative edge event from the signal.



3629
3630
3631
 
# File 'lib/HDLRuby/hruby_high.rb', line 3629

def negedge
    return Event.new(:negedge,self.to_ref)
end

#posedge ⇒ Object

Creates a positive edge event from the signal.



3624
3625
3626
 
# File 'lib/HDLRuby/hruby_high.rb', line 3624

def posedge
    return Event.new(:posedge,self.to_ref)
end

#to_expr ⇒ Object

Converts to a new expression.



3644
3645
3646
 
# File 'lib/HDLRuby/hruby_high.rb', line 3644

def to_expr
    return self.to_ref
end

#to_low(name = self.name) ⇒ Object

Converts the system to HDLRuby::Low and set its +name+.



3654
3655
3656
3657
3658
3659
3660
3661
3662
 
# File 'lib/HDLRuby/hruby_high.rb', line 3654

def to_low(name = self.name)
    # return HDLRuby::Low::SignalI.new(name,self.type.to_low)
    valueL = self.value ? self.value.to_low : nil
    signalIL = HDLRuby::Low::SignalI.new(name,self.type.to_low,valueL)
    # # For debugging: set the source high object 
    # signalIL.properties[:low2high] = self.hdr_id
    # self.properties[:high2low] = signalIL
    return signalIL
end

#to_ref ⇒ Object

Converts to a new reference.



3639
3640
3641
 
# File 'lib/HDLRuby/hruby_high.rb', line 3639

def to_ref
    return RefObject.new(this,self)
end