# \[ANN\] Ruby-VPI 17.0.0

**URL:** <https://rubytalk.org/t/ann-ruby-vpi-17-0-0/39317>\
**Category:** ruby-talk\
**Created:** [22 July 2007 22:06 UTC](https://rubytalk.org/t/ann-ruby-vpi-17-0-0/39317 "2007-07-22T22:06:22Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Suraj\_Kurapati1](https://avatars.discourse-cdn.com/v4/letter/s/f19dbf/32.png) [@Suraj\_Kurapati1](https://rubytalk.org/u/Suraj_Kurapati1)\
**Post date:** [22 July 2007 22:06 UTC](https://rubytalk.org/t/ann-ruby-vpi-17-0-0/39317/1 "2007-07-22T22:06:22Z")

</div>

Ruby-VPI is a Ruby interface to IEEE 1364-2005 Verilog VPI  
and a platform for unit testing, rapid prototyping, and  
systems integration of Verilog modules through Ruby. It  
lets you create complex Verilog test benches easily and  
wholly in Ruby.

&nbsp;&nbsp;• See [http://ruby-vpi.rubyforge.org](http://ruby-vpi.rubyforge.org) for details.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Version 17.0.0 (2007-07-22)

&nbsp;&nbsp;This release makes the Ruby-VPI testing framework more  
&nbsp;&nbsp;lightweight by reducing the number of files and  
&nbsp;&nbsp;parameters involved.

Caution

&nbsp;&nbsp;• The generate\_test.rb and convert.rb executables have  
&nbsp;&nbsp;&nbsp;&nbsp;been replaced by a single ruby-vpi executable to avoid  
&nbsp;&nbsp;&nbsp;&nbsp;name conflicts with other software. They are now  
&nbsp;&nbsp;&nbsp;&nbsp;accessed using the

&nbsp;&nbsp;&nbsp;&nbsp;ruby-vpi generate

&nbsp;&nbsp;&nbsp;&nbsp;and

&nbsp;&nbsp;&nbsp;&nbsp;ruby-vpi convert

&nbsp;&nbsp;&nbsp;&nbsp;commands respectively.

&nbsp;&nbsp;• The --name parameter has been removed from the  
&nbsp;&nbsp;&nbsp;&nbsp;automated test generator. Similarly, you can no longer  
&nbsp;&nbsp;&nbsp;&nbsp;insert an arbitrary name in a test’s file names (see  
&nbsp;&nbsp;&nbsp;&nbsp;the user manual for details).

&nbsp;&nbsp;• The DEBUG environment variable, which controls wether  
&nbsp;&nbsp;&nbsp;&nbsp;the test runner starts the interactive debugger, has  
&nbsp;&nbsp;&nbsp;&nbsp;been renamed to DEBUGGER.

&nbsp;&nbsp;• The SIMULATOR\_TARGET and SIMULATOR\_INCLUDES parameters  
&nbsp;&nbsp;&nbsp;&nbsp;have been eliminated from test runners. The former is  
&nbsp;&nbsp;&nbsp;&nbsp;detected automatically. As for the latter, you can  
&nbsp;&nbsp;&nbsp;&nbsp;specify paths to directories in the SIMULATOR\_SOURCES  
&nbsp;&nbsp;&nbsp;&nbsp;parameter instead.

&nbsp;&nbsp;• The bench.rb and bench.v files of a generated test are  
&nbsp;&nbsp;&nbsp;&nbsp;(1) no longer generated by the test generator and (2)  
&nbsp;&nbsp;&nbsp;&nbsp;are now ignored. You must move the functionality  
&nbsp;&nbsp;&nbsp;&nbsp;provided by these files into design.rb and your Verilog  
&nbsp;&nbsp;&nbsp;&nbsp;module’s source file respectively.

&nbsp;&nbsp;• The design.rb and proto.rb files are now loaded into a  
&nbsp;&nbsp;&nbsp;&nbsp;separate namespace (Ruby module). For example, if the  
&nbsp;&nbsp;&nbsp;&nbsp;Verilog module under test has the name “counter” and  
&nbsp;&nbsp;&nbsp;&nbsp;the design.rb file defines a class named “Foo”, then  
&nbsp;&nbsp;&nbsp;&nbsp;that class will be accessible as “Counter::Foo”.

&nbsp;&nbsp;• The global Vpi::simulate method has been replaced by  
&nbsp;&nbsp;&nbsp;&nbsp;the cycle! method in the design.rb file.

&nbsp;&nbsp;• The simulate! method in the proto.rb file has been  
&nbsp;&nbsp;&nbsp;&nbsp;renamed to feign! for accuracy.

&nbsp;&nbsp;• The RubyVpi module has been renamed to RubyVPI.

&nbsp;&nbsp;• RSpec \>= 1.0.0 is now required by Ruby-VPI.

&nbsp;&nbsp;• The project license has been further simplified.

Repairs

&nbsp;&nbsp;• Restored support for Enumerable methods in Vpi::Handle.

&nbsp;&nbsp;• The specification now begins to execute at simulation  
&nbsp;&nbsp;&nbsp;&nbsp;time 0. Previously it began at simulation time 1.

Improvements

&nbsp;&nbsp;• The bench.rb and bench.v files of a generated test have  
&nbsp;&nbsp;&nbsp;&nbsp;been eliminated!

&nbsp;&nbsp;&nbsp;&nbsp;One important benefit is that the Ruby interface to the  
&nbsp;&nbsp;&nbsp;&nbsp;Verilog module under test is now a direct reference,  
&nbsp;&nbsp;&nbsp;&nbsp;whereas previously it was an indirect reference (it  
&nbsp;&nbsp;&nbsp;&nbsp;pointed to the Verilog module defined in bench.v, which  
&nbsp;&nbsp;&nbsp;&nbsp;in turn wrapped around the actual Verilog module under  
&nbsp;&nbsp;&nbsp;&nbsp;test).

&nbsp;&nbsp;&nbsp;&nbsp;As a result, you can now access the internals of the  
&nbsp;&nbsp;&nbsp;&nbsp;Verilog module under test by simply calling methods on  
&nbsp;&nbsp;&nbsp;&nbsp;the Ruby interface, as you would naturally expect to be  
&nbsp;&nbsp;&nbsp;&nbsp;the case.

&nbsp;&nbsp;• The “a” accessor, which returns an array of child  
&nbsp;&nbsp;&nbsp;&nbsp;handles, has been added to the method naming format for  
&nbsp;&nbsp;&nbsp;&nbsp;accessing child handles.

&nbsp;&nbsp;• All parameter objects in the Verilog module under test  
&nbsp;&nbsp;&nbsp;&nbsp;are automatically made available as constants. For  
&nbsp;&nbsp;&nbsp;&nbsp;example, if the Verilog module under test has the name  
&nbsp;&nbsp;&nbsp;&nbsp;counter and has a parameter object named WIDTH, then  
&nbsp;&nbsp;&nbsp;&nbsp;you can access the integer value of that parameter  
&nbsp;&nbsp;&nbsp;&nbsp;using Counter::WIDTH.

&nbsp;&nbsp;• The automated test generator now tries to automatically  
&nbsp;&nbsp;&nbsp;&nbsp;detect the clock and reset signal from Verilog module  
&nbsp;&nbsp;&nbsp;&nbsp;declarations.

&nbsp;&nbsp;• Exceptions are now raised when you try to write to a  
&nbsp;&nbsp;&nbsp;&nbsp;read-only VPI property, such as VpiName.

&nbsp;&nbsp;• Added high?, high!, low?, and low! methods to the  
&nbsp;&nbsp;&nbsp;&nbsp;Vpi::Handle class.

&nbsp;&nbsp;• Revised the user manual by removing unnecessary  
&nbsp;&nbsp;&nbsp;&nbsp;sections and adding newer material from my master’s  
&nbsp;&nbsp;&nbsp;&nbsp;thesis.

Contributions

&nbsp;&nbsp;• Added Jacinto Shy II’s register file example to  
&nbsp;&nbsp;&nbsp;&nbsp;Ruby-VPI. It can be found in samp/register\_file/.

> **···**
>
> --  
> Posted via [http://www.ruby-forum.com/](http://www.ruby-forum.com/).
