pwn 0.5.620 → 0.5.621

data/lib/pwn/sdr/decoder/wifi.rb

@@ -1,26 +1,18 @@
 # frozen_string_literal: true
 
-require 'shellwords'
-
 module PWN
   module SDR
     module Decoder
-      # 802.11 (WiFi) beacon/probe decoder for the 2.4 / 5 / 6 GHz bands.
+      # Pure-Ruby 802.11 (WiFi) activity detector.
       #
-      # 20+ MHz OFDM cannot be recovered from a general-purpose SDR at
-      # bit-level in real time, so this module drives an existing monitor-mode
-      # NIC via `tshark` (or `airodump-ng`) instead — freq_obj[:mon_iface]
-      # selects the interface, freq_obj[:freq] is mapped to a WLAN channel.
+      # 20+ MHz OFDM cannot be demodulated in interpreted Ruby in real
+      # time. Native mode reports channel occupancy/duty and maps
+      # freq_obj to a WLAN channel number. `parse_line` retained for
+      # offline pipe-delimited tshark-fields analysis.
       module WiFi
         TSHARK_FIELDS = %w[
-          frame.time_relative
-          wlan.fc.type_subtype
-          wlan.bssid
-          wlan.sa
-          wlan.da
-          wlan_radio.channel
-          wlan_radio.signal_dbm
-          wlan.ssid
+          frame.time_relative wlan.fc.type_subtype wlan.bssid wlan.sa
+          wlan.da wlan_radio.channel wlan_radio.signal_dbm wlan.ssid
         ].freeze
 
         # Supported Method Parameters::
@@ -30,28 +22,20 @@ module PWN
 
         public_class_method def self.decode(opts = {})
           freq_obj = opts[:freq_obj]
-          raise 'ERROR: :freq_obj is required' unless freq_obj.is_a?(Hash)
-
-          iface = (freq_obj[:mon_iface] || 'wlan0mon').to_s
-          hz    = PWN::SDR.hz_to_i(freq: freq_obj[:freq])
-          mhz   = (hz / 1_000_000.0).round
-
-          tshark = ['tshark', '-i', iface, '-I', '-l', '-n',
-                    '-Y', 'wlan.fc.type == 0',
-                    '-T', 'fields', '-E', 'separator=|']
-          TSHARK_FIELDS.each { |f| tshark.push('-e', f) }
-
-          inner = "iw dev #{Shellwords.escape(iface)} set freq #{mhz} 2>/dev/null; " \
-                  "exec #{Shellwords.join(tshark)}"
-          direct_cmd = "bash -c #{Shellwords.escape(inner)}"
-
-          PWN::SDR::Decoder::Base.run_pipeline(
+          hz  = PWN::SDR.hz_to_i(freq: freq_obj[:freq])
+          mhz = (hz / 1_000_000.0).round
+          ch  = case mhz
+                when 2412..2472 then ((mhz - 2412) / 5) + 1
+                when 2484       then 14
+                when 5000..5900 then (mhz - 5000) / 5
+                else 0
+                end
+          PWN::SDR::Decoder::Base.run_detector(
             freq_obj: freq_obj,
             protocol: 'WiFi-802.11',
-            required_bins: %w[tshark iw],
-            direct_cmd: direct_cmd,
-            line_match: /\S/,
-            parser: proc { |line| parse_line(line: line) }
+            note: '20+ MHz OFDM — native mode reports channel occupancy/duty only.',
+            threshold: 6.0,
+            describe: proc { |b| { modulation: 'OFDM', channel: ch, mhz: mhz, airtime_ms: b[:duration_ms] } }
           )
         end
 
@@ -61,8 +45,7 @@ module PWN
         public_class_method def self.parse_line(opts = {})
           f = opts[:line].to_s.split('|', -1)
           out = {
-            protocol: 'WiFi',
-            subtype: f[1], bssid: f[2], sa: f[3], da: f[4],
+            protocol: 'WiFi', subtype: f[1], bssid: f[2], sa: f[3], da: f[4],
             channel: f[5], rssi_dbm: f[6], ssid: f[7]
           }.reject { |_, v| v.to_s.empty? }
           out[:summary] = "WiFi ch#{out[:channel]} #{out[:bssid]} '#{out[:ssid]}' #{out[:rssi_dbm]}dBm"
@@ -78,15 +61,11 @@ module PWN
         # Display Usage for this Module
 
         public_class_method def self.help
-          puts "USAGE:
+          puts "USAGE (ruby-native detector, no external binaries):
             #{self}.decode(
               freq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq'
             )
 
-            NOTE: Requires a monitor-mode WLAN interface (freq_obj[:mon_iface],
-                  default 'wlan0mon'), `iw`, and `tshark`. General SDRs cannot
-                  demodulate 802.11 OFDM in real time.
-
             #{self}.parse_line(line: '0.1|8|aa:bb:..|aa:bb:..|ff:ff:..|6|-42|linksys')
 
             #{self}.authors

data/lib/pwn/sdr/decoder/zigbee.rb

@@ -1,26 +1,18 @@
 # frozen_string_literal: true
 
-require 'shellwords'
-
 module PWN
   module SDR
     module Decoder
-      # IEEE 802.15.4 / ZigBee decoder for the 2.405–2.480 GHz allocation.
-      # 250 kbit/s O-QPSK requires raw I/Q; this drives KillerBee's `zbdump`
-      # (with any supported adapter — CC2531, ApiMote, RZUSB, HackRF via
-      # gr-ieee802-15-4) or falls back to `whsniff` piped through `tshark`
-      # for structured PAN/src/dst/cmd extraction.
+      # Pure-Ruby IEEE 802.15.4 / ZigBee activity detector.
+      #
+      # 250 kbit/s O-QPSK across 2 MHz channels — native mode reports
+      # per-channel packet bursts and derives channel 11–26 from
+      # freq_obj. `parse_line` retained for offline pipe-delimited
+      # analysis.
       module ZigBee
         TSHARK_FIELDS = %w[
-          frame.time_relative
-          wpan.src16
-          wpan.dst16
-          wpan.src64
-          wpan.dst64
-          wpan.dst_pan
-          wpan.frame_type
-          zbee_nwk.cmd.id
-          wpan.seq_no
+          frame.time_relative wpan.src16 wpan.dst16 wpan.src64 wpan.dst64
+          wpan.dst_pan wpan.frame_type zbee_nwk.cmd.id wpan.seq_no
         ].freeze
 
         # Supported Method Parameters::
@@ -30,25 +22,17 @@ module PWN
 
         public_class_method def self.decode(opts = {})
           freq_obj = opts[:freq_obj]
-          raise 'ERROR: :freq_obj is required' unless freq_obj.is_a?(Hash)
-
           hz = PWN::SDR.hz_to_i(freq: freq_obj[:freq])
-          # 802.15.4 ch11..26 → 2405 + 5*(ch-11) MHz
           ch = (((hz - 2_405_000_000) / 5_000_000.0).round + 11).clamp(11, 26)
-
-          tshark = ['tshark', '-r', '-', '-l', '-T', 'fields', '-E', 'separator=|']
-          TSHARK_FIELDS.each { |f| tshark.push('-e', f) }
-
-          inner = "whsniff -c #{ch} 2>/dev/null | #{Shellwords.join(tshark)}"
-          direct_cmd = "bash -c #{Shellwords.escape(inner)}"
-
-          PWN::SDR::Decoder::Base.run_pipeline(
+          PWN::SDR::Decoder::Base.run_detector(
             freq_obj: freq_obj,
             protocol: 'ZigBee',
-            required_bins: %w[whsniff tshark],
-            direct_cmd: direct_cmd,
-            line_match: /\S/,
-            parser: proc { |line| parse_line(line: line) }
+            note: '250 kbit/s O-QPSK — native mode reports 802.15.4 packet bursts only.',
+            threshold: 8.0,
+            describe: proc { |b|
+              octets = (b[:duration_ms] * 250 / 8).round
+              { modulation: 'O-QPSK', channel: ch, est_octets: octets, classification: octets < 20 ? 'ACK/beacon' : 'data-frame' }
+            }
           )
         end
 
@@ -58,11 +42,8 @@ module PWN
         public_class_method def self.parse_line(opts = {})
           f = opts[:line].to_s.split('|', -1)
           out = {
-            protocol: 'ZigBee',
-            src16: f[1], dst16: f[2],
-            src64: f[3], dst64: f[4],
-            pan_id: f[5], frame_type: f[6],
-            nwk_cmd: f[7], seq: f[8]
+            protocol: 'ZigBee', src16: f[1], dst16: f[2], src64: f[3], dst64: f[4],
+            pan_id: f[5], frame_type: f[6], nwk_cmd: f[7], seq: f[8]
           }.reject { |_, v| v.to_s.empty? }
           out[:summary] = "ZigBee PAN=#{out[:pan_id]} #{out[:src16] || out[:src64]}→#{out[:dst16] || out[:dst64]} type=#{out[:frame_type]}"
           out
@@ -77,14 +58,11 @@ module PWN
         # Display Usage for this Module
 
         public_class_method def self.help
-          puts "USAGE:
+          puts "USAGE (ruby-native detector, no external binaries):
             #{self}.decode(
               freq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq'
             )
 
-            NOTE: Requires `whsniff` (CC2531) or KillerBee, plus `tshark`.
-                  Channel is derived from freq_obj[:freq] (11–26).
-
             #{self}.parse_line(line: '0.1|0x0001|0xffff||||0x01||42')
 
             #{self}.authors

data/lib/pwn/sdr/decoder.rb

@@ -9,12 +9,20 @@ module PWN
     # uniform `.decode(freq_obj:)` entry point (see PWN::SDR::Decoder::Base)
     # so PWN::SDR::GQRX can dispatch on a `decoder:` key from
     # PWN::SDR::FrequencyAllocation.band_plans.
+    #
+    # 100 % ruby-native — no decoder in this namespace shells out to an
+    # external binary. Audio-rate protocols (POCSAG, FLEX, Morse, RTTY,
+    # APT, Pager) are fully demodulated in Ruby via PWN::SDR::Decoder::DSP;
+    # wideband/I/Q-only protocols (ADS-B, GSM, LTE, GPS, LoRa, WiFi, DECT,
+    # ZigBee, Bluetooth, Iridium, P25, RFID, RTL433) run a native
+    # burst/energy characteriser (see Base.run_detector).
     module Decoder
       autoload :ADSB,      'pwn/sdr/decoder/adsb'
       autoload :APT,       'pwn/sdr/decoder/apt'
       autoload :Base,      'pwn/sdr/decoder/base'
       autoload :Bluetooth, 'pwn/sdr/decoder/bluetooth'
       autoload :DECT,      'pwn/sdr/decoder/dect'
+      autoload :DSP,       'pwn/sdr/decoder/dsp'
       autoload :Flex,      'pwn/sdr/decoder/flex'
       autoload :GPS,       'pwn/sdr/decoder/gps'
       autoload :GSM,       'pwn/sdr/decoder/gsm'

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.620'
+  VERSION = '0.5.621'
 end

data/spec/lib/pwn/sdr/decoder/dsp_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::SDR::Decoder::DSP do
+  it 'should display information for authors' do
+    authors_response = PWN::SDR::Decoder::DSP
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::SDR::Decoder::DSP
+    expect(help_response).to respond_to :help
+  end
+end

data/third_party/pwn_rdoc.jsonl

@@ -1547,10 +1547,15 @@
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::APT.decode Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::APT.decode`: Supported Method Parameters\n\nPWN::SDR::Decoder::APT.decode(\n\nfreq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::APT.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::APT.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.authors Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.bin_available? Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.bin_available?`: Supported Method Parameters\n\nPWN::SDR::Decoder::Base.bin_available?(bin: ‘multimon-ng’)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.build_spinner Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.build_spinner`: Supported Method Parameters\n\nspinner, max_len = PWN::SDR::Decoder::Base.build_spinner(banner: ‘…’)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.log_path Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.log_path`: Supported Method Parameters\n\npath = PWN::SDR::Decoder::Base.log_path(protocol: ‘POCSAG’)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.match_line? Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.match_line?`: Supported Method Parameters\n\nPWN::SDR::Decoder::Base.match_line?(line: str, matcher: Regexp|String|Array)\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.run_pipeline Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.run_pipeline`: Supported Method Parameters\n\nPWN::SDR::Decoder::Base.run_pipeline(\n\nfreq_obj:    'required - freq_obj Hash from PWN::SDR::GQRX.init_freq',\nprotocol:    'required - short name used in banner / log filename',\ndecode_cmd:  'optional - shell pipeline reading 22 050 Hz s16le on stdin',\ndirect_cmd:  'optional - stand-alone shell cmd (owns the SDR itself)',\nline_match:  'optional - Regexp/String a stdout line must match',\nparser:      'optional - Proc.new { |line| Hash } to structure a line',\nrequired_bins: 'optional - Array of executables that must exist on PATH',\nresample_hz: 'optional - sox output rate for decode_cmd (default 22050)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.read_level Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.read_level`: Supported Method Parameters\n\nlvl = PWN::SDR::Decoder::Base.read_level(gqrx_sock:, udp_listener:)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.run_detector Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.run_detector`: Supported Method Parameters\n\nPWN::SDR::Decoder::Base.run_detector(\n\nfreq_obj:  'required - freq_obj Hash from PWN::SDR::GQRX.init_freq',\nprotocol:  'required - short name for banner / log filename',\nnote:      'optional - one-line explanation shown once',\nthreshold: 'optional - dBFS above rolling floor to call a burst (default 8.0)',\ndescribe:  'optional - Proc.new { |burst_hash| Hash } extra fields'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.run_native Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.run_native`: Supported Method Parameters\n\nPWN::SDR::Decoder::Base.run_native(\n\nfreq_obj: 'required - freq_obj Hash from PWN::SDR::GQRX.init_freq',\nprotocol: 'required - short name for banner / log filename',\ndemod:    'required - object responding to #feed(samples,&emit)',\nrate:     'optional - assumed UDP sample rate (default 48000)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.strip_freq_obj Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.strip_freq_obj`: Supported Method Parameters\n\nh = PWN::SDR::Decoder::Base.strip_freq_obj(freq_obj: {…})\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::Base.wait_for_enter Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Base.wait_for_enter`: Supported Method Parameters\n\nPWN::SDR::Decoder::Base.wait_for_enter(spinner:, title_ref:)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Bluetooth.authors Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Bluetooth.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Bluetooth.decode Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Bluetooth.decode`: Supported Method Parameters\n\nPWN::SDR::Decoder::Bluetooth.decode(\n\nfreq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Bluetooth.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Bluetooth.help`: "}]}
@@ -1559,6 +1564,22 @@
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::DECT.decode Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DECT.decode`: Supported Method Parameters\n\nPWN::SDR::Decoder::DECT.decode(\n\nfreq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::DECT.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DECT.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::DECT.parse_line Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DECT.parse_line`: Supported Method Parameters\n\nPWN::SDR::Decoder::DECT.parse_line(line: ‘RFPI: 01 23 45 67 89 slot 4 carrier 3 RSSI -55’)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.authors Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.baudot_decode Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.baudot_decode`: Supported Method Parameters\n\ntxt = PWN::SDR::Decoder::DSP.baudot_decode(bits: Array<0|1>) 5-bit ITA2 with LTRS(31)/FIGS(27) shift, LSB-first per character.\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.bch_31_21_syndrome Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.bch_31_21_syndrome`: Supported Method Parameters\n\nsyn = PWN::SDR::Decoder::DSP.bch_31_21_syndrome(word: Integer)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.bits_to_int Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.bits_to_int`: Supported Method Parameters\n\nint = PWN::SDR::Decoder::DSP.bits_to_int(bits: [1,0,1,…])\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.dc_block Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.dc_block`: Supported Method Parameters\n\ny = PWN::SDR::Decoder::DSP.dc_block(\n\nsamples: 'required - Array<Float>',\nalpha:   'optional - pole (default 0.995)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.envelope Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.envelope`: Supported Method Parameters\n\nenv = PWN::SDR::Decoder::DSP.envelope(\n\nsamples: 'required - Array<Float>',\nwindow:  'optional - moving-average window in samples (default 32)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.envelope_signed Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.envelope_signed`: Supported Method Parameters\n\ny = PWN::SDR::Decoder::DSP.envelope_signed(samples:, window:)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.even_parity_ok? Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.even_parity_ok?`: Supported Method Parameters\n\nok = PWN::SDR::Decoder::DSP.even_parity_ok?(word: Integer, width: 32)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.find_sync Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.find_sync`: Supported Method Parameters\n\nidx = PWN::SDR::Decoder::DSP.find_sync(\n\nbits:    'required - Array<0|1>',\npattern: 'required - Array<0|1> or Integer (MSB-first)',\nwidth:   'optional - bit-width when pattern is Integer',\nmax_err: 'optional - allowed bit errors (default 0)',\nfrom:    'optional - start index (default 0)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.fsk_slice Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.fsk_slice`: Supported Method Parameters\n\nbits = PWN::SDR::Decoder::DSP.fsk_slice(\n\nsamples: 'required - Array<Float>',\nrate:    'required - sample rate (Hz)',\nbaud:    'required - symbol rate',\nmark_hz: 'required - mark tone (bit=1)',\nspace_hz:'required - space tone (bit=0)'\n\n) Non-coherent 2-FSK: per-symbol Goertzel on mark/space, pick the winner.\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.goertzel Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.goertzel`: Supported Method Parameters\n\npower = PWN::SDR::Decoder::DSP.goertzel(\n\nsamples: 'required - Array<Float>',\nrate:    'required - sample rate (Hz)',\nfreq:    'required - target tone frequency (Hz)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.nrz_slice Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.nrz_slice`: Supported Method Parameters\n\nbits = PWN::SDR::Decoder::DSP.nrz_slice(\n\nsamples: 'required - Array<Float> (post-FM-discriminator baseband)',\nrate:    'required - sample rate (Hz)',\nbaud:    'required - symbol rate',\ninvert:  'optional - flip bit polarity (default false)'\n\n) Simple mid-bit sampler with zero-crossing resync. Returns Array<0|1>.\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.resample Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.resample`: Supported Method Parameters\n\nout = PWN::SDR::Decoder::DSP.resample(\n\nsamples: 'required - Array<Float>',\nsrc_rate: 'required - input sample rate (Hz)',\ndst_rate: 'required - output sample rate (Hz)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.rms_dbfs Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.rms_dbfs`: Supported Method Parameters\n\ndbfs = PWN::SDR::Decoder::DSP.rms_dbfs(samples: Array<Float>)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::DSP.unpack_s16le Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::DSP.unpack_s16le`: Supported Method Parameters\n\nsamples = PWN::SDR::Decoder::DSP.unpack_s16le(\n\ndata: 'required - raw String of little-endian signed 16-bit PCM'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Flex.authors Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Flex.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Flex.decode Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Flex.decode`: Supported Method Parameters\n\npocsag_resp = PWN::SDR::Decoder::Flex.decode(\n\nfreq_obj: 'required - GQRX socket object returned from #connect method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::Flex.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::Flex.help`: "}]}
@@ -1639,7 +1660,7 @@
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.disconnect_udp Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.disconnect_udp`: Supported Method Parameters\n\nPWN::SDR::GQRX.disconnect_udp(\n\nudp_listener: 'required - UDP socket object returned from #listen_udp method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.duration_between Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.duration_between`: Supported Method Parameters\n\nduration = PWN::SDR::GQRX.duration_between(\n\ntimestamp_start: 'required - Start timestamp',\ntimestamp_end: 'required - End timestamp'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.edge_detection Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.edge_detection`: Supported Method Parameters\n\ncandidate_signals = PWN::SDR::GQRX.edge_detection(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nhz: 'required - Frequency to start edge detection from',\nprecision: 'required - Frequency step precision',\nstep_hz: 'required - Frequency step in Hz for edge detection',\nstrength_lock: 'required - Strength lock in dBFS to determine signal edges'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.fast_scan_range Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.fast_scan_range`: Supported Method Parameters\n\nfast_resp = PWN::SDR::GQRX.fast_scan_range(\n\ngqrx_sock: 'required - GQRX socket object',\nranges: 'required - Array<Hash> of {start_freq:, target_freq: }',\nsample_rate: 'optional - Set this to GQRX visible input sample rate (the span width)',\nnfft: 'optional - FFT size',\navg: 'optional',\ncapture_secs: 'optional',\nstrength_lock: 'optional',\nmin_snr_db: 'optional - Minimum SNR in dB above per-chunk noise floor to report (defaults to 12.0)',\ndemodulator_mode: 'optional - Demodulator mode to attribute to detections (defaults to WFM)',\nbandwidth: 'optional - Passband bandwidth to attribute to detections (defaults to \"200.000\")',\nsquelch: 'optional - Squelch level (defaults to strength_lock - 3.0)',\ndecoder: 'optional - Decoder key (e.g. :gsm) to attribute to detections',\nlocation: 'optional - Location string for AI analysis',\nkeep_spectrum: 'optional - if true return raw spectrum arrays too (large)'\n\n)\n\nUses chunk-wise retuning where chunk = sample_rate so that the *entire visible band* (waterfall width) is captured via a single FFT each time rather than point-by-point hops. This yields near real-time panoramic coverage. Update rate is roughly (retune + capture + fft) per chunk.\n\nPer-signal output shape is INTENTIONALLY IDENTICAL to scan_range / init_freq (:freq, :demodulator_mode, :bandwidth, :strength_db, :decoder, :squelch, :strength_lock, :iteration, :ai_analysis) so that analyze_scan / analyze_log and downstream decoders behave the same regardless of which scan mode produced the log. FFT-specific extras (:hz, :bw_hz, :snr_db, :prominence_db, :noise_floor_db, :chunk_center, :method) are appended for provenance.\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::GQRX.fast_scan_range Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.fast_scan_range`: Supported Method Parameters\n\nfast_resp = PWN::SDR::GQRX.fast_scan_range(\n\ngqrx_sock: 'required - GQRX socket object',\nranges: 'required - Array<Hash> of {start_freq:, target_freq: }',\nsample_rate: 'optional - Set this to GQRX visible input sample rate (the span width)',\nnfft: 'optional - FFT size',\navg: 'optional',\ncapture_secs: 'optional',\nstrength_lock: 'optional',\nmin_snr_db: 'optional - Minimum SNR in dB above per-chunk noise floor to report (defaults to 12.0)',\nprecision: 'optional - Band-plan channel raster; detections snapped to 10**(precision-1) Hz grid (defaults to 5)',\nmin_bw_ratio: 'optional - Reject FFT peaks narrower than min_bw_ratio * plan bandwidth as spurs (defaults to 0.30)',\ndemodulator_mode: 'optional - Demodulator mode to attribute to detections (defaults to WFM)',\nbandwidth: 'optional - Passband bandwidth to attribute to detections (defaults to \"200.000\")',\nsquelch: 'optional - Squelch level (defaults to strength_lock - 3.0)',\ndecoder: 'optional - Decoder key (e.g. :gsm) to attribute to detections',\nlocation: 'optional - Location string for AI analysis',\nkeep_spectrum: 'optional - if true return raw spectrum arrays too (large)'\n\n)\n\nUses chunk-wise retuning where chunk = sample_rate so that the *entire visible band* (waterfall width) is captured via a single FFT each time rather than point-by-point hops. This yields near real-time panoramic coverage. Update rate is roughly (retune + capture + fft) per chunk.\n\nPer-signal output shape is INTENTIONALLY IDENTICAL to scan_range / init_freq (:freq, :demodulator_mode, :bandwidth, :strength_db, :decoder, :squelch, :strength_lock, :iteration, :ai_analysis) so that analyze_scan / analyze_log and downstream decoders behave the same regardless of which scan mode produced the log. FFT-specific extras (:hz, :bw_hz, :snr_db, :prominence_db, :noise_floor_db, :chunk_center, :method) are appended for provenance.\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.find_best_peak Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.find_best_peak`: Supported Method Parameters\n\nbest_peak = PWN::SDR::GQRX.find_best_peak(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\ncandidate_signals: 'required - Array of candidate signals from edge_detection',\nstep_hz: 'required - Frequency step in Hz for peak finding',\nstrength_lock: 'required - Strength lock in dBFS to determine signal edges'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.get_spectrum_snapshot Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.get_spectrum_snapshot`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.help Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.help`: "}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.620
+  version: 0.5.621
 platform: ruby
 authors:
 - 0day Inc.
@@ -2150,6 +2150,7 @@ files:
 - lib/pwn/sdr/decoder/base.rb
 - lib/pwn/sdr/decoder/bluetooth.rb
 - lib/pwn/sdr/decoder/dect.rb
+- lib/pwn/sdr/decoder/dsp.rb
 - lib/pwn/sdr/decoder/flex.rb
 - lib/pwn/sdr/decoder/gps.rb
 - lib/pwn/sdr/decoder/gsm.rb
@@ -2564,6 +2565,7 @@ files:
 - spec/lib/pwn/sdr/decoder/base_spec.rb
 - spec/lib/pwn/sdr/decoder/bluetooth_spec.rb
 - spec/lib/pwn/sdr/decoder/dect_spec.rb
+- spec/lib/pwn/sdr/decoder/dsp_spec.rb
 - spec/lib/pwn/sdr/decoder/flex_spec.rb
 - spec/lib/pwn/sdr/decoder/gps_spec.rb
 - spec/lib/pwn/sdr/decoder/gsm_spec.rb