HDLRuby 2.11.12 → 3.0.0

data/lib/HDLRuby/hdrcc.rb

@@ -263,6 +263,9 @@ module HDLRuby
             # Initialize the environment for processing the hdr file.
             bind = TOPLEVEL_BINDING.clone
             eval("require 'HDLRuby'\n\nconfigure_high\n\n",bind)
+            if $options[:std] then
+                eval("require 'std/std.rb'\n\ninclude HDLRuby::High::Std\n\n",bind)
+            end
             # Process it.
             eval(@texts[0],bind,@top_file_name,1)
             # Get the resulting instance
@@ -280,8 +283,8 @@ module HDLRuby
     end
 
 
-    # Extend the Code class with generation of file for the content.
     class HDLRuby::Low::Code
+        ## Extends the Code class with generation of file for the content.
 
         ## Creates a file in +path+ containing the content of the code.
         def to_file(path = "")
@@ -337,6 +340,9 @@ end
 require 'optparse'
 # Process the command line options
 $options = {}
+# By default the std libraries are loaded.
+$options[:std] = true
+# Parse the options
 $optparse = OptionParser.new do |opts|
     opts.banner = "Usage: hdrcc.rb [options] <input file> [<output directory or file>]"
 
@@ -435,6 +441,9 @@ $optparse = OptionParser.new do |opts|
     opts.on("--testall","Compile all the available unit tests.") do |t|
         $options[:testall] = t
     end
+    opts.on("--no-std", "Compile without the standard library.") do |t|
+        $options[:std] = false
+    end
     opts.on("-t", "--top system", "Specify the top system to process") do|t|
         $options[:top] = t
     end
@@ -445,7 +454,11 @@ $optparse = OptionParser.new do |opts|
         $options[:dump] = v
         $options[:multiple] = v
     end
-    opts.on("--version", "Shows the version of HDLRuby.") do |v|
+    opts.on("--get-samples", "Copy the sample directory (hdr_samples) to current one, the exit") do
+        FileUtils.copy_entry(File.dirname(__FILE__) + "/hdr_samples","./hdr_samples")
+        exit
+    end
+    opts.on("--version", "Show the version of HDLRuby, then exit") do |v|
         puts VERSION
         exit
     end

data/lib/HDLRuby/hdrlib.rb

@@ -226,8 +226,8 @@ module HDLRuby
     end
 
 
-    # Extend the Code class with generation of file for the content.
     class HDLRuby::Low::Code
+        ## Extends the Code class with generation of file for the content.
 
         ## Creates a file in +path+ containing the content of the code.
         def to_file(path = "")

data/lib/HDLRuby/hruby_db.rb

@@ -9,7 +9,7 @@ warn "hruby_db.rb (former hruby_low.rb) is deprecated."
 ##
 # Low-level libraries for describing digital hardware.        
 #######################################################
-module HDLRuby::Low
+module HDLRuby::LowDB
 
     Base = HDLRuby::Base
 
@@ -151,7 +151,7 @@ module HDLRuby::Low
     end
 
     ##
-    # Describes a unsigned integer data type.
+    # Describes an unsigned integer data type.
     class TypeUnsigned < Base::TypeUnsigned
         include Ltype
     end

data/lib/HDLRuby/hruby_high.rb

@@ -2044,7 +2044,7 @@ module HDLRuby::High
     end
 
     ##
-    # Describes a unsigned integer data type.
+    # Describes an unsigned integer data type.
     class TypeUnsigned < TypeVector
 
         # Creates a new vector type named +name+ from +base+ type and with
@@ -2855,17 +2855,17 @@ module HDLRuby::High
 
         # Casts to a bit vector type.
         def to_bit
-            return self.as(bit[self.width])
+            return self.as(HDLRuby::High.top_user.bit[self.type.width])
         end
 
         # Casts to an unsigned bit vector type.
         def to_unsigned
-            return self.as(unsigned[self.width])
+            return self.as(HDLRuby::High.top_user.unsigned[self.type.width])
         end
 
         # Casts to a signed bit vector type.
-        def to_unsigned
-            return self.as(signed[self.width])
+        def to_signed
+            return self.as(HDLRuby::High.top_user.signed[self.type.width])
         end
 
         # Extends on the left to +n+ bits filling with +v+ bit values.
@@ -2997,6 +2997,12 @@ module HDLRuby::High
              define_method(orig_operator(operator),&meth)
          end
 
+         # The <=> operator is also supported by is transformed into a sub
+         # with a signed result.
+         def <=>(expr)
+             return (self.as(self.type.base[self.type.width+1])-expr).to_signed
+         end
+
 
          # Creates an access to elements of range +rng+ of the signal.
          #
@@ -3188,7 +3194,7 @@ module HDLRuby::High
 
 
     ##
-    # Describes a section operation (generalization of the ternary operator).
+    # Describes a selection operation (generalization of the ternary operator).
     #
     # NOTE: choice is using the value of +select+ as an index.
     class Select < Low::Select
@@ -3344,6 +3350,12 @@ module HDLRuby::High
             end
         end
 
+        # Get the refered objects.
+        def objects
+            return [ self.object] if self.is_a?(RefObject)
+            return self.each.map { |ref| ref.objects }.flatten
+        end
+
         # Reference can be used like enumerator
         include Enumerable
     end
@@ -4410,14 +4422,14 @@ module HDLRuby::High
             super(nil)
             # # Save the Location for debugging information
             # @location = caller_locations
-            # Sets the current behavior
-            @@cur_behavior = self
+            # # Sets the current behavior
+            # @@cur_behavior = self
             # Add the events (they may be hierarchical to flatten)
             events.flatten.each { |event| self.add_event(event) }
             # Create and add the block.
             self.block = High.make_block(mode,&ruby_block)
-            # Unset the current behavior
-            @@cur_behavior = nil
+            # # Unset the current behavior
+            # @@cur_behavior = nil
         end
 
         # Sets an event to the behavior.
@@ -4584,12 +4596,21 @@ module HDLRuby::High
         end
     end
 
-    # The current behavior: by default none.
-    @@cur_behavior = nil
+    # # The current behavior: by default none.
+    # @@cur_behavior = nil
 
     # Gets the enclosing behavior if any.
     def self.cur_behavior
-        return @@cur_behavior
+        # return @@cur_behavior
+        if in_behavior? then
+            user = top_user
+            while(user && !user.is_a?(Behavior)) do
+                user = user.parent
+            end
+            return user
+        else
+            return nil
+        end
     end
 
     # Tell if we are in a behavior.
@@ -4765,13 +4786,10 @@ module HDLRuby::High
                 return Value.new(TypeSigned.new(:"",self.bit_length..0),self)
             end
         end
-    end
-    
-    # Extends the Float class for computing for conversion to expression.
-    class ::Float
-        # Converts to a new high-level expression.
-        def to_expr
-            return Value.new(Float,self)
+
+        # Gets the bit width
+        def width
+            return self.bit_length
         end
     end
 

data/lib/HDLRuby/hruby_high_fullname.rb

@@ -5,10 +5,11 @@ require "HDLRuby/hruby_high"
 module HDLRuby::High
 
 ##
-# Library for describing adding the fullname method to HDLRuby::High objects.
+# Library for adding the fullname method to HDLRuby::High objects.
 #
 ########################################################################
 
+
     class SystemT
 
         ## Returns the name of the signal with its hierarchy.
@@ -32,6 +33,7 @@ module HDLRuby::High
 
     end
 
+
     class Scope
         include WithFullname
     end

data/lib/HDLRuby/hruby_low.rb

@@ -1919,7 +1919,7 @@ module HDLRuby::Low
     end
 
     ##
-    # Describes a unsigned integer data type.
+    # Describes an unsigned integer data type.
     class TypeUnsigned < TypeVector
 
         # Creates a new vector type named +name+ from +base+ type and with
@@ -6117,7 +6117,7 @@ module HDLRuby::Low
 
 
     ## 
-    # Describe a this reference.
+    # Describes a this reference.
     #
     # This is the current system.
     class RefThis < Ref 

data/lib/HDLRuby/hruby_low2c.rb

@@ -165,8 +165,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the SystemT class with generation of C text.
     class SystemT
+        ## Extends the SystemT class with generation of C text.
 
         # Generates the text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object and +hnames+
@@ -402,8 +402,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Scope class with generation of C text.
     class Scope
+        ## Extends the Scope class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -567,8 +567,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Type class with generation of C text.
     class Type
+        ## Extends the Type class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -587,8 +587,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the TypeDef class with generation of C text.
+
     class TypeDef
+        ## Extends the TypeDef class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -601,8 +602,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the TypeVector class with generation of C text.
+
     class TypeVector
+        ## Extends the TypeVector class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -618,8 +620,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the TypeTuple class with generation of C text.
+
     class TypeTuple
+        ## Extends the TypeTuple class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -634,8 +637,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the TypeStruct class with generation of C text.
     class TypeStruct
+        ## Extends the TypeStruct class with generation of C text.
 
         # Generates the text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -650,8 +653,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Behavior class with generation of C text.
     class Behavior
+        ## Extends the Behavior class with generation of C text.
 
         # Generates the text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object and
@@ -837,8 +840,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the TimeBehavior class with generation of C text.
+
     class TimeBehavior
+        ## Extends the TimeBehavior class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -850,8 +854,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Event class with generation of C text.
     class Event
+        ## Extends the Event class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -870,8 +874,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the SignalI class with generation of C text.
     class SignalI
+        ## Extends the SignalI class with generation of C text.
 
         # The id of a signal in the simulator.
         @@signal_id = 0
@@ -1085,8 +1089,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the SystemI class with generation of C text.
     class SystemI
+        ## Extends the SystemI class with generation of C text.
 
         ## Generates the C text of the equivalent HDLRuby code.
         #  +level+ is the hierachical level of the object.
@@ -1166,8 +1170,8 @@ module HDLRuby::Low
     end
 
 
-    # Extend the Chunk cass with generation of text code.
     class HDLRuby::Low::Chunk
+        # Extend the Chunk cass with generation of text code.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1198,8 +1202,9 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the SystemI class with generation of C text.
     class Code
+        ## Extends the SystemI class with generation of C text.
+
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
         # def to_c(level = 0)
@@ -1320,8 +1325,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Statement class with generation of C text.
     class Statement
+        ## Extends the Statement class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1362,8 +1367,8 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Transmit class with generation of C text.
     class Transmit
+        ## Extends the Transmit class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -1464,8 +1469,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Print class with generation of C text.
     class Print
+        ## Extends the Print class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -1533,8 +1538,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the TimeTerminate class with generation of C text.
+
     class TimeTerminate
+        ## Extends the TimeTerminate class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1544,8 +1550,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Configure class with generation of C text.
+
     class Configure
+        ## Extends the Configure class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1556,8 +1563,8 @@ module HDLRuby::Low
     end
 
     
-    ## Extends the If class with generation of C text.
     class If
+        ## Extends the If class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -1677,8 +1684,8 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the When class with generation of C text.
     class When
+        ## Extends the When class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1721,8 +1728,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Case class with generation of C text.
+
     class Case
+        ## Extends the Case class with generation of C text.
 
         # # Generates the text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -1855,8 +1863,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Delay class with generation of C text.
     class Delay
+        ## Extends the Delay class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1871,8 +1879,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the TimeWait class with generation of C text.
     class TimeWait
+        ## Extends the TimeWait class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -1892,8 +1900,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the TimeRepeat class with generation of C text.
+
     class TimeRepeat
+        ## Extends the TimeRepeat class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -1933,8 +1942,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Block class with generation of C text.
+
     class Block
+        ## Extends the Block class with generation of C text.
 
         # Adds the c code of the blocks to +res+ at +level+
         def add_blocks_code(res,level)
@@ -2086,20 +2096,22 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Block class with generation of C text.
     class TimeBlock
+        ## Extends the Block class with generation of C text.
+
         # TimeBlock is identical to Block in C
     end
 
 
-    ## Extends the Connection class with generation of C text.
     class Connection
+        ## Extends the Connection class with generation of C text.
+
         # Nothing required, Transmit is generated identically.
     end
 
 
-    ## Extends the Expression class with generation of C text.
     class Expression
+        ## Extends the Expression class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -2121,8 +2133,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Value class with generation of C text.
     class Value
+        ## Extends the Value class with generation of C text.
 
         ## Generates the C text for an access to the value.
         #  +level+ is the hierachical level of the object.
@@ -2290,8 +2302,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Cast class with generation of C text.
     class Cast
+        ## Extends the Cast class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -2346,8 +2358,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Operation class with generation of C text.
     class Operation
+        ## Extends the Operation class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object.
@@ -2358,8 +2370,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Unary class with generation of C text.
+
     class Unary
+        ## Extends the Unary class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -2442,8 +2455,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the Binary class with generation of C text.
     class Binary
+        ## Extends the Binary class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -2591,8 +2604,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Select class with generation of C text.
+
     class Select
+        ## Extends the Select class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -2669,9 +2683,9 @@ module HDLRuby::Low
         end
     end
 
-    ## Extends the Concat class with generation of C text.
-    class Concat
 
+    class Concat
+        ## Extends the Concat class with generation of C text.
 
         # # Generates the C text for the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object.
@@ -2800,8 +2814,8 @@ module HDLRuby::Low
 
 
 
-    ## Extends the Ref class with generation of C text.
     class Ref
+        ## Extends the Ref class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object and
@@ -2814,8 +2828,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the RefConcat class with generation of C text.
     class RefConcat
+        ## Extends the RefConcat class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object and
@@ -2848,8 +2862,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the RefIndex class with generation of C text.
     class RefIndex
+        ## Extends the RefIndex class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is thehierachical level of the object and
@@ -2958,8 +2972,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the RefRange class with generation of C text.
     class RefRange
+        ## Extends the RefRange class with generation of C text.
 
         # # Generates the C text of the equivalent HDLRuby code.
         # # +level+ is the hierachical level of the object and
@@ -3071,8 +3085,8 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the RefName class with generation of C text.
     class RefName
+        ## Extends the RefName class with generation of C text.
 
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object and
@@ -3128,8 +3142,9 @@ module HDLRuby::Low
     end
 
 
-    ## Extends the RefThis class with generation of C text.
     class RefThis 
+        ## Extends the RefThis class with generation of C text.
+
         # Generates the C text of the equivalent HDLRuby code.
         # +level+ is the hierachical level of the object and
         # +left+ tells if it is a left value or not.