pwn 0.4.459 → 0.4.463

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34af764fdd574b15da3c45adb4097933e47a3aaca2de6dcb4c8f8005b6608f1d
-  data.tar.gz: 5bf7e7551c6c62d12a2c2811493034ba31a0545f59aa3a72483aa3701b04b626
+  metadata.gz: a39a74b8bc26847795f54fdcbd7f48eb5a38c2587da0d233e74bd96a8267c9a9
+  data.tar.gz: fa37dda7a5e16dc6743da3930b5278d83077e2ba100d65566eef9fd39c373967
 SHA512:
-  metadata.gz: 95f9def16df7e14a69731c08b4b7f4d3cf5e9e2e4b2c618b7c5b75dfba4bbbeed142f2aa03328ef3412c8bc95bc5ee87292ded504adc2d50d197113ce80c648d
-  data.tar.gz: 98d0f7cc871533e29b2c1321ae65ef48f56be4debc0bad1cb0617504567e0b12adf1d363c295746c5c1241c3666b42e95a46eaded7028467228cb799d0a33416
+  metadata.gz: e08cddc2558b06ed364a65dd058f94d75f2b02241a8adf613818c992ad038e8bb5f23b30d59e8f9061a3d1538a817697eabf4985f484f4076827e4fbbbe28ddc
+  data.tar.gz: 2b098194d45038d7cc85ba1653a3aa85bb432de6049fcebbcc58575a982eb02b31c4757d425c984e60c88a07a6a62868c411ed52043d79dff649052e65a3c27f

data/Gemfile

@@ -59,7 +59,7 @@ gem 'rex', '2.0.13'
 gem 'rmagick', '4.2.5'
 gem 'rspec', '3.11.0'
 gem 'rtesseract', '3.1.2'
-gem 'rubocop', '1.29.1'
+gem 'rubocop', '1.30.0'
 gem 'rubocop-rake', '0.6.0'
 gem 'rubocop-rspec', '2.11.1'
 gem 'ruby-audio', '1.6.1'

data/README.md

@@ -37,7 +37,7 @@ $ rvm use ruby-3.1.2@pwn
 $ rvm list gemsets
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.4.459]:001 >>> PWN.help
+pwn[v0.4.463]: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.1.2@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.4.459]:001 >>> PWN.help
+pwn[v0.4.463]:001 >>> PWN.help
 ```
 
 

data/bin/pwn_serial_check_voicemail

@@ -35,7 +35,7 @@ serial_obj = PWN::Plugins::Serial.connect
 
 PWN::Plugins::Serial.request(
   serial_obj: serial_obj,
-  request: "ATDT#{voicemail_num};\r\n"
+  payload: "ATDT#{voicemail_num};\r\n"
 )
 
 # TODO: Loop until data received indicates call picked up instead of sleep
@@ -44,18 +44,18 @@ sleep 13
 voicemail_pin.each_char do |pin_char|
   PWN::Plugins::Serial.request(
     serial_obj: serial_obj,
-    request: "AT+VTS=#{pin_char}\r\n"
+    payload: "AT+VTS=#{pin_char}\r\n"
   )
 end
 
 PWN::Plugins::Serial.request(
   serial_obj: serial_obj,
-  request: "AT+VTS=#\r\n"
+  payload: "AT+VTS=#\r\n"
 )
 
 PWN::Plugins::Serial.request(
   serial_obj: serial_obj,
-  request: "AT+CHUP;\r\n"
+  payload: "AT+CHUP;\r\n"
 )
 
 session_data = PWN::Plugins::Serial.dump_session_data

data/bin/pwn_serial_msr206

@@ -0,0 +1,66 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: false
+
+require 'pwn'
+require 'optparse'
+
+opts = {}
+OptionParser.new do |options|
+  options.banner = "USAGE:
+    #{$PROGRAM_NAME} [opts]
+  "
+
+  options.on('-dDEV', '--block-dev=DEV', '<Optional - MSR206 block device path (defaults to /dev/ttyUSB0)>') do |d|
+    opts[:block_dev] = d
+  end
+
+  options.on('-bBAUD', '--baud=DEV', '<Optional - (defaults to 9600)>') do |d|
+    opts[:block_dev] = d
+  end
+
+  options.on('-DDATABITS', '--data-bits=DATABITS', '<Optional - (defaults to 7)>') do |d|
+    opts[:block_dev] = d
+  end
+
+  options.on('-sSTOPBITS', '--stop-bits=STOPBITS', '<Optional - (defaults to 1)>') do |d|
+    opts[:block_dev] = d
+  end
+
+  options.on('-pPARITY', '--parity=PARITY', '<Optional - :even|:mark|:odd|:space|:none (defaults to :odd)>') do |d|
+    opts[:block_dev] = d
+  end
+
+  options.on('-fFLOW', '--flow-control=FLOW', '<Optional - :none||:hard||:soft (defaults to :none)>') do |d|
+    opts[:block_dev] = d
+  end
+end.parse!
+
+if opts.empty?
+  puts `#{$PROGRAM_NAME} --help`
+  exit 1
+end
+
+begin
+  block_dev = opts[:block_dev]
+  baud = opts[:baud]
+  data_bits = opts[:data_bits]
+  stop_bits = opts[:stop_bits]
+  parity = opts[:parity]
+  flow_control = opts[:flow_control]
+
+  msr206_obj = PWN::Plugins::MSR206.connect(
+    block_dev: block_dev,
+    baud: baud,
+    data_bits: data_bits,
+    stop_bits: stop_bits,
+    parity: parity,
+    flow_control: flow_control
+  )
+
+  serial_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :simulate_power_cycle_warm_reset
+  )
+rescue SystemExit, Interrupt
+  puts "\nGoodbye."
+end

data/bin/pwn_serial_qualcomm_commands

@@ -7,7 +7,7 @@ serial_obj = PWN::Plugins::Serial.connect
 
 PWN::Plugins::Serial.request(
   serial_obj: serial_obj,
-  request: "AT+CLAC\r\n"
+  payload: "AT+CLAC\r\n"
 )
 
 session_data = PWN::Plugins::Serial.dump_session_data

data/lib/pwn/plugins/bus_pirate.rb

@@ -63,28 +63,28 @@ module PWN
         case mode
         when 'BBI01'
           # Enter reset binary mode
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x00')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x00])
         when 'SPI1'
           # Enter binary SPI mode
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x01')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x01])
         when 'I2C1'
           # Enter I2C mode
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x02')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x02])
         when 'ART1'
           # Enter UART mode
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x03')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x03])
         when '1W01'
           # Enter 1-Wire mode
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x04')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x04])
         when 'RAW1'
           # Enter raw-wire mode
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x05')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x05])
         when 'RESET'
           # Reset Bus Pirate
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x0F')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x0F])
         when 'STEST'
           # Bus Pirate self-tests
-          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, request: '\x10')
+          PWN::Plugins::Serial.request(serial_obj: bus_pirate_obj, payload: [0x10])
         else
           raise "Invalid mode: #{mode}"
         end

data/lib/pwn/plugins/msr206.rb

@@ -9,15 +9,20 @@ module PWN
       # msr206_obj = PWN::Plugins::MSR206.connect(
       #   block_dev: 'optional - serial block device path (defaults to /dev/ttyUSB0)',
       #   baud: 'optional - (defaults to 9600)',
-      #   data_bits: 'optional - (defaults to 8)',
+      #   data_bits: 'optional - (defaults to 7)',
       #   stop_bits: 'optional - (defaults to 1)',
-      #   parity: 'optional - (defaults to SerialPort::NONE)',
-      #   flow_control: 'optional - (defaults to SerialPort::HARD) SerialPort::NONE|SerialPort::SOFT|SerialPort::HARD'
+      #   parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :odd),'
+      #   flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
       # )
 
       public_class_method def self.connect(opts = {})
         # Default Baud Rate for this Device is 19200
-        opts[:baud] = 19_200 if opts[:baud].nil?
+        opts[:block_dev] = '/dev/ttyUSB0' unless opts[:block_dev]
+        opts[:baud] = 9_600 unless opts[:baud]
+        opts[:data_bits] = 7 unless opts[:data_bits]
+        opts[:stop_bits] = 1 unless opts[:stop_bits]
+        opts[:parity] = :odd unless opts[:parity]
+        opts[:flow_control] = :none unless opts[:flow_control]
         msr206_obj = PWN::Plugins::Serial.connect(opts)
       rescue StandardError => e
         disconnect(msr206_obj: msr206_obj) unless msr206_obj.nil?
@@ -88,47 +93,6 @@ module PWN
         raise e
       end
 
-      # Supported Method Parameters::
-      # cmd_response_arr = get_cmd_responses(
-      #   msr206_obj: 'required - msr206_obj returned from #connect method'
-      # )
-
-      public_class_method def self.get_cmd_responses(opts = {})
-        msr206_obj = opts[:msr206_obj]
-
-        raw_byte_arr = PWN::Plugins::Serial.dump_session_data(
-          serial_obj: msr206_obj
-        )
-
-        hex_esc_raw_resp = ''
-        raw_byte_arr.each do |byte|
-          this_byte = byte.unpack1('H*')
-          # Needed when #unpack1 returns 2 bytes instead of one
-          # e.g."ް" translates to deb0 (that's not a double quote ")
-          # instead of de b0
-          # this condition is ghetto-hacker-ish.
-          if this_byte.length == 4
-            byte_one = this_byte[1..2]
-            byte_two = this_byte[-2..-1]
-            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{byte_one}"
-            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{byte_two}"
-          else
-            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{this_byte}"
-          end
-        end
-
-        # Return command response array in space-delimited hex
-        cmd_response_arr = hex_esc_raw_resp.upcase.strip.split(/(?=FF)/)
-        cmd_response_arr.map(&:strip)
-      rescue StandardError => e
-        # Flush Responses for Next Request
-        PWN::Plugins::Serial.flush_session_data(
-          serial_obj: msr206_obj
-        )
-
-        raise e
-      end
-
       # Supported Method Parameters::
       # parsed_cmd_resp_arr = parse_responses(
       #   cmd_resp: 'required - command response string'
@@ -150,10 +114,9 @@ module PWN
 
         while keep_parsing_responses
           until next_response_detected
-            all_cmd_responses = get_cmd_responses(
-              msr206_obj: msr206_obj
-            )
-            # bytes_in_cmd_resp = cmd_resp.split.length if cmd_resp
+            all_cmd_responses = PWN::Plugins::Serial.response(serial_obj: msr206_obj)
+            cmd_resp = all_cmd_responses.last
+            bytes_in_cmd_resp = cmd_resp.split.length if cmd_resp
             a_cmd_r_len = all_cmd_responses.length
 
             next_response_detected = true if a_cmd_r_len > last_a_cmd_r_len
@@ -175,9 +138,7 @@ module PWN
         raise e
       ensure
         # Flush Responses for Next Request
-        PWN::Plugins::Serial.flush_session_data(
-          serial_obj: msr206_obj
-        )
+        PWN::Plugins::Serial.flush_session_data
       end
 
       # Supported Method Parameters::
@@ -211,8 +172,6 @@ module PWN
           cmd_bytes = [0x29]
         when :version_report
           cmd_bytes = [0x39]
-        when :power_on_report
-          cmd_bytes = [0x3A]
         when :set_write_density
           cmd_bytes = [0x3B]
         when :set_temp_write_current
@@ -304,9 +263,10 @@ module PWN
         # If parameters to a command are set, append them.
         cmd_bytes += params_bytes unless params_bytes.empty?
         # Execute the command.
-        cmd_bytes.each do |byte|
-          msr206_obj[:serial_conn].putc(byte)
-        end
+        PWN::Plugins::Serial.request(
+          serial_obj: msr206_obj,
+          payload: cmd_bytes
+        )
 
         # Parse commands response(s).
         # Return an array of hashes.
@@ -316,6 +276,9 @@ module PWN
         )
       rescue StandardError => e
         raise e
+      ensure
+        # Flush Responses for Next Request
+        PWN::Plugins::Serial.flush_session_data
       end
 
       # Supported Method Parameters::
@@ -346,10 +309,10 @@ module PWN
           msr206_obj = #{self}.connect(
             block_dev: 'optional serial block device path (defaults to /dev/ttyUSB0)',
             baud: 'optional (defaults to 9600)',
-            data_bits: 'optional (defaults to 8)',
+            data_bits: 'optional (defaults to 7)',
             stop_bits: 'optional (defaults to 1)',
-            parity: 'optional (defaults to SerialPort::NONE)',
-            flow_control: 'optional (defaults to SerialPort::NONE)'
+            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :odd),'
+            flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
           )
 
           cmds = #{self}.list_cmds

data/lib/pwn/plugins/serial.rb

@@ -8,7 +8,6 @@ module PWN
     # This plugin is used for interacting with serial devices including, but not limited to,
     # modems (including cellphone radios), legacy equipment, arduinos, & other misc ftdi devices
     module Serial
-      # @session_data = ""
       @session_data = []
 
       # Supported Method Parameters::
@@ -17,8 +16,8 @@ module PWN
       #   baud: 'optional - (defaults to 9600)',
       #   data_bits: 'optional - (defaults to 8)',
       #   stop_bits: 'optional - (defaults to 1)',
-      #   parity: 'optional - (defaults to SerialPort::NONE)',
-      #   flow_control: 'optional - (defaults to SerialPort::HARD) SerialPort::NONE|SerialPort::SOFT|SerialPort::HARD'
+      #   parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :none)',
+      #   flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
       # )
 
       public_class_method def self.connect(opts = {})
@@ -45,17 +44,27 @@ module PWN
                       opts[:stop_bits].to_i
                     end
 
-        parity = if opts[:parity].nil?
-                   SerialPort::NONE
-                 else
-                   opts[:parity]
-                 end
+        case opts[:parity]
+        when :even
+          parity = SerialPort::EVEN
+        when :mark
+          parity = SerialPort::MARK
+        when :odd
+          parity = SerialPort::ODD
+        when :space
+          parity = SerialPort::SPACE
+        else
+          parity = SerialPort::NONE
+        end
 
-        flow_control = if opts[:flow_control].nil?
-                         SerialPort::HARD
-                       else
-                         opts[:flow_control]
-                       end
+        case opts[:flow_control]
+        when :hard
+          flow_control = SerialPort::HARD
+        when :soft
+          flow_control = SerialPort::SOFT
+        else
+          flow_control = SerialPort::NONE
+        end
 
         serial_conn = SerialPort.new(
           block_dev,
@@ -138,21 +147,39 @@ module PWN
       # Supported Method Parameters::
       # PWN::Plugins::Serial.request(
       #   serial_obj: 'required serial_obj returned from #connect method',
-      #   request: 'required - string to write to serial device'
+      #   payload: 'required - array of bytes OR string to write to serial device (e.g. [0x00, 0x41, 0x90, 0x00] OR "ATDT+15555555\r\n"'
       # )
 
       public_class_method def self.request(opts = {})
         serial_obj = opts[:serial_obj]
-        request = opts[:request].to_s.scrub
+        payload = opts[:payload]
         serial_conn = serial_obj[:serial_conn]
-        chars_written = serial_conn.write(request)
+
+        byte_arr = payload
+        byte_arr = payload.chars if payload.instance_of?(String)
+
+        byte_arr.each do |byte|
+          serial_conn.putc(byte)
+        end
+
         serial_conn.flush
-        chars_written
       rescue StandardError => e
         disconnect(serial_obj: serial_obj) unless serial_obj.nil?
         raise e
       end
 
+      # public_class_method def self.request(opts = {})
+      #   serial_obj = opts[:serial_obj]
+      #   request = opts[:request].to_s.scrub
+      #   serial_conn = serial_obj[:serial_conn]
+      #   chars_written = serial_conn.write(request)
+      #   serial_conn.flush
+      #   chars_written
+      # rescue StandardError => e
+      #   disconnect(serial_obj: serial_obj) unless serial_obj.nil?
+      #   raise e
+      # end
+
       # Supported Method Parameters::
       # PWN::Plugins::Serial.response(
       #   serial_obj: 'required - serial_obj returned from #connect method'
@@ -160,37 +187,60 @@ module PWN
 
       public_class_method def self.response(opts = {})
         serial_obj = opts[:serial_obj]
-        @session_data.last
+
+        raw_byte_arr = dump_session_data
+
+        hex_esc_raw_resp = ''
+        raw_byte_arr.each do |byte|
+          # this_byte = "\s#{byte.unpack1('H*')}"
+          this_byte = byte.unpack1('H*')
+          # Needed when #unpack1 returns 2 bytes instead of one
+          # e.g."ް" translates to deb0 (that's not a double quote ")
+          # instead of de b0
+          # this condition is ghetto-hacker-ish.
+          if this_byte.length == 4
+            byte_one = this_byte[1..2]
+            byte_two = this_byte[-2..-1]
+            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{byte_one}"
+            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{byte_two}"
+          else
+            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{this_byte}"
+          end
+        end
+
+        # Return command response array in space-delimited hex
+        cmd_response_arr = hex_esc_raw_resp.upcase.strip.split(/(?=FF)/)
+        cmd_response_arr.map(&:strip)
       rescue StandardError => e
-        disconnect(serial_obj: serial_obj) unless serial_obj.nil?
+        # Flush Responses for Next Request
+        flush_session_data(serial_obj: serial_obj)
+
         raise e
       end
 
-      # Supported Method Parameters::
-      # session_data = PWN::Plugins::Serial.dump_session_data(
-      #   serial_obj: 'required - serial_obj returned from #connect method'
-      # )
+      # public_class_method def self.response(opts = {})
+      #   serial_obj = opts[:serial_obj]
+      #   @session_data.last
+      # rescue StandardError => e
+      #   disconnect(serial_obj: serial_obj) unless serial_obj.nil?
+      #   raise e
+      # end
 
-      public_class_method def self.dump_session_data(opts = {})
-        serial_obj = opts[:serial_obj]
+      # Supported Method Parameters::
+      # session_data = PWN::Plugins::Serial.dump_session_data
 
+      public_class_method def self.dump_session_data
         @session_data
       rescue StandardError => e
-        disconnect(serial_obj: serial_obj) unless serial_obj.nil?
         raise e
       end
 
       # Supported Method Parameters::
-      # session_data = PWN::Plugins::Serial.flush_session_data(
-      #   serial_obj: 'required - serial_obj returned from #connect method'
-      # )
-
-      public_class_method def self.flush_session_data(opts = {})
-        serial_obj = opts[:serial_obj]
+      # session_data = PWN::Plugins::Serial.flush_session_data
 
+      public_class_method def self.flush_session_data
         @session_data.clear
       rescue StandardError => e
-        disconnect(serial_obj: serial_obj) unless serial_obj.nil?
         raise e
       end
 
@@ -203,7 +253,7 @@ module PWN
         serial_obj = opts[:serial_obj]
         serial_conn = serial_obj[:serial_conn]
         session_thread = serial_obj[:session_thread]
-        flush_session_data(serial_obj: serial_obj)
+        flush_session_data
         session_thread.terminate
         serial_conn.close
         serial_conn = nil
@@ -228,8 +278,8 @@ module PWN
             baud: 'optional (defaults to 9600)',
             data_bits: 'optional (defaults to 8)',
             stop_bits: 'optional (defaults to 1)',
-            parity: 'optional (defaults to SerialPort::NONE)',
-            flow_control: 'optional (defaults to SerialPort::NONE)'
+            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :none)',
+            flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
           )
 
           line_state = #{self}.get_line_state(
@@ -242,20 +292,16 @@ module PWN
 
           #{self}.request(
             serial_obj: 'required serial_obj returned from #connect method',
-            request: 'required string to write to serial device'
+            payload: 'required - array of bytes OR string to write to serial device (e.g. [0x00, 0x41, 0x90, 0x00] OR \"ATDT+15555555\r\n\"'
           )
 
           #{self}.response(
             serial_obj: 'required serial_obj returned from #connect method'
           )
 
-          session_data_arr = #{self}.dump_session_data(
-            serial_obj: 'required serial_obj returned from #connect method'
-          )
+          session_data_arr = #{self}.dump_session_data
 
           #{self}.flush_session_data
-            serial_obj: 'required serial_obj returned from #connect method'
-          )
 
           #{self}.disconnect(
             serial_obj: 'required serial_obj returned from #connect method'

data/lib/pwn/plugins/son_micro_rfid.rb

@@ -8,16 +8,21 @@ module PWN
       # Supported Method Parameters::
       # son_micro_rfid_obj = PWN::Plugins::SonMicroRFID.connect(
       #   block_dev: 'optional - serial block device path (defaults to /dev/ttyUSB0)',
-      #   baud: 'optional - (defaults to 9600)',
+      #   baud: 'optional - (defaults to 19_200)',
       #   data_bits: 'optional - (defaults to 8)',
       #   stop_bits: 'optional - (defaults to 1)',
-      #   parity: 'optional - (defaults to SerialPort::NONE)',
-      #   flow_control: 'optional - (defaults to SerialPort::HARD) SerialPort::NONE|SerialPort::SOFT|SerialPort::HARD'
+      #   parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :none)',
+      #   flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
       # )
 
       public_class_method def self.connect(opts = {})
         # Default Baud Rate for this Device is 19200
-        opts[:baud] = 19_200 if opts[:baud].nil?
+        opts[:block_dev] = '/dev/ttyUSB0' unless opts[:block_dev]
+        opts[:baud] = 19_200 unless opts[:baud]
+        opts[:data_bits] = 8 unless opts[:data_bits]
+        opts[:stop_bits] = 1 unless opts[:stop_bits]
+        opts[:parity] = :none unless opts[:parity]
+        opts[:flow_control] = :none unless opts[:flow_control]
         son_micro_rfid_obj = PWN::Plugins::Serial.connect(opts)
       rescue StandardError => e
         disconnect(son_micro_rfid_obj: son_micro_rfid_obj) unless son_micro_rfid_obj.nil?
@@ -108,50 +113,9 @@ module PWN
         raise e
       end
 
-      # Supported Method Parameters::
-      # cmd_response_arr = get_cmd_responses(
-      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
-      # )
-
-      public_class_method def self.get_cmd_responses(opts = {})
-        son_micro_rfid_obj = opts[:son_micro_rfid_obj]
-
-        raw_byte_arr = PWN::Plugins::Serial.dump_session_data(
-          serial_obj: son_micro_rfid_obj
-        )
-
-        hex_esc_raw_resp = ''
-        raw_byte_arr.each do |byte|
-          # this_byte = "\s#{byte.unpack1('H*')}"
-          this_byte = byte.unpack1('H*')
-          # Needed when #unpack1 returns 2 bytes instead of one
-          # e.g."ް" translates to deb0 (that's not a double quote ")
-          # instead of de b0
-          # this condition is ghetto-hacker-ish.
-          if this_byte.length == 4
-            byte_one = this_byte[1..2]
-            byte_two = this_byte[-2..-1]
-            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{byte_one}"
-            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{byte_two}"
-          else
-            hex_esc_raw_resp = "#{hex_esc_raw_resp}\s#{this_byte}"
-          end
-        end
-
-        # Return command response array in space-delimited hex
-        cmd_response_arr = hex_esc_raw_resp.upcase.strip.split(/(?=FF)/)
-        cmd_response_arr.map(&:strip)
-      rescue StandardError => e
-        # Flush Responses for Next Request
-        PWN::Plugins::Serial.flush_session_data(
-          serial_obj: son_micro_rfid_obj
-        )
-
-        raise e
-      end
-
       # Supported Method Parameters::
       # parsed_cmd_resp_arr = parse_responses(
+      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
       #   cmd_resp: 'required - command response string'
       # )
 
@@ -173,13 +137,14 @@ module PWN
         while keep_parsing_responses
           until next_response_detected
             print '.'
-            all_cmd_responses = get_cmd_responses(
-              son_micro_rfid_obj: son_micro_rfid_obj
+            all_cmd_responses = PWN::Plugins::Serial.response(
+              serial_obj: son_micro_rfid_obj
             )
             cmd_resp = all_cmd_responses.last
             bytes_in_cmd_resp = cmd_resp.split.length if cmd_resp
             a_cmd_r_len = all_cmd_responses.length
 
+            # Dont proceed until the expected_cmd_resp_byte_len byte appears
             next_response_detected = true if bytes_in_cmd_resp > 3 &&
                                              a_cmd_r_len > last_a_cmd_r_len
           end
@@ -194,8 +159,8 @@ module PWN
           cmd_hex = cmd_resp.split[3]
 
           while bytes_in_cmd_resp < expected_cmd_resp_byte_len
-            all_cmd_responses = get_cmd_responses(
-              son_micro_rfid_obj: son_micro_rfid_obj
+            all_cmd_responses = PWN::Plugins::Serial.response(
+              serial_obj: son_micro_rfid_obj
             )
 
             cmd_resp = all_cmd_responses.last
@@ -210,6 +175,7 @@ module PWN
           puts "#{all_cmd_responses}\n\n\n"
 
           parsed_cmd_resp_hash = {}
+          parsed_cmd_resp_hash[:raw_resp] = PWN::Plugins::Serial.dump_session_data.inspect
           parsed_cmd_resp_hash[:hex_resp] = cmd_resp
           parsed_cmd_resp_hash[:cmd_hex] = cmd_hex
           parsed_cmd_resp_hash[:cmd_desc] = cmd.to_sym
@@ -268,9 +234,7 @@ module PWN
         raise e
       ensure
         # Flush Responses for Next Request
-        PWN::Plugins::Serial.flush_session_data(
-          serial_obj: son_micro_rfid_obj
-        )
+        PWN::Plugins::Serial.flush_session_data
       end
 
       # Supported Method Parameters::
@@ -355,9 +319,10 @@ module PWN
         # If parameters to a command are set, append them.
         cmd_bytes += params_bytes unless params_bytes.empty?
         # Execute the command.
-        cmd_bytes.each do |byte|
-          son_micro_rfid_obj[:serial_conn].putc(byte)
-        end
+        PWN::Plugins::Serial.request(
+          serial_obj: son_micro_rfid_obj,
+          payload: cmd_bytes
+        )
 
         # Parse commands response(s).
         # Return an array of hashes.
@@ -369,9 +334,7 @@ module PWN
         raise e
       ensure
         # Flush Responses for Next Request
-        PWN::Plugins::Serial.flush_session_data(
-          serial_obj: son_micro_rfid_obj
-        )
+        PWN::Plugins::Serial.flush_session_data
       end
 
       # Supported Method Parameters::
@@ -401,11 +364,11 @@ module PWN
         puts "USAGE:
           son_micro_rfid_obj = #{self}.connect(
             block_dev: 'optional serial block device path (defaults to /dev/ttyUSB0)',
-            baud: 'optional (defaults to 9600)',
+            baud: 'optional (defaults to 19_200)',
             data_bits: 'optional (defaults to 8)',
             stop_bits: 'optional (defaults to 1)',
-            parity: 'optional (defaults to SerialPort::NONE)',
-            flow_control: 'optional (defaults to SerialPort::NONE)'
+            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :odd),'
+            flow_control: 'optional - :none||:hard||:soft (defaults to :none)'
           )
 
           cmds = #{self}.list_cmds

data/lib/pwn/version.rb

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

data/pwn.gemspec

@@ -24,7 +24,6 @@ Gem::Specification.new do |spec|
     File.basename(f)
   end
 
-  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
   dev_dependency_arr = %i[

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.4.459
+  version: 0.4.463
 platform: ruby
 authors:
 - 0day Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-25 00:00:00.000000000 Z
+date: 2022-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -674,14 +674,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.29.1
+        version: 1.30.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.29.1
+        version: 1.30.0
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -1016,6 +1016,7 @@ executables:
 - pwn_perimeter_recon
 - pwn_sast
 - pwn_serial_check_voicemail
+- pwn_serial_msr206
 - pwn_serial_qualcomm_commands
 - pwn_simple_http_server
 - pwn_web_cache_deception
@@ -1075,6 +1076,7 @@ files:
 - bin/pwn_perimeter_recon
 - bin/pwn_sast
 - bin/pwn_serial_check_voicemail
+- bin/pwn_serial_msr206
 - bin/pwn_serial_qualcomm_commands
 - bin/pwn_simple_http_server
 - bin/pwn_web_cache_deception
@@ -1974,218 +1976,4 @@ rubygems_version: 3.3.14
 signing_key: 
 specification_version: 4
 summary: Automated Security Testing for CI/CD Pipelines & Beyond
-test_files:
-- spec/lib/pwn/aws/acm_spec.rb
-- spec/lib/pwn/aws/api_gateway_spec.rb
-- spec/lib/pwn/aws/app_stream_spec.rb
-- spec/lib/pwn/aws/application_auto_scaling_spec.rb
-- spec/lib/pwn/aws/application_discovery_service_spec.rb
-- spec/lib/pwn/aws/auto_scaling_spec.rb
-- spec/lib/pwn/aws/batch_spec.rb
-- spec/lib/pwn/aws/budgets_spec.rb
-- spec/lib/pwn/aws/cloud_formation_spec.rb
-- spec/lib/pwn/aws/cloud_front_spec.rb
-- spec/lib/pwn/aws/cloud_hsm_spec.rb
-- spec/lib/pwn/aws/cloud_search_domain_spec.rb
-- spec/lib/pwn/aws/cloud_search_spec.rb
-- spec/lib/pwn/aws/cloud_trail_spec.rb
-- spec/lib/pwn/aws/cloud_watch_events_spec.rb
-- spec/lib/pwn/aws/cloud_watch_logs_spec.rb
-- spec/lib/pwn/aws/cloud_watch_spec.rb
-- spec/lib/pwn/aws/code_build_spec.rb
-- spec/lib/pwn/aws/code_commit_spec.rb
-- spec/lib/pwn/aws/code_deploy_spec.rb
-- spec/lib/pwn/aws/code_pipeline_spec.rb
-- spec/lib/pwn/aws/cognito_identity_provider_spec.rb
-- spec/lib/pwn/aws/cognito_identity_spec.rb
-- spec/lib/pwn/aws/cognito_sync_spec.rb
-- spec/lib/pwn/aws/config_service_spec.rb
-- spec/lib/pwn/aws/data_pipleline_spec.rb
-- spec/lib/pwn/aws/database_migration_service_spec.rb
-- spec/lib/pwn/aws/device_farm_spec.rb
-- spec/lib/pwn/aws/direct_connect_spec.rb
-- spec/lib/pwn/aws/directory_service_spec.rb
-- spec/lib/pwn/aws/dynamo_db_spec.rb
-- spec/lib/pwn/aws/dynamo_db_streams_spec.rb
-- spec/lib/pwn/aws/ec2_spec.rb
-- spec/lib/pwn/aws/ecr_spec.rb
-- spec/lib/pwn/aws/ecs_spec.rb
-- spec/lib/pwn/aws/efs_spec.rb
-- spec/lib/pwn/aws/elasti_cache_spec.rb
-- spec/lib/pwn/aws/elastic_beanstalk_spec.rb
-- spec/lib/pwn/aws/elastic_load_balancing_spec.rb
-- spec/lib/pwn/aws/elastic_load_balancing_v2_spec.rb
-- spec/lib/pwn/aws/elastic_transcoder_spec.rb
-- spec/lib/pwn/aws/elasticsearch_service_spec.rb
-- spec/lib/pwn/aws/emr_spec.rb
-- spec/lib/pwn/aws/firehose_spec.rb
-- spec/lib/pwn/aws/game_lift_spec.rb
-- spec/lib/pwn/aws/glacier_spec.rb
-- spec/lib/pwn/aws/health_spec.rb
-- spec/lib/pwn/aws/iam_spec.rb
-- spec/lib/pwn/aws/import_export_spec.rb
-- spec/lib/pwn/aws/inspector_spec.rb
-- spec/lib/pwn/aws/iot_data_plane_spec.rb
-- spec/lib/pwn/aws/iot_spec.rb
-- spec/lib/pwn/aws/kinesis_analytics_spec.rb
-- spec/lib/pwn/aws/kinesis_spec.rb
-- spec/lib/pwn/aws/kms_spec.rb
-- spec/lib/pwn/aws/lambda_preview_spec.rb
-- spec/lib/pwn/aws/lambda_spec.rb
-- spec/lib/pwn/aws/lex_spec.rb
-- spec/lib/pwn/aws/lightsail_spec.rb
-- spec/lib/pwn/aws/machine_learning_spec.rb
-- spec/lib/pwn/aws/marketplace_commerce_analytics_spec.rb
-- spec/lib/pwn/aws/marketplace_metering_spec.rb
-- spec/lib/pwn/aws/ops_works_cm_spec.rb
-- spec/lib/pwn/aws/ops_works_spec.rb
-- spec/lib/pwn/aws/pinpoint_spec.rb
-- spec/lib/pwn/aws/polly_spec.rb
-- spec/lib/pwn/aws/rds_spec.rb
-- spec/lib/pwn/aws/redshift_spec.rb
-- spec/lib/pwn/aws/rekognition_spec.rb
-- spec/lib/pwn/aws/route53_domains_spec.rb
-- spec/lib/pwn/aws/route53_spec.rb
-- spec/lib/pwn/aws/s3_spec.rb
-- spec/lib/pwn/aws/service_catalog_spec.rb
-- spec/lib/pwn/aws/ses_spec.rb
-- spec/lib/pwn/aws/shield_spec.rb
-- spec/lib/pwn/aws/simple_db_spec.rb
-- spec/lib/pwn/aws/sms_spec.rb
-- spec/lib/pwn/aws/snowball_spec.rb
-- spec/lib/pwn/aws/sns_spec.rb
-- spec/lib/pwn/aws/sqs_spec.rb
-- spec/lib/pwn/aws/ssm_spec.rb
-- spec/lib/pwn/aws/states_spec.rb
-- spec/lib/pwn/aws/storage_gateway_spec.rb
-- spec/lib/pwn/aws/sts_spec.rb
-- spec/lib/pwn/aws/support_spec.rb
-- spec/lib/pwn/aws/swf_spec.rb
-- spec/lib/pwn/aws/waf_regional_spec.rb
-- spec/lib/pwn/aws/waf_spec.rb
-- spec/lib/pwn/aws/workspaces_spec.rb
-- spec/lib/pwn/aws/x_ray_spec.rb
-- spec/lib/pwn/aws_spec.rb
-- spec/lib/pwn/banner/bubble_spec.rb
-- spec/lib/pwn/banner/matrix_spec.rb
-- spec/lib/pwn/banner/ninja_spec.rb
-- spec/lib/pwn/banner/off_the_air_spec.rb
-- spec/lib/pwn/banner/pirate_spec.rb
-- spec/lib/pwn/banner_spec.rb
-- spec/lib/pwn/ffi_spec.rb
-- spec/lib/pwn/plugins/android_spec.rb
-- spec/lib/pwn/plugins/authentication_helper_spec.rb
-- spec/lib/pwn/plugins/basic_auth_spec.rb
-- spec/lib/pwn/plugins/beef_spec.rb
-- spec/lib/pwn/plugins/burp_suite_spec.rb
-- spec/lib/pwn/plugins/bus_pirate_spec.rb
-- spec/lib/pwn/plugins/char_spec.rb
-- spec/lib/pwn/plugins/credit_card_spec.rb
-- spec/lib/pwn/plugins/dao_ldap_spec.rb
-- spec/lib/pwn/plugins/dao_mongo_spec.rb
-- spec/lib/pwn/plugins/dao_postgres_spec.rb
-- spec/lib/pwn/plugins/dao_sqlite3_spec.rb
-- spec/lib/pwn/plugins/defect_dojo_spec.rb
-- spec/lib/pwn/plugins/detect_os_spec.rb
-- spec/lib/pwn/plugins/ein_spec.rb
-- spec/lib/pwn/plugins/file_fu_spec.rb
-- spec/lib/pwn/plugins/fuzz_spec.rb
-- spec/lib/pwn/plugins/git_spec.rb
-- spec/lib/pwn/plugins/hacker_one_spec.rb
-- spec/lib/pwn/plugins/ibm_appscan_spec.rb
-- spec/lib/pwn/plugins/ip_info_spec.rb
-- spec/lib/pwn/plugins/jenkins_spec.rb
-- spec/lib/pwn/plugins/json_pathify_spec.rb
-- spec/lib/pwn/plugins/mail_agent_spec.rb
-- spec/lib/pwn/plugins/metasploit_spec.rb
-- spec/lib/pwn/plugins/msr206_spec.rb
-- spec/lib/pwn/plugins/nessus_cloud_spec.rb
-- spec/lib/pwn/plugins/nexpose_vuln_scan_spec.rb
-- spec/lib/pwn/plugins/nmap_it_spec.rb
-- spec/lib/pwn/plugins/oauth2_spec.rb
-- spec/lib/pwn/plugins/ocr_spec.rb
-- spec/lib/pwn/plugins/openvas_spec.rb
-- spec/lib/pwn/plugins/owasp_zap_spec.rb
-- spec/lib/pwn/plugins/packet_spec.rb
-- spec/lib/pwn/plugins/pdf_parse_spec.rb
-- spec/lib/pwn/plugins/pony_spec.rb
-- spec/lib/pwn/plugins/rabbit_mq_spec.rb
-- spec/lib/pwn/plugins/rfidler_spec.rb
-- spec/lib/pwn/plugins/serial_spec.rb
-- spec/lib/pwn/plugins/shodan_spec.rb
-- spec/lib/pwn/plugins/slack_client_spec.rb
-- spec/lib/pwn/plugins/sock_spec.rb
-- spec/lib/pwn/plugins/son_micro_rfid_spec.rb
-- spec/lib/pwn/plugins/spider_spec.rb
-- spec/lib/pwn/plugins/ssn_spec.rb
-- spec/lib/pwn/plugins/thread_pool_spec.rb
-- spec/lib/pwn/plugins/transparent_browser_spec.rb
-- spec/lib/pwn/plugins/twitter_api_spec.rb
-- spec/lib/pwn/plugins/uri_scheme_spec.rb
-- spec/lib/pwn/plugins/vsphere_spec.rb
-- spec/lib/pwn/plugins_spec.rb
-- spec/lib/pwn/reports/fuzz_spec.rb
-- spec/lib/pwn/reports/sast_spec.rb
-- spec/lib/pwn/reports_spec.rb
-- spec/lib/pwn/sast/amqp_connect_as_guest_spec.rb
-- spec/lib/pwn/sast/apache_file_system_util_api_spec.rb
-- spec/lib/pwn/sast/aws_spec.rb
-- spec/lib/pwn/sast/banned_function_calls_c_spec.rb
-- spec/lib/pwn/sast/base64_spec.rb
-- spec/lib/pwn/sast/beef_hook_spec.rb
-- spec/lib/pwn/sast/cmd_execution_java_spec.rb
-- spec/lib/pwn/sast/cmd_execution_python_spec.rb
-- spec/lib/pwn/sast/cmd_execution_ruby_spec.rb
-- spec/lib/pwn/sast/cmd_execution_scala_spec.rb
-- spec/lib/pwn/sast/csrf_spec.rb
-- spec/lib/pwn/sast/deserial_java_spec.rb
-- spec/lib/pwn/sast/emoticon_spec.rb
-- spec/lib/pwn/sast/eval_spec.rb
-- spec/lib/pwn/sast/factory_spec.rb
-- spec/lib/pwn/sast/file_permission_spec.rb
-- spec/lib/pwn/sast/http_authorization_header_spec.rb
-- spec/lib/pwn/sast/inner_html_spec.rb
-- spec/lib/pwn/sast/keystore_spec.rb
-- spec/lib/pwn/sast/location_hash_spec.rb
-- spec/lib/pwn/sast/log4j_spec.rb
-- spec/lib/pwn/sast/logger_spec.rb
-- spec/lib/pwn/sast/password_spec.rb
-- spec/lib/pwn/sast/pom_version_spec.rb
-- spec/lib/pwn/sast/port_spec.rb
-- spec/lib/pwn/sast/private_key_spec.rb
-- spec/lib/pwn/sast/redirect_spec.rb
-- spec/lib/pwn/sast/redos_spec.rb
-- spec/lib/pwn/sast/shell_spec.rb
-- spec/lib/pwn/sast/signature_spec.rb
-- spec/lib/pwn/sast/sql_spec.rb
-- spec/lib/pwn/sast/ssl_spec.rb
-- spec/lib/pwn/sast/sudo_spec.rb
-- spec/lib/pwn/sast/task_tag_spec.rb
-- spec/lib/pwn/sast/throw_errors_spec.rb
-- spec/lib/pwn/sast/token_spec.rb
-- spec/lib/pwn/sast/version_spec.rb
-- spec/lib/pwn/sast/window_location_hash_spec.rb
-- spec/lib/pwn/sast_spec.rb
-- spec/lib/pwn/www/app_cobalt_io_spec.rb
-- spec/lib/pwn/www/bing_spec.rb
-- spec/lib/pwn/www/bug_crowd.rb
-- spec/lib/pwn/www/checkip_spec.rb
-- spec/lib/pwn/www/coinbase_pro_spec.rb
-- spec/lib/pwn/www/duckduckgo_spec.rb
-- spec/lib/pwn/www/facebook_spec.rb
-- spec/lib/pwn/www/google_spec.rb
-- spec/lib/pwn/www/hacker_one_spec.rb
-- spec/lib/pwn/www/linkedin_spec.rb
-- spec/lib/pwn/www/pandora_spec.rb
-- spec/lib/pwn/www/pastebin_spec.rb
-- spec/lib/pwn/www/paypal_spec.rb
-- spec/lib/pwn/www/synack_spec.rb
-- spec/lib/pwn/www/torch_spec.rb
-- spec/lib/pwn/www/trading_view_spec.rb
-- spec/lib/pwn/www/twitter_spec.rb
-- spec/lib/pwn/www/uber_spec.rb
-- spec/lib/pwn/www/upwork_spec.rb
-- spec/lib/pwn/www/youtube_spec.rb
-- spec/lib/pwn/www_spec.rb
-- spec/lib/pwn_spec.rb
-- spec/spec_helper.rb
+test_files: []