pwn 0.4.462 → 0.4.465

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37d931b296420b63615c112480340d40f4acbdfb6bb256e913c455c8295c719c
-  data.tar.gz: 55217d2337393257a470dd1fdc2db4ca06c51181aa58051d60c7abfdcee98c88
+  metadata.gz: 0ce80ecfe98017552fc1b5da930b332b64284fa51ae55465fd8774bcdc354a77
+  data.tar.gz: 70880e0ec3b2c750e0c2ac60cd41deaea5aada6bfd191cd9ce21d7a1dd7e7bbf
 SHA512:
-  metadata.gz: 6a091c103a8fb6e5d57fa2016cde91ea6df3c3e48d6df55dc1e90aaab59c6c1a5ef22fa77b22560bf732dab9e7a74a7e4de8e00d83cbed203b9ed67ec322c7ea
-  data.tar.gz: 621f3fadae40efe379949ea7f85cba3ed62b78740296daac6a08646468bade05c74b34da1399cb46a3c1f16c1c739a882e5d2d5b0f720d7c441987a780c06e87
+  metadata.gz: 3abe9759400c7cc906788386eb0efe23f0411a93f6ae299ad0f365ba9358c9440fd550d710eec59eba01fc7947e6403f44ce78b408a9a54e4e365fbff76a6140
+  data.tar.gz: a25c91a96cf55c80ba0ba8b3e080ddc1a6a712082a00c3b8fb16869d621f97a693b3220c105e942c1b9b36cc3453cd94fd7d6747f9517a6a0d8bd1244fb9eeee

data/.rubocop_todo.yml

@@ -1,47 +1,47 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2022-05-08 06:06:43 UTC using RuboCop version 1.29.0.
+# on 2022-05-27 23:04:56 UTC using RuboCop version 1.30.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 227
+# Offense count: 234
 Lint/UselessAssignment:
   Enabled: false
 
-# Offense count: 246
+# Offense count: 253
 # Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
   Max: 328
 
-# Offense count: 60
+# Offense count: 63
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 # IgnoredMethods: refine
 Metrics/BlockLength:
-  Max: 194
+  Max: 196
 
 # Offense count: 45
 # Configuration parameters: CountBlocks.
 Metrics/BlockNesting:
   Max: 5
 
-# Offense count: 83
+# Offense count: 89
 # Configuration parameters: IgnoredMethods.
 Metrics/CyclomaticComplexity:
   Max: 231
 
-# Offense count: 440
+# Offense count: 459
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
 Metrics/MethodLength:
   Max: 466
 
-# Offense count: 33
+# Offense count: 34
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
   Max: 1186
 
-# Offense count: 75
+# Offense count: 81
 # Configuration parameters: IgnoredMethods.
 Metrics/PerceivedComplexity:
   Max: 51
@@ -50,33 +50,33 @@ Metrics/PerceivedComplexity:
 Style/ClassVars:
   Enabled: false
 
-# Offense count: 281
-# This cop supports safe auto-correction (--auto-correct).
+# Offense count: 285
+# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, SingleLineConditionsOnly, IncludeTernaryExpressions.
 # SupportedStyles: assign_to_condition, assign_inside_condition
 Style/ConditionalAssignment:
   Enabled: false
 
 # Offense count: 2
-# This cop supports safe auto-correction (--auto-correct).
+# This cop supports safe autocorrection (--autocorrect).
 Style/ExplicitBlockArgument:
   Exclude:
     - 'lib/pwn/plugins/nmap_it.rb'
 
 # Offense count: 95
-# This cop supports safe auto-correction (--auto-correct).
+# This cop supports safe autocorrection (--autocorrect).
 Style/RedundantCondition:
   Exclude:
     - 'bin/pwn_simple_http_server'
     - 'lib/pwn/plugins/packet.rb'
 
 # Offense count: 44
-# This cop supports unsafe auto-correction (--auto-correct-all).
+# This cop supports unsafe autocorrection (--autocorrect-all).
 Style/SlicingWithRange:
   Enabled: false
 
-# Offense count: 531
-# This cop supports safe auto-correction (--auto-correct).
+# Offense count: 555
+# This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, IgnoredPatterns.
 # URISchemes: http, https
 Layout/LineLength:

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.462]:001 >>> PWN.help
+pwn[v0.4.465]: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.462]:001 >>> PWN.help
+pwn[v0.4.465]:001 >>> PWN.help
 ```
 
 

data/bin/pwn_serial_msr206

@@ -0,0 +1,178 @@
+#!/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=BAUD', '<Optional - (defaults to 9600)>') do |b|
+    opts[:baud] = b
+  end
+
+  options.on('-DDATABITS', '--data-bits=DATABITS', '<Optional - (defaults to 8)>') do |d|
+    opts[:data_bits] = d
+  end
+
+  options.on('-sSTOPBITS', '--stop-bits=STOPBITS', '<Optional - (defaults to 1)>') do |s|
+    opts[:stop_bits] = s
+  end
+
+  options.on('-pPARITY', '--parity=PARITY', '<Optional - even|mark|odd|space|none (defaults to none)>') do |p|
+    opts[:parity] = p
+  end
+
+  options.on('-fFLOWCTRL', '--flow-control=FLOWCTRL', '<Optional - none||hard||soft (defaults to none)>') do |f|
+    opts[:flow_control] = f
+  end
+end.parse!
+
+if opts.empty?
+  puts `#{$PROGRAM_NAME} --help`
+  exit 1
+end
+
+begin
+  block_dev = opts[:block_dev] if File.exist?(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
+  )
+
+  puts "- Welcome to #{File.basename($PROGRAM_NAME)} -"
+  puts "Connected via: #{block_dev} @ #{msr206_obj[:serial_conn].modem_params}"
+  puts "Flow Control: #{msr206_obj[:serial_conn].flow_control}"
+  puts "Signals: #{msr206_obj[:serial_conn].signals}"
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :simulate_power_cycle_warm_reset
+  )
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :version_report
+  )
+  puts "Firmware Version: #{exec_resp[:decoded]}"
+
+  # Main Menu
+  menu_msg = ''
+  loop do
+    unless menu_msg.include?('ERROR')
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :yellow_on
+      )
+    end
+
+    puts "\n>> MAIN MENU OPTIONS:"
+    puts '[(R)ead Card]'
+    puts '[(C)opy Card]'
+    puts '[(E)dit Card]'
+    puts '[(B)ackup Card]'
+    puts '[(W)arm Reset]'
+    puts '[(Q)uit]'
+    puts menu_msg
+    print 'MAIN MENU OPTION >>> '
+    menu_msg = ''
+    option = gets.scrub.chomp.strip.upcase.to_sym
+
+    case option
+    when :R
+      menu_msg = 'READY TO READ - PLEASE SWIPE CARD'
+      # Read Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+    when :C
+      menu_msg = 'READY TO COPY - PLEASE SWIPE ORIGINAL CARD'
+      # Read Original Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+
+      # TODO: Save Original Card Contents
+      # arm_to_write card to clone
+      # read cloned card to verify successful write
+    when :E
+      menu_msg = 'READY TO EDIT - PLEASE SWIPE TARGET CARD'
+      # Read Target Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+
+      # TODO: Save Original Card Contents
+      # arm_to_write card to edit
+      # read edited card to verify successful write
+    when :B
+      menu_msg = 'READY TO BACKUP - PLEASE SWIPE CARD'
+      # Read Card
+      PWN::Plugins::MSR206.wait_for_swipe(
+        msr206_obj: msr206_obj,
+        type: :arm_to_read
+      )
+    when :W
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :simulate_power_cycle_warm_reset
+      )
+      puts exec_resp.inspect
+    when :Q
+      exit
+    else
+      menu_msg = '****** ERROR: Invalid Menu Option Selected ******'
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :yellow_off
+      )
+
+      exec_resp = PWN::Plugins::MSR206.exec(
+        msr206_obj: msr206_obj,
+        cmd: :red_flash
+      )
+    end
+  end
+rescue StandardError => e
+  raise e
+rescue SystemExit, Interrupt
+  puts "\nGoodbye."
+ensure
+  # Lights Off
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :green_off
+  )
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :yellow_off
+  )
+
+  exec_resp = PWN::Plugins::MSR206.exec(
+    msr206_obj: msr206_obj,
+    cmd: :red_off
+  )
+
+  msr206_obj = PWN::Plugins::MSR206.disconnect(msr206_obj: msr206_obj) if msr206_obj
+end

data/lib/pwn/plugins/msr206.rb

@@ -9,18 +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 7)',
+      #   data_bits: 'optional - (defaults to 8)',
       #   stop_bits: 'optional - (defaults to 1)',
-      #   parity: 'optional - (defaults to SerialPort::ODD)',
-      #   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[:block_dev] = '/dev/ttyUSB0' unless opts[:block_dev]
         opts[:baud] = 9_600 unless opts[:baud]
-        opts[:data_bits] = 7 unless opts[:data_bits]
+        opts[:data_bits] = 8 unless opts[:data_bits]
         opts[:stop_bits] = 1 unless opts[:stop_bits]
-        opts[:parity] = :odd unless opts[:parity]
+        opts[:parity] = :none 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?
@@ -91,6 +93,221 @@ module PWN
         raise e
       end
 
+      # Supported Method Parameters::
+      # parsed_cmd_resp_arr = decode(
+      #   raw_byte_arr: 'required - raw_byte_arr produced in #parse_responses'
+      # )
+
+      private_class_method def self.decode(opts = {})
+        raw_byte_arr = opts[:raw_byte_arr]
+
+        decoded_data_str = ''
+        if raw_byte_arr
+          raw_byte_arr.first.split.each do |byte_str|
+            case byte_str
+            when '1B'
+              decoded_data_str += ''
+            when '20'
+              decoded_data_str += ' '
+            when '21'
+              decoded_data_str += '!'
+            when '22'
+              decoded_data_str += '"'
+            when '23'
+              decoded_data_str += '#'
+            when '24'
+              decoded_data_str += '$'
+            when '25'
+              decoded_data_str += '%'
+            when '26'
+              decoded_data_str += '&'
+            when '27'
+              decoded_data_str += "'"
+            when '28'
+              decoded_data_str += '('
+            when '29'
+              decoded_data_str += ')'
+            when '2A', 'AA'
+              decoded_data_str += '*'
+            when '2B', 'AB'
+              decoded_data_str += '+'
+            when '2C', 'AC'
+              decoded_data_str += ','
+            when '2D', 'AD'
+              decoded_data_str += '-'
+            when '2E', 'AE'
+              decoded_data_str += '.'
+            when '2F', 'AF'
+              decoded_data_str += '/'
+            when '30', 'B0'
+              decoded_data_str += '0'
+            when '31', 'B1'
+              decoded_data_str += '1'
+            when '32', 'B2'
+              decoded_data_str += '2'
+            when '33', 'B3'
+              decoded_data_str += '3'
+            when '34', 'B4'
+              decoded_data_str += '4'
+            when '35', 'B5'
+              decoded_data_str += '5'
+            when '36', 'B6'
+              decoded_data_str += '6'
+            when '37', 'B7'
+              decoded_data_str += '7'
+            when '38', 'B8'
+              decoded_data_str += '8'
+            when '39', 'B9'
+              decoded_data_str += '9'
+            when '3A', 'BA'
+              decoded_data_str += ':'
+            when '3B', 'BB'
+              decoded_data_str += ';'
+            when '3C', 'BC'
+              decoded_data_str += '<'
+            when '3D', 'BD'
+              decoded_data_str += '='
+            when '3E', 'BE'
+              decoded_data_str += '>'
+            when '3F', 'BF'
+              decoded_data_str += '?'
+            when '40', 'C0'
+              decoded_data_str += '@'
+            when '41', 'C1'
+              decoded_data_str += 'A'
+            when '42', 'C2'
+              decoded_data_str += 'B'
+            when '43', 'C3'
+              decoded_data_str += 'C'
+            when '44', 'C4'
+              decoded_data_str += 'D'
+            when '45', 'C5'
+              decoded_data_str += 'E'
+            when '46', 'C6'
+              decoded_data_str += 'F'
+            when '47', 'C7'
+              decoded_data_str += 'G'
+            when '48', 'C8'
+              decoded_data_str += 'H'
+            when '49', 'C9'
+              decoded_data_str += 'I'
+            when '4A', 'CA'
+              decoded_data_str += 'J'
+            when '4B', 'CB'
+              decoded_data_str += 'K'
+            when '4C', 'CC'
+              decoded_data_str += 'L'
+            when '4D', 'CD'
+              decoded_data_str += 'M'
+            when '4E', 'CE'
+              decoded_data_str += 'N'
+            when '4F', 'CF'
+              decoded_data_str += 'O'
+            when '50', 'D0'
+              decoded_data_str += 'P'
+            when '51', 'D1'
+              decoded_data_str += 'Q'
+            when '52', 'D2'
+              decoded_data_str += 'R'
+            when '53', 'D3'
+              decoded_data_str += 'S'
+            when '54', 'D4'
+              decoded_data_str += 'T'
+            when '55', 'D5'
+              decoded_data_str += 'U'
+            when '56', 'D6'
+              decoded_data_str += 'V'
+            when '57', 'D7'
+              decoded_data_str += 'W'
+            when '58', 'D8'
+              decoded_data_str += 'X'
+            when '59', 'D9'
+              decoded_data_str += 'Y'
+            when '5A', 'DA'
+              decoded_data_str += 'Z'
+            when '5B', 'DB'
+              decoded_data_str += '['
+            when '5C', 'DC'
+              decoded_data_str += '\\'
+            when '5D', 'DD'
+              decoded_data_str += ']'
+            when '5E', 'DE'
+              decoded_data_str += '^'
+            when '5F', 'DF'
+              decoded_data_str += '_'
+            when '60', 'E0'
+              decoded_data_str += '`'
+            when '61', 'E1'
+              decoded_data_str += 'a'
+            when '62', 'E2'
+              decoded_data_str += 'b'
+            when '63', 'E3'
+              decoded_data_str += 'c'
+            when '64', 'E4'
+              decoded_data_str += 'd'
+            when '65', 'E5'
+              decoded_data_str += 'e'
+            when '66', 'E6'
+              decoded_data_str += 'f'
+            when '67', 'E7'
+              decoded_data_str += 'g'
+            when '68', 'E8'
+              decoded_data_str += 'h'
+            when '69', 'E9'
+              decoded_data_str += 'i'
+            when '6A', 'EA'
+              decoded_data_str += 'j'
+            when '6B', 'EB'
+              decoded_data_str += 'k'
+            when '6C', 'EC'
+              decoded_data_str += 'l'
+            when '6D', 'ED'
+              decoded_data_str += 'm'
+            when '6E', 'EE'
+              decoded_data_str += 'n'
+            when '6F', 'EF'
+              decoded_data_str += 'o'
+            when '70', 'F0'
+              decoded_data_str += 'p'
+            when '71', 'F1'
+              decoded_data_str += 'q'
+            when '72', 'F2'
+              decoded_data_str += 'r'
+            when '73', 'F3'
+              decoded_data_str += 's'
+            when '74', 'F4'
+              decoded_data_str += 't'
+            when '75', 'F5'
+              decoded_data_str += 'u'
+            when '76', 'F6'
+              decoded_data_str += 'v'
+            when '77', 'F7'
+              decoded_data_str += 'w'
+            when '78', 'F8'
+              decoded_data_str += 'x'
+            when '79', 'F9'
+              decoded_data_str += 'y'
+            when '7A', 'FA'
+              decoded_data_str += 'z'
+            when '7B', 'FB'
+              decoded_data_str += '{'
+            when '7C', 'FC'
+              decoded_data_str += '|'
+            when '7D', 'FD'
+              decoded_data_str += '}'
+            when '7E', 'FE'
+              decoded_data_str += '~'
+            else
+              decoded_data_str += "\u00BF"
+            end
+          end
+        end
+
+        decoded_data_str
+      rescue StandardError => e
+        raise e
+      end
+
       # Supported Method Parameters::
       # parsed_cmd_resp_arr = parse_responses(
       #   cmd_resp: 'required - command response string'
@@ -98,11 +315,15 @@ module PWN
 
       private_class_method def self.parse_responses(opts = {})
         msr206_obj = opts[:msr206_obj]
-        cmd = opts[:cmd].to_s.scrub.strip.chomp
+        cmd = opts[:cmd]
 
         keep_parsing_responses = true
         next_response_detected = false
-        all_cmd_responses = []
+        response = {}
+        response[:cmd] = cmd
+        response[:cmd] ||= :na
+
+        raw_byte_arr = []
         a_cmd_r_len = 0
         last_a_cmd_r_len = 0
 
@@ -112,26 +333,57 @@ module PWN
 
         while keep_parsing_responses
           until next_response_detected
-            all_cmd_responses = PWN::Plugins::Serial.response(serial_obj: msr206_obj)
-            cmd_resp = all_cmd_responses.last
+            raw_byte_arr = PWN::Plugins::Serial.response(serial_obj: msr206_obj)
+            cmd_resp = raw_byte_arr.last
             bytes_in_cmd_resp = cmd_resp.split.length if cmd_resp
-            a_cmd_r_len = all_cmd_responses.length
+            a_cmd_r_len = raw_byte_arr.length
 
             next_response_detected = true if a_cmd_r_len > last_a_cmd_r_len
           end
 
-          #   cmd_resp = all_cmd_responses.last
-          #   case cmd_resp
-          #   when '21', '28', '29', '2A', '2B', '2D', '2F', '3A', '31', '32', '33', '3E', '3F', '5E', '7E', '98 FE'
-          #     next_response_detected = true
-          #   end
+          case cmd_resp
+          when '21'
+            response[:msg] = :invalid_command
+          when '28'
+            response[:msg] = :card_speed_measurement_start
+          when '29'
+            response[:msg] = :card_speed_measurement_end
+          when '2A'
+            response[:msg] = :error
+          when '2B'
+            response[:msg] = :no_data_found
+          when '2D'
+            response[:msg] = :insufficient_leading_zeros_for_custom_writing
+          when '2F'
+            response[:msg] = :first_lsb_char_not_one_for_custom_writing
+          when '3A'
+            response[:msg] = :power_on_report
+          when '31'
+            response[:msg] = :unsuccessful_read_after_write_track1
+          when '32'
+            response[:msg] = :unsuccessful_read_after_write_track2
+          when '33'
+            response[:msg] = :unsuccessful_read_after_write_track3
+          when '3E'
+            response[:msg] = :card_edge_detected
+          when '3F'
+            response[:msg] = :communications_error
+          when '5E'
+            response[:msg] = :ack_command_completed
+          when '7E'
+            response[:msg] = :command_not_supported_by_hardware
+          else
+            response[:msg] = :na
+          end
+
           next_response_detected = false
           last_a_cmd_r_len = a_cmd_r_len
-          print "\n"
           keep_parsing_responses = false
         end
 
-        all_cmd_responses
+        response[:raw] = raw_byte_arr
+        response[:decoded] = decode(raw_byte_arr: raw_byte_arr)
+        response
       rescue StandardError => e
         raise e
       ensure
@@ -279,6 +531,119 @@ module PWN
         PWN::Plugins::Serial.flush_session_data
       end
 
+      # Supported Method Parameters::
+      # PWN::Plugins::MSR206.wait_for_swipe(
+      #   msr206_obj: 'required - msr206_obj returned from #connect method'
+      # )
+
+      public_class_method def self.wait_for_swipe(opts = {})
+        msr206_obj = opts[:msr206_obj]
+        type = opts[:type].to_s.scrub.strip.chomp.to_sym
+        types_arr = %i[
+          arm_to_read
+          arm_to_read_w_speed_prompts
+          arm_to_write_no_raw
+          arm_to_write_with_raw
+          arm_to_write_with_raw_speed_prompts
+        ]
+
+        raise "ERROR Unsupported type in #wait_for_swipe - #{type}. Valid types:\n#{types_arr}" unless types_arr.include?(type)
+
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :red_off
+        )
+
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :yellow_off
+        )
+
+        exec_resp = PWN::Plugins::MSR206.exec(
+          msr206_obj: msr206_obj,
+          cmd: type
+        )
+
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :green_on
+        )
+
+        exec_resp = PWN::Plugins::MSR206.exec(
+          msr206_obj: msr206_obj,
+          cmd: :card_edge_detect
+        )
+
+        print 'Ready.  Please Swipe Card Now:'
+        loop do
+          exec_resp = parse_responses(
+            msr206_obj: msr206_obj,
+            cmd: :card_edge_detect
+          )
+
+          break if exec_resp[:msg] == :ack_command_completed
+        end
+
+        puts "*** ISO Track Format: Standard #{'*' * 17}"
+        print 'TRACK 1 >>> '
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :tx_iso_std_data_track1,
+          params: [0x31]
+        )
+        puts exec_resp[:decoded]
+        puts exec_resp.inspect
+
+        # print ">> Track 1 (ALT DATA)\n"
+        # exec_resp = exec(
+        #   msr206_obj: msr206_obj,
+        #   cmd: :alt_tx_iso_std_data_track1,
+        #   params: [0x31]
+        # )
+        # puts exec_resp.inspect
+
+        print "\nTRACK 2 >>> "
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :tx_iso_std_data_track2,
+          params: [0x32]
+        )
+        puts exec_resp[:decoded]
+        puts exec_resp.inspect
+
+        # print ">> Track 2 (ALT DATA)\n"
+        # exec_resp = exec(
+        #   msr206_obj: msr206_obj,
+        #   cmd: :alt_tx_iso_std_data_track2,
+        #   params: [0x32]
+        # )
+        # puts exec_resp.inspect
+
+        print "\nTRACK 3 >>> "
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :tx_iso_std_data_track3,
+          params: [0x33]
+        )
+        puts exec_resp[:decoded]
+        puts exec_resp.inspect
+
+        # print ">> Track 3 (ALT DATA)\n"
+        # exec_resp = exec(
+        #   msr206_obj: msr206_obj,
+        #   cmd: :alt_tx_iso_std_data_track3,
+        #   params: [0x33]
+        # )
+        # puts exec_resp.inspect
+      rescue StandardError => e
+        raise e
+      ensure
+        exec_resp = exec(
+          msr206_obj: msr206_obj,
+          cmd: :green_off
+        )
+      end
+
       # Supported Method Parameters::
       # PWN::Plugins::MSR206.disconnect(
       #   msr206_obj: 'required - msr206_obj returned from #connect method'
@@ -307,10 +672,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 7)',
+            data_bits: 'optional (defaults to 8)',
             stop_bits: 'optional (defaults to 1)',
-            parity: 'optional (defaults to SerialPort::ODD)',
-            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)'
           )
 
           cmds = #{self}.list_cmds

data/lib/pwn/plugins/serial.rb

@@ -16,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 = {})
@@ -278,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(

data/lib/pwn/plugins/son_micro_rfid.rb

@@ -11,16 +11,18 @@ module PWN
       #   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[: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?
@@ -365,8 +367,8 @@ module PWN
             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.462'
+  VERSION = '0.4.465'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.4.462
+  version: 0.4.465
 platform: ruby
 authors:
 - 0day Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-26 00:00:00.000000000 Z
+date: 2022-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -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