libusb 0.2.2 → 0.3.0

data/Manifest.txt

@@ -1,3 +0,0 @@
-# List of files is auto generated by 'git ls-files',
-# but let Hoe find the VERSION string:
-lib/libusb.rb

data/README.rdoc

@@ -1,115 +0,0 @@
-# -*- coding: utf-8 -*-
-
-= Access USB devices from Ruby via libusb-1.0.
-
-* http://github.com/larskanis/libusb
-
-== DESCRIPTION:
-
-LIBUSB is a Ruby binding that gives Ruby programmers access to arbitrary USB devices.
-
-* libusb[http://libusbx.org] is a library that gives full access to devices connected via the USB bus. No special kernel driver is thus necessary for accessing USB devices.
-* This Ruby binding supports the API version 1.0 of libusb[http://libusbx.org]. Note that the old "legacy" version 0.1.x of libusb uses a completely different API that is covered by the ruby extension ruby-usb[http://www.a-k-r.org/ruby-usb/] .
-
-
-LIBUSB for Ruby is covered by the GNU Lesser General Public License version 3.
-
-== FEATURES:
-* Access to descriptors of devices, configurations, interfaces, settings and endpoints
-* Synchronous and asynchronous communication for bulk, control, interrupt and isochronous transfers
-* Compatibility layer for ruby-usb[http://www.a-k-r.org/ruby-usb/] (API based on libusb-0.1). See {::USB} for description.
-
-== SYNOPSIS:
-
-  require "libusb"
-
-  usb = LIBUSB::Context.new
-  device = usb.devices(:idVendor => 0x04b4, :idProduct => 0x8613).first
-  device.open_interface(0) do |handle|
-    handle.control_transfer(:bmRequestType => 0x40, :bRequest => 0xa0, :wValue => 0xe600, :wIndex => 0x0000, :dataOut => 1.chr)
-  end
-{LIBUSB::Context#devices} is used to get all or only particular devices.
-After {LIBUSB::Device#open_interface opening and claiming} the {LIBUSB::Device} the resulting {LIBUSB::DevHandle} can be
-used to communicate with the connected USB device
-by {LIBUSB::DevHandle#control_transfer}, {LIBUSB::DevHandle#bulk_transfer},
-{LIBUSB::DevHandle#interrupt_transfer} or by using the {LIBUSB::Transfer} classes.
-
-A {LIBUSB::Device} can also be used to retrieve information about it,
-by using the device descriptor attributes.
-A {LIBUSB::Device} could have several configurations. You can then decide of which
-configuration to enable. You can only enable one configuration at a time.
-
-Each {LIBUSB::Configuration} has one or more interfaces. These can be seen as functional group
-performing a single feature of the device.
-
-Each {LIBUSB::Interface} has at least one {LIBUSB::Setting}. The first setting is always default.
-An alternate setting can be used independent on each interface.
-
-Each {LIBUSB::Setting} specifies it's own set of communication endpoints.
-Each {LIBUSB::Endpoint} specifies the type of transfer, direction, polling interval and
-maximum packet size.
-
-
-== REQUIREMENTS:
-
-* Linux, MacOSX or Windows system with Ruby MRI 1.8.7/1.9.x or JRuby
-
-== INSTALL:
-
-  gem install libusb
-
-In order to use LIBUSB, you also need the libusb-1.0[http://libusbx.org] library (but not necessarily its header files).
-* Debian or Ubuntu:
-    sudo apt-get install libusb-1.0-0-dev
-* OS-X: install with homebrew:
-    brew install libusb
-  or macports:
-    port install libusb
-* Windows: libusb.gem comes with a precompiled +libusb.dll+, but you need to install a device driver (see below)
-
-Latest code can be used in this way:
-
-  git clone git://github.com/larskanis/libusb.git
-  rake install_gem
-
-
-== Usage on Windows
-
-In contrast to Linux, any access to an USB device by LIBUSB on Windows requires a proper driver
-installed in the system. Fortunately creating such a driver is quite easy with
-Zadig[http://sourceforge.net/projects/libwdi/files/zadig/]. Select the interesting USB device,
-choose WinUSB driver and press "Install Driver". That's it. You may take the generated output directory
-with it's INI-file and use it for driver installation on other 32 or 64 bit Windows
-systems.
-
-
-== Cross compiling for Windows
-
-Libusb-gem can be build on a linux or darwin host for the win32 platform,
-using the mingw cross compiler collection. Libusb is downloaded from source
-git repo, cross compiled and included in the generated libusb.gem.
-
-Install mingw32. On a debian based system this should work:
-
-  apt-get install mingw32
-
-On MacOS X, if you have MacPorts installed:
-
-  port install i386-mingw32-gcc
-
-Download and cross compile libusb for win32:
-
-  rake cross gem
-
-If everything works, there should be libusb-VERSION-x86-mingw32.gem in the pkg
-directory.
-
-== Resources
-
-* API documentation of Libusb for Ruby: http://rubydoc.info/gems/libusb/frames
-* Mailinglist: http://rubyforge.org/mailman/listinfo/libusb-hackers
-* Overall introduction to USB: http://www.usbmadesimple.co.uk
-
-== Todo
-
-* add proper handling for polling and timing: http://libusb.sourceforge.net/api-1.0/group__poll.html

data/test/test_libusb_keyboard.rb

@@ -1,50 +0,0 @@
-# This test requires a connected, but not mounted mass storage device with
-# read/write access allowed. Based on the following specifications:
-#   http://www.usb.org/developers/devclass_docs/usbmassbulk_10.pdf
-#   http://en.wikipedia.org/wiki/SCSI_command
-#
-
-require "test/unit"
-require "libusb"
-
-class TestLibusbKeyboard < Test::Unit::TestCase
-  include LIBUSB
-
-  attr_accessor :usb
-  attr_accessor :device
-  attr_accessor :dev
-  attr_accessor :endpoint_in
-  attr_accessor :endpoint_out
-
-  def setup
-    @usb = Context.new
-    @usb.debug = 3
-
-    @device = usb.devices( :bDeviceClass=>CLASS_HID, :bDeviceProtocol=>1 ).first
-    abort "no keyboard device found" unless @device
-
-    @endpoint_in = @device.endpoints.find{|ep| ep.bEndpointAddress&ENDPOINT_IN != 0 }.bEndpointAddress
-    @endpoint_out = @device.endpoints.find{|ep| ep.bEndpointAddress&ENDPOINT_IN == 0 }.bEndpointAddress
-
-    @dev = @device.open
-
-    if RUBY_PLATFORM=~/linux/i && dev.kernel_driver_active?(0)
-      dev.detach_kernel_driver(0)
-    end
-    dev.claim_interface(0)
-
-    # clear any pending data
-    dev.clear_halt(endpoint_in)
-  end
-
-  def teardown
-    dev.release_interface(0) if dev
-    dev.close if dev
-  end
-
-  def test_read
-    data_length = 8
-    recv = dev.interrupt_transfer(:endpoint=>endpoint_in, :dataIn=>data_length)
-    p recv
-  end
-end