basechip 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,20 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'archive-tar-minitar'
+gem 'activesupport'
+gem 'i18n'
+gem 'thor'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+ #gem "shoulda", ">= 0"
+  gem "yard"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+  gem "turn", :require=>false
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.0)
+    ansi (1.3.0)
+    archive-tar-minitar (0.5.2)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2)
+    rcov (0.9.9)
+    thor (0.14.6)
+    turn (0.8.2)
+      ansi (>= 1.2.2)
+    yard (0.7.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  archive-tar-minitar
+  bundler (~> 1.0.0)
+  i18n
+  jeweler (~> 1.6.4)
+  rcov
+  thor
+  turn
+  yard

data/LICENSE.txt

@@ -0,0 +1,14 @@
+Copyright 2011 Tommy Poulter
+
+basechip is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+basechip is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with basechip.  If not, see <http://www.gnu.org/licenses/>.

data/README.rdoc

@@ -0,0 +1,19 @@
+= basechip
+
+Description goes here.
+
+== Contributing to basechip
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Tommy Poulter. See LICENSE.txt for
+further details.
+

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/basechip

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+
+# Copyright 2011 Tommy Poulter
+#
+# This file is part of basechip.
+#
+# basechip is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+# 
+# basechip is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with basechip.  If not, see <http://www.gnu.org/licenses/>.
+
+begin
+#   require "base_chip"
+# rescue LoadError
+  path = File.expand_path('../../lib', __FILE__)
+  $:.unshift(path)
+  require "base_chip"
+end

data/collateral/block/block.rb.erb

@@ -0,0 +1,20 @@
+
+# these routines search for and install various settings in the base_chip/
+# folder
+discover_recipes
+discover_tools
+discover_configurations
+discover_actions
+discover_test_lists
+
+# define configurations and actions applicable for all configurations
+# configuration :block_name do |b|
+#   Things to do
+# end
+
+# define defaults for any setting on any element in the data structure below
+# this block
+# delete_on_pass true
+# zip_on_fail true
+
+

data/collateral/configuration/configuration.rb.erb

@@ -0,0 +1,19 @@
+
+# these routines search for and install various settings in the base_chip/
+# folder
+discover_recipes
+discover_tools
+discover_actions
+discover_test_lists
+
+# define configurations and actions applicable for all configurations
+# configuration :block_name do |b|
+#   Things to do
+# end
+
+# define defaults for any setting on any element in the data structure below
+# this block
+# delete_on_pass true
+# zip_on_fail true
+
+

data/collateral/project/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'archive-tar-minitar'
+gem 'activesupport'
+gem 'i18n'
+gem 'thor'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+ #gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+  gem "turn", :require=>false
+end

data/collateral/project/gitignore

@@ -0,0 +1,6 @@
+*.dbg
+*.dbg.gz
+*.vcd
+*.vcd.gz
+out
+reports

data/collateral/project/project.rb.erb

@@ -0,0 +1,76 @@
+# This file contains the configuration for the project 'usbhostslave', and is
+#   executed from within that project
+
+
+# This routine sets up the default directory structure for finding source
+#   files according to language and purpose.  You can define your own
+#   directory structure if you prefer.  The directory structure is primarily
+#   used for creating build lists, and can be ignored/omitted if you don't need
+#   BaseChip to generate build lists.
+default_directory_structure
+default_modes
+
+# A directory needs to be set up as a landing place for installed tools and
+#   blocks not stored in the repository.
+shared_directory '/home/poulter/silicon/basechip/test/examples/soc2/shared'
+
+
+# These routines search for and execute various settings files in the base_chip/
+#   folder.
+discover_recipes        # Execute all files in base_chip/recipes in this context
+                        
+discover_subprojects    # Find all files in base_chip/subprojects or
+                        #   base_chip/project.rb in subdirectories, add a
+                        #   subproject for each, and execute the file within
+                        #   that block's context.
+                        
+discover_blocks         # Find all files in base_chip/blocks or base_chip/block.rb
+                        #   in subdirectories, add a block for each, and execute
+                        #   the file within that block's context.
+discover_configurations # Find all files in base_chip/configurations, add a tool
+                        #   for each, and execute the file within that
+                        #   configuration's context.
+                        
+discover_tools          # Find all files in base_chip/tools, add a tool for each,
+                        #   and execute the file within that tool's context.
+discover_actions        # Find all files in base_chip/actions, add an action for
+                        #   each, and execute the file within that action's
+                        #   context
+discover_test_lists     # Find all files in base_chip/test_lists, add a test
+                        #   list for each, and execute the file within that test
+                        #   list's context.
+
+discover_cluster_types  # Find all files in base_chip/cluster_types, add a
+                        #   cluster_type for each, and execute the file within
+                        #   that cluster_type's context.
+
+
+# blocks need at least one configuration.  The :default configuration has
+#   special meaning, as it is used when no configuration is specified on the
+#   command line or when referencing a subblock.  This can be removed, but
+#   defining it here adds it to all blocks and generally saves time.
+#   "remove_configuration :default" can be called for the blocks that don't
+#   want this configuration present.
+configuration :default do |c|
+end
+
+block :wrapper do |b|
+  b.action :icarun do |a|
+    a.pass_regex /Finished all tests/
+  end
+end
+block :usbDevice do |b|
+  b.action :icarun do |a|
+    a.pass_regex /Finished all tests/
+  end
+end
+
+# # If discover_blocks isn't being used, you can define blocks and
+# #   configurations/actions applicable for all blocks as shown below
+# block :block_name do |b|
+#   Things to do
+# end
+
+# # define defaults for any setting on any element in the data structure
+# delete_on_pass true
+# zip_on_fail true

data/collateral/project/settings.rb.erb

@@ -0,0 +1,26 @@
+
+project :<%= BaseChip.project %> do |p|
+
+  # this routine sets up the default directory structure for finding source
+  # files according to language and purpose
+  p.default_directory_structure
+  
+  # these routines search for and install various settings in the base_chip/
+  # folder
+  p.discover_recipes
+  p.discover_tools
+  p.discover_blocks
+  p.discover_configurations
+  p.discover_actions
+  p.discover_test_lists
+  
+  # define blocks and configurations/actions applicable for all blocks
+  # p.block :block_name do |b|
+  #   Things to do
+  # end
+
+  # define defaults for any setting on any element in the data structure
+  # p.delete_on_pass true
+  # p.zip_on_fail true
+
+end

data/collateral/recipes/icarus.rb

@@ -0,0 +1,73 @@
+# Copyright 2011 Tommy Poulter
+#
+# This file is part of basechip.
+#
+# basechip is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+# 
+# basechip is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with basechip.  If not, see <http://www.gnu.org/licenses/>.
+
+tool :icarus do |t|
+  t.default_version "0.9.4"
+
+  t.packages :ubuntu => %w{ build-essential
+                            git-core
+                            wget 
+                          }
+  vs = %w{0.4 0.6 0.6.1 0.7 0.8 0.8.1 0.8.2 0.8.3 0.8.4 0.8.5 0.8.6 0.8.7 0.9.1 0.9.2 0.9.3 0.9.4 cvshead elaborate-net-rework embedded-vvp master pei-branch performance v0_6-branch v0_8-branch v0_8-devel v0_9-branch var-array-rework verilog-ams version0_1 vvp-net-out-rework}
+  vs.each do |name|
+    t.version name do |v|
+      v.install %{
+        mkdir -p                                         #{v.path}     &&
+        git clone git://icarus.com/~steve-icarus/verilog #{v.tool.path}/tmp &&
+        cd                                               #{v.tool.path}/tmp &&
+        #{
+          case v.name
+          when /^[\d\.]+$/; "git checkout v#{v.name.gsub(/\./,'_')} &&\n"
+          when 'master'   ;
+          else            ; "git checkout #{ v.name               } &&\n"
+          end
+}        sh autoconf.sh &&
+        ./configure --prefix=#{v.path} &&
+        make         &&
+        make install &&
+        rm -rf               #{v.tool.path}/tmp
+      }
+    end
+  end
+end
+
+action :icarus do |a|
+  a.log_to   "icarus.log"
+  a.out_file "icarus.log" do end
+
+  a.before lambda {
+    f = File.open("icarus.f","w")
+    f.puts((a.configuration.bom.headers.to_a.map{|h| "+incdir+#{h}"} + 
+            a.configuration.bom.verilog.to_a                         ).join("\n"))
+    f.close
+  }
+
+  a.configuration.tools[:icarus].configure
+  a.command "#{a.configuration.tools[:icarus].path}/bin/iverilog #{a.args} -f icarus.f"
+end
+
+action :icarun do |a|
+  a.log_to   "icarun.log"
+  a.out_file "icarun.log" do end
+
+  a.append_depends [:icarus]
+
+  a.args BaseChip.options.replace_arguments.join(' ') if BaseChip.options.replace_arguments
+
+  a.configuration.actions[:icarus].configure
+  a.command "#{a.configuration.actions[:icarus].directory}/a.out #{BaseChip.options.append_arguments.join(' ') if BaseChip.options.append_arguments} #{a.args}"
+end
+

data/collateral/recipes/icarus.rb.erb

@@ -0,0 +1,88 @@
+# Copyright 2011 Tommy Poulter
+#
+# This file is part of basechip.
+#
+# basechip is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+# 
+# basechip is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with basechip.  If not, see <http://www.gnu.org/licenses/>.
+
+<%
+  default_version = nil
+  vs              = []
+
+  `git ls-remote git://icarus.com/~steve-icarus/verilog`.split(/\n/).each do |b|
+    next unless b = case b
+                    when /refs\/tags\/v([\d_]+\d)$/; default_version = $1.gsub(/_/,'.')
+                    when /refs\/heads\/(.*)$/  ; $1
+                    end
+
+    vs << b
+  end
+  vs.sort!
+%>
+
+tool :icarus do |t|
+  t.default_version <%= default_version.inspect %>
+
+  t.packages :ubuntu => %w{ build-essential
+                            git-core
+                            wget 
+                          }
+  vs = %w{<%= vs.join(' ') %>}
+  vs.each do |name|
+    t.version name do |v|
+      v.install %{
+        mkdir -p                                         #{v.     path} &&
+        git clone git://icarus.com/~steve-icarus/verilog #{v.tool.path}/tmp &&
+        cd                                               #{v.tool.path}/tmp &&
+        #{
+          case v.name
+          when /^[\d\.]+$/; "git checkout v#{v.name.gsub(/\./,'_')} &&\n"
+          when 'master'   ;
+          else            ; "git checkout #{ v.name               } &&\n"
+          end
+}        sh autoconf.sh &&
+        ./configure --prefix=#{v.path} &&
+        make         &&
+        make install &&
+        rm -rf               #{v.tool.path}/tmp
+      }
+    end
+  end
+end
+
+action :icarus do |a|
+  a.log_to   "icarus.log"
+  a.out_file "icarus.log" do end
+
+  a.before lambda {
+    f = File.open("icarus.f","w")
+    f.puts((a.configuration.bom.headers.to_a.map{|h| "+incdir+#{h}"} + 
+            a.configuration.bom.verilog.to_a                         ).join("\n"))
+    f.close
+  }
+
+  a.configuration.tools[:icarus].configure
+  a.command "#{a.configuration.tools[:icarus].path}/bin/iverilog #{a.args} -f icarus.f"
+end
+
+action :icarun do |a|
+  a.log_to   "icarun.log"
+  a.out_file "icarun.log" do end
+
+  a.append_depends [:icarus]
+
+  a.args BaseChip.options.replace_arguments.join(' ') if BaseChip.options.replace_arguments
+
+  a.configuration.actions[:icarus].configure
+  a.command "#{a.configuration.actions[:icarus].directory}/a.out #{BaseChip.options.append_arguments.join(' ') if BaseChip.options.append_arguments} #{a.args}"
+end
+

data/collateral/recipes/local_cluster.rb

@@ -0,0 +1,27 @@
+# Copyright 2011 Tommy Poulter
+#
+# This file is part of basechip.
+#
+# basechip is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+# 
+# basechip is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with basechip.  If not, see <http://www.gnu.org/licenses/>.
+
+cluster_type :local   do |t|
+  t.cluster  :default do |c|
+    # Process.spawn issues the command and returns the process id
+    c.submit_procedure lambda { |command|
+      Process.spawn command
+    }
+    # Don't need a procedure here.  BaseChip will add the id returned from submit_procedure to this command
+    c.kill_command "kill -9"
+  end
+end
+

data/lib/array.rb

@@ -0,0 +1,26 @@
+# Copyright 2011 Tommy Poulter
+#
+# This file is part of basechip.
+#
+# basechip is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 3 as
+# published by the Free Software Foundation.
+# 
+# basechip is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with basechip.  If not, see <http://www.gnu.org/licenses/>.
+
+class Array
+  def nice_or
+    case size
+    when 0; raise "nice_or should not be called on an empty array"
+    when 1;    self[0]
+    when 2; "#{self[0]                 } or #{self[-1]}"
+    else    "#{self[0 .. -2].join(', ')} or #{self[-1]}"
+    end
+  end
+end