ruby-adept 0.0.1 → 1.0.0

data/Gemfile

@@ -1,10 +1,10 @@
 source 'https://rubygems.org'
 
-gem "ffi"
-gem "bindata"
-gem "trollop"
-gem "smart_colored"
-gem "progressbar"
+gemspec
+
+group :development do
+  gem 'pry'
+end
 
 # Specify your gem's dependencies in adept.gemspec
 gemspec

data/Rakefile

@@ -1,16 +1,25 @@
 require "bundler/gem_tasks"
 
-task :default => [:test_offline]
+task :default => :test_all
 
-#Offline tests only: don't perform tests that require live hardware. 
-task :test_offline do
-  sh "rspec -Ilib --tag=~online"
+task :test_all do
+  sh "rspec -Ilib"
 end
 
-task :test do
-  sh "rspec -Ilib"
+desc 'Builds the ruby-adept gem.'
+task :build do
+  sh "gem build ruby-adept.gemspec"
 end
 
-task :install_adept do
+desc 'Builds and installs the ruby-adept gem.'
+task :install => :build do
+  sh "gem install pkg/ruby-adept-#{Adept::VERSION}.gem"
+end
 
+desc 'Tags the current version, pushes it GitHub, and pushes the gem.'
+task :release => :build do
+  sh "git tag v#{Adept::VERSION}"
+  sh "git push origin master"
+  sh "git push origin v#{Adept::VERSION}"
+  sh "git push pkg.ruby-adept-#{Adept::VERSION}.gem"
 end

data/bin/bprog

@@ -37,10 +37,14 @@ end
 #
 # Get the currently connected device.
 #
-def get_target_connection(opts={})
+def get_target_connection(fail_silently = false)
 
   #Ensure that we have a plugged-in board.
-  fatal_error "It doesn't look like there's a Digilent board plugged in, on or off." if Device::connected_devices.empty? 
+  if Device::connected_devices.empty?
+    fatal_error "It doesn't look like there's a Digilent board plugged in, on or off." unless fail_silently
+    exit
+  end
+
 
   #By default, use the first connected device.
   device = Device::open_first_connected_device
@@ -50,7 +54,12 @@ def get_target_connection(opts={})
   fatal_error "This device isn't supported." unless device.supported_connections.include?(JTAG::Connection)
 
   jtag = JTAG::Connection.new(device)
-  fatal_error "The power switch is off on your connected board! Turn it on, and try again." if jtag.connected_devices.empty?
+
+  #Ensure that we found a supporte FPGA.
+  if jtag.connected_devices.empty?
+    fatal_error "The power switch is off on your connected board! Turn it on, and try again." unless fail_silently
+    exit
+  end
 
   jtag
 
@@ -59,16 +68,21 @@ end
 #
 # Get the target file.
 # 
-def get_target_file(opts={})
+def get_target_file(do_not_guess=false, allow_none = false)
 
   #If a file was provided on the command line, use it.
   file = ARGV.shift if ARGV
 
   #Attempt to determine the target file automagically.
-  unless file
+  unless file or do_not_guess
 
     #Attempt to determine the file.
-    file = ISE::ProjectNavigator::most_recent_project.bit_file
+    begin
+      file = ISE::ProjectNavigator::most_recent_project.bit_file
+    rescue
+      file = nil
+    end
+
     fatal_error "You didn't specify a file to program, and I couldn't figure out a likely candidate.\n      Perhaps you still need to generate a programming file?"  unless file
 
     #And warn the user of the file we chose.
@@ -77,27 +91,176 @@ def get_target_file(opts={})
 
   end
 
-  fatal_error "The file you asked me to program doesn't seem to exist." unless File::exists?(file)
+  #If the provided file does not exist...
+  unless file && File::exists?(file) 
+
+    #... and this is allowed, return nil.
+    if allow_none 
+      return nil
+
+    #Otherwise, throw a fatal error.
+    end
+      fatal_error "The file you asked me to program doesn't seem to exist." 
+    else
+
+  end
+
 
   #Return the ascertained file.
   file
 
 end
 
-def configure_fpga(jtag, bitfile_path)
+#
+# Returns the part name of the first connected FPGA,
+# or nil if no FPGAs are connected.
+#
+def connected_fpga_part_name(jtag)
+ 
+  #Find the first connected FPGA.
+  fpga = jtag.connected_devices.find { |device| device.is_a? JTAG::Devices::FPGA }
+
+  #If we found an FPGA, return its part name. Otherwise, return nil.
+  return fpga ? fpga.part_name : nil
+
+end
+
+#
+# Configures the first connected FPGA with the provided bitstream.
+#
+def configure_fpga(jtag, bitstream)
 
   #Find the first connected FPGA.
   fpga = jtag.connected_devices.find { |device| device.is_a? JTAG::Devices::FPGA }
   fatal_error "This board doesn't feature a supported FPGA!" unless fpga
 
-  #Get the bit-file in question.
-  bitstream = Adept::DataFormats::Bitstream.from_file(bitfile_path)
+  #If we've been provided with a string, assume it is a filename,
+  #and open the relevant bitfile.
+  if bitstream.is_a?(String)
+    bitstream = Adept::DataFormats::Bitstream.from_file(bitfile_path)
+  end
+
+  #Use the bitfile to program the device.
   fpga.configure(bitstream)
 
 end
 
-connection = get_target_connection
-file = get_target_file
+#
+# Displays a list of available cores.
+# 
+def list_available_cores(compatible_with=nil, display_help=true)
+
+  #Print a short header...
+  puts((compatible_with ? ' Connected board supports the following' : ' Available ').bold + " cores:\n\n".bold)
+
+  #... and a list of available cores.
+  cores = Core.available_cores(compatible_with)
+  cores.each { |core| puts "  #{core.shortname}:\t#{core.name}\t(#{core.targets.keys.join(", ")})" }
+
+  puts "  No cores supported." if cores.empty?
+
+  #If the display_help option was set, display a short help blurb.
+  if display_help 
+    puts "\n  Short-names (to the left) can be used as parameters to the"
+    puts "  --core command line flag."
+  end
+
+end
+
+#
+# Merge the provided file into the specified core, and return the resultant
+# bitstream.
+#
+def merge_file_and_core(core_name, file, target=nil)
+
+  #... try to find a core with the given name.
+  core = Core.from_shortname(core_name)
+
+  #If we couldn't find a core with the given name, print an error message.
+  unless core 
+    fatal_error "Couldn't find a core with the name #{core_name.underline}.\n" + 
+      "You can list all available cores with the --list-cores command line option.  " 
+  end
+
+  if file
+    puts "Merging".bold + " #{File.basename(file)} into the #{core.shortname} core..."
+  end
+
+  #Create a bitstream from the given core.
+  file = core.to_bitstream(target, file)
+
+  #Notify the user that programming is about to begin.
+  puts "Programming".bold + " the attached board with the #{core.shortname} core..."
+
+  file
+
+end
+
+def read_bitstream(file)
+  begin
+    Adept::DataFormats::Bitstream.from_file(file)
+  rescue IOError
+    fatal_error "You specified a file to program that wasn't a bitfile!\n" +
+       "(If you wanted to program this file to a processor core, use the --core <processor> option.)"
+  end
+end
+
+#Parse the command-line flags.
+options = Trollop::options do
+  version "bprog #{Adept::VERSION} (c) 2013 Binghamton University"
+
+  banner <<-BANNER
+  bprog #{Adept::VERSION} (c) 2013 Binghamton University
+  Author: Kyle Temkin, ktemkin@binghamton.edu
+
+  bprog ("board programmer") is a command-line programmer for Digilent devices
+  intended to simplify the process of programming Digilent devices.
+
+  usage: [options] <filename>
+
+  BANNER
+
+  opt :core, "Specifies a soft-core to use. If a compiled program is provided, it will be merged into the specified core.", :type => String
+  opt :'list-cores', "Display a list of all available processor cores." 
+
+end
+
+# If the list-cores option is set, list the available cores, and quit.
+list_available_cores if options[:'list-cores']
+
+# If we're using the core option, make the file argument optional,
+# and do not attempt to guess it. (Options[:core] will be nil unless
+# a core name is provided, and true-like otherwise.)
+allow_none = do_not_guess = options[:core]
+
+# Create a JTAG connection to the Adept board.
+connection = get_target_connection(options[:'list-cores'])
+
+# Get the name of the connected FPGA, if applicable.
+part_name = connected_fpga_part_name(connection)
+
+#If the list_available_cores flag is set, list the compatible cores,
+#
+#and quit.
+if options[:'list-cores']
+  puts
+  puts
+  list_available_cores(part_name, false) 
+  exit
+end
+
+# Get the target file, if applicable.
+file = get_target_file(do_not_guess, allow_none)
+
+# If the core option was specified, attempt to merge it with the provided
+# filename. (If no filename was provided, the core's bitstream will be returned.)
+if options[:core]
+  file = merge_file_and_core(options[:core], file, part_name) 
+
+# Otherwise, read the file as a bitstream directly.
+else
+  file = read_bitstream(file) 
+end
 
 begin
   configure_fpga(connection, file)

data/cores/avr8/avr_250k.bmm

@@ -0,0 +1,56 @@
+// BMM LOC annotation file.
+//
+// Release 13.4 -  P.15xf, build 2.8 Mar 16, 2012
+// Copyright (c) 1995-2013 Xilinx, Inc.  All rights reserved.
+
+
+///////////////////////////////////////////////////////////////////////////////
+//
+// Processor 'avrmap', ID 0, memory map.
+//
+///////////////////////////////////////////////////////////////////////////////
+
+ADDRESS_MAP avrmap PPC405 0
+
+    ///////////////////////////////////////////////////////////////////////////////
+    //
+    // Processor 'avrmap' address space 'rom_code' 0x00000000:0x00003FFF (16 KBytes).
+    //
+    ///////////////////////////////////////////////////////////////////////////////
+
+    ADDRESS_SPACE rom_code RAMB16 [0x00000000:0x00003FFF]
+        BUS_BLOCK
+            PM_Inst/RAM_Word0 RAMB16 [15:0] [0:1023] PLACED = X1Y2;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word1 RAMB16 [15:0] [1024:2047] PLACED = X0Y1;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word2 RAMB16 [15:0] [2048:3071] PLACED = X0Y2;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word3 RAMB16 [15:0] [3072:4095] PLACED = X1Y0;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word4 RAMB16 [15:0] [4096:5119] PLACED = X1Y5;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word5 RAMB16 [15:0] [5120:6143] PLACED = X1Y3;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word6 RAMB16 [15:0] [6144:7167] PLACED = X1Y4;
+        END_BUS_BLOCK;
+
+        BUS_BLOCK
+            PM_Inst/RAM_Word7 RAMB16 [15:0] [7168:8191] PLACED = X1Y1;
+        END_BUS_BLOCK;
+    END_ADDRESS_SPACE;
+
+END_ADDRESS_MAP;
+

data/cores/avr8/core.yaml

@@ -0,0 +1,11 @@
+name: ATMega103-compatible AVR
+shortname: atmega103
+version: 1.0
+targets: 
+
+  #Spartan 3E 250K-gate
+  3s250ecp132:
+    bit_file: avr_250k.bit
+    memory_map: avr_250k.bmm
+    
+  

data/firmware/epp_stream/epp_stream.xise

@@ -26,7 +26,7 @@
       <association xil_pn:name="PostTranslateSimulation" xil_pn:seqID="5"/>
     </file>
     <file xil_pn:name="epp_controller.vhd" xil_pn:type="FILE_VHDL">
-      <association xil_pn:name="BehavioralSimulation" xil_pn:seqID="12"/>
+      <association xil_pn:name="BehavioralSimulation" xil_pn:seqID="0"/>
       <association xil_pn:name="Implementation" xil_pn:seqID="1"/>
     </file>
     <file xil_pn:name="Basys2_100_250General.ucf" xil_pn:type="FILE_UCF">
@@ -181,7 +181,7 @@
     <property xil_pn:name="Optimization Strategy (Cover Mode)" xil_pn:value="Area" xil_pn:valueState="default"/>
     <property xil_pn:name="Optimize Instantiated Primitives" xil_pn:value="false" xil_pn:valueState="default"/>
     <property xil_pn:name="Other Bitgen Command Line Options" xil_pn:value="" xil_pn:valueState="default"/>
-    <property xil_pn:name="Other Compiler Options" xil_pn:value="" xil_pn:valueState="default"/>
+    <property xil_pn:name="Other Compiler Options" xil_pn:value="-mt off -v 1" xil_pn:valueState="non-default"/>
     <property xil_pn:name="Other Compiler Options Map" xil_pn:value="" xil_pn:valueState="default"/>
     <property xil_pn:name="Other Compiler Options Par" xil_pn:value="" xil_pn:valueState="default"/>
     <property xil_pn:name="Other Compiler Options Translate" xil_pn:value="" xil_pn:valueState="default"/>
@@ -256,8 +256,8 @@
     <property xil_pn:name="Run for Specified Time Translate" xil_pn:value="true" xil_pn:valueState="default"/>
     <property xil_pn:name="Safe Implementation" xil_pn:value="No" xil_pn:valueState="default"/>
     <property xil_pn:name="Security" xil_pn:value="Enable Readback and Reconfiguration" xil_pn:valueState="default"/>
-    <property xil_pn:name="Selected Module Instance Name" xil_pn:value="/TopLevel" xil_pn:valueState="non-default"/>
-    <property xil_pn:name="Selected Simulation Root Source Node Behavioral" xil_pn:value="work.TopLevel" xil_pn:valueState="non-default"/>
+    <property xil_pn:name="Selected Module Instance Name" xil_pn:value="/fifo_testbench" xil_pn:valueState="non-default"/>
+    <property xil_pn:name="Selected Simulation Root Source Node Behavioral" xil_pn:value="work.fifo_testbench" xil_pn:valueState="non-default"/>
     <property xil_pn:name="Selected Simulation Root Source Node Post-Map" xil_pn:value="" xil_pn:valueState="default"/>
     <property xil_pn:name="Selected Simulation Root Source Node Post-Route" xil_pn:value="" xil_pn:valueState="default"/>
     <property xil_pn:name="Selected Simulation Root Source Node Post-Translate" xil_pn:value="" xil_pn:valueState="default"/>
@@ -273,7 +273,7 @@
     <property xil_pn:name="Slice Packing" xil_pn:value="true" xil_pn:valueState="default"/>
     <property xil_pn:name="Slice Utilization Ratio" xil_pn:value="100" xil_pn:valueState="default"/>
     <property xil_pn:name="Specify 'define Macro Name and Value" xil_pn:value="" xil_pn:valueState="default"/>
-    <property xil_pn:name="Specify Top Level Instance Names Behavioral" xil_pn:value="work.TopLevel" xil_pn:valueState="default"/>
+    <property xil_pn:name="Specify Top Level Instance Names Behavioral" xil_pn:value="work.fifo_testbench" xil_pn:valueState="default"/>
     <property xil_pn:name="Specify Top Level Instance Names Post-Map" xil_pn:value="Default" xil_pn:valueState="default"/>
     <property xil_pn:name="Specify Top Level Instance Names Post-Route" xil_pn:value="Default" xil_pn:valueState="default"/>
     <property xil_pn:name="Specify Top Level Instance Names Post-Translate" xil_pn:value="Default" xil_pn:valueState="default"/>

data/lib/adept.rb

@@ -9,3 +9,4 @@ require 'adept/connection_provider'
 require 'adept/jtag'
 
 require 'adept/boards'
+require 'adept/core'

data/lib/adept/core.rb

@@ -0,0 +1,148 @@
+require 'adept'
+require 'yaml'
+require 'tempfile'
+
+module Adept
+
+
+  #
+  # Class which represents a data-2-mem configurable IP core.
+  # 
+  class Core
+
+    attr_reader :name
+    attr_reader :targets
+    attr_reader :shortname
+   
+    #
+    # Returns a list of all available cores, optionally filtered by a device ID string.
+    #
+    def self.available_cores(device=nil)
+
+      #Determine the path at which the ruby-adept gem is stored.
+      gem_path = File.expand_path('../..', File.dirname(__FILE__))
+
+      #Get a list of all available core definition files.
+      core_definitions = Dir["#{gem_path}/cores/**/core.yaml"]
+
+      #Convert each definition to a YAML core.
+      definitions = core_definitions.map { |file| from_definition_file(file) }
+
+      #If we were passed a device shortname to filter by, ensure we
+      #only return cores that support that target.
+      unless device.nil?
+        definitions = definitions.select { |core| core.targets.include?(device) }
+      end
+
+      definitions
+
+    end
+
+    #
+    # Returns the core with the given shortname, or nil if no 
+    # such core exists.
+    #
+    def self.from_shortname(shortname)
+      available_cores.find { |core| core.shortname == shortname }
+    end
+
+    #
+    # Creates a new Core object from a YAML definition file.
+    #
+    # file: The full path to a YAML core definition file.
+    #
+    def self.from_definition_file(file)
+
+      #Get the path of the directory that holds the core's files.
+      base_path = File.dirname(file)
+
+      #Parse the YAML definition file.
+      raw_definition = YAML.load_file(file)
+
+      #Return a new core object. 
+      new(raw_definition["name"], raw_definition["shortname"], base_path, raw_definition["targets"])
+
+    end
+
+    #
+    # Initializes a new instance of a Core object.
+    #
+    def initialize(name, shortname, base_path, targets)
+      @name = name
+      @shortname = shortname
+      @base_path = base_path
+      @targets = targets
+    end
+
+    #
+    #  Returns a bitstream which can be use to load the given core onto the target
+    #  device. If a program is provided, it will be loaded into the resultant bitstream.
+    #
+    #  target: The Device ID string of the board to be programmed.
+    #
+    def to_bitstream(target=@targets.keys.first, program=nil)
+
+      #Ensure the target is a string.
+      target = target.to_s
+
+      #Get the path to the bitfile and memory map which will be used to generate the new bitfile.
+      memory_map = "#@base_path/#{@targets[target]['memory_map']}"
+      bit_file   = "#@base_path/#{@targets[target]['bit_file']}"
+
+      #If no program was provided, return the bitfile unmodified.
+      return Adept::DataFormats::Bitstream.from_file(bit_file) unless program
+
+      #Generate the new raw bitfile...
+      hex = with_temporary_files                      { |dest, _|      system("avr-objcopy -O ihex -R .eeprom -R .fuse -R .lock #{program} #{dest}") } 
+      mem = with_temporary_files(hex, '.mem', '.hex') { |dest, source| system("srec_cat #{source} -Intel -Byte_Swap 2 -Data_Only -Line_Length 100000000 -o #{dest} -vmem 8") }
+      bit = with_temporary_files(mem, '.bit', '.mem') { |dest, source| system("data2mem -bm #{memory_map} -bt #{bit_file} -bd #{source} -o b #{dest}") }
+
+      #... wrap it in a Bitstream object, and return it.
+      Adept::DataFormats::Bitstream.from_string(bit)
+
+    end
+
+    #
+    # Print a debugging represntation of the core.
+    #
+    def inspect
+      "<IP Core 0x#{object_id.to_s(16)}: #@name>"
+    end
+
+    private
+
+    #
+    # Executes a given block with an "anonymous" temporary file.
+    # The temporary file is deleted at the end of the block, and its contents
+    # are returned.
+    # 
+    def with_temporary_files(file_contents='', dest_extension = '', source_extension = '', message=nil)
+
+      #File mode for all of the created temporary files.
+      #Create the files, and allow read/write, but do not lock for exclusive access.
+      file_mode = File::CREAT | File::RDWR
+
+      #Create a new file which contains the provided file content.
+      #Used to pass arbitrary data into an external tool.
+      Tempfile.open(['core_prev', source_extension], :mode => file_mode) do |source_file|
+
+        #Fill the source file with the provided file contents...
+        source_file.write(file_contents)
+        source_file.flush
+
+        #Create a new file which will store the resultant file content.
+        Tempfile.open(['core_next', dest_extension], :mode => file_mode) do |destination_file|
+
+          #Yield the file's paths the provided block.
+          raise CommandFailedError, message unless yield [destination_file.path, source_file.path]
+
+          #And return the content of the destination file.
+          return File::read(destination_file)
+
+        end
+
+      end
+    end
+
+  end
+end

data/lib/adept/error.rb

@@ -1,4 +1,6 @@
 module Adept
   class Error < StandardError; end
   class CommunicationError < Error; end
+  class CommandFailedError < Error; end
+  class UnsupportedDeviceError < Error; end
 end

data/lib/adept/jtag/device.rb

@@ -161,6 +161,8 @@ module Adept
       #
       def self.idcode_matches_mask(mask, idcode)
 
+        return false if idcode.nil?
+
         #Convert the IDcode into a string, for comparison.
         idcode = idcode.unpack("H*").first.downcase
 

data/lib/adept/version.rb

@@ -1,3 +1,3 @@
 module Adept
-  VERSION = "0.0.1"
+  VERSION = "1.0.0"
 end

data/{adept.gemspec → ruby-adept.gemspec}

@@ -15,16 +15,16 @@ Gem::Specification.new do |gem|
   gem.summary       = "Framework for working with Digilent Adept devices."
   gem.homepage      = "http://www.github.com/ktemkin/ruby-adept"
 
-  gem.add_runtime_dependency 'bindata'
+  gem.add_runtime_dependency 'bindata', '~>1.4.5'
+  gem.add_runtime_dependency 'ffi', '~>1.3.1'
+  gem.add_runtime_dependency 'require_all', '~>1.2.1'
+  gem.add_runtime_dependency 'smart_colored', '~>1.1.1'
+  gem.add_runtime_dependency 'trollop', '~>2.0'
+  gem.add_runtime_dependency 'ruby-elf', '~>1.0.8'
   gem.add_runtime_dependency 'ruby-ise'
-  gem.add_runtime_dependency 'trollop'
-  gem.add_runtime_dependency 'smart_colored'
-  gem.add_runtime_dependency 'ffi'
-  gem.add_runtime_dependency 'require_all'
-
-  gem.add_development_dependency 'rspec'
-  gem.add_development_dependency 'fakefs'
 
+  gem.add_development_dependency 'rspec', '~>2.12.0'
+  gem.add_development_dependency 'fakefs', '~>0.4.2'
 
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

data/spec/lib/adept/core_spec.rb

@@ -0,0 +1,58 @@
+
+require 'adept'
+
+#
+# Specification for the Adept Device interface.
+# These tests assume _only_ one connected Basys2 board!
+#
+describe Adept::Core do
+
+  let(:avr8) { 'ATMega103-compatible AVR' }
+
+  #
+  # Matcher which returns true if the given list contains the AVR-8.
+  # 
+  RSpec::Matchers.define :include_a_core_named do |expected|
+    match do |given|
+      given.find { |core| core.name == expected }
+    end
+
+    failure_message_for_should { |given| "expected #{actual.inspect} to contain a core named '#{expected}'" }
+    failure_message_for_should_not { |given| "expected #{actual.inspect} to not contain a core named '#{expected}'" }
+  end
+
+
+  describe "class methods" do
+
+    describe "#available_cores" do
+      subject { Adept::Core }
+
+      it "should return an array of known cores" do
+        
+        #Get a list of all available cores...
+        cores = subject.available_cores
+
+        #... and validate their types.
+        cores.should be_an Array
+        cores.all? { |x| x.should be_a Adept::Core}
+
+      end
+
+      context "when provided with a device name" do
+        it "should return only the cores that correspond to that device name" do
+          subject.available_cores('invalidDevice').should_not include_a_core_named avr8
+        end
+      end
+
+      context "when a device name is not provided" do
+        it "should return all known cores as core objects" do
+          subject.available_cores('3s250ecp132').should include_a_core_named avr8
+        end
+      end
+
+    end
+
+  end
+
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-adept
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,90 +9,106 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-29 00:00:00.000000000 Z
+date: 2013-03-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.5
 - !ruby/object:Gem::Dependency
-  name: ruby-ise
+  name: ffi
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
-  name: trollop
+  name: require_all
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.2.1
 - !ruby/object:Gem::Dependency
   name: smart_colored
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.1.1
 - !ruby/object:Gem::Dependency
-  name: ffi
+  name: trollop
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: require_all
+  name: ruby-elf
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.8
+- !ruby/object:Gem::Dependency
+  name: ruby-ise
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -112,33 +128,33 @@ dependencies:
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.12.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.12.0
 - !ruby/object:Gem::Dependency
   name: fakefs
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.4.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.4.2
 description: ! "Ruby library for working with Digilent devices via the Adept SDK.\n
   \    Provides both low-level wrappers for the Adept SDK elements and high-level\n
   \    interfaces, including simple programming and configuration routines."
@@ -155,9 +171,11 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- adept.gemspec
 - autotest/discover.rb
 - bin/bprog
+- cores/avr8/avr_250k.bit
+- cores/avr8/avr_250k.bmm
+- cores/avr8/core.yaml
 - firmware/.gitignore
 - firmware/epp_stream/Basys2_100_250General.ucf
 - firmware/epp_stream/epp_controller.vhd
@@ -168,6 +186,7 @@ files:
 - lib/adept/boards.rb
 - lib/adept/boards/basys2.rb
 - lib/adept/connection_provider.rb
+- lib/adept/core.rb
 - lib/adept/data_formats.rb
 - lib/adept/data_formats/bitstream.rb
 - lib/adept/data_formats/data_factories.rb
@@ -193,7 +212,9 @@ files:
 - lib/adept/low_level/jtag.rb
 - lib/adept/low_level/library.rb
 - lib/adept/version.rb
+- ruby-adept.gemspec
 - spec/firmware/epp_loopback.bit
+- spec/lib/adept/core_spec.rb
 - spec/lib/adept/data_formats/bitstream_spec.rb
 - spec/lib/adept/data_formats/data_factories_spec.rb
 - spec/lib/adept/device_spec.rb
@@ -229,6 +250,7 @@ specification_version: 3
 summary: Framework for working with Digilent Adept devices.
 test_files:
 - spec/firmware/epp_loopback.bit
+- spec/lib/adept/core_spec.rb
 - spec/lib/adept/data_formats/bitstream_spec.rb
 - spec/lib/adept/data_formats/data_factories_spec.rb
 - spec/lib/adept/device_spec.rb