pwn 0.5.230 → 0.5.231

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7af8e67a2f1debdf6740514a5c0f0b447d8b2e3020ec722c089ad7686492c760
-  data.tar.gz: 26fcb204bd1248eda0e941df4b0c7c55dacc8efa718fb67af994d3a3e66785a9
+  metadata.gz: d675dc77a942b4bd3de91ba881adf1e4527c72540ac4b895ab4eb4811f46653a
+  data.tar.gz: e308821bcd440f215af4016aeeedaaacf5bd42db8a4a10386905005a22a0c925
 SHA512:
-  metadata.gz: a3df6c9362495ef739f14ad4730624722639cbf60e666f2c75d9026b36d1b419edda106c8b03f03e8e958e2786354a05c71d1bbc4f1a92df9a64f34c62bcca42
-  data.tar.gz: e954c806a59456360e755695c0290acd2e067fde05982d6b81a2cd21b3fa22c95c6549e64e2b964e387eb265f86673d7b2c82e4b6b8d7b736483e6dcb9f3b3d1
+  metadata.gz: dba513ab987854314a5dc81e2da1b3034e5a680d40d5c8fd030da7be131876fcbb8115b55e32b025f285a4e294c76d3c755ee58fb508f2f65b725edd06cb6105
+  data.tar.gz: 5a52df8f8efcd105e32ff80f025058814303c349e78da1384104db4bf879c0a0d21b1ec36ead39e416c3b08ede56b7022b10bab28227d06e0247810410f949d9

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.230]:001 >>> PWN.help
+pwn[v0.5.231]: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.230]:001 >>> PWN.help
+pwn[v0.5.231]: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.230]:001 >>> PWN.help
+pwn[v0.5.231]: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/lib/pwn/plugins/flipper_zero.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module PWN
+  module Plugins
+    # This plugin is used for interacting with Bus Pirate v3.6
+    # This plugin may be compatible with other versions, however,
+    # has not been tested with anything other than v3.6.
+    module FlipperZero
+      # Supported Method Parameters::
+      # PWN::Plugins::FlipperZero.connect_via_screen(
+      #   block_dev: 'optional - serial block device path (defaults to /dev/ttyACM0)'
+      # )
+
+      public_class_method def self.connect_via_screen(opts = {})
+        block_dev = opts[:block_dev].to_s if File.exist?(
+          opts[:block_dev].to_s
+        )
+
+        block_dev ||= '/dev/ttyACM0'
+
+        screen_bin = '/usr/bin/screen'
+        raise "ERROR: #{screen_bin} not found." unless File.exist?(screen_bin)
+
+        system(
+          screen_bin,
+          block_dev,
+          '115200',
+          '8',
+          'N',
+          '1'
+        )
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # flipper_zero_obj = PWN::Plugins::FlipperZero.connect(
+      #   block_dev: 'optional serial block device path (defaults to /dev/ttyACM0)',
+      #   baud: 'optional (defaults to 9600)',
+      #   data_bits: 'optional (defaults to 8)',
+      #   stop_bits: 'optional (defaults to 1)',
+      #   parity: 'optional - :even||:odd|:none (defaults to :none)'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        PWN::Plugins::Serial.connect(opts)
+      rescue StandardError => e
+        disconnect(flipper_zero_obj: opts[:flipper_zero_obj]) unless opts[:flipper_zero_obj].nil?
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # response = PWN::Plugins::FlipperZero.request(
+      #   flipper_zero_obj: 'required - flipper_zero_obj returned from #connect method',
+      #   payload: 'required - payload to send to the device'
+      # )
+      public_class_method def self.request(opts = {})
+        serial_obj = opts[:flipper_zero_obj]
+        payload = "#{opts[:payload]}\r\n" if opts[:payload]
+        PWN::Plugins::Serial.request(
+          serial_obj: serial_obj,
+          payload: payload
+        )
+        response = PWN::Plugins::Serial.dump_session_data
+        puts response.join
+        PWN::Plugins::Serial.flush_session_data
+        response
+      rescue StandardError => e
+        disconnect(flipper_zero_obj: opts[:flipper_zero_obj]) unless opts[:flipper_zero_obj].nil?
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::FlipperZero.disconnect(
+      #   flipper_zero_obj: 'required - flipper_zero_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        PWN::Plugins::Serial.disconnect(
+          serial_obj: opts[:flipper_zero_obj]
+        )
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          #{self}.connect_via_screen(
+            block_dev: 'optional serial block device path (defaults to /dev/ttyUSB0)'
+          )
+
+          flipper_zero_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)',
+            stop_bits: 'optional (defaults to 1)',
+            parity: 'optional - :even||:odd|:none (defaults to :none)'
+          )
+
+          response = #{self}.request(
+            flipper_zero_obj: 'required - flipper_zero_obj returned from #connect method',
+            payload: 'required - payload to send to the device'
+          )
+
+          #{self}.disconnect(
+            flipper_zero_obj: 'required - flipper_zero_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/plugins.rb

@@ -25,6 +25,7 @@ module PWN
     autoload :DetectOS, 'pwn/plugins/detect_os'
     autoload :EIN, 'pwn/plugins/ein'
     autoload :FileFu, 'pwn/plugins/file_fu'
+    autoload :FlipperZero, 'pwn/plugins/flipper_zero'
     autoload :Fuzz, 'pwn/plugins/fuzz'
     autoload :Git, 'pwn/plugins/git'
     autoload :Github, 'pwn/plugins/github'

data/lib/pwn/version.rb

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

data/spec/lib/pwn/plugins/flipper_zero_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::Plugins::FlipperZero do
+  it 'should display information for authors' do
+    authors_response = PWN::Plugins::FlipperZero
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::Plugins::FlipperZero
+    expect(help_response).to respond_to :help
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.230
+  version: 0.5.231
 platform: ruby
 authors:
 - 0day Inc.
 bindir: bin
 cert_chain: []
-date: 2025-01-14 00:00:00.000000000 Z
+date: 2025-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -1828,6 +1828,7 @@ files:
 - lib/pwn/plugins/detect_os.rb
 - lib/pwn/plugins/ein.rb
 - lib/pwn/plugins/file_fu.rb
+- lib/pwn/plugins/flipper_zero.rb
 - lib/pwn/plugins/fuzz.rb
 - lib/pwn/plugins/git.rb
 - lib/pwn/plugins/github.rb
@@ -2163,6 +2164,7 @@ files:
 - 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/flipper_zero_spec.rb
 - spec/lib/pwn/plugins/fuzz_spec.rb
 - spec/lib/pwn/plugins/git_spec.rb
 - spec/lib/pwn/plugins/github_spec.rb