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_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



3438
3439
3440
3441
3442
3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
 
# File 'lib/HDLRuby/hruby_high.rb', line 3438

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.



3429
3430
3431
 
# File 'lib/HDLRuby/hruby_high.rb', line 3429

def can_read
  @can_read
end

#can_write ⇒ Object

Tells if the signal can be written.



3432
3433
3434
 
# File 'lib/HDLRuby/hruby_high.rb', line 3432

def can_write
  @can_write
end

#dir ⇒ Object

The bounding direction.



3426
3427
3428
 
# File 'lib/HDLRuby/hruby_high.rb', line 3426

def dir
  @dir
end

Instance Method Details

#coerce(obj) ⇒ Object

Coerce by converting signal to an expression.



3513
3514
3515
 
# File 'lib/HDLRuby/hruby_high.rb', line 3513

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

#edge ⇒ Object

Creates an edge event from the signal.



3498
3499
3500
 
# File 'lib/HDLRuby/hruby_high.rb', line 3498

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

#negedge ⇒ Object

Creates a negative edge event from the signal.



3493
3494
3495
 
# File 'lib/HDLRuby/hruby_high.rb', line 3493

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

#posedge ⇒ Object

Creates a positive edge event from the signal.



3488
3489
3490
 
# File 'lib/HDLRuby/hruby_high.rb', line 3488

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

#to_expr ⇒ Object

Converts to a new expression.



3508
3509
3510
 
# File 'lib/HDLRuby/hruby_high.rb', line 3508

def to_expr
    return self.to_ref
end

#to_low(name = self.name) ⇒ Object

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



3518
3519
3520
3521
3522
3523
3524
3525
3526
 
# File 'lib/HDLRuby/hruby_high.rb', line 3518

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.



3503
3504
3505
 
# File 'lib/HDLRuby/hruby_high.rb', line 3503

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