pwn 0.5.258 → 0.5.260

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 443e67e982f8e4a3dcc8545434d8a26d25e2bbf09077d55c5a34c43a452f8046
-  data.tar.gz: 9a7c64e5d7d5b8147d7c6035d9420d9e23c1942956e12c10d157fa7f011f881d
+  metadata.gz: 86b3d84a00228717b3006d33ebad22d955b97fae6550df11ddd3ec6efe00e21c
+  data.tar.gz: 382592644674ac400a9eb7f341d33ff5136a321fae2277d78fc0f467bab4f58e
 SHA512:
-  metadata.gz: e690ce4edcfad20e36cdc78969fdf02763f0158d6396a2fb768168afa36b0463de714fbc47d1a9f401f6ad51e067fb6f7d1c41ec54a55cb277a0ac32c173ede0
-  data.tar.gz: 25ce8c4a5668197d47a6a943e9a2db6f79b55ff69be35d8c9f588d9b7e87d7eb6055653997df5baf2aace84ff9f5f42f6671b7316f001f1ccc9d1603a5c220ca
+  metadata.gz: 3c4c8b8b013f272e97a50f600751eaf861605bd331cc12f94945ce60e584824fcc253239792ea6242e82afdd91aea5429e9a8d925e97d78d5bdae278fcfa6aef
+  data.tar.gz: 8335d9dfcdd0fce241db4ca601b54137a32dcf773f615f2ca5bb04d8917452b4ee73857af68fd2d76ea4b455fdb776b827269742357d896b0115968805c49e87

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-04-21 18:26:41 UTC using RuboCop version 1.75.2.
+# on 2025-04-22 21:19:03 UTC using RuboCop version 1.75.3.
 # 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
@@ -41,7 +41,7 @@ Lint/RedundantTypeConversion:
     - 'lib/pwn/plugins/jenkins.rb'
     - 'lib/pwn/plugins/repl.rb'
 
-# Offense count: 319
+# Offense count: 303
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AutoCorrect.
 Lint/UselessAssignment:
@@ -89,7 +89,7 @@ Metrics/MethodLength:
   Exclude:
     - 'lib/pwn/banner/code_cave.rb'
 
-# Offense count: 11
+# Offense count: 12
 # Configuration parameters: CountComments, Max, CountAsOne.
 Metrics/ModuleLength:
   Exclude:
@@ -103,6 +103,7 @@ Metrics/ModuleLength:
     - 'lib/pwn/plugins/open_ai.rb'
     - 'lib/pwn/plugins/packet.rb'
     - 'lib/pwn/plugins/repl.rb'
+    - 'lib/pwn/plugins/son_micro_rfid.rb'
     - 'lib/pwn/plugins/transparent_browser.rb'
 
 # Offense count: 1

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.258]:001 >>> PWN.help
+pwn[v0.5.260]: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.1@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.258]:001 >>> PWN.help
+pwn[v0.5.260]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.4.1@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.258]:001 >>> PWN.help
+pwn[v0.5.260]: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_serial_msr206

@@ -36,11 +36,6 @@ OptionParser.new do |options|
   end
 end.parse!
 
-# if opts.empty?
-#   puts `#{File.basename($PROGRAM_NAME)} --help`
-#   exit 1
-# end
-
 begin
   block_dev = opts[:block_dev]
   baud = opts[:baud]

data/bin/pwn_serial_son_micro_sm132_rfid

@@ -31,18 +31,17 @@ OptionParser.new do |options|
     opts[:parity] = p
   end
 
-  options.on('-fFLOWCTRL', '--flow-control=FLOWCTRL', '<Optional - none||hard||soft (defaults to none)>') do |f|
+  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 `#{File.basename($PROGRAM_NAME)} --help`
-  exit 1
-end
+  options.on('-v', '--verbose', '<Optional - Enable verbose output>') do
+    opts[:verbose] = true
+  end
+end.parse!
 
 begin
-  block_dev = opts[:block_dev] if File.exist?(opts[:block_dev])
+  block_dev = opts[:block_dev] if opts[:block_dev] && File.exist?(opts[:block_dev])
   baud = opts[:baud]
   data_bits = opts[:data_bits]
   stop_bits = opts[:stop_bits]
@@ -59,9 +58,11 @@ begin
   )
 
   puts "- Welcome to #{File.basename($PROGRAM_NAME)} -"
-  puts "Connected via: #{block_dev} @ #{son_micro_rfid_obj[:serial_conn].modem_params}"
-  puts "Flow Control: #{son_micro_rfid_obj[:serial_conn].flow_control}"
-  puts "Signals: #{son_micro_rfid_obj[:serial_conn].signals}"
+  if opts[:verbose]
+    puts "Connected via: #{block_dev} @ #{son_micro_rfid_obj[:serial_conn].modem_params}"
+    puts "Flow Control: #{son_micro_rfid_obj[:serial_conn].flow_control}"
+    puts "Signals: #{son_micro_rfid_obj[:serial_conn].signals}"
+  end
 
   exec_resp = PWN::Plugins::SonMicroRFID.exec(
     son_micro_rfid_obj: son_micro_rfid_obj,
@@ -78,11 +79,20 @@ begin
   # Main Menu
   menu_msg = ''
   loop do
+    unless menu_msg.include?('ERROR')
+      exec_resp = PWN::Plugins::SonMicroRFID.exec(
+        son_micro_rfid_obj: son_micro_rfid_obj,
+        cmd: :antenna_power,
+        params: :on
+      )
+    end
+
     puts "\n>> MAIN MENU OPTIONS:"
-    puts '[(R)ead Card]'
-    puts '[(B)ackup Card]'
-    puts '[(C)opy Card]'
-    puts '[(L)oad Card from File]'
+    puts '[(R)ead Tag]'
+    puts '[(B)ackup Tag]'
+    puts '[(C)lone Tag]'
+    puts '[(L)oad Data from File and Write to Tag]'
+    puts '[(U)pdate Tag]'
     puts '[(W)arm Reset]'
     puts '[(Q)uit]'
     puts menu_msg
@@ -92,41 +102,91 @@ begin
 
     case option
     when :R
-      menu_msg = 'READ CARD'
-      rfid_data = PWN::Plugins::SonMicroRFID.read_card(
-        son_micro_rfid_obj: son_micro_rfid_obj
-      )
+      menu_msg = 'READ TAG'
+      begin
+        rfid_data = PWN::Plugins::SonMicroRFID.read_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        puts "\nRFID Data:"
+        puts "Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}" if rfid_data[:block_data]
+      rescue StandardError => e
+        menu_msg = "ERROR: Failed to read tag - #{e.message}"
+      end
     when :B
-      menu_msg = 'BACKUP CARD TO FILE'
-      rfid_data = PWN::Plugins::SonMicroRFID.backup_card(
-        son_micro_rfid_obj: son_micro_rfid_obj
-      )
+      menu_msg = 'BACKUP TAG TO FILE'
+      begin
+        rfid_data = PWN::Plugins::SonMicroRFID.backup_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        puts "\nBackup successful. RFID Data:"
+        puts "Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}" if rfid_data[:block_data]
+      rescue StandardError => e
+        menu_msg = "ERROR: Failed to backup tag - #{e.message}"
+      end
     when :C
-      menu_msg = 'COPY CARD'
-      rfid_data = PWN::Plugins::SonMicroRFID.copy_card(
-        son_micro_rfid_obj: son_micro_rfid_obj
-      )
+      menu_msg = 'CLONE TAG'
+      print 'This will overwrite the target tag. Continue? [y/N]: '
+      next unless gets.chomp.strip.upcase == 'Y'
+
+      begin
+        rfid_data = PWN::Plugins::SonMicroRFID.clone_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        puts "\nClone successful. RFID Data:"
+        puts "Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}" if rfid_data[:block_data]
+      rescue StandardError => e
+        menu_msg = "ERROR: Failed to clone tag - #{e.message}"
+      end
     when :L
       menu_msg = 'LOAD FROM FILE'
-      rfid_data = PWN::Plugins::SonMicroRFID.load_card_from_file(
-        son_micro_rfid_obj: son_micro_rfid_obj
-      )
+      print 'This will overwrite the target tag. Continue? [y/N]: '
+      next unless gets.chomp.strip.upcase == 'Y'
+
+      begin
+        rfid_data = PWN::Plugins::SonMicroRFID.load_tag_from_file(son_micro_rfid_obj: son_micro_rfid_obj)
+        puts "\nLoad successful. RFID Data:"
+        puts "Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}" if rfid_data[:block_data]
+      rescue StandardError => e
+        menu_msg = "ERROR: Failed to load tag - #{e.message}"
+      end
+    when :U
+      menu_msg = 'UPDATE TAG'
+      print 'This will modify the tag\'s data. Continue? [y/N]: '
+      next unless gets.chomp.strip.upcase == 'Y'
+
+      begin
+        rfid_data = PWN::Plugins::SonMicroRFID.update_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        puts "\nUpdate successful. RFID Data:"
+        puts "Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}" if rfid_data[:block_data]
+      rescue StandardError => e
+        menu_msg = "ERROR: Failed to update tag - #{e.message}"
+      end
     when :W
       menu_msg = 'WARM RESET'
-      exec_resp = PWN::Plugins::SonMicroRFID.exec(
-        son_micro_rfid_obj: son_micro_rfid_obj,
-        cmd: :reset
-      )
+      begin
+        exec_resp = PWN::Plugins::SonMicroRFID.exec(
+          son_micro_rfid_obj: son_micro_rfid_obj,
+          cmd: :reset
+        )
+        puts 'Warm reset complete.'
+      rescue StandardError => e
+        menu_msg = "ERROR: Failed to reset - #{e.message}"
+      end
     when :Q
       exit
     else
       menu_msg = '****** ERROR: Invalid Menu Option Selected ******'
+      exec_resp = PWN::Plugins::SonMicroRFID.exec(
+        son_micro_rfid_obj: son_micro_rfid_obj,
+        cmd: :antenna_power,
+        params: :off
+      )
     end
   end
 rescue StandardError => e
+  puts "ERROR: #{e.message}"
   raise e
 rescue SystemExit, Interrupt
   puts "\nGoodbye."
 ensure
-  son_micro_rfid_obj = PWN::Plugins::SonMicroRFID.disconnect(son_micro_rfid_obj: son_micro_rfid_obj) if son_micro_rfid_obj
+  PWN::Plugins::SonMicroRFID.disconnect(son_micro_rfid_obj: son_micro_rfid_obj) if son_micro_rfid_obj
 end

data/lib/pwn/plugins/msr206.rb

@@ -10,7 +10,7 @@ module PWN
     module MSR206
       # Logger instance for auditing and debugging
       private_class_method def self.logger
-        @logger ||= Logger.new('msr206.log')
+        @logger ||= Logger.new('/tmp/pwn-msr206.log')
       end
 
       # Supported Method Parameters::

data/lib/pwn/plugins/son_micro_rfid.rb

@@ -1,11 +1,18 @@
 # frozen_string_literal: true
 
+require 'logger'
+require 'timeout'
+
 module PWN
   module Plugins
     # This plugin is used for interacting with a SonMicro
-    # SM132 USB RFID Reader / Writer (PCB V3) &&
-    # SM2330-USB Rev.0
+    # SM132 USB RFID Reader / Writer (PCB V3) && SM2330-USB Rev.0
     module SonMicroRFID
+      # Logger instance for auditing and debugging
+      private_class_method def self.logger
+        @logger ||= Logger.new('/tmp/pwn-sonmicro_rfid.log')
+      end
+
       # Supported Method Parameters::
       # son_micro_rfid_obj = PWN::Plugins::SonMicroRFID.connect(
       #   block_dev: 'optional - serial block device path (defaults to /dev/ttyUSB0)',
@@ -17,24 +24,25 @@ module PWN
       # )
 
       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)
+        opts[:block_dev] ||= '/dev/ttyUSB0'
+        opts[:baud] ||= 19_200
+        opts[:data_bits] ||= 8
+        opts[:stop_bits] ||= 1
+        opts[:parity] ||= :none
+        opts[:flow_control] ||= :none
+
+        logger.info("Connecting to #{opts[:block_dev]} at baud #{opts[:baud]}")
+        PWN::Plugins::Serial.connect(opts)
       rescue StandardError => e
+        logger.error("Connection failed: #{e.message}")
         disconnect(son_micro_rfid_obj: son_micro_rfid_obj) unless son_micro_rfid_obj.nil?
         raise e
       end
 
       # Supported Method Parameters::
-      #  cmds = PWN::Plugins::SonMicroRFID.list_cmds
+      # cmds = PWN::Plugins::SonMicroRFID.list_cmds
       public_class_method def self.list_cmds
-        # Returns an Array of Symbols
-        cmds = %i[
+        %i[
           reset
           firmware
           seek_for_tag
@@ -56,13 +64,15 @@ module PWN
           poll_buffer
         ]
       rescue StandardError => e
+        logger.error("Error listing commands: #{e.message}")
         raise e
       end
 
       # Supported Method Parameters::
-      #  params = PWN::Plugins::SonMicroRFID.list_params(
-      #   cmd: 'required - cmd returned from #list_cmds method',
+      # params = PWN::Plugins::SonMicroRFID.list_params(
+      #   cmd: 'required - cmd returned from #list_cmds method'
       # )
+
       public_class_method def self.list_params(opts = {})
         cmd = opts[:cmd].to_s.scrub.strip.chomp
 
@@ -70,17 +80,17 @@ module PWN
         when :reset
           params = %i[reset_not_implemented]
         when :firmware
-          params = %i[firmware_not_implemented]
+          params = %i[firmware_no_params_required]
         when :seek_for_tag
           params = %i[seek_for_tag_no_params_required]
         when :select_tag
           params = %i[select_tag_no_params_required]
         when :authenticate
-          params = %i[authenticate_not_implemented]
+          params = %i[block key_type key]
         when :read_block
-          params = %i[read_block_not_implemented]
+          params = %i[block]
         when :write_block
-          params = %i[write_block_not_implemented]
+          params = %i[block data]
         when :write_value
           params = %i[write_value_not_implemented]
         when :write_four_byte_block
@@ -94,11 +104,11 @@ module PWN
         when :antenna_power
           params = %i[off on reset]
         when :read_port
-          params = %i[antenna_power_not_implemented]
+          params = %i[read_port_not_implemented]
         when :write_port
           params = %i[write_port_not_implemented]
         when :halt
-          params = %i[halt_not_implemented]
+          params = %i[halt_no_params_required]
         when :set_baud_rate
           params = %i[set_baud_rate_not_implemented]
         when :sleep
@@ -106,148 +116,134 @@ module PWN
         when :poll_buffer
           params = %i[poll_buffer_not_implemented]
         else
-          raise "Unsupported Command: #{cmd}.  Supported commands are:\n#{list_cmds}\n\n\n"
+          logger.error("Unsupported command: #{cmd}")
+          raise "Unsupported Command: #{cmd}. Supported commands are:\n#{list_cmds.join("\n")}\n"
         end
 
         params
       rescue StandardError => e
+        logger.error("Error listing parameters for #{cmd}: #{e.message}")
         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'
+      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method',
+      #   cmd: 'required - command symbol'
       # )
 
       private_class_method def self.parse_responses(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
         cmd = opts[:cmd].to_s.scrub.strip.chomp
 
-        keep_parsing_responses = true
-        next_response_detected = false
-        all_cmd_responses = []
-        a_cmd_r_len = 0
-        last_a_cmd_r_len = 0
-
-        parsed_cmd_resp_arr = []
-        bytes_in_cmd_resp = 0
-        cmd_resp = ''
-
-        # Parse All Responses and add them to parsed_cmd_resp_arr
-        while keep_parsing_responses
-          until next_response_detected
-            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
+        Timeout.timeout(5) do
+          keep_parsing_responses = true
           next_response_detected = false
-          last_a_cmd_r_len = a_cmd_r_len
-
-          # Third byte
-          expected_cmd_resp_byte_len = cmd_resp.split[2].to_i(16) + 4
-
-          # Fourth byte
-          cmd_hex = cmd_resp.split[3]
+          all_cmd_responses = []
+          a_cmd_r_len = 0
+          last_a_cmd_r_len = 0
+
+          parsed_cmd_resp_arr = []
+          bytes_in_cmd_resp = 0
+          cmd_resp = ''
+
+          while keep_parsing_responses
+            until next_response_detected
+              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
+              next_response_detected = true if bytes_in_cmd_resp > 3 && a_cmd_r_len > last_a_cmd_r_len
+            end
+            next_response_detected = false
+            last_a_cmd_r_len = a_cmd_r_len
 
-          while bytes_in_cmd_resp < expected_cmd_resp_byte_len
-            all_cmd_responses = PWN::Plugins::Serial.response(
-              serial_obj: son_micro_rfid_obj
-            )
+            expected_cmd_resp_byte_len = cmd_resp.split[2].to_i(16) + 4
+            cmd_hex = cmd_resp.split[3]
 
-            cmd_resp = all_cmd_responses.last
-            bytes_in_cmd_resp = cmd_resp.split.length
-            # puts "EXPECTED CMD BYTE LEN: #{expected_cmd_resp_byte_len}"
-            # puts "LAST CMD BYTE LEN: #{bytes_in_cmd_resp} >>>"
-            # puts all_cmd_responses
-            # puts "COMMAND HEX: #{cmd_hex}\n\n\n"
-          end
+            while bytes_in_cmd_resp < expected_cmd_resp_byte_len
+              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
+            end
 
-          # puts "\nALL CMD RESPS >>>"
-          # puts "#{all_cmd_responses}\n\n\n"
-          parsed_cmd_resp_hash = {}
-          parsed_cmd_resp_hash[:cmd_hex] = cmd_hex
-          parsed_cmd_resp_hash[:cmd_desc] = cmd.to_sym
-          parsed_cmd_resp_hash[:hex_resp] = cmd_resp
-          resp_code = '?'
-
-          # TODO: Detect EMV
-          case cmd_hex
-          when '82', '83'
-            resp_code = cmd_resp.split[4]
+            parsed_cmd_resp_hash = {}
+            parsed_cmd_resp_hash[:cmd_hex] = cmd_hex
+            parsed_cmd_resp_hash[:cmd_desc] = cmd.to_sym
+            parsed_cmd_resp_hash[:hex_resp] = cmd_resp
+            resp_code = cmd_resp.split[4] || '?'
             parsed_cmd_resp_hash[:resp_code_hex] = resp_code
-            case resp_code
-            when '01'
-              parsed_cmd_resp_hash[:resp_code_desc] = :mifare_ultralight
-              parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(
-                ' '
-              )
-            when '02'
-              parsed_cmd_resp_hash[:resp_code_desc] = :mifare_classic_1k
-              parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(
-                ' '
-              )
-            when '03'
-              parsed_cmd_resp_hash[:resp_code_desc] = :mifare_classic_4k
-              parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(
-                ' '
-              )
-            when '4C'
-              parsed_cmd_resp_hash[:resp_code_desc] = :seeking_tag
-              parsed_cmd_resp_hash[:tag_id] = :seeking_tag
-            when '4E'
-              parsed_cmd_resp_hash[:resp_code_desc] = :no_tag_present
-              parsed_cmd_resp_hash[:tag_id] = :not_available
-            when '55'
-              parsed_cmd_resp_hash[:resp_code_desc] = :antenna_off
-              parsed_cmd_resp_hash[:tag_id] = :not_available
-            when 'FF'
-              parsed_cmd_resp_hash[:resp_code_desc] = :unknown_tag_type
-              parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(
-                ' '
-              )
+
+            case cmd_hex
+            when '82', '83'
+              case resp_code
+              when '01'
+                parsed_cmd_resp_hash[:resp_code_desc] = :mifare_ultralight
+                parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(' ')
+              when '02'
+                parsed_cmd_resp_hash[:resp_code_desc] = :mifare_classic_1k
+                parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(' ')
+              when '03'
+                parsed_cmd_resp_hash[:resp_code_desc] = :mifare_classic_4k
+                parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(' ')
+              when '4C'
+                parsed_cmd_resp_hash[:resp_code_desc] = :seeking_tag
+                parsed_cmd_resp_hash[:tag_id] = :seeking_tag
+              when '4E'
+                parsed_cmd_resp_hash[:resp_code_desc] = :no_tag_present
+                parsed_cmd_resp_hash[:tag_id] = :not_available
+              when '55'
+                parsed_cmd_resp_hash[:resp_code_desc] = :antenna_off
+                parsed_cmd_resp_hash[:tag_id] = :not_available
+              when 'FF'
+                parsed_cmd_resp_hash[:resp_code_desc] = :unknown_tag_type
+                parsed_cmd_resp_hash[:tag_id] = cmd_resp.split[5..-2].join(' ')
+              else
+                parsed_cmd_resp_hash[:resp_code_desc] = :unknown_resp_code
+                parsed_cmd_resp_hash[:tag_id] = :not_available
+              end
+            when '85' # Assumed for authenticate
+              parsed_cmd_resp_hash[:resp_code_desc] = resp_code == '00' ? :auth_success : :auth_failed
+            when '86' # Assumed for read_block
+              parsed_cmd_resp_hash[:resp_code_desc] = resp_code == '00' ? :read_success : :read_failed
+              parsed_cmd_resp_hash[:block_data] = cmd_resp.split[5..-2].join(' ')
+            when '87' # Assumed for write_block
+              parsed_cmd_resp_hash[:resp_code_desc] = resp_code == '00' ? :write_success : :write_failed
             else
-              parsed_cmd_resp_hash[:resp_code_desc] = :unknown_resp_code
-              parsed_cmd_resp_hash[:tag_id] = :not_available
+              parsed_cmd_resp_hash[:resp_code_desc] = :unknown_response
             end
-          else
-            parsed_cmd_resp_hash[:cmd_desc] = :not_available
-          end
 
-          keep_parsing_responses = false unless resp_code == '4C'
+            keep_parsing_responses = false unless resp_code == '4C'
+            parsed_cmd_resp_arr.push(parsed_cmd_resp_hash)
+          end
 
-          parsed_cmd_resp_arr.push(parsed_cmd_resp_hash)
+          parsed_cmd_resp_arr
         end
-
-        parsed_cmd_resp_arr
+      rescue Timeout::Error
+        logger.error("Device response timed out for command: #{cmd}")
+        raise 'ERROR: Device response timed out'
       rescue StandardError => e
+        logger.error("Error parsing response for command #{cmd}: #{e.message}")
         raise e
       ensure
-        # Flush Responses for Next Request
         PWN::Plugins::Serial.flush_session_data
       end
 
       # Supported Method Parameters::
-      #  PWN::Plugins::SonMicroRFID.exec(
-      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
+      # PWN::Plugins::SonMicroRFID.exec(
+      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method',
       #   cmd: 'required - cmd returned from #list_cmds method',
       #   params: 'optional - parameters for specific command returned from #list_params method'
       # )
+
       public_class_method def self.exec(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
         cmd = opts[:cmd].to_s.scrub.strip.chomp
-        params = opts[:params].to_s.scrub.strip.chomp
+        params = opts[:params]
 
-        params_bytes = []
+        logger.info("Executing command: #{cmd} with params: #{params.inspect}")
 
-        # Use the Mifare Panel Application to reverse enginner commands.
+        params_bytes = []
         case cmd.to_sym
         when :reset
           cmd_bytes = [0xFF, 0x00, 0x01, 0x80, 0x81]
@@ -258,32 +254,40 @@ module PWN
         when :select_tag
           cmd_bytes = [0xFF, 0x00, 0x01, 0x83, 0x84]
         when :authenticate
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x00]
+          raise "Parameters must be a hash with :block, :key_type, :key for #{cmd}" unless params.is_a?(Hash)
+
+          # Placeholder: [block, key_type, key]
+          cmd_bytes = [0xFF, 0x00, 0x07, 0x85]
+          block = params[:block].to_i
+          key_type = params[:key_type] == :key_a ? 0x60 : 0x61
+          key = params[:key] || [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF]
+          params_bytes = [block, key_type] + key
         when :read_block
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x01]
+          # Placeholder: [block]
+          cmd_bytes = [0xFF, 0x00, 0x02, 0x86]
+          params_bytes = [params[:block].to_i] if params.is_a?(Hash) && params[:block]
         when :write_block
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x02]
+          raise "Parameters must be a hash with :block, :data for #{cmd}" unless params.is_a?(Hash) && params[:block] && params[:data]
+
+          # Placeholder: [block, data]
+          cmd_bytes = [0xFF, 0x00, 0x06, 0x87] # Adjust length based on data
+          block = params[:block].to_i
+          data = params[:data].is_a?(Array) ? params[:data] : params[:data].split.map { |b| b.to_i(16) }
+          params_bytes = [block] + data
+          cmd_bytes[2] = params_bytes.length + 2 # Update length
         when :write_value
-          # Last two bytes not correct
           cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x03]
         when :write_four_byte_block
-          # Last two bytes not correct
           cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x04]
         when :write_key
-          # Last two bytes not correct
           cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x05]
         when :increment
-          # Last two bytes not correct
           cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x06]
         when :decrement
-          # Last two bytes not correct
           cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x07]
         when :antenna_power
           cmd_bytes = [0xFF, 0x00, 0x02, 0x90]
-          case params.to_sym
+          case params.to_s.to_sym
           when :off
             params_bytes = [0x00, 0x92]
           when :on
@@ -291,94 +295,225 @@ module PWN
           when :reset
             params_bytes = [0x02, 0x94]
           else
-            raise "Unsupported Parameters: #{params} for #{cmd}.  Supported parameters for #{cmd} are:\n#{list_params(cmd: cmd)}\n\n\n"
+            raise "Unsupported Parameters: #{params} for #{cmd}. Supported parameters are:\n#{list_params(cmd: cmd).join("\n")}\n"
           end
         when :read_port
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01]
+          cmd_bytes = [0xFF, 0x00, 0x01, 0x00, 0x08]
         when :write_port
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01, 0x08]
+          cmd_bytes = [0xFF, 0x00, 0x01, 0x08, 0x09]
         when :halt
           cmd_bytes = [0xFF, 0x00, 0x01, 0x93, 0x94]
         when :set_baud_rate
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01, 0x09]
+          cmd_bytes = [0xFF, 0x00, 0x01, 0x09, 0x0A]
         when :sleep
-          # Last two bytes not correct
-          cmd_bytes = [0xFF, 0x00, 0x01, 0x0a]
+          cmd_bytes = [0xFF, 0x00, 0x01, 0x0A, 0x0B]
         when :poll_buffer
           cmd_bytes = [0xFF, 0x00, 0x01, 0xB0, 0xB1]
         else
-          raise "Unsupported Command: #{cmd}.  Supported commands are:\n#{list_cmds}\n\n\n"
+          logger.error("Unsupported command: #{cmd}")
+          raise "Unsupported Command: #{cmd}. Supported commands are:\n#{list_cmds.join("\n")}\n"
         end
 
-        # If parameters to a command are set, append them.
         cmd_bytes += params_bytes unless params_bytes.empty?
-        # Execute the command.
         PWN::Plugins::Serial.request(
           serial_obj: son_micro_rfid_obj,
           payload: cmd_bytes
         )
 
-        # Parse commands response(s).
-        # Return an array of hashes.
-        parse_responses(
+        response = parse_responses(
           son_micro_rfid_obj: son_micro_rfid_obj,
           cmd: cmd.to_sym
         )
+        logger.info("Response for #{cmd}: #{response.inspect}")
+        response
       rescue StandardError => e
+        logger.error("Error executing command #{cmd}: #{e.message}")
         raise e
       ensure
-        # Flush Responses for Next Request
         PWN::Plugins::Serial.flush_session_data
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::SonMicroRFID.read_card(
-      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
+      # PWN::Plugins::SonMicroRFID.read_tag(
+      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method',
+      #   authn: 'optional - authentication flag (default: false)',
+      #   key: 'optional - key for authentication (default: [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF])'
       # )
 
-      public_class_method def self.read_card(opts = {})
+      public_class_method def self.read_tag(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
-        print 'Reader Activated.  Please Scan Card...'
+        authn = opts[:authn] ||= false
+        key = opts[:key] ||= [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF]
+
+        logger.info('Starting read_tag')
+
+        print 'Reader Activated. Please Scan Tag...'
         exec_resp = exec(
           son_micro_rfid_obj: son_micro_rfid_obj,
           cmd: :seek_for_tag
         )
 
         rfid_data = exec_resp.last
-        puts "#{rfid_data[:resp_code_desc]} >>> #{rfid_data[:tag_id]}"
+        logger.info(rfid_data)
 
+        if rfid_data[:resp_code_desc] == :no_tag_present
+          logger.error('No RFID tag detected')
+          raise 'No RFID tag detected'
+        end
+
+        # Read block data (e.g., block 4 for Ultralight, sector 0 block 0 for Classic)
+        case rfid_data[:resp_code_desc]
+        when :mifare_ultralight
+          exec_resp = exec(
+            son_micro_rfid_obj: son_micro_rfid_obj,
+            cmd: :read_block,
+            params: { block: 4 } # Example block
+          )
+          rfid_data[:block_data] = exec_resp.last[:block_data] if exec_resp.last[:resp_code_desc] == :read_success
+        when :mifare_classic_1k, :mifare_classic_4k
+          if authn
+            exec_resp = exec(
+              son_micro_rfid_obj: son_micro_rfid_obj,
+              cmd: :authenticate,
+              params: { block: 0, key_type: :key_a, key: key }
+            )
+            if exec_resp.last[:resp_code_desc] == :auth_success
+              exec_resp = exec(
+                son_micro_rfid_obj: son_micro_rfid_obj,
+                cmd: :read_block,
+                params: { block: 0 }
+              )
+              rfid_data[:block_data] = exec_resp.last[:block_data] if exec_resp.last[:resp_code_desc] == :read_success
+            else
+              logger.error("Authentication failed for #{rfid_data[:resp_code_desc]}")
+              raise 'Authentication failed'
+            end
+          end
+        end
+
+        puts "\n#{rfid_data[:resp_code_desc]} >>> Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}" if rfid_data[:block_data]
+        logger.info("Read tag successful: #{rfid_data.inspect}")
         rfid_data
       rescue StandardError => e
+        logger.error("Error reading tag: #{e.message}")
+        puts "ERROR: Failed to read tag - #{e.message}"
         raise e
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::SonMicroRFID.write_card(
-      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
+      # PWN::Plugins::SonMicroRFID.write_tag(
+      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method',
+      #   rfid_data: 'required - RFID data to write (see #read_tag for structure)',
+      #   authn: 'optional - authentication flag (default: false)',
+      #   key: 'optional - key for authentication (default: [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF])'
       # )
 
-      public_class_method def self.write_card(opts = {})
+      public_class_method def self.write_tag(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
         rfid_data = opts[:rfid_data]
-        # TODO: write card
-        puts rfid_data.inspect
+        authn = opts[:authn] ||= false
+        key = opts[:key] ||= [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF]
+        logger.info('Starting write_tag')
+
+        unless rfid_data.is_a?(Hash) && rfid_data[:resp_code_desc] && rfid_data[:tag_id]
+          logger.error('Invalid rfid_data: must be a hash with :resp_code_desc and :tag_id')
+          raise 'Invalid rfid_data: must be a hash with :resp_code_desc and :tag_id'
+        end
+
+        puts "\nWriting to tag with Tag ID: #{rfid_data[:tag_id]}"
+        print 'This will overwrite the tag. Continue? [y/N]: '
+        unless gets.chomp.strip.upcase == 'Y'
+          logger.info('Write cancelled by user')
+          puts 'Write cancelled.'
+          return rfid_data
+        end
+
+        # Select tag
+        exec_resp = exec(
+          son_micro_rfid_obj: son_micro_rfid_obj,
+          cmd: :select_tag
+        )
+        if exec_resp.last[:resp_code_desc] == :no_tag_present
+          logger.error('No RFID tag detected for writing')
+          raise 'No RFID tag detected for writing'
+        end
+
+        # Write block data
+        case rfid_data[:resp_code_desc]
+        when :mifare_ultralight
+          if rfid_data[:block_data]
+            data = rfid_data[:block_data].split.map { |b| b.to_i(16) }
+            exec_resp = exec(
+              son_micro_rfid_obj: son_micro_rfid_obj,
+              cmd: :write_block,
+              params: { block: 4, data: data }
+            )
+            unless exec_resp.last[:resp_code_desc] == :write_success
+              logger.error('Failed to write block for Ultralight')
+              raise 'Failed to write block'
+            end
+          end
+        when :mifare_classic_1k, :mifare_classic_4k
+          if authn
+            exec_resp = exec(
+              son_micro_rfid_obj: son_micro_rfid_obj,
+              cmd: :authenticate,
+              params: { block: 0, key_type: :key_a, key: key }
+            )
+            if exec_resp.last[:resp_code_desc] == :auth_success
+              if rfid_data[:block_data]
+                data = rfid_data[:block_data].split.map { |b| b.to_i(16) }
+                exec_resp = exec(
+                  son_micro_rfid_obj: son_micro_rfid_obj,
+                  cmd: :write_block,
+                  params: { block: 0, data: data }
+                )
+                unless exec_resp.last[:resp_code_desc] == :write_success
+                  logger.error('Failed to write block for Classic')
+                  raise 'Failed to write block'
+                end
+              end
+            else
+              logger.error("Authentication failed for #{rfid_data[:resp_code_desc]}")
+              raise 'Authentication failed'
+            end
+          end
+        else
+          logger.error("Unsupported tag type: #{rfid_data[:resp_code_desc]}")
+          raise "Unsupported tag type: #{rfid_data[:resp_code_desc]}"
+        end
+
+        # Verify write by re-reading
+        read_data = read_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        if read_data[:block_data] == rfid_data[:block_data]
+          puts 'Write verification successful.'
+          logger.info('Write verification successful')
+        else
+          puts 'ERROR: Written data does not match read data.'
+          logger.error('Written data does not match read data')
+        end
 
+        logger.info("Write tag successful: #{rfid_data.inspect}")
+        puts 'Tag written successfully.'
         rfid_data
       rescue StandardError => e
+        logger.error("Error writing tag: #{e.message}")
+        puts "ERROR: Failed to write tag - #{e.message}"
         raise e
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::SonMicroRFID.backup_card(
+      # PWN::Plugins::SonMicroRFID.backup_tag(
       #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
       # )
 
-      public_class_method def self.backup_card(opts = {})
+      public_class_method def self.backup_tag(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
-        rfid_data = read_card(son_micro_rfid_obj: son_micro_rfid_obj)
+        logger.info('Starting backup_tag')
+
+        rfid_data = read_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+
         file = ''
         backup_msg = ''
         loop do
@@ -390,41 +525,64 @@ module PWN
           backup_msg = "\n****** ERROR: Directory #{file_dir} for #{file} does not exist ******"
           puts backup_msg
         end
-        File.write(file, "#{JSON.pretty_generate(rfid_data)}\n")
 
-        puts 'complete.'
+        File.write(file, "#{JSON.pretty_generate(rfid_data)}\n")
+        logger.info("Backup saved to #{file}")
+        puts 'Backup complete.'
         rfid_data
       rescue StandardError => e
+        logger.error("Error backing up tag: #{e.message}")
+        puts "ERROR: Failed to backup tag - #{e.message}"
         raise e
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::SonMicroRFID.copy_card(
+      # PWN::Plugins::SonMicroRFID.clone_tag(
       #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
       # )
 
-      public_class_method def self.copy_card(opts = {})
+      public_class_method def self.clone_tag(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
-        rfid_data = read_card(son_micro_rfid_obj: son_micro_rfid_obj)
-        write_card(
+        logger.info('Starting clone_tag')
+
+        print 'This will overwrite the target tag. Continue? [y/N]: '
+        unless gets.chomp.strip.upcase == 'Y'
+          logger.info('Copy cancelled by user')
+          puts 'Copy cancelled.'
+          return nil
+        end
+
+        rfid_data = read_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        write_tag(
           son_micro_rfid_obj: son_micro_rfid_obj,
           rfid_data: rfid_data
         )
       rescue StandardError => e
+        logger.error("Error copying tag: #{e.message}")
+        puts "ERROR: Failed to copy tag - #{e.message}"
         raise e
       end
 
       # Supported Method Parameters::
-      # PWN::Plugins::SonMicroRFID.load_card_from_file(
+      # PWN::Plugins::SonMicroRFID.load_tag_from_file(
       #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
       # )
 
-      public_class_method def self.load_card_from_file(opts = {})
+      public_class_method def self.load_tag_from_file(opts = {})
         son_micro_rfid_obj = opts[:son_micro_rfid_obj]
+        logger.info('Starting load_tag_from_file')
+
+        print 'This will overwrite the target tag. Continue? [y/N]: '
+        unless gets.chomp.strip.upcase == 'Y'
+          logger.info('Load cancelled by user')
+          puts 'Load cancelled.'
+          return nil
+        end
+
         file = ''
         restore_msg = ''
         loop do
-          print 'Enter File Name to Restore to Card: '
+          print 'Enter File Name to Restore to Tag: '
           file = gets.scrub.chomp.strip
           break if File.exist?(file)
 
@@ -432,17 +590,89 @@ module PWN
           puts restore_msg
         end
 
-        rfid_data = JSON.parse(
-          File.read(file),
-          symbolize_names: true
+        rfid_data = JSON.parse(File.read(file), symbolize_names: true)
+        write_tag(
+          son_micro_rfid_obj: son_micro_rfid_obj,
+          rfid_data: rfid_data
         )
+      rescue StandardError => e
+        logger.error("Error loading tag from file: #{e.message}")
+        puts "ERROR: Failed to load tag from file - #{e.message}"
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::SonMicroRFID.update_tag(
+      #   son_micro_rfid_obj: 'required - son_micro_rfid_obj returned from #connect method'
+      # )
+
+      public_class_method def self.update_tag(opts = {})
+        son_micro_rfid_obj = opts[:son_micro_rfid_obj]
+        logger.info('Starting update_tag')
+
+        print 'This will modify the tag\'s data. Continue? [y/N]: '
+        unless gets.chomp.strip.upcase == 'Y'
+          logger.info('Update cancelled by user')
+          puts 'Update cancelled.'
+          return nil
+        end
+
+        rfid_data = read_tag(son_micro_rfid_obj: son_micro_rfid_obj)
+        unless rfid_data.is_a?(Hash) && rfid_data[:resp_code_desc] && rfid_data[:tag_id]
+          logger.error('Invalid rfid_data structure')
+          raise 'Invalid rfid_data structure'
+        end
+
+        # Update block data
+        block_data = rfid_data[:block_data] || ''
+        puts "\nCurrent Block Data: #{block_data}"
+        print 'Enter Updated Block Data (hex bytes, space-separated, press Enter to keep original): '
+        updated_value = gets.scrub.chomp.strip
+
+        if updated_value.empty?
+          puts "Keeping original value: #{block_data}"
+          logger.info("Keeping original block data: #{block_data}")
+          updated_value = block_data
+        else
+          # Validate hex bytes
+          unless updated_value.match?(/\A([\da-fA-F]{2}\s)*[\da-fA-F]{2}\z/)
+            logger.error('Invalid block data: must be hex bytes (e.g., FF 00)')
+            raise 'Invalid block data: must be hex bytes (e.g., FF 00)'
+          end
+          # Validate length based on tag type
+          data_bytes = updated_value.split.map { |b| b.to_i(16) }
+          max_bytes = rfid_data[:resp_code_desc] == :mifare_ultralight ? 4 : 16
+          unless data_bytes.length <= max_bytes
+            logger.error("Block data too long: max #{max_bytes} bytes")
+            raise "Block data too long: max #{max_bytes} bytes"
+          end
+          logger.info("Updated block data: #{updated_value}")
+        end
+
+        rfid_data[:block_data] = updated_value
+
+        # Confirm changes
+        puts "\nUpdated RFID Data:"
+        puts "Tag ID: #{rfid_data[:tag_id]}"
+        puts "Block Data: #{rfid_data[:block_data]}"
+        print 'Confirm writing these changes to the tag? [y/N]: '
+        unless gets.chomp.strip.upcase == 'Y'
+          logger.info('Update cancelled by user')
+          puts 'Update cancelled.'
+          return rfid_data
+        end
 
-        # TODO: Save Original Card Contents
-        write_card(
+        rfid_data = write_tag(
           son_micro_rfid_obj: son_micro_rfid_obj,
           rfid_data: rfid_data
         )
+
+        logger.info("Update tag successful: #{rfid_data.inspect}")
+        puts 'tag updated successfully.'
+        rfid_data
       rescue StandardError => e
+        logger.error("Error updating tag: #{e.message}")
+        puts "ERROR: Failed to update tag - #{e.message}"
         raise e
       end
 
@@ -452,19 +682,29 @@ module PWN
       # )
 
       public_class_method def self.disconnect(opts = {})
-        PWN::Plugins::Serial.disconnect(
-          serial_obj: opts[:son_micro_rfid_obj]
+        son_micro_rfid_obj = opts[:son_micro_rfid_obj]
+
+        logger.info('Disabling antenna power')
+        exec(
+          son_micro_rfid_obj: son_micro_rfid_obj,
+          cmd: :antenna_power,
+          params: :off
         )
+
+        logger.info('Disconnecting from device')
+
+        PWN::Plugins::Serial.disconnect(serial_obj: son_micro_rfid_obj)
       rescue StandardError => e
+        logger.error("Error disconnecting: #{e.message}")
         raise e
       end
 
       # Author(s):: 0day Inc. <support@0dayinc.com>
 
       public_class_method def self.authors
-        "AUTHOR(S):
+        'AUTHOR(S):
           0day Inc. <support@0dayinc.com>
-        "
+        '
       end
 
       # Display Usage for this Module
@@ -476,13 +716,14 @@ module PWN
             baud: 'optional (defaults to 19_200)',
             data_bits: 'optional (defaults to 8)',
             stop_bits: 'optional (defaults to 1)',
-            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :odd)'
+            parity: 'optional - :even|:mark|:odd|:space|:none (defaults to :none)',
+            flow_control: 'optional - :none|:hard|:soft (defaults to :none)'
           )
 
           cmds = #{self}.list_cmds
 
           params = #{self}.list_params(
-            cmd: 'required - cmd returned from #list_cmds method',
+            cmd: 'required - cmd returned from #list_cmds method'
           )
 
           parsed_cmd_resp_arr = #{self}.exec(
@@ -491,6 +732,35 @@ module PWN
             params: 'optional - parameters for specific command returned from #list_params method'
           )
 
+          rfid_data = #{self}.read_tag(
+            son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method',
+            authn: 'optional - authentication flag (default: false)',
+            key: 'optional - key for authentication (default: [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF])'
+          )
+
+          rfid_data = #{self}.write_tag(
+            son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method',
+            rfid_data: 'required - RFID data to write',
+            authn: 'optional - authentication flag (default: false)',
+            key: 'optional - key for authentication (default: [0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF])'
+          )
+
+          rfid_data = #{self}.backup_tag(
+            son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method'
+          )
+
+          rfid_data = #{self}.clone_tag(
+            son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method'
+          )
+
+          rfid_data = #{self}.load_tag_from_file(
+            son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method'
+          )
+
+          rfid_data = #{self}.update_tag(
+            son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method'
+          )
+
           #{self}.disconnect(
             son_micro_rfid_obj: 'required son_micro_rfid_obj returned from #connect method'
           )

data/lib/pwn/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.258
+  version: 0.5.260
 platform: ruby
 authors:
 - 0day Inc.
@@ -1952,7 +1952,6 @@ files:
 - lib/pwn/www/uber.rb
 - lib/pwn/www/upwork.rb
 - lib/pwn/www/youtube.rb
-- msr206.log
 - packer/daemons/msfrpcd.rb
 - packer/daemons/openvas.rb
 - packer/deploy_docker_containers.sh

data/msr206.log

@@ -1,68 +0,0 @@
-# Logfile created on 2025-04-22 11:39:09 -0600 by logger.rb/v1.7.0
-I, [2025-04-22T11:39:09.967768 #2867164]  INFO -- : Connecting to /dev/ttyUSB0 at baud 9600
-I, [2025-04-22T11:39:09.991620 #2867164]  INFO -- : Setting protocol to usi0
-I, [2025-04-22T11:39:09.991792 #2867164]  INFO -- : Executing command: proto_usi0 with params: nil
-I, [2025-04-22T11:39:10.092182 #2867164]  INFO -- : Response for proto_usi0: {cmd: :proto_usi0, cmd_bytes: ["0x55", "0x53", "0x49", "0x30"], msg: :response, hex: ["A1 AB A1"], binary: ["10100001", "10101011", "10100001"], decoded: "¿+¿"}
-I, [2025-04-22T11:39:10.092353 #2867164]  INFO -- : Executing command: simulate_power_cycle_warm_reset with params: nil
-I, [2025-04-22T11:39:10.996840 #2867164]  INFO -- : Response for simulate_power_cycle_warm_reset: {cmd: :simulate_power_cycle_warm_reset, cmd_bytes: ["0x7f"], msg: :power_on_report, hex: ["BA"], binary: ["10111010"], decoded: ":"}
-I, [2025-04-22T11:39:10.996886 #2867164]  INFO -- : Retrieving configuration
-I, [2025-04-22T11:39:10.996905 #2867164]  INFO -- : Executing command: configuration_request with params: nil
-I, [2025-04-22T11:39:11.097145 #2867164]  INFO -- : Response for configuration_request: {cmd: :configuration_request, cmd_bytes: ["0x23"], msg: :response, hex: ["F7"], binary: ["11110111"], decoded: "w"}
-I, [2025-04-22T11:39:11.097302 #2867164]  INFO -- : Configuration: {track1_read: true, track2_read: true, track3_read: true, track1_write: true, track2_write: true, track3_write: true, not_used: false, parity: true}
-I, [2025-04-22T11:39:11.097349 #2867164]  INFO -- : Executing command: version_report with params: nil
-I, [2025-04-22T11:39:11.198353 #2867164]  INFO -- : Response for version_report: {cmd: :version_report, cmd_bytes: ["0x39"], msg: :response, hex: ["32 B0 B6 C1 CD 31 37 31 20 31 32 AD 46 E5 62 AD 32 B0 B0 B9"], binary: ["00110010", "10110000", "10110110", "11000001", "11001101", "00110001", "00110111", "00110001", "00100000", "00110001", "00110010", "10101101", "01000110", "11100101", "01100010", "10101101", "00110010", "10110000", "10110000", "10111001"], decoded: "206AM171 12-Feb-2009"}
-I, [2025-04-22T11:39:11.198500 #2867164]  INFO -- : Executing command: green_flash with params: nil
-I, [2025-04-22T11:39:11.298726 #2867164]  INFO -- : Response for green_flash: {cmd: :green_flash, cmd_bytes: ["0x28"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:39:19.913780 #2867164]  INFO -- : Executing command: green_off with params: nil
-I, [2025-04-22T11:39:20.014016 #2867164]  INFO -- : Response for green_off: {cmd: :green_off, cmd_bytes: ["0x6c"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:39:20.014120 #2867164]  INFO -- : Executing command: yellow_off with params: nil
-I, [2025-04-22T11:39:20.114315 #2867164]  INFO -- : Response for yellow_off: {cmd: :yellow_off, cmd_bytes: ["0x6b"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:39:20.114443 #2867164]  INFO -- : Executing command: red_off with params: nil
-I, [2025-04-22T11:39:20.214668 #2867164]  INFO -- : Response for red_off: {cmd: :red_off, cmd_bytes: ["0x6d"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:39:20.214799 #2867164]  INFO -- : Disconnecting from device
-I, [2025-04-22T11:41:46.363878 #2872588]  INFO -- : Connecting to /dev/ttyUSB0 at baud 19200
-I, [2025-04-22T11:41:46.379386 #2872588]  INFO -- : Setting protocol to usi0
-I, [2025-04-22T11:41:46.379521 #2872588]  INFO -- : Executing command: proto_usi0 with params: nil
-I, [2025-04-22T11:41:46.479918 #2872588]  INFO -- : Response for proto_usi0: {cmd: :proto_usi0, cmd_bytes: ["0x55", "0x53", "0x49", "0x30"], msg: :response, hex: ["06 FE 06 FE"], binary: ["00000110", "11111110", "00000110", "11111110"], decoded: "¿~¿~"}
-I, [2025-04-22T11:41:46.480081 #2872588]  INFO -- : Executing command: simulate_power_cycle_warm_reset with params: nil
-I, [2025-04-22T11:41:46.580309 #2872588]  INFO -- : Response for simulate_power_cycle_warm_reset: {cmd: :simulate_power_cycle_warm_reset, cmd_bytes: ["0x7f"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:46.580431 #2872588]  INFO -- : Retrieving configuration
-I, [2025-04-22T11:41:46.580459 #2872588]  INFO -- : Executing command: configuration_request with params: nil
-I, [2025-04-22T11:41:46.680666 #2872588]  INFO -- : Response for configuration_request: {cmd: :configuration_request, cmd_bytes: ["0x23"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:46.680809 #2872588]  INFO -- : Configuration: {track1_read: false, track2_read: true, track3_read: true, track1_write: false, track2_write: false, track3_write: false, not_used: false, parity: false}
-I, [2025-04-22T11:41:46.680848 #2872588]  INFO -- : Executing command: version_report with params: nil
-I, [2025-04-22T11:41:46.781057 #2872588]  INFO -- : Response for version_report: {cmd: :version_report, cmd_bytes: ["0x39"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:46.781196 #2872588]  INFO -- : Executing command: green_flash with params: nil
-I, [2025-04-22T11:41:46.881415 #2872588]  INFO -- : Response for green_flash: {cmd: :green_flash, cmd_bytes: ["0x28"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:50.780641 #2872588]  INFO -- : Executing command: green_off with params: nil
-I, [2025-04-22T11:41:50.880870 #2872588]  INFO -- : Response for green_off: {cmd: :green_off, cmd_bytes: ["0x6c"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:50.880965 #2872588]  INFO -- : Executing command: yellow_flash with params: nil
-I, [2025-04-22T11:41:50.981179 #2872588]  INFO -- : Response for yellow_flash: {cmd: :yellow_flash, cmd_bytes: ["0x7c"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:52.023768 #2872588]  INFO -- : Executing command: green_off with params: nil
-I, [2025-04-22T11:41:52.124015 #2872588]  INFO -- : Response for green_off: {cmd: :green_off, cmd_bytes: ["0x6c"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:52.124151 #2872588]  INFO -- : Executing command: yellow_off with params: nil
-I, [2025-04-22T11:41:52.224358 #2872588]  INFO -- : Response for yellow_off: {cmd: :yellow_off, cmd_bytes: ["0x6b"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:52.224491 #2872588]  INFO -- : Executing command: red_off with params: nil
-I, [2025-04-22T11:41:52.324786 #2872588]  INFO -- : Response for red_off: {cmd: :red_off, cmd_bytes: ["0x6d"], msg: :response, hex: ["06 FE"], binary: ["00000110", "11111110"], decoded: "¿~"}
-I, [2025-04-22T11:41:52.324969 #2872588]  INFO -- : Disconnecting from device
-I, [2025-04-22T11:41:56.503719 #2872594]  INFO -- : Connecting to /dev/ttyUSB0 at baud 19200
-I, [2025-04-22T11:41:56.518859 #2872594]  INFO -- : Setting protocol to usi0
-I, [2025-04-22T11:41:56.519014 #2872594]  INFO -- : Executing command: proto_usi0 with params: nil
-I, [2025-04-22T11:41:56.619439 #2872594]  INFO -- : Response for proto_usi0: {cmd: :proto_usi0, cmd_bytes: ["0x55", "0x53", "0x49", "0x30"], msg: :response, hex: ["A1 AB A1"], binary: ["10100001", "10101011", "10100001"], decoded: "¿+¿"}
-I, [2025-04-22T11:41:56.619599 #2872594]  INFO -- : Executing command: simulate_power_cycle_warm_reset with params: nil
-I, [2025-04-22T11:41:57.524457 #2872594]  INFO -- : Response for simulate_power_cycle_warm_reset: {cmd: :simulate_power_cycle_warm_reset, cmd_bytes: ["0x7f"], msg: :power_on_report, hex: ["BA"], binary: ["10111010"], decoded: ":"}
-I, [2025-04-22T11:41:57.524512 #2872594]  INFO -- : Retrieving configuration
-I, [2025-04-22T11:41:57.524530 #2872594]  INFO -- : Executing command: configuration_request with params: nil
-I, [2025-04-22T11:41:57.624761 #2872594]  INFO -- : Response for configuration_request: {cmd: :configuration_request, cmd_bytes: ["0x23"], msg: :response, hex: ["F7"], binary: ["11110111"], decoded: "w"}
-I, [2025-04-22T11:41:57.624863 #2872594]  INFO -- : Configuration: {track1_read: true, track2_read: true, track3_read: true, track1_write: true, track2_write: true, track3_write: true, not_used: false, parity: true}
-I, [2025-04-22T11:41:57.624906 #2872594]  INFO -- : Executing command: version_report with params: nil
-I, [2025-04-22T11:41:57.725212 #2872594]  INFO -- : Response for version_report: {cmd: :version_report, cmd_bytes: ["0x39"], msg: :response, hex: ["32 B0 B6 C1 CD 31 37 31 20 31 32 AD 46 E5 62 AD 32 B0 B0 B9"], binary: ["00110010", "10110000", "10110110", "11000001", "11001101", "00110001", "00110111", "00110001", "00100000", "00110001", "00110010", "10101101", "01000110", "11100101", "01100010", "10101101", "00110010", "10110000", "10110000", "10111001"], decoded: "206AM171 12-Feb-2009"}
-I, [2025-04-22T11:41:57.725298 #2872594]  INFO -- : Executing command: green_flash with params: nil
-I, [2025-04-22T11:41:57.825519 #2872594]  INFO -- : Response for green_flash: {cmd: :green_flash, cmd_bytes: ["0x28"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:42:03.647677 #2872594]  INFO -- : Executing command: green_off with params: nil
-I, [2025-04-22T11:42:03.747938 #2872594]  INFO -- : Response for green_off: {cmd: :green_off, cmd_bytes: ["0x6c"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:42:03.748010 #2872594]  INFO -- : Executing command: yellow_off with params: nil
-I, [2025-04-22T11:42:03.848227 #2872594]  INFO -- : Response for yellow_off: {cmd: :yellow_off, cmd_bytes: ["0x6b"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:42:03.848295 #2872594]  INFO -- : Executing command: red_off with params: nil
-I, [2025-04-22T11:42:03.948506 #2872594]  INFO -- : Response for red_off: {cmd: :red_off, cmd_bytes: ["0x6d"], msg: :ack_command_completed, hex: ["5E"], binary: ["01011110"], decoded: "^"}
-I, [2025-04-22T11:42:03.948574 #2872594]  INFO -- : Disconnecting from device