Module: PWN::SDR::Decoder::WiFi

Defined in:
lib/pwn/sdr/decoder/wifi.rb

Overview

True-air + detector-fallback decoder for WiFi. Prefers PWN::FFI I/Q (RTL-SDR / ADALM-Pluto / HackRF / capture file) via Base.run_iq; degrades to Base.run_detector with no hardware.

Defined Under Namespace

Classes: DemodIQ

Constant Summary collapse

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
].freeze

Class Method Summary collapse

Class Method Details

.authors ⇒ Object

Author(s)

0day Inc. support@0dayinc.com



113
114
115
 
# File 'lib/pwn/sdr/decoder/wifi.rb', line 113

public_class_method def self.authors
  "AUTHOR(S):\n  0day Inc. <support@0dayinc.com>\n"
end

.decode(opts = {}) ⇒ Object

Supported Method Parameters

PWN::SDR::Decoder::WiFi.decode( freq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq' )



74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
 
# File 'lib/pwn/sdr/decoder/wifi.rb', line 74

public_class_method def self.decode(opts = {})
  freq_obj = opts[:freq_obj]

  rate  = (opts[:sample_rate] || freq_obj[:iq_rate] || 2_000_000).to_i
  proto = 'WiFi-802.11'
  demod = DemodIQ.new(
    rate: rate, protocol: proto, modulation: 'OFDM',
    extra: { threshold: 6.0 }
  )
  PWN::SDR::Decoder::Base.run_iq(
    freq_obj: freq_obj,
    protocol: proto,
    sample_rate: rate,
    source: opts[:source],
    file: opts[:file],
    demod: demod,
    threshold: 6.0,
    note: '20+ MHz OFDM — true-air I/Q path reports channel occupancy/duty.',
    describe: proc { |b| { modulation: 'OFDM', airtime_ms: b[:duration_ms] } }
  )
end

.help ⇒ Object 



117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/pwn/sdr/decoder/wifi.rb', line 117

public_class_method def self.help
  puts "USAGE (true-air I/Q via PWN::FFI + detector fallback):
    #{self}.decode(
      freq_obj: 'required - freq_obj returned from PWN::SDR::GQRX.init_freq',
      source:   'optional - :auto|:rtlsdr|:adalm_pluto|:file',
      file:     'optional - .cu8/.cs16 capture'
    )

    #{self}.authors
  "
end

.parse_line(opts = {}) ⇒ Object 



101
102
103
104
105
106
107
108
109
 
# File 'lib/pwn/sdr/decoder/wifi.rb', line 101

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],
    channel: f[5], rssi: f[6], ssid: f[7]
  }.reject { |_, v| v.to_s.empty? }
  out[:summary] = "WiFi ch=#{out[:channel]} BSSID=#{out[:bssid]} SSID=#{out[:ssid]} RSSI=#{out[:rssi]}"
  out
end