rtlsdr 0.2.0 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11d3df08cd7b98efaa65bb9f88b05b0f39c021b335f1d2608b19c7a2802587dd
-  data.tar.gz: b130ec333e4589206502d251c2bd06dc5986f4980562618c5bd41bdfd4bd1463
+  metadata.gz: bdda82a845fb18a7c4e62aa92047ed89c380ff8cb4eeb09c0d67791fd6504fc2
+  data.tar.gz: 4427f96657f4c5be7e36693fc1c217ed138caf89128d3203201d4c76dbfc5599
 SHA512:
-  metadata.gz: 7a6c4c85e4adf587e671ebc8bfc09e95a377726f06b1463acd1c174c306c3ab801b55b873ed2ae07eb57971f27334feca58c242dc1b70a7dba23c84df4b705a3
-  data.tar.gz: c8013753f9247e5d994a44ea403ca09b98cea991fb5eb7e0b4d99c22fa8fce8ec39b8c4e098f9eef177a04db16bce920cf03ba63a7a9a2b7ad8c26a3957e5fd0
+  metadata.gz: fa87ae066f74a465ba70b33ad0ec5d0619abd698216911325754182e2bfb6b6a872aef24e82d430ebea12a304b342fbf007d5afbe36464011ee9f4806bd844e1
+  data.tar.gz: 96b90536e0c46f750ae06d22ff5608dbfdfeb06879221f7ada51c5ec2c50560029744d8296c170a69173c33e4e07e472bdc64ca96e1ed475736e19affdb62835

data/lib/rtlsdr/ffi.rb

@@ -140,10 +140,11 @@ module RTLSDR
     attach_function :rtlsdr_get_offset_tuning, [:rtlsdr_dev_t], :int
 
     # Streaming functions
+    # Note: blocking: true releases the GVL so other Ruby threads can run
     attach_function :rtlsdr_reset_buffer, [:rtlsdr_dev_t], :int
-    attach_function :rtlsdr_read_sync, %i[rtlsdr_dev_t pointer int pointer], :int
-    attach_function :rtlsdr_wait_async, %i[rtlsdr_dev_t rtlsdr_read_async_cb_t pointer], :int
-    attach_function :rtlsdr_read_async, %i[rtlsdr_dev_t rtlsdr_read_async_cb_t pointer uint32 uint32], :int
+    attach_function :rtlsdr_read_sync, %i[rtlsdr_dev_t pointer int pointer], :int, blocking: true
+    attach_function :rtlsdr_wait_async, %i[rtlsdr_dev_t rtlsdr_read_async_cb_t pointer], :int, blocking: true
+    attach_function :rtlsdr_read_async, %i[rtlsdr_dev_t rtlsdr_read_async_cb_t pointer uint32 uint32], :int, blocking: true
     attach_function :rtlsdr_cancel_async, [:rtlsdr_dev_t], :int
 
     # Bias tee functions

data/lib/rtlsdr/fftw.rb

@@ -45,21 +45,49 @@ module RTLSDR
       attr_reader :load_error
     end
 
-    # FFTW planning flags
+    # @!group FFTW Planning Flags
+    # These constants control how FFTW plans are created. Higher effort flags
+    # produce faster transforms but take longer to plan.
+
+    # @return [Integer] Measure execution time to find optimal plan
     FFTW_MEASURE = 0
+
+    # @return [Integer] Allow input array to be destroyed during planning
     FFTW_DESTROY_INPUT = 1
+
+    # @return [Integer] Don't assume arrays are aligned in memory
     FFTW_UNALIGNED = 2
+
+    # @return [Integer] Minimize memory usage at cost of speed
     FFTW_CONSERVE_MEMORY = 4
+
+    # @return [Integer] Try all possible algorithms (very slow planning)
     FFTW_EXHAUSTIVE = 8
+
+    # @return [Integer] Preserve input array contents during transform
     FFTW_PRESERVE_INPUT = 16
+
+    # @return [Integer] Like MEASURE but try harder (slower planning)
     FFTW_PATIENT = 32
+
+    # @return [Integer] Use quick heuristic to pick plan (fast planning, default)
     FFTW_ESTIMATE = 64
+
+    # @return [Integer] Only use wisdom (cached plans), fail if none available
     FFTW_WISDOM_ONLY = 2_097_152
 
-    # FFT direction
+    # @!endgroup
+
+    # @!group FFT Direction Constants
+
+    # @return [Integer] Forward FFT direction (time to frequency domain)
     FFTW_FORWARD = -1
+
+    # @return [Integer] Backward/Inverse FFT direction (frequency to time domain)
     FFTW_BACKWARD = 1
 
+    # @!endgroup
+
     if available?
       # Memory allocation
       attach_function :fftw_malloc, [:size_t], :pointer

data/lib/rtlsdr/version.rb

@@ -12,5 +12,5 @@ module RTLSDR
   #
   # @return [String] Current gem version
   # @since 0.1.0
-  VERSION = "0.2.0"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rtlsdr
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.3
 platform: ruby
 authors:
 - joshfng