rtlsdr 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '019e21a841f8f9f9aaf543741487c734d4b1c7b2ff4b2bfd20e37cf56fbfcf00'
-  data.tar.gz: c4c3657ae68d2b5f8f2b931c8256447b9ab8feb0d0bbdfe61e7d035e34ee4053
+  metadata.gz: bdda82a845fb18a7c4e62aa92047ed89c380ff8cb4eeb09c0d67791fd6504fc2
+  data.tar.gz: 4427f96657f4c5be7e36693fc1c217ed138caf89128d3203201d4c76dbfc5599
 SHA512:
-  metadata.gz: cf8de21d50dbf21fd92dfec27cdeab872ccf83e3bbe1132ebbeab74bba98ae4e84da90f794574fc8c742da761768f2f49b26f5ea3c345b49960646a0e63ea053
-  data.tar.gz: 5d587f36838184747666800ac202e52d33584169926f9cd2bd72db1d39a5f4189be4b7025898c675f274134ba326537f08782f9682d7e6fe58dce0921f21b497
+  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.1"
+  VERSION = "0.2.3"
 end

metadata

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