pwn 0.5.518 → 0.5.520

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4782a5ea26c616b61254cbc43ba1fa0fbee4f71890b48ac3b0197a0586965356
-  data.tar.gz: 987fdf3e321dd0790ca1f059c483a045bcee5239f63ba5f2bfbd065e5f85c24f
+  metadata.gz: f6d0dc923ff782c8b1fcd7ad1ec99996f9d2a07770e6c877c217104f889b5c1c
+  data.tar.gz: 700f54af4422a4e36080057cfeb221dc51f78e9bb66f0b2f6041ab4878e6c19e
 SHA512:
-  metadata.gz: 4417e4d4bbcffc1596d854c0d37eb2911b65456257c8d5520afeb1706bda670f1cb4881f312ca521951ae8d47eba063af98ac4f89d981c34b50f5e2acc052c7b
-  data.tar.gz: c989b552b031669fb6a2a96580d53ad4f240607d68f7ee2d4b9f65a9b0e48c6d1b5666613782a356a5edb11fb5d2178b30501a7e3bfa2fc6057eda39d3a70299
+  metadata.gz: c65607836b13bdd1c45fd0d2e845855cba2dd8d75180026f71238c2e9ae8a74bca150adf988b641dadbb156772cb1db96cb1e5fc9c9bee3319c3b08279fc6cd1
+  data.tar.gz: 54146ccf00a69c62116c448f9c143a7e1d14192cf055e41bd5fb272238e8242f734ae57fc9cc37e54798c4bcdc6986eb51e5c11fc9d6feef83345bd064c3cf5d

data/Gemfile

@@ -20,7 +20,7 @@ gem 'base32', '0.3.4'
 gem 'bitcoin-ruby', '0.0.20'
 gem 'brakeman', '7.1.1'
 gem 'bson', '5.2.0'
-gem 'bundler', '>=4.0.2'
+gem 'bundler', '>=4.0.3'
 gem 'bundler-audit', '>=0.9.3'
 gem 'bunny', '2.24.0'
 gem 'colorize', '1.1.0'

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.518]:001 >>> PWN.help
+pwn[v0.5.520]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.4.7@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.518]:001 >>> PWN.help
+pwn[v0.5.520]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.4.7@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.518]:001 >>> PWN.help
+pwn[v0.5.520]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/bin/pwn_gqrx_scanner

@@ -45,10 +45,6 @@ PWN::Driver::Parser.new do |options|
     opts[:demodulator_mode] = d
   end
 
-  options.on('-rRDS', '--rds', '<Optional - Enable RDS Decoding when in WFM or WFM_ST Demodulator Mode (Defaults to false)>') do |r|
-    opts[:rds] = r
-  end
-
   options.on('-PINT', '--precision=INT', '<Optional - Precision of Frequency 1-12 (Defaults to 5)>') do |p|
     opts[:precision] = p
   end
@@ -116,7 +112,6 @@ begin
   gqrx_sock = PWN::SDR::GQRX.connect(target: host, port: port)
 
   demodulator_mode = opts[:demodulator_mode]
-  rds = opts[:rds]
   bandwidth = opts[:bandwidth]
   overlap_protection = opts[:overlap_protection]
 
@@ -144,6 +139,7 @@ begin
   baseband_gain = baseband_gain.to_f unless baseband_gain.nil?
 
   scan_log = opts[:scan_log]
+  decoder = opts[:decoder]
   location = opts[:location]
 
   # Merge opts again to ensure we override profile values with CLI values
@@ -152,7 +148,6 @@ begin
     start_freq: start_freq,
     target_freq: target_freq,
     demodulator_mode: demodulator_mode,
-    rds: rds,
     bandwidth: bandwidth,
     overlap_protection: overlap_protection,
     audio_gain_db: audio_gain_db,
@@ -164,6 +159,7 @@ begin
     intermediate_gain: intermediate_gain,
     baseband_gain: baseband_gain,
     scan_log: scan_log,
+    decoder: decoder,
     location: location
   )
   puts 'Scan Complete.'

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

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'json'
+require 'tty-spinner'
+
 module PWN
   module SDR
     module Decoder
@@ -7,90 +10,70 @@ module PWN
       module RDS
         # Supported Method Parameters::
         # rds_resp = PWN::SDR::GQRX.decode_rds(
-        #   gqrx_sock: 'required - GQRX socket object returned from #connect method'
+        #   freq_obj: 'required - GQRX socket object returned from #connect method'
         # )
-
-        # private_class_method def self.rds(opts = {})
         public_class_method def self.decode(opts = {})
-          gqrx_sock = opts[:gqrx_sock]
+          freq_obj = opts[:freq_obj]
+          gqrx_sock = freq_obj[:gqrx_sock]
 
-          # We toggle RDS off and on to reset the decoder
-          rds_resp = PWN::SDR::GQRX.gqrx_cmd(
+          freq_obj = freq_obj.dup
+          freq_obj.delete(:gqrx_sock)
+          skip_rds = "\n"
+          puts JSON.pretty_generate(freq_obj)
+          puts "\n*** FM Radio RDS Decoder ***"
+          puts '(Press [ENTER] to continue)...'
+
+          # Toggle RDS off and on to reset the decoder
+          PWN::SDR::GQRX.gqrx_cmd(
             gqrx_sock: gqrx_sock,
             cmd: 'U RDS 0',
             resp_ok: 'RPRT 0'
           )
 
-          rds_resp = PWN::SDR::GQRX.gqrx_cmd(
+          PWN::SDR::GQRX.gqrx_cmd(
             gqrx_sock: gqrx_sock,
             cmd: 'U RDS 1',
             resp_ok: 'RPRT 0'
           )
 
-          rds_resp = {}
-          attempts = 0
-          max_attempts = 120
-          skip_rds = "\n"
-          print 'INFO: Decoding FM radio RDS data (Press ENTER to skip)...'
-          max_attempts.times do
-            attempts += 1
-            rds_resp[:rds_pi] = PWN::SDR::GQRX.gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'p RDS_PI')
-            rds_resp[:rds_ps_name] = PWN::SDR::GQRX.gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'p RDS_PS_NAME')
-            rds_resp[:rds_radiotext] = PWN::SDR::GQRX.gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'p RDS_RADIOTEXT')
-
-            # Break if ENTER key pressed
-            # This is useful if no RDS data is available
-            # on the current frequency (e.g. false+)
-            break if $stdin.ready? && $stdin.read_nonblock(1) == skip_rds
-
-            break if rds_resp[:rds_pi] != '0000' && !rds_resp[:rds_ps_name].empty? && !rds_resp[:rds_radiotext].empty?
-
-            print '.'
-            sleep 0.1
-          end
-          puts 'complete.'
-          rds_resp
-        rescue StandardError => e
-          raise e
-        end
-
-        # Starts the live decoding thread.
-        def self.start(opts = {})
-          freq_obj = opts[:freq_obj]
-          raise ':ERROR: :freq_obj is required' unless freq_obj.is_a?(Hash)
-
-          gqrx_sock = freq_obj[:gqrx_sock]
-          freq = freq_obj[:freq]
-          bandwidth = freq_obj[:bandwidth].to_i
-          record_path = freq_obj[:record_path]
-
-          sleep 0.1 until File.exist?(record_path)
-
-          header = File.binread(record_path, HEADER_SIZE)
-          raise 'Invalid WAV header' unless header.start_with?('RIFF') && header.include?('WAVE')
-
-          bytes_read = HEADER_SIZE
-
-          puts "GSM Decoder started for freq: #{freq}, bandwidth: #{bandwidth}"
-
-          Thread.new do
-            loop do
-              sleep 1
+          # Use TTY::Spinner correctly with a dynamic :title token
+          spinner = TTY::Spinner.new('[:spinner] :title', format: :arrow_pulse)
+          spinner.update(title: 'INFO: Decoding FM radio RDS data...')
+          spinner.auto_spin # Background thread handles smooth animation
+
+          last_resp = {}
+
+          loop do
+            rds_resp = {
+              rds_pi: PWN::SDR::GQRX.gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'p RDS_PI').to_s.strip.chomp,
+              rds_ps_name: PWN::SDR::GQRX.gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'p RDS_PS_NAME').to_s.strip.chomp,
+              rds_radiotext: PWN::SDR::GQRX.gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'p RDS_RADIOTEXT').to_s.strip.chomp
+            }
+
+            # Only update the displayed message when we have new, complete, valid RDS data
+            if rds_resp[:rds_pi] != '0000' && rds_resp != last_resp
+              status = "Program ID: #{rds_resp[:rds_pi]} | Station Name: #{rds_resp[:rds_ps_name].ljust(8)} | Radio Text: #{rds_resp[:rds_radiotext]}"
+              spinner.update(title: status)
+              last_resp = rds_resp.dup
             end
-          rescue StandardError => e
-            puts "Decoder error: #{e.message}"
-          ensure
-            cleanup(record_path: record_path)
-          end
-        end
 
-        # Stops the decoding thread.
-        def self.stop(opts = {})
-          freq_obj = opts[:freq_obj]
-          raise 'ERROR: :freq_obj is required' unless freq_obj.is_a?(Hash)
+            # Non-blocking check for ENTER key
+            if $stdin.wait_readable(0)
+              begin
+                char = $stdin.read_nonblock(1)
+                break if char == skip_rds
+              rescue IO::WaitReadable, EOFError
+                # No-op
+              end
+            end
 
-          decoder_thread = freq_obj[:decoder_thread]
-          decoder_thread.kill if decoder_thread.is_a?(Thread)
+            sleep 0.01
+          end
+        rescue StandardError => e
+          spinner.error('Decoding failed') if defined?(spinner)
+          raise e
+        ensure
+          spinner.stop if spinner
         end
 
         # Author(s):: 0day Inc. <support@0dayinc.com>
@@ -105,12 +88,7 @@ module PWN
 
         public_class_method def self.help
           puts "USAGE:
-            gsm_decoder_thread = #{self}.start(
-              freq_obj: 'required - freq_obj returned from PWN::SDR::Receiver::GQRX.init_freq method'
-            )
-
-            # To stop the decoder thread:
-            #{self}.stop(
+            #{self}.decode(
               freq_obj: 'required - freq_obj returned from PWN::SDR::Receiver::GQRX.init_freq method'
             )
 

data/lib/pwn/sdr/frequency_allocation.rb

@@ -180,9 +180,9 @@ module PWN
             start_freq: '87.900.000',
             target_freq: '108.000.000',
             demodulator_mode: :WFM_ST,
-            rds: true,
             bandwidth: '200.000',
-            precision: 6
+            precision: 6,
+            decoder: :rds
           },
           frs: {
             start_freq: '462.562.500',

data/lib/pwn/sdr/gqrx.rb

@@ -178,7 +178,7 @@ module PWN
             distance_between_unique_samples = (strength_db - prev_strength_db).abs.round(2)
             strength_measured = true if distance_between_unique_samples.positive? && strength_lock > strength_db
           end
-          strength_measured = true if distance_between_unique_samples.positive? && distance_between_unique_samples < 5
+          strength_measured = true if (distance_between_unique_samples.positive? && distance_between_unique_samples < 5) || attempts >= 500
 
           break if strength_measured
 
@@ -187,7 +187,8 @@ module PWN
         end
         # Uncomment for debugging strength measurement attempts
         # which translates to speed and accuracy refinement
-        puts "\tStrength Measurement Attempts: #{attempts} | Freq: #{freq} | Phase: #{phase} | Unique Samples: #{unique_samples} | dbFS Distance Unique Samples: #{distance_between_unique_samples}"
+        puts "\tStrength Measurement Attempts: #{attempts} | Freq: #{freq} | Phase: #{phase}"
+        puts "\tUnique Samples: #{unique_samples} | dbFS Distance Unique Samples: #{distance_between_unique_samples}"
 
         strength_db.round(1)
       rescue StandardError => e
@@ -469,7 +470,6 @@ module PWN
       #   gqrx_sock: 'required - GQRX socket object returned from #connect method',
       #   freq: 'required - Frequency to set',
       #   demodulator_mode: 'optional - Demodulator mode (defaults to WFM)',
-      #   rds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',
       #   bandwidth: 'optional - Bandwidth (defaults to "200.000")',
       #   squelch: 'optional - Squelch level to set (Defaults to current value)',
       #   decoder: 'optional - Decoder key (e.g., :gsm) to start live decoding (starts recording if provided)',
@@ -498,8 +498,6 @@ module PWN
         demodulator_mode = opts[:demodulator_mode] ||= :WFM
         raise "ERROR: Invalid demodulator_mode '#{demodulator_mode}'. Valid modes: #{valid_demodulator_modes.join(', ')}" unless valid_demodulator_modes.include?(demodulator_mode.to_sym)
 
-        rds = opts[:rds] ||= false
-
         bandwidth = opts[:bandwidth] ||= '200.000'
         squelch = opts[:squelch]
         decoder = opts[:decoder]
@@ -537,8 +535,8 @@ module PWN
           freq: freq,
           demodulator_mode: demodulator_mode,
           bandwidth: bandwidth,
-          rds: rds,
-          strength_db: strength_db
+          strength_db: strength_db,
+          decoder: decoder
         }
 
         unless suppress_details
@@ -572,58 +570,56 @@ module PWN
             cmd: 'l BB_GAIN'
           )
 
-          rds_resp = nil
-          rds_resp = PWN::SDR::Decoder::RDS.decode(gqrx_sock: gqrx_sock) if rds
-
           freq_obj[:audio_gain_db] = audio_gain_db
           freq_obj[:demod_mode_n_passband] = demod_n_passband
           freq_obj[:bb_gain] = bb_gain
           freq_obj[:if_gain] = if_gain
           freq_obj[:rf_gain] = rf_gain
           freq_obj[:squelch] = squelch
-          freq_obj[:rds] = rds_resp
-        end
-
-        # Start recording and decoding if decoder provided
-        decoder_module = nil
-        decoder_thread = nil
-        record_path = nil
-        if decoder
-          # Resolve decoder module via case statement for extensibility
-          case decoder
-          when :gsm
-            decoder_module = PWN::SDR::Decoder::GSM
-          when :rds
-            decoder_module = PWN::SDR::Decoder::RDS
-          else
-            raise "ERROR: Unknown decoder key: #{decoder}. Supported: :gsm"
-          end
-
-          # Ensure recording is off before starting
-          record_status = gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'u RECORD')
-          gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'U RECORD 0', resp_ok: 'RPRT 0') if record_status == '1'
-
-          # Start recording
-          gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'U RECORD 1', resp_ok: 'RPRT 0')
-
-          # Prepare for decoder
-          start_time = Time.now
-          expected_filename = "gqrx_#{start_time.strftime('%Y%m%d_%H%M%S')}_#{current_freq_raw}.wav"
-          record_path = File.join(record_dir, expected_filename)
-
-          # Build partial gqrx_obj for decoder start
-          freq_obj[:record_path] = record_path
 
-          # Initialize and start decoder (module style: .start returns thread)
-          freq_obj[:gqrx_sock] = gqrx_sock
-          decoder_thread = decoder_module.start(freq_obj: freq_obj)
-          freq_obj.delete(:gqrx_sock)
+          # Start recording and decoding if decoder provided
+          if decoder
+            decoder = decoder.to_s.to_sym
+            decoder_module = nil
+            decoder_thread = nil
+            record_path = nil
+
+            # Resolve decoder module via case statement for extensibility
+            case decoder
+            when :gsm
+              decoder_module = PWN::SDR::Decoder::GSM
+            when :rds
+              decoder_module = PWN::SDR::Decoder::RDS
+            else
+              raise "ERROR: Unknown decoder key: #{decoder}. Supported: :gsm"
+            end
 
-          freq_obj[:freq] = current_freq
-          freq_obj[:decoder] = decoder
-          freq_obj[:decoder_module] = decoder_module
-          freq_obj[:decoder_thread] = decoder_thread
-          freq_obj[:record_path] = record_path
+            # Ensure recording is off before starting
+            # unless decoder == :rds
+            #   puts decoder.inspect
+            #   record_status = gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'u RECORD')
+            #   gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'U RECORD 0', resp_ok: 'RPRT 0') if record_status == '1'
+
+            #   # Start recording
+            #   gqrx_cmd(gqrx_sock: gqrx_sock, cmd: 'U RECORD 1', resp_ok: 'RPRT 0')
+
+            #   # Prepare for decoder
+            #   start_time = Time.now
+            #   expected_filename = "gqrx_#{start_time.strftime('%Y%m%d_%H%M%S')}_#{current_freq_raw}.wav"
+            #   record_path = File.join(record_dir, expected_filename)
+
+            #   # Build partial gqrx_obj for decoder start
+            #   freq_obj[:record_path] = record_path
+            # end
+
+            # Initialize and start decoder (module style: .start returns thread)
+            freq_obj[:gqrx_sock] = gqrx_sock
+            freq_obj[:decoder_module] = decoder_module
+            freq_obj[:record_path] = record_path
+            decoder_module.decode(freq_obj: freq_obj)
+            # decoder_thread = decoder_module.start(freq_obj: freq_obj)
+            # freq_obj[:decoder_thread] = decoder_thread
+          end
         end
 
         freq_obj
@@ -631,14 +627,13 @@ module PWN
         raise e
       ensure
         # Ensure decoder recording stops
-        if decoder
-          gqrx_cmd(
-            gqrx_sock: gqrx_sock,
-            cmd: 'U RECORD 0',
-            resp_ok: 'RPRT 0'
-          )
-          decoder_module.stop(freq_obj: freq_obj)
-        end
+        # if decoder && decoder != :rds
+        #   gqrx_cmd(
+        #     gqrx_sock: gqrx_sock,
+        #     cmd: 'U RECORD 0',
+        #     resp_ok: 'RPRT 0'
+        #   )
+        # end
         disconnect(gqrx_sock: gqrx_sock) if gqrx_sock.is_a?(TCPSocket) && !keep_alive
       end
 
@@ -648,7 +643,6 @@ module PWN
       #   start_freq: 'required - Start frequency of scan range',
       #   target_freq: 'required - Target frequency of scan range',
       #   demodulator_mode: 'optional - Demodulator mode (e.g. WFM, AM, FM, USB, LSB, RAW, CW, RTTY / defaults to WFM)',
-      #   rds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',
       #   bandwidth: 'optional - Bandwidth in Hz (Defaults to "200.000")',
       #   precision: 'optional - Frequency step precision (number of digits; defaults to 1)',
       #   strength_lock: 'optional - Strength lock in dBFS (defaults to -70.0)',
@@ -674,7 +668,6 @@ module PWN
         hz_target = PWN::SDR.hz_to_i(target_freq)
 
         demodulator_mode = opts[:demodulator_mode]
-        rds = opts[:rds] ||= false
 
         bandwidth = opts[:bandwidth] ||= '200.000'
 
@@ -682,6 +675,7 @@ module PWN
         strength_lock = opts[:strength_lock] ||= -70.0
         squelch = opts[:squelch] ||= (strength_lock - 3.0)
         scan_log = opts[:scan_log] ||= "/tmp/pwn_sdr_gqrx_scan_#{PWN::SDR.hz_to_s(hz_start)}-#{PWN::SDR.hz_to_s(hz_target)}_#{log_timestamp}.json"
+        decoder = opts[:decoder]
         location = opts[:location] ||= 'United States'
 
         step_hz = 10**(precision - 1)
@@ -750,9 +744,9 @@ module PWN
           gqrx_sock: gqrx_sock,
           freq: hz_start,
           demodulator_mode: demodulator_mode,
-          rds: rds,
           bandwidth: bandwidth,
           squelch: squelch,
+          decoder: decoder,
           suppress_details: true,
           keep_alive: true
         )
@@ -811,8 +805,8 @@ module PWN
               prev_freq_obj = init_freq(
                 gqrx_sock: gqrx_sock,
                 freq: best_freq,
-                rds: rds,
                 suppress_details: true,
+                decoder: decoder,
                 keep_alive: true
               )
               prev_freq_obj[:strength_lock] = strength_lock
@@ -874,6 +868,7 @@ module PWN
         )
 
         scan_resp[:signals].each do |signal|
+          # puts JSON.pretty_generate(signal)
           signal[:gqrx_sock] = gqrx_sock
           # This is required to keep connection alive during analysis
           signal[:keep_alive] = true
@@ -881,9 +876,11 @@ module PWN
           freq_obj = signal.merge(freq_obj)
           # Redact gqrx_sock from output
           freq_obj.delete(:gqrx_sock)
-          puts JSON.pretty_generate(freq_obj)
-          print 'Press [ENTER] to continue...'
-          gets
+          unless freq_obj[:decoder]
+            puts JSON.pretty_generate(freq_obj)
+            print 'Press [ENTER] to continue...'
+            gets
+          end
           puts "\n" * 3
         end
       rescue Interrupt
@@ -958,7 +955,6 @@ module PWN
             gqrx_sock: 'required - GQRX socket object returned from #connect method',
             freq: 'required - Frequency to set',
             demodulator_mode: 'optional - Demodulator mode (defaults to WFM)',
-            rds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',
             bandwidth: 'optional - Bandwidth (defaults to \"200.000\")',
             decoder: 'optional - Decoder key (e.g., :gsm) to start live decoding (starts recording if provided)',
             record_dir: 'optional - Directory where GQRX saves recordings (required if decoder provided; defaults to /tmp/gqrx_recordings)',

data/lib/pwn/version.rb

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

data/third_party/pwn_rdoc.jsonl

@@ -1274,11 +1274,18 @@
 {"messages":[{"role":"user","content":"PWN::SAST::WindowLocationHash.scan Usage"},{"role":"assistant","content":"`PWN::SAST::WindowLocationHash.scan`: Supported Method Parameters\n\nPWN::SAST::WindowLocationHash.scan(\n\ndir_path: 'optional path to dir defaults to .'\ngit_repo_root_uri: 'optional http uri of git repo scanned'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SAST::WindowLocationHash.security_references Usage"},{"role":"assistant","content":"`PWN::SAST::WindowLocationHash.security_references`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR.help Usage"},{"role":"assistant","content":"`PWN::SDR.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR.hz_to_i Usage"},{"role":"assistant","content":"`PWN::SDR.hz_to_i`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR.hz_to_s Usage"},{"role":"assistant","content":"`PWN::SDR.hz_to_s`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::GSM.authors Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::GSM.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::GSM.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::GSM.help`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::GSM.start Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::GSM.start`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::Decoder::GSM.stop Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::GSM.stop`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::RDS.authors Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::RDS.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::RDS.decode Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::RDS.decode`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::RDS.help Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::RDS.help`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::RDS.start Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::RDS.start`: "}]}
+{"messages":[{"role":"user","content":"PWN::SDR::Decoder::RDS.stop Usage"},{"role":"assistant","content":"`PWN::SDR::Decoder::RDS.stop`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::FlipperZero.authors Usage"},{"role":"assistant","content":"`PWN::SDR::FlipperZero.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::FlipperZero.connect Usage"},{"role":"assistant","content":"`PWN::SDR::FlipperZero.connect`: Supported Method Parameters\n\nflipper_zero_obj = PWN::SDR::FlipperZero.connect(\n\nblock_dev: 'optional serial block device path (defaults to /dev/ttyACM0)',\nbaud: 'optional (defaults to 9600)',\ndata_bits: 'optional (defaults to 8)',\nstop_bits: 'optional (defaults to 1)',\nparity: 'optional - :even||:odd|:none (defaults to :none)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::FlipperZero.connect_via_screen Usage"},{"role":"assistant","content":"`PWN::SDR::FlipperZero.connect_via_screen`: Supported Method Parameters\n\nPWN::SDR::FlipperZero.connect_via_screen(\n\nblock_dev: 'optional - serial block device path (defaults to /dev/ttyACM0)'\n\n)\n"}]}
@@ -1292,18 +1299,16 @@
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.analyze_scan Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.analyze_scan`: Supported Method Parameters\n\nPWN::SDR::GQRX.analyze_scan(\n\nscan_resp: 'required - Scan response hash returned from #scan_range method',\ntarget: 'optional - GQRX target IP address (defaults to 127.0.0.1)',\nport: 'optional - GQRX target port (defaults to 7356)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.authors Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.connect Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.connect`: Supported Method Parameters\n\ngqrx_sock = PWN::SDR::GQRX.connect(\n\ntarget: 'optional - GQRX target IP address (defaults to 127.0.0.1)',\nport: 'optional - GQRX target port (defaults to 7356)'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.decode_rds Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.decode_rds`: Supported Method Parameters\n\nrds_resp = PWN::SDR::GQRX.decode_rds(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.disconnect Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.disconnect`: Supported Method Parameters\n\nPWN::SDR::GQRX.disconnect(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method'\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',\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.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.gqrx_cmd Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.gqrx_cmd`: Supported Method Parameters\n\ngqrx_resp = PWN::SDR::GQRX.gqrx_cmd(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\ncmd: 'required - GQRX command to execute',\nresp_ok: 'optional - Expected response from GQRX to indicate success'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.help Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.help`: "}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.init_freq Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.init_freq`: Supported Method Parameters\n\nfreq_obj = PWN::SDR::GQRX.init_freq(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nfreq: 'required - Frequency to set',\ndemodulator_mode: 'optional - Demodulator mode (defaults to WFM)',\nrds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',\nbandwidth: 'optional - Bandwidth (defaults to 200_000)',\nsquelch: 'optional - Squelch level to set (Defaults to current value)',\ndecoder: 'optional - Decoder key (e.g., :gsm) to start live decoding (starts recording if provided)',\nrecord_dir: 'optional - Directory where GQRX saves recordings (required if decoder provided; defaults to /tmp/gqrx_recordings)',\nsuppress_details: 'optional - Boolean to include extra frequency details in return hash (defaults to false)',\nkeep_alive: 'optional - Boolean to keep GQRX connection alive after method completion (defaults to false)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::GQRX.init_freq Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.init_freq`: Supported Method Parameters\n\nfreq_obj = PWN::SDR::GQRX.init_freq(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nfreq: 'required - Frequency to set',\ndemodulator_mode: 'optional - Demodulator mode (defaults to WFM)',\nrds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',\nbandwidth: 'optional - Bandwidth (defaults to \"200.000\")',\nsquelch: 'optional - Squelch level to set (Defaults to current value)',\ndecoder: 'optional - Decoder key (e.g., :gsm) to start live decoding (starts recording if provided)',\nrecord_dir: 'optional - Directory where GQRX saves recordings (required if decoder provided; defaults to /tmp/gqrx_recordings)',\nsuppress_details: 'optional - Boolean to include extra frequency details in return hash (defaults to false)',\nkeep_alive: 'optional - Boolean to keep GQRX connection alive after method completion (defaults to false)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.log_signals Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.log_signals`: Supported Method Parameters\n\nscan_resp = PWN::SDR::GQRX.log_signals(\n\nsignals_arr: 'required - Array of detected signals',\ntimestamp_start: 'required - Scan start timestamp',\nscan_log: 'required - Path to save detected signals log'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.measure_signal_strength Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.measure_signal_strength`: Supported Method Parameters\n\nstrength_db = PWN::SDR::GQRX.measure_signal_strength(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nstrength_lock: 'optional - Strength lock in dBFS to determine signal edges (defaults to -70.0)'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.scan_range Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.scan_range`: Supported Method Parameters\n\nscan_resp = PWN::SDR::GQRX.scan_range(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nstart_freq: 'required - Start frequency of scan range',\ntarget_freq: 'required - Target frequency of scan range',\ndemodulator_mode: 'optional - Demodulator mode (e.g. WFM, AM, FM, USB, LSB, RAW, CW, RTTY / defaults to WFM)',\nrds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',\nbandwidth: 'optional - Bandwidth in Hz (Defaults to 200_000)',\nprecision: 'optional - Frequency step precision (number of digits; defaults to 1)',\nstrength_lock: 'optional - Strength lock in dBFS (defaults to -70.0)',\nsquelch: 'optional - Squelch level in dBFS (defaults to strength_lock - 3.0)',\naudio_gain_db: 'optional - Audio gain in dB (defaults to 6.0)',\nrf_gain: 'optional - RF gain (defaults to 0.0)',\nintermediate_gain: 'optional - Intermediate gain (defaults to 32.0)',\nbaseband_gain: 'optional - Baseband gain (defaults to 10.0)',\nscan_log: 'optional - Path to save detected signals log (defaults to /tmp/pwn_sdr_gqrx_scan_<start_freq>-<target_freq>_<timestamp>.json)',\nlocation: 'optional - Location string to include in AI analysis (e.g., \"New York, NY\", 90210, GPS coords, etc.)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::GQRX.measure_signal_strength Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.measure_signal_strength`: Supported Method Parameters\n\nstrength_db = PWN::SDR::GQRX.measure_signal_strength(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nfreq: 'required - Frequency to measure signal strength',\nstrength_lock: 'optional - Strength lock in dBFS to determine signal edges (defaults to -70.0)',\nphase: 'optional - Phase of measurement for logging purposes (defaults to :find_candidates)'\n\n)\n"}]}
+{"messages":[{"role":"user","content":"PWN::SDR::GQRX.scan_range Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.scan_range`: Supported Method Parameters\n\nscan_resp = PWN::SDR::GQRX.scan_range(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nstart_freq: 'required - Start frequency of scan range',\ntarget_freq: 'required - Target frequency of scan range',\ndemodulator_mode: 'optional - Demodulator mode (e.g. WFM, AM, FM, USB, LSB, RAW, CW, RTTY / defaults to WFM)',\nrds: 'optional - Boolean to enable/disable RDS decoding (defaults to false)',\nbandwidth: 'optional - Bandwidth in Hz (Defaults to \"200.000\")',\nprecision: 'optional - Frequency step precision (number of digits; defaults to 1)',\nstrength_lock: 'optional - Strength lock in dBFS (defaults to -70.0)',\nsquelch: 'optional - Squelch level in dBFS (defaults to strength_lock - 3.0)',\naudio_gain_db: 'optional - Audio gain in dB (defaults to 6.0)',\nrf_gain: 'optional - RF gain (defaults to 0.0)',\nintermediate_gain: 'optional - Intermediate gain (defaults to 32.0)',\nbaseband_gain: 'optional - Baseband gain (defaults to 10.0)',\nscan_log: 'optional - Path to save detected signals log (defaults to /tmp/pwn_sdr_gqrx_scan_<start_freq>-<target_freq>_<timestamp>.json)',\nlocation: 'optional - Location string to include in AI analysis (e.g., \"New York, NY\", 90210, GPS coords, etc.)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::GQRX.tune_to Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.tune_to`: Supported Method Parameters\n\ntune_resp = PWN::SDR::GQRX.tune_to(\n\ngqrx_sock: 'required - GQRX socket object returned from #connect method',\nhz: 'required - Frequency to tune to'\n\n)\n"}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.cast_to_pretty_hz Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.cast_to_pretty_hz`: "}]}
-{"messages":[{"role":"user","content":"PWN::SDR::GQRX.cast_to_raw_hz Usage"},{"role":"assistant","content":"`PWN::SDR::GQRX.cast_to_raw_hz`: "}]}
 {"messages":[{"role":"user","content":"PWN::SDR::RFIDler.authors Usage"},{"role":"assistant","content":"`PWN::SDR::RFIDler.authors`: Author(s)\n\n0day Inc. <support@0dayinc.com>\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::RFIDler.connect_via_screen Usage"},{"role":"assistant","content":"`PWN::SDR::RFIDler.connect_via_screen`: Supported Method Parameters\n\nPWN::SDR::RFIDler.connect_via_screen(\n\nblock_dev: 'optional - serial block device path (defaults to /dev/ttyUSB0)'\n\n)\n"}]}
 {"messages":[{"role":"user","content":"PWN::SDR::RFIDler.help Usage"},{"role":"assistant","content":"`PWN::SDR::RFIDler.help`: "}]}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.518
+  version: 0.5.520
 platform: ruby
 authors:
 - 0day Inc.
@@ -141,14 +141,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.2
+        version: 4.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.2
+        version: 4.0.3
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -2447,7 +2447,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Automated Security Testing for CI/CD Pipelines & Beyond
 test_files: []