digiusb 0.0.2

data/bin/digiterm

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+$:.unshift File.dirname(__FILE__) + "/../lib"
+require 'digiusb'
+require 'io/console'
+
+puts "Looking for Digispark running DigiUSB..."
+
+sleep 0.25 until DigiUSB.sparks.length > 0
+spark = DigiUSB.sparks.last
+
+puts "Attached to #{spark}"
+puts "Type control + c to exit"
+
+begin
+  loop do
+    print spark.getc
+    
+    begin
+      char = IO.console.read_nonblock(1)
+      spark.putc char
+    rescue Errno::EAGAIN
+    end
+  end
+rescue LIBUSB::ERROR_PIPE
+  puts "Digispark disconnected or crashed"
+rescue Interrupt
+  puts ""
+end

data/examples/finn.rb

@@ -0,0 +1,13 @@
+require 'digiusb'
+
+spark = DigiUSB.sparks.last
+
+print spark.puts "Jake! Jake! Good Morning! Whatcha' doin' buddy?"
+print msg = spark.gets
+print spark.puts "What are you #{msg.downcase.gsub(/[^a-z]/, '')} about, dude?"
+print spark.gets
+print spark.puts "Haha! Beep! Boop! Boooop! Beep! Boop!"
+print spark.gets
+print spark.puts "Huh! I like it!"
+print spark.puts "Weeeeoooooooo!"
+print spark.puts "Woooooah! Algebraic!"

data/lib/digiusb.rb

@@ -0,0 +1,117 @@
+require 'libusb'
+
+# simple IO-like read/write access to a digispark using the DigiUSB library
+class DigiUSB
+  ProductID = 0x05df
+  VendorID = 0x16c0
+  Manufacturer = "digistump.com"
+  Timeout = 1_000 # one second till device crashes due to lack of calling DigiUSB.refresh()
+  
+  def initialize device
+    @device = device
+    @handle = nil
+  end
+  
+  def self.sparks
+    usb = LIBUSB::Context.new
+    usb.devices.select { |device|
+      device.idProduct == ProductID && device.idVendor == VendorID && device.manufacturer == "digistump.com"
+    }.map { |handle|
+      self.new(handle)
+    }
+  end
+  
+  
+  # read a single character
+  def getc
+    control_transfer(
+      bRequest: 0x01, # hid get report
+      dataIn: 1
+    )
+  end
+  
+  # write a single character
+  def putc character
+    character = [character].pack('c') if character.is_a? Integer
+    raise "Cannot putc more than one byte" if character.bytesize > 1
+    raise "Cannot putc fewer than one byte" if character.bytesize < 1
+    
+    control_transfer(
+      bRequest: 0x09, # hid set report
+      wIndex: character.ord
+    )
+  end
+  
+  # get a string up until the first newline
+  def gets
+    chars = ""
+    chars += getc() until chars.include? "\n"
+    return chars
+  end
+  
+  # write a string followed by a newline
+  def puts string = ""
+    write "#{string}\n"
+  end
+  alias_method :println, :puts
+  
+  # write a string
+  def write string
+    string.each_byte do |byte|
+      putc byte
+    end
+    string
+  end
+  alias_method :print, :write
+  
+  # read a certain number of bytes and return them as a string
+  def read bytes = 1
+    chars = ""
+    chars += getc() until chars.length == bytes
+    return chars
+  end
+  
+  def inspect
+    "<Digispark:#{@device.product}:@#{@device.bus_number}->#{@device.device_address}>"
+  end
+  alias_method :to_s, :inspect
+  
+  
+  
+  private
+  
+  def io
+    unless @handle
+      @handle = @device.open
+    end
+    
+    @handle
+  end
+  
+  def control_transfer(opts = {}) #:nodoc:
+    io.control_transfer({
+      wIndex: 0,
+      wValue: 0,
+      bmRequestType: usb_request_type(opts),
+      timeout: Timeout
+    }.merge opts)
+  rescue LIBUSB::ERROR_TIMEOUT, LIBUSB::ERROR_IO
+    raise ErrorCrashed
+  end
+  
+  # calculate usb request type
+  def usb_request_type opts #:nodoc:
+    value = LIBUSB::REQUEST_TYPE_CLASS | LIBUSB::RECIPIENT_DEVICE
+    value |= LIBUSB::ENDPOINT_OUT if opts.has_key? :dataOut
+    value |= LIBUSB::ENDPOINT_IN if opts.has_key? :dataIn
+    return value
+  end
+end
+
+class DigiUSB::ErrorCrashed < StandardError
+  def initialize
+    super("Digispark has crashed, most likely due to not running DigiUSB.refresh() often enough in device program #{$!.class.name}")
+  end
+end
+
+

data/license.txt

@@ -0,0 +1 @@
+Do whatever you like with it!

data/readme.txt

@@ -0,0 +1,21 @@
+DigiUSB is a little rubygem for talking to Digisparks using the DigiUSB library provided by Digistump. It works a little bit like a digi-serial port - you can send digi-bytes to it and read digi-bytes out, and includes some common digi-methods like gets, puts, print, and write, so you can use it a bit like an IO. DigiUSB also comes with a little terminal called digiterm, which you can use to sort of telnet in to your sparks!
+
+Sometimes it's lonely on the internet so I made a virtual friend as an example. You can find it in the examples folder - open jake.ino up in the digispark version of the arduino software and upload it in the usual way. Once that's done pop open your terminal and enter 'digiterm'
+
+Type in lines like these to play with your new best friend!:->
+
+  Jake! Jake! Good Morning! Whatcha' doin' buddy?
+  What are you meditating about, dude?
+  Haha! Beep! Boop! Boooop! Beep! Boop!
+  Huh! I like it!
+  Weeeeoooooooo!
+  Woooooah! Algebraic!
+
+Eventually I found myself too busy to play with Jake but I didn't want him to get lonely, so I made a robot to play with him. You can setup your own friend for Jake too! Just create a cron job or alarm or whatever on your computer to run finn.rb from the examples folder however often you want. I chose once per second. You might want to opt for a more frequent interval!
+
+I hope this all makes sense and is useful to someone.
+
+As usual, I'm sorry I killed your cat. It was an accident, but I wont accept any liability for that or anything else digiusb might do to you or your beloved friends. What were you doing keeping all those knives in the catroom anyway?!
+
+—
+Bluebie

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: digiusb
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Bluebie
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: libusb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+description: ! "A tiny library for talking to digispark (a small arduino clone) over
+  usb a bit like talking\n  to a real arduino through a serial port! This library
+  works with the DigiUSB library built in to Digistump's\n  version of the Arduino
+  software. Also includes a tiny terminal tool, kinda like telnet for digisparks"
+email: a@creativepony.com
+executables:
+- digiterm
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/digiusb.rb
+- readme.txt
+- license.txt
+- examples/finn.rb
+- !binary |-
+  YmluL2RpZ2l0ZXJt
+homepage: http://github.com/Bluebie/digiusb.rb
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- lib/digiusb.rb
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: a tiny library for talking to digisparks
+test_files: []
+has_rdoc: