libusb 0.7.0-x64-mingw-ucrt

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dc910549250e503a8d367f199199ac7fb2b58629d20616f75d9cb7cf67e5efaf
+  data.tar.gz: 6225ccbcc2c35169106b1c0cb5a78e36f9d24972c6eeb698e0cf104250aca619
+SHA512:
+  metadata.gz: 7eb46d18970c9b92f8d05e003ce893264ade31ff9b3cc05d5b5dd5a79189a8ea3367f2db7819867bb33be6b36184bc1a7e4869bd26337c6bce0897e0e7e0c8a0
+  data.tar.gz: b2229eea4abf30c22df289a84a9226b5803ff929d491420b2d66095ab611ad65df3bb6e70481653fc5a195ab98c81f257923b6613cd9b442eb9eeee30f3be561

data/.appveyor.yml

@@ -0,0 +1,33 @@
+image: Visual Studio 2019
+
+clone_depth: 1
+
+init:
+  - SET PATH=C:/Ruby%ruby_version%/bin;%PATH%
+install:
+  - ps: |
+      if ($env:ruby_version -like "*head*") {
+        $(new-object net.webclient).DownloadFile("https://github.com/oneclick/rubyinstaller2/releases/download/rubyinstaller-head/rubyinstaller-$env:ruby_version.exe", "$pwd/ruby-setup.exe")
+        cmd /c ruby-setup.exe /verysilent /currentuser /dir=C:/Ruby$env:ruby_version
+      }
+  - ruby --version
+  - gem --version
+  - ridk version
+  - ridk enable
+  - c:/msys64/usr/bin/bash -lc "pacman -S --noconfirm --needed ${MINGW_PACKAGE_PREFIX}-gcc ${MINGW_PACKAGE_PREFIX}-openssl"
+  - gcc -v
+  - gem install bundler --conservative
+  - bundle install
+
+build_script:
+  - bundle exec rake compile
+
+test_script:
+  - bundle exec rake ci
+
+environment:
+  matrix:
+    - ruby_version: "head-x64"
+    - ruby_version: "33"
+    - ruby_version: "30-x64"
+    - ruby_version: "25"

data/.github/workflows/ci.yml

@@ -0,0 +1,185 @@
+name: Build docker images
+concurrency:
+  group: "${{github.workflow}}-${{github.ref}}"
+  cancel-in-progress: true
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 5 * * 3" # At 05:00 on Wednesday # https://crontab.guru/#0_5_*_*_3
+  push:
+    branches:
+      - master
+    tags:
+      - "*.*.*"
+  pull_request:
+    types: [opened, synchronize]
+    branches:
+      - "*"
+
+jobs:
+  # These jobs use Buildx layer caching
+  docker_build:
+    name: Build
+
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - x86-mingw32
+          - x64-mingw-ucrt
+          - x64-mingw32
+          - x86-linux
+          - x86_64-linux
+
+    runs-on: ubuntu-latest
+    env:
+      PLATFORM: ${{ matrix.platform }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+
+      - name: Build libusb.gem
+        run: |
+          bundle exec rake gem:native:${PLATFORM}
+
+      - name: Upload binary gem
+        uses: actions/upload-artifact@v4
+        with:
+          name: gem-${{ matrix.platform }}
+          path: pkg/*-*-*.gem
+
+      - if: matrix.platform == 'jruby'
+        name: Upload source gem
+        uses: actions/upload-artifact@v4
+        with:
+          name: gem-ruby
+          path: pkg/*-?.?.?.gem
+
+  job_test_native:
+    name: Bin (${{matrix.ruby}}, ${{matrix.os}}, ${{matrix.platform}})
+    needs: docker_build
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows
+            ruby: "2.5"
+            platform: x64-mingw32
+          - os: windows
+            ruby: "3.3"
+            platform: x64-mingw-ucrt
+          - os: ubuntu
+            ruby: "2.5"
+            platform: x86_64-linux
+          - os: ubuntu
+            ruby: "3.3"
+            platform: x86_64-linux
+
+    runs-on: ${{ matrix.os }}-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - run: ruby --version
+      - name: Download gem-${{matrix.platform}}
+        uses: actions/download-artifact@v4
+        with:
+          name: gem-${{ matrix.platform }}
+      - name: Install gem-${{matrix.platform}}
+        run: gem install *.gem --verbose
+      - name: bundle install
+        run: bundle install
+      - name: Generate Gemfile_libusb_gem to ensure the installed gem is used
+        run: bundle exec rake gemfile_libusb_gem
+      - name: Run tests
+        env:
+          BUNDLE_GEMFILE: Gemfile_libusb_gem
+        run: |
+          bundle exec rake ci
+
+  # These jobs use Buildx layer caching
+  source_gem:
+    name: Source gem
+
+    strategy:
+      fail-fast: false
+
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+
+      - name: Build libusb.gem
+        run: |
+          bundle exec rake gem
+
+      - name: Upload binary gem
+        uses: actions/upload-artifact@v4
+        with:
+          name: gem-ruby
+          path: pkg/*.gem
+
+  job_test_source:
+    name: Src (${{matrix.ruby}}, ${{matrix.os}}, ${{matrix.extconfopts}})
+    needs: source_gem
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - windows
+          - ubuntu
+          - macos
+        ruby:
+          - "3.3"
+          - "2.5"
+          - "head"
+          - "jruby"
+          - "truffleruby"
+        extconfopts: [ --disable-system-libusb, --enable-system-libusb ]
+        exclude:
+          - os: windows
+            ruby: "truffleruby"
+          - os: windows
+            ruby: "jruby"
+            # Fails to install libusb from MSYS2
+            extconfopts: --enable-system-libusb
+          - os: windows
+            ruby: "jruby"
+            # configure: error: unrecognized option: `--prefix\=D:/jruby-9.4.6.0/lib/ruby/gems/shared/gems/libusb-0.6.4/ports/x86_64-w64-mingw32/libusb/1.0.27'
+            extconfopts: --disable-system-libusb
+
+    runs-on: ${{ matrix.os }}-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - run: ruby --version
+      - name: Download gem
+        uses: actions/download-artifact@v4
+        with:
+          name: gem-ruby
+      - name: Install libusb on Windows
+        if: matrix.os == 'windows' && matrix.extconfopts == '--enable-system-libusb'
+        shell: cmd
+        run: C:/msys64/usr/bin/sh -c "pacman --sync --refresh --needed --noconfirm  ${MINGW_PACKAGE_PREFIX}-libusb"
+      - name: Install gem
+        run: gem install *.gem --verbose -- ${{ matrix.extconfopts }}
+      - name: bundle install
+        run: bundle install
+      - name: Generate Gemfile_libusb_gem to ensure the installed gem is used
+        run: bundle exec rake gemfile_libusb_gem
+      - name: Run tests
+        env:
+          BUNDLE_GEMFILE: Gemfile_libusb_gem
+        run: |
+          bundle exec rake ci

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+.bundle
+Gemfile.lock
+ports/*
+pkg/*
+lib/libusb-1.0*
+lib/pkgconfig
+include
+tmp

data/.travis.yml

@@ -0,0 +1,26 @@
+language: ruby
+
+sudo: false
+
+dist: xenial
+matrix:
+  include:
+    - rvm: ruby-head
+      env:
+        - RUBYOPT="--enable-frozen-string-literal --debug=frozen-string-literal"
+    - rvm: 2.4.3
+      env:
+        - RUBYOPT="--enable-frozen-string-literal --debug=frozen-string-literal"
+    - rvm: 3.0
+      env:
+        - RUBYOPT="--enable-frozen-string-literal --debug=frozen-string-literal"
+    - rvm: 2.7
+    - rvm: 2.6
+    - rvm: 2.3.1
+    - rvm: jruby-9.2.14.0
+    - rvm: truffleruby
+
+  allow_failures:
+    - rvm: ruby-head
+
+script: bundle exec rake travis

data/.yardopts

@@ -0,0 +1,6 @@
+--title "libusb-1.0 Ruby Interface"
+--no-private
+lib/**/*.rb
+-
+README.md
+History.md

data/COPYING

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in libusb.gemspec
+gemspec
+
+group :test do
+  gem 'eventmachine'
+  gem 'minitest'
+end
+
+gem 'rake-compiler-dock', '~> 1.1'
+gem 'rake-compiler', '~> 1.0'
+gem 'bundler', '>= 1', '< 3'
+gem 'yard', '~> 0.6', '>= 0.9.36'
+
+# For some reason this is required in addition to the gemspec
+# when 'bundle config force_ruby_platform true' is active:
+gem 'ffi'
+gem 'mini_portile2'

data/History.md

@@ -0,0 +1,193 @@
+0.7.0 / 2024-04-18
+------------------
+
+Added:
+* Garbage collect LIBUSB::Context objects. #47
+  Context objects were intentionally not garbage collected previously, since it led to segfauls, when the context was freed before other libusb objects.
+  Now refcounting all objects bound to a particular Context ensures that the underlying libusb context is always freed at last, avoiding any segfaults.
+  Registered log callback and pollfd callbacks are disabled before garbage collecting LIBUSB::Context.
+* Cancel USB transfers on any exceptions not only LIBUSB::Error, but also Interrupt or IRB::Abort, etc.
+  Otherwise incomplete transfers lead to LIBUSB::ERROR_BUSY at the next command.
+* Update Windows binary support for ruby up to 3.3.x
+* Update bundled libusb version to 1.0.27.
+* Add support for new functions of libusb-1.0.27
+  They are:
+  - libusb_init_context
+  - libusb_set_log_cb
+  - libusb_wrap_sys_device
+* Add global Libusb.set_option and Libusb.set_options . #42
+* Add LIBUSB::Device.max_alt_packet_size. #42
+  Introduced in libusb-1.0.27 as libusb_get_max_alt_packet_size()
+* Add BOS platform descriptor introduced in libusb-1.0.27. #49
+* Add enums for all BOS descripors of the USB-3.2-V1.1 spec. #49
+
+Changed:
+* Set minimum Ruby version requirement to 2.5.0.
+* Fix a circular reference in ZeroCopyMemory.
+  This circular reference blocked all objects referenced by a LIBUSB::Transfer to be released by the garbage collector.
+* Make ZeroCopyMemory an opt-in rather then enforcing it
+  In therory libusb_dev_mem_alloc shouldn't provide a pointer unless zero-copy-memory is supported by the linux kernel.
+  But in practice this has been a repeating cause of issues, since some kernels don't handle these transfers.
+  So it's better to enable it on request only.
+  For instance older raspberry pi kernels didn't handle zero-copy-memory.
+* Fix struct member size in Bos::SsUsbDeviceCapability. #48
+  The bmAttributes member is defined as uint8_t not uint32_t.
+* Fix context reference in device of hotplug notification callback.
+* Deregister pollfd callbacks in eventmachine_unregister.
+
+
+0.6.4 / 2018-05-05
+------------------
+
+Added:
+* New function Context#set_option.
+  It is also available when running libusb < 1.0.22 and calls libusb_set_debug() in this case.
+* Add definition for SUPER_SPEED_PLUS.
+* Linux: Use system libusb even when only library but no dev package is installed.
+* Add Transfer#dev_handle and #timeout
+* Use system libusb even when no development package is installed.
+  Means "libusb-1.0-0" is enough, no need for "libusb-dev" on Ubuntu.
+
+Changed:
+* Update libusb to 1.0.22
+
+Deprecated:
+* Deprecate Context#debug= analogous to libusb_set_debug in libusb-1.0.22.
+
+
+0.6.3 / 2017-08-20
+------------------
+* Fix compat with FreeBSD. #24
+
+0.6.2 / 2017-01-13
+------------------
+* Fix windows DLL loading bugs #22 and #23.
+
+0.6.1 / 2016-12-18
+------------------
+* Fix installation of bundled libusb library in source gem.
+
+0.6.0 / 2016-12-09
+------------------
+* Update bundled libusb version to 1.0.21.
+* Set minimum Ruby version requirement to 1.9.3.
+* Add binary gems for Linux in addition to Windows.
+* Switch to mini_portile2 for (cross-) builing the libusb library.
+* Add Context#interrupt_event_handler new in libusb-1.0.21
+* Add support for persistent/zerocopy device memory for transfers.
+  It is new in libusb-1.0.21 and enabled by default for DevHandle#*_transfer methods.
+* Raise a more meaningful exception in case of bulk stream transfers on too old libusb versions.
+* Prefer the bundled libusb-dll over installed system library.
+
+0.5.1 / 2015-09-29
+------------------
+* Add ability to force use of the system or builtin libusb-1.0 library.
+    Use: gem install libusb -- --enable-system-libusb / --disable-system-libusb
+* Update to libusb-1.0.20.
+* Build Windows binary gems per rake-compiler-dock.
+* Fix memory leak in Context#pollfds and use libusb_free_pollfds() if available.
+
+0.5.0 / 2015-01-08
+------------------
+* Add support for BOS describtors of libusb-1.0.16
+* Add support for superspeed endpoint companion descriptors of libusb-1.0.16
+* Add support for USB-3.0 bulk streams of libusb-1.0.19
+* Update bundled libusb version to 1.0.19.
+* Update windows cross build to gcc-4.8 and recent rubygems
+
+0.4.1 / 2014-05-17
+------------------
+* Update bundled libusb version to 1.0.18.
+* Change libusbx references back to libusb, since they have merged again.
+
+0.4.0 / 2013-11-20
+------------------
+* Add support for device hotplug notifications.
+* Update to libusbx-1.0.17.
+* Add DevHandle#auto_detach_kernel_driver= of libusb-1.0.16.
+* Add new capabilities introduced with libusb-1.0.16.
+* Offer #has_capability? for libusb versions older than 1.0.9.
+* Add new method port_numbers with alias to port_path.
+* Use libusb_get_port_numbers preferred to now deprecated libusb_get_port_path.
+
+0.3.4 / 2013-04-05
+------------------
+* Avoid closing of pollfds by the Ruby GC when used as IO object.
+
+0.3.3 / 2013-04-05
+------------------
+* Build and package binary x64 version of libusb for Windows in addition to x86.
+* Fix build on Windows from source gem (although may take almost an hour).
+
+0.3.2 / 2013-02-16
+------------------
+* Don't enforces DevKit installation on Windows.
+* Fix error check on libusb_get_device_list(). Thanks to Paul Kunysch for the bug report.
+* Add support for Cygwin. Requires ffi-1.4.0.
+
+0.3.1 / 2013-01-22
+------------------
+* Fix loading of compiled libusb library on OSX
+
+0.3.0 / 2013-01-21
+------------------
+* Build bundled libusbx sources in case libusb-1.0.so can not be loaded from the system
+* Replace Hoe with Bundler
+* Add timeout and completion_flag to Context#handle_events
+* Add asynchronous DevHandle#{control|interrupt|bulk}_transfer method variants
+* Add the ability to retrieve the data already transfered when it comes to an exception
+* Add notification API for libusb's file describtors for event driven USB transfers
+* Add experimental integration to EventMachine
+* Add several convenience methods to descriptors
+* Add missing return code checks to libusb_init() and libusb_get_device_list()
+
+0.2.2 / 2012-10-19
+------------------
+* Add method Interface#bInterfaceNumber
+* Fix methods (#claim_interface, #detach_kernel_driver) with Interface-type parameter
+* update to libusbx-1.0.14 for windows build
+
+0.2.1 / 2012-09-25
+------------------
+* Rename Configuration#maxPower to #bMaxPower as done in libusbx-1.0.13 and in ruby-usb.gem
+* update to libusbx-1.0.13 for windows build (with support for libusbK and libusb0)
+
+0.2.0 / 2012-06-15
+------------------
+* Divide up the libusb library across multiple files, required with autoload
+* add methods: LIBUSB.has_capability?, Device#device_speed (libusb-1.0.9+)
+* add possibility to read out libusb version: LIBUSB.version (libusbx-1.0.10+)
+* add methods: Device#parent, Device#port_number, Device#port_path (libusbx-1.0.12+)
+* switch to libusbx-1.0.12 for windows build
+
+0.1.3 / 2012-03-15
+-------------------
+* Add documentation of descriptor accessors
+* Fix #extra accessor of Configuration, Setting and Endpoint
+
+0.1.2 / 2012-03-14
+------------------
+* Mark all blocking functions as blocking in FFI, so that parallel threads are not blocked
+* Add method Device#open_interface
+* Add block variant to #claim_interface
+* update API documentation
+
+0.1.1 / 2011-12-09
+------------------
+* avoid ffi calls with :blocking=>true, als long as it isn't stable on win32
+
+0.1.0 / 2011-10-01
+------------------
+* add test suite based on mass storage devices
+* usable async transfers
+* migration to rake-compiler and hoe
+* cross compiled Windows gems
+* distinct exception classes
+* new compatibility layer for ruby-usb.gem
+* many helper methods for different USB descriptors
+* add LIBUSB constants
+* downcase methods names
+
+0.0.1 / 2009-06-23
+------------------
+* first public release