HDLRuby 3.5.1 → 3.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ddf985a2c95d278dd5267350cb09cf3310d29a21ede26b0dea69381ae0cd8ed8
-  data.tar.gz: 0b38f0e98fdc47a7a0ba692777957a76cc239fc22d5ae4eb9c4b979df88fa186
+  metadata.gz: 705f4b6e4835c910f62b0bced03175761ce62766d976c71123fa8756d7103714
+  data.tar.gz: e72f192e90d3aad1fa9819988251223108011b3bd9e931d3349ed1dd6d7413f7
 SHA512:
-  metadata.gz: fbe2f1ecba2cbd9fe06e1707479b5024a4b21a839f857a357b2ea4880ecb90dd1a48a91c8e32b45ea5f1b670d52b1e3fdb6297f71cd2dd05cc013447fd0151ad
-  data.tar.gz: 16cde53ba9e257f76c60f7ce1b75fda7b416433668d07fe0f696fcdeff000e921777e142cb09140930ccf65de48dea8f4565d0831c896bc7304d59d0bc64f5d2
+  metadata.gz: d92f346ae79abb3a701784861d16c162a134a2f07477657e6976d569d591cbbb38f0bff20da5b2eeff6b32efdc170b539e34f807bba1d58ac770611b1582810f
+  data.tar.gz: d84037e56a7dacfc3e43a96a8885f1813b2a708be069a128878e3cf8a54602d3a28dd0db7d04fdde976bdde6880afd7b239bd356addd37bc0bcd05abab7a45ee

data/README.md

@@ -17,6 +17,10 @@ hdrcc --get-tuto
 
 __What's new__
 
+For HDLRuby version 3.6.0:
+
+ * Added a new element for the GUI board that allows to assign an expression to a signal on the fly while simulating.
+
 For HDLRuby version 3.5.0:
 
  * Added direct support for Verilog HDL files as input to 'hdrcc'.
@@ -2220,6 +2224,10 @@ The list of possible elements is as follows:
 
  * `bt`: represents a set of push buttons, their number is set to match the bit-width of the attached signal.
 
+ * `text`: Represents a text input box whose content is interpreted as an expression. The syntax of the expression follows Ruby, and the available variables include the board's display objects. For example, if a set of LEDs is named `leds`, it will be accessible as a variable.
+
+ * `hook`: Attaches a signal to the board without displaying. It can be used as a variable in `text` expressions, similar to display objects.
+
  * `led`: represents a set of LEDs, their number is set to match the bit-width of the attached signal.
 
  * `hexa`: represents a hexadecimal number display, its character width is set to match the width of the largest possible value of the attached signal.

data/lib/HDLRuby/hdr_samples/with_board.rb

@@ -10,6 +10,7 @@ system :with_board do
     inner rst: 0
     [8].inner :sw_a, :sw_b
     [9].inner :led_z
+    [8].inner :expr, :show
     [16].inner counter: 0
     [8].inner :counter8
     signed[8].inner :scounter8
@@ -19,11 +20,16 @@ system :with_board do
     board(:some_board) do
         actport clk2.posedge
         bt  reset:    rst
+        hook sw_ai: sw_a
+        hook sw_bi: sw_b
         row
         sw  sw_a:     sw_a
         sw  sw_b:     sw_b
         led led_z:    led_z
         row
+        text expr:    expr
+        digit show:   show
+        row
         digit cnt_d:  counter
         hexa  cnt_h:  counter
         digit cnt_s:  scounter8
@@ -35,6 +41,9 @@ system :with_board do
     # The adder.
     led_z <= sw_a.as(bit[9]) + sw_b
 
+    # The text input and result.
+    show <= expr
+
     # The counters and the generation of +clk2+.
     counter8 <= counter[7..0]
     scounter8 <= counter[7..0]
@@ -52,7 +61,7 @@ system :with_board do
         clk <= 0
         clk2 <= 0
         !10.ns
-        repeat(1000) do
+        repeat(10000) do
             clk <= 1
             !10.ns
             clk <= 0

data/lib/HDLRuby/ui/hruby_board.rb

@@ -20,6 +20,9 @@ module HDLRuby::High::Std
     include Hmissing
 
     attr_reader :namespace
+
+    ## Suffix telling a text is an expression to compute.
+    TO_COMPUTE = "="
     
     ## Class describing a row of slide switches.
     SW = Struct.new(:id, :size, :hwrite) do
@@ -50,6 +53,27 @@ module HDLRuby::High::Std
       end
     end
 
+    ## Class describing a text-based input.
+    TEXT = Struct.new(:id, :size, :hwrite) do
+      def to_html
+        return "<div class=\"textset\" id=\"#{self.id}\" data-value=\"0\">\\n" + 
+          '<form onSubmit="text_submit(this); return false">\\n' +
+          '<span class="name">' + self.hwrite.to_s.chop + '</span>' +
+          '<span>&nbsp;&nbsp;</span>' + 
+             '<input class="matrix_in" type="text" name="text" ' +
+               'placeholder="Enter an expression">' +
+          "</form>\\n" +
+        "</div>\\n"
+      end
+    end
+
+    ## Class describing a hook (invisible display element).
+    HOOK = Struct.new(:id, :size, :hread) do
+      def to_html
+        return "<div id=\"#{self.id}\" data-value=\"0\"/>\\n"
+      end
+    end
+
     ## Class describing a row of LEDs.
     LED = Struct.new(:id, :size, :hread) do
       def to_html
@@ -476,6 +500,17 @@ Content-Type: text/html
     -webkit-shadow: -1px -1px 1px white, 1px 1px 1px #101010;
   }
 
+  .matrix_in {
+    font-size: 26px;
+    font-family: "Lucida Console", "Courier New", monospace;
+    color: #0B190B;
+    background-color: #9BBC0F;
+    border: solid 2px #505050;
+    box-shadow: -1px -1px 1px white, 1px 1px 1px #101010;
+    -moz-box-shadow: -1px -1px 1px white, 1px 1px 1px #101010;
+    -webkit-shadow: -1px -1px 1px white, 1px 1px 1px #101010;
+  }
+
   .bt {
     background-color: #ccc;
     border: solid 2px #505050;
@@ -586,7 +621,8 @@ Content-Type: text/html
     const element = prow.lastElementChild;
     // Depending of the kind of element.
     if (element.classList.contains('swset') ||
-      element.classList.contains('btset')) {
+        element.classList.contains('btset') ||
+        element.classList.contains('textset') ) {
       // Input element.
       input_ids.push(element.id);
     } else {
@@ -660,6 +696,16 @@ Content-Type: text/html
     btset.dataset.value = btset.dataset.value & ~(1 << bit);
   }
 
+  
+  // Handler of the text submit
+  function text_submit(form) {
+     // Get the et holding the form.
+     const textset = form.parentElement;
+     // Update the value, suffixed with #{TO_COMPUTE} for telling it is a
+     // text expression to compute.
+     textset.dataset.value = form.elements.text.value + "#{TO_COMPUTE}"
+  }
+
 
   // Switch a led on.
   function led_on(led) {
@@ -916,7 +962,7 @@ HTMLRESPONSE
       end
       # Create the HDLRuby program port.
       @program.outport(hport)
-      # Create the ui component.
+      # Create the UI component.
       hport = hport.first
       @elements << SW.new(@elements.size,hport[1].type.width,:"#{hport[0]}=")
     end
@@ -929,10 +975,37 @@ HTMLRESPONSE
       # Create the HDLRuby program port.
       @program.outport(hport)
       hport = hport.first
-      # Create the ui component.
+      # Create the UI component.
       @elements << BT.new(@elements.size,hport[1].type.width,:"#{hport[0]}=")
     end
 
+    # Add a new text input element attached to HDLRuby port +hport+
+    def text(hport)
+      if !hport.is_a?(Hash) or hport.size != 1 then
+        raise UIError.new("Malformed HDLRuby port declaration: #{hport}")
+      end
+      # Create the HDLRuby program port.
+      @program.outport(hport)
+      hport = hport.first
+      # Create the UI component.
+      @elements << TEXT.new(@elements.size,hport[1].type.width,:"#{hport[0]}=")
+    end
+
+    # Add a new hook element attached to HDLRuby port +hport+.
+    # NOTE: a hook element is not displayed on the board but can be used
+    # in the `text` expression.
+    def hook(hport)
+      if !hport.is_a?(Hash) or hport.size != 1 then
+        raise UIError.new("Malformed HDLRuby port declaration: #{hport}")
+      end
+      # Create the HDLRuby program port.
+      @program.inport(hport)
+      hport = hport.first
+      # Createthe UI component (invisible)
+      @elements << HOOK.new(@elements.size,hport[1].type.width,hport[0])
+      @out_elements << @elements[-1]
+    end
+
     # Add a new LED element attached to HDLRuby port +hport+.
     def led(hport)
       if !hport.is_a?(Hash) or hport.size != 1 then
@@ -941,7 +1014,7 @@ HTMLRESPONSE
       # Create the HDLRuby program port.
       @program.inport(hport)
       hport = hport.first
-      # Createthe ui component.
+      # Createthe UI component.
       @elements << LED.new(@elements.size,hport[1].type.width,hport[0])
       @out_elements << @elements[-1]
     end
@@ -1032,6 +1105,35 @@ HTMLRESPONSE
     end
 
 
+    # Compute a value.
+    def compute(val)
+      # Preprocess val to match Ruby syntax.
+      val = "0" unless val
+      val = val.gsub("%20"," ")
+      # Replace the names by the corresponding ports read result.
+      # val = val.gsub(/([^0-9\.A-Z][_a-z][_a-zA-Z0-9]*)/) do |str|
+      #   RubyHDL.send(Regexp.last_match[1]).to_s rescue 0
+      # end
+      val = val.gsub(/([\._a-zA-Z0-9]+)/) do |str|
+        if str[0] >= "a" && str[0] <= "z" then
+          # Variable identifier, process it if recognized.
+          RubyHDL.send(Regexp.last_match[1]).to_s rescue str
+        else
+          # Other token leave it as is.
+          str
+        end
+      end
+      # Compute.
+      res = 0
+      safe = $SAFE
+      begin
+        $SAFE = 2
+        res = eval(val).to_i
+      rescue SyntaxError => se
+      end
+      $SAFE = safe
+      return res
+    end
 
     # Update port number +id+ with value +val+.
     def update_port(id,val)
@@ -1057,8 +1159,17 @@ HTMLRESPONSE
         # This should be an AJAX request, process it.
         commands = request.split(";")
         commands.each do |command|
-          next unless command.include?(":")
-          id, val = command.split(":").map {|t| t.to_i}
+          # next unless command.include?(":")
+          # id, val = command.split(":").map {|t| t.to_i}
+          id, val = command.split(":",2)
+          next unless val
+          id = id.to_i
+          if val[-1] == "=" then
+            # This is an expression to compute.
+            val = self.compute(val.chop)
+          else
+            val = val.to_i
+          end
           self.update_port(id,val)
         end
         # And generate the response: an update of each board output element.

data/lib/HDLRuby/version.rb

@@ -1,3 +1,3 @@
 module HDLRuby
-  VERSION = "3.5.1"
+  VERSION = "3.6.0"
 end

data/tuto/tutorial_sw.html

@@ -3047,6 +3047,10 @@ end
 </li>
 <li><p><code>led</code>: represents a set of LEDs, their number is set to match the bit-width of the attached signal.</p>
 </li>
+<li><p><code>text</code>: Represents a text input box whose content is interpreted as an expression. The syntax of the expression follows Ruby, and the available variables include the board's display objects. For example, if a set of LEDs is named <code>leds</code>, it will be accessible as a variable.</p>
+</li>
+<li><p><code>hook</code>: Attaches a signal to the board without displaying. It can be used as a variable in <code>text</code> expressions, similar to display objects.</p>
+</li>
 <li><p><code>hexa</code>: represents a hexadecimal number display, its character width is set to match the width of the largest possible value of the attached signal.</p>
 </li>
 <li><p><code>digit</code>: represents a decimal number display, its character width is set to match the width of the largest possible positive or the smallest possible negative value of the attached signal.</p>

data/tuto/tutorial_sw.md

@@ -3750,6 +3750,10 @@ And the comprise the following:
 
  * `led`: represents a set of LEDs, their number is set to match the bit-width of the attached signal.
 
+ * `text`: Represents a text input box whose content is interpreted as an expression. The syntax of the expression follows Ruby, and the available variables include the board's display objects. For example, if a set of LEDs is named `leds`, it will be accessible as a variable.
+
+ * `hook`: Attaches a signal to the board without displaying. It can be used as a variable in `text` expressions, similar to display objects.
+
  * `hexa`: represents a hexadecimal number display, its character width is set to match the width of the largest possible value of the attached signal.
 
  * `digit`: represents a decimal number display, its character width is set to match the width of the largest possible positive or the smallest possible negative value of the attached signal.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: HDLRuby
 version: !ruby/object:Gem::Version
-  version: 3.5.1
+  version: 3.6.0
 platform: ruby
 authors:
 - Lovic Gauthier
 bindir: exe
 cert_chain: []
-date: 2024-12-25 00:00:00.000000000 Z
+date: 2025-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -488,7 +488,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.0
+rubygems_version: 3.6.2
 specification_version: 4
 summary: HDLRuby is a library for describing and simulating digital electronic systems.
 test_files: []