hardsploit_gui 2.2 → 2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c7307c772e8b3f54b1002fab4f345ebe6cedf03a
-  data.tar.gz: f8c2fa22801cccd46aba0827e7df99f53d7f082a
+  metadata.gz: 740436397cfcd4b59bb8dfb2f56f553eec501a91
+  data.tar.gz: 426ea68b4a548332b7b77118e1ad3216cfee823f
 SHA512:
-  metadata.gz: c9e513dff9867a765efcd05b201adc6ef65f4400048e33ae9e919d5c5618ece34437f55460e91ce118346d1f9305819335a64fce9736997682d323d73051320c
-  data.tar.gz: cd870eb9329e07c4b695fecc88a764ef45265004122bc332b9451c302847e6d9cd953463af3ef1a47f396ace36f580dfd88d074fd871bcd5869dd77ea1ab35a2
+  metadata.gz: bdacc3c5aecaafd699973412afde50e6e8aaefc822aeca401e94b522e0dfc8125ce46670143a76fc87f7335dcb2d4789b7aee58bd327a4eaef677f5cf34468cc
+  data.tar.gz: 3c93bed4532a6c89d161f6f229035e6b32733da62693f60f012f8c20c33303cebd33805ac81d87455bbdadef3ca671ed68810438383b5da18400f65e66f6f741

data/bin/hardsploit_gui

@@ -1,3 +1,3 @@
 #!/usr/bin/env ruby
-require "hardsploit"
-Hardsploit_GUI.new
+require 'Hardsploit_gui'
+Hardsploit_gui.new

data/lib/{Firmware → Firmwares}/FPGA/VersionFPGA.rb

@@ -1,5 +1,5 @@
 class VersionFPGA
 	module VERSION_FPGA
-     FPGA = "V1.1.0"
+     FPGA = "V1.2.0"
   end
 end

data/lib/{Firmware → Firmwares}/UC/VersionUC.rb

@@ -7,6 +7,6 @@
 
 class VersionUC
 	module VERSION_UC
-	   UC = "V1.0.2"
+	   UC = "V1.0.3"
   end
 end

data/lib/HardsploitAPI/Core/HardsploitAPI.rb

@@ -0,0 +1,210 @@
+require 'singleton'
+require 'libusb'
+require 'thread'
+require_relative 'HardsploitAPI_CONSTANT'
+require_relative 'HardsploitAPI_USB_COMMUNICATION'
+require_relative 'HardsploitAPI_FIRMWARE'
+require_relative 'HardsploitAPI_ERROR'
+require_relative '../../Firmwares/FPGA/VersionFPGA'
+require_relative '../../Firmwares/UC/VersionUC'
+class String
+  def black;          "\e[30m#{self}\e[0m" end
+  def red;            "\e[31m#{self}\e[0m" end
+  def green;          "\e[32m#{self}\e[0m" end
+  def brown;          "\e[33m#{self}\e[0m" end
+  def blue;           "\e[34m#{self}\e[0m" end
+  def magenta;        "\e[35m#{self}\e[0m" end
+  def cyan;           "\e[36m#{self}\e[0m" end
+  def gray;           "\e[37m#{self}\e[0m" end
+
+  def bg_black;       "\e[40m#{self}\e[0m" end
+  def bg_red;         "\e[41m#{self}\e[0m" end
+  def bg_green;       "\e[42m#{self}\e[0m" end
+  def bg_brown;       "\e[43m#{self}\e[0m" end
+  def bg_blue;        "\e[44m#{self}\e[0m" end
+  def bg_magenta;     "\e[45m#{self}\e[0m" end
+  def bg_cyan;        "\e[46m#{self}\e[0m" end
+  def bg_gray;        "\e[47m#{self}\e[0m" end
+
+  def bold;           "\e[1m#{self}\e[22m" end
+  def italic;         "\e[3m#{self}\e[23m" end
+  def underline;      "\e[4m#{self}\e[24m" end
+  def blink;          "\e[5m#{self}\e[25m" end
+  def reverse_color;  "\e[7m#{self}\e[27m" end
+end
+
+class HardsploitAPI
+  include Singleton
+  include USB_COMMAND
+  include USB
+  include VERSION
+  include ERROR
+
+  @@callbackData = nil
+  @@callbackInfo = nil
+  @@callbackProgress = nil
+  @@callbackSpeedOfTransfert = nil
+  @@id = 0
+  @@crossWiringValue = Array.new
+
+  def self.callbackData= fn
+        @@callbackData = fn
+  end
+  def self.callbackInfo= fn
+        @@callbackInfo = fn
+  end
+  def self.callbackProgress= fn
+        @@callbackProgress = fn
+  end
+  def self.callbackSpeedOfTransfert= fn
+        @@callbackSpeedOfTransfert = fn
+  end
+
+  def self.crossWiringValue
+    return @@crossWiringValue
+  end
+
+  def self.id=id
+    if (id < 0) then
+      raise ERROR::HARDSPLOIT_NOT_FOUND
+    else
+      @@id = id
+    end
+  end
+
+  def initialize
+       if @@callbackData == nil or @@callbackInfo == nil or @@callbackProgress == nil or @@callbackSpeedOfTransfert == nil then
+         raise "Error you need to specify callbackData callbackInfo callbackProgress callbackSpeedOfTransfert first"
+       else
+         #Default wiring
+         for i in 0..63
+         	@@crossWiringValue.push i
+         end
+         self.connect
+         puts "Hardsploit is connected".green.bold
+       end
+  end
+
+  # Set the leds of uC  returning nothing
+	# * +led+:: USB_COMMAND::GREEN_LED  or USB_COMMAND::RED_LED
+	# * +state+:: callback to return +data for dump function+
+	def setStatutLed(led:,state:)
+		packet_send = Array.new
+		packet_send.push 0 #size set before send automatic
+		packet_send.push 0	#size set before send automatic
+		packet_send.push HardsploitAPI.lowByte(word:led)
+		packet_send.push HardsploitAPI.highByte(word:led)
+		packet_send.push (state ? 1 : 0)
+		return sendPacket(packet_send)
+	end
+
+
+  # Set custom value to wiring led
+  # * +value+:: 64 bits (8x8 Bytes) values to represent led (PortH PortG PortF PortE PortD PortC PortB PortA)
+  def setWiringLeds(value:)
+  #  parametters = HardsploitAPI.checkParametters(["value"],args)
+  #  val = parametters[:value]
+
+    packet = Array.new
+    packet.push 0  #low byte of lenght of trame refresh automaticly before send by usb
+    packet.push 0  #high byte of lenght of trame refresh automaticly before send by usb
+    packet.push HardsploitAPI.lowByte(word:USB_COMMAND::FPGA_COMMAND)
+    packet.push HardsploitAPI.highByte(word:USB_COMMAND::FPGA_COMMAND)
+
+    packet.push 0x23 #Command SPI write wiring led
+
+    packet.push  HardsploitAPI.reverseBit((value & 0x00000000000000FF) >> 0)
+    packet.push  HardsploitAPI.reverseBit((value & 0x000000000000FF00) >> 8 )
+    packet.push  HardsploitAPI.reverseBit((value & 0x0000000000FF0000) >> 16 )
+    packet.push  HardsploitAPI.reverseBit((value & 0x00000000FF000000) >> 24 )
+    packet.push  HardsploitAPI.reverseBit((value & 0x000000FF00000000) >> 32 )
+    packet.push  HardsploitAPI.reverseBit((value & 0x0000FF0000000000) >> 40 )
+    packet.push  HardsploitAPI.reverseBit((value & 0x00FF000000000000) >> 48 )
+    packet.push  HardsploitAPI.reverseBit((value & 0xFF00000000000000) >> 56 )
+
+    return  HardsploitAPI.instance.sendPacket(packet)
+  end
+
+  # Obtaint the version number of the board
+  def getVersionNumber
+    packet = Array.new
+    packet.push 0  #low byte of lenght of trame refresh automaticly before send by usb
+    packet.push 0  #high byte of lenght of trame refresh automaticly before send by usb
+    packet.push HardsploitAPI.lowByte(word:USB_COMMAND::GET_VERSION_NUMBER)
+    packet.push HardsploitAPI.highByte(word:USB_COMMAND::GET_VERSION_NUMBER)
+
+    #remove header
+    version_number = self.sendAndReceiveDATA(packet,1000).drop(4)
+    if version_number.size < 20 then #if size more thant 20 char error when reading version number
+        return version_number.pack('U*')
+    else
+      return "BAD VERSION NUMBER"
+    end
+  end
+
+  def getAllVersions
+    puts "API             : #{VERSION::API}".blue.bold
+    puts "Board           : #{getVersionNumber}".blue.bold
+    puts "FPGA            : #{VersionFPGA::VERSION_FPGA::FPGA}".blue.bold
+    puts "Microcontroller : #{VersionUC::VERSION_UC::UC}".blue.bold
+  end
+
+  def self.reverseBit(byte)
+    return byte.to_s(2).rjust(8, "0").reverse.to_i(2)
+  end
+
+  # Set cross wiring
+  # * +value+:: 64*8 bits to represent wiring
+  def setCrossWiring(value:)
+    if not value.size == 64 then
+      raise HardsploitAPI::ERROR::API_CROSS_WIRING
+    end
+
+    packet = Array.new
+    packet.push 0  #low byte of lenght of trame refresh automaticly before send by usb
+    packet.push 0  #high byte of lenght of trame refresh automaticly before send by usb
+    packet.push HardsploitAPI.lowByte(word:USB_COMMAND::FPGA_COMMAND)
+    packet.push HardsploitAPI.highByte(word:USB_COMMAND::FPGA_COMMAND)
+
+    packet.push 0x75 #Cross wiring command
+    packet.push *value
+    @@crossWiringValue = value
+    return self.sendPacket(packet)
+  end
+
+  def self.allPosibility(numberOfConnectedPinFromA0:,numberOfSignalsForBus:)
+      if numberOfConnectedPinFromA0 < numberOfSignalsForBus then
+        raise HardsploitAPI::ERROR::API_SCANNER_WRONG_PIN_NUMBER
+      end
+      a =	  Array.new
+      for i in 0..numberOfConnectedPinFromA0-1
+        a.push i
+      end
+     return a.permutation.to_a
+  end
+
+  def self.prepare_packet
+		packet = []
+		packet.push 0  #low byte of lenght of trame refresh automaticly before send by usb
+		packet.push 0  #high byte of lenght of trame refresh automaticly before send by usb
+		packet.push HardsploitAPI.lowByte(word:HardsploitAPI::USB_COMMAND::FPGA_COMMAND)
+		packet.push HardsploitAPI.highByte(word:HardsploitAPI::USB_COMMAND::FPGA_COMMAND)
+		packet.push 0x50 #Command RAW COMMUNICATION TO FPGA FIFO
+		return packet
+	end
+
+  #call back
+  def consoleProgress(percent:,startTime:,endTime:)
+    @@callbackProgress.call(percent:percent,startTime:startTime,endTime:endTime)
+  end
+  def consoleData(value)
+    @@callbackData.call(value)
+  end
+  def consoleSpeed(value)
+    @@callbackSpeedOfTransfert.call(value)
+  end
+  def consoleInfo(value)
+    @@callbackInfo.call(value)
+  end
+
+end

data/lib/HardsploitAPI/Core/HardsploitAPI_CONSTANT.rb

@@ -0,0 +1,150 @@
+#!/usr/bin/ruby
+#===================================================
+#  Hardsploit API - By Opale Security
+#  www.opale-security.com || www.hardsploit.io
+#  License: GNU General Public License v3
+#  License URI: http://www.gnu.org/licenses/gpl.txt
+#===================================================
+
+class HardsploitAPI
+public
+
+# Obtain signal Id
+# Params:
+# +signal+:: Name of signal you want obtain ud
+def self.getSignalId(signal:)
+	wires = Hash.new
+
+	#Parallel module
+	wires["A0"]				 = 0
+	wires["A1"]				 = 1
+	wires["A2"]				 = 2
+	wires["A3"]				 = 3
+	wires["A4"]				 = 4
+	wires["A5"]				 = 5
+	wires["A6"]				 = 6
+	wires["A7"]				 = 7
+	wires["A8"]				 = 8
+	wires["A9"]				 = 9
+	wires["A10"]			 = 10
+	wires["A11"]			 = 11
+	wires["A12"]			 = 12
+	wires["A13"]			 = 13
+	wires["A14"]			 = 14
+	wires["A15"]			 = 15
+	wires["A16"]			 = 16
+	wires["A17"]			 = 17
+	wires["A18"]			 = 18
+	wires["A19"]			 = 19
+	wires["A20"]			 = 20
+	wires["A21"]			 = 21
+	wires["A22"]			 = 22
+	wires["A23"]			 = 23
+	wires["A24"]			 = 24
+	wires["A25"]			 = 25
+	wires["A26"]			 = 26
+	wires["A27"]			 = 27
+	wires["A28"]			 = 28
+	wires["A29"]			 = 29
+	wires["A30"]			 = 30
+	wires["A31"]			 = 31
+
+	wires["D0"] 			 = 32
+	wires["D1"]				 = 33
+	wires["D2"]				 = 34
+	wires["D3"] 			 = 35
+	wires["D4"]				 = 36
+	wires["D5"] 			 = 37
+	wires["D6"] 			 = 38
+	wires["D7"] 			 = 39
+	wires["D8"] 			 = 40
+	wires["D9"] 			 = 41
+	wires["D10"] 			 = 42
+	wires["D11"] 			 = 43
+	wires["D12"] 			 = 44
+	wires["D13"]			 = 45
+	wires["D14"]			 = 46
+	wires["D15"] 			 = 47
+
+	wires["RST"]			 = 48
+	wires["CE"] 			 = 49
+	wires["OE"] 			 = 50
+	wires["WE"] 			 = 51
+	wires["PARA_CLK"]	 = 52
+	wires["WP"] 			 = 53
+	wires["ADV"] 			 = 54
+
+	#SPI module
+	wires["SPI_CLK"]	 = 0
+	wires["CS"] 	 		 = 1
+	wires["MOSI"]	 		 = 2
+	wires["MISO"]  		 = 3
+	wires["PULSE"] 		 = 4
+
+	#I2C module
+	wires["I2C_CLK"] 	 = 0
+	wires["SDA"] 	 		 = 1
+
+	#UART module
+	wires["TX"] 	 		 = 0
+	wires["RX"] 	 		 = 1
+
+	#SWD module
+	wires["SWD_CLK"] 	 = 0
+	wires["SWD_IO"] 	 = 1
+
+	return wires[signal]
+end
+
+	# Power on the led for each signal specified
+	# Params:
+	# +signal+:: Name of signal you want visual help (set the led)
+def signalHelpingWiring(signal:)
+		begin
+			HardsploitAPI.instance.setWiringLeds(value:2**HardsploitAPI.crossWiringValue.index(HardsploitAPI.getSignalId(signal:signal)))
+		rescue
+		   raise 'UNKNOWN SIGNAL'
+		end
+	end
+
+	module USB_COMMAND
+		GREEN_LED                    =  0
+		RED_LED                      =  1
+		LOOPBACK                     =  2
+		ERASE_FIRMWARE               =  3
+		WRITE_PAGE_FIRMWARE          =  4
+		READ_PAGE_FIRMWARE           =  5
+		READ_ID_FLASH                =  6
+		START_FPGA                   =  7
+		STOP_FPGA                    =  8
+		FPGA_COMMAND                 =  9
+		FPGA_DATA 			             = 10
+		STOP_FPGA_DATA               = 11
+		START_FPGA_DATA              = 12
+		GET_SERIAL_NUMBER            = 13
+		GET_VERSION_NUMBER           = 14
+		VCP_ERROR                    = 0xFFFF
+	end
+
+	module I2C
+		KHZ_100  = 0
+		KHZ_400  = 1
+		KHZ_1000 = 2
+		KHZ_40   = 3
+	end
+
+	module SPISniffer
+		MOSI = 1
+		MISO = 2
+		MISO_MOSI = 3
+	end
+
+	module USB
+			OUT_ENDPOINT   = 0X02
+			IN_ENDPOINT    = 0X81
+			USB_TRAME_SIZE = 8192
+	end
+	module VERSION
+		API   = "2.0.0"
+	end
+end

data/lib/HardsploitAPI/Core/HardsploitAPI_ERROR.rb

@@ -0,0 +1,109 @@
+#!/usr/bin/ruby
+#===================================================
+#  Hardsploit API - By Opale Security
+#  www.opale-security.com || www.hardsploit.io
+#  License: GNU General Public License v3
+#  License URI: http://www.gnu.org/licenses/gpl.txt
+#===================================================
+
+class HardsploitAPI
+	module ERROR
+    class Standard < StandardError; end
+
+		class HARDSPLOIT_NOT_FOUND < Standard
+			def initialize(msg="HARDSPLOIT NOT FOUND")
+					super(msg)
+			end
+		end
+		class API_CROSS_WIRING < Standard
+			def initialize(msg="The crossWiring array must be a 64 items array")
+					super(msg)
+			end
+		end
+		class API_SCANNER_WRONG_PIN_NUMBER < Standard
+			def initialize(msg="You need to connect more thant pins needed by the module 2 for swd, 2 for I2C etc")
+					super(msg)
+			end
+		end
+		class FileIssue < Standard
+			def initialize(msg="Issue with file")
+					super(msg)
+			end
+		end
+
+		class I2CWrongSpeed < Standard
+			def initialize(msg="Uknown speed, speed must be KHZ_100 = 0, KHZ_400 = 1,KHZ_1000 = 2")
+					super(msg)
+			end
+		end
+		class SPIWrongPulse < Standard
+			def initialize(msg="Wrong, Pulse must be 0 or 1")
+					super(msg)
+			end
+		end
+		class SPIWrongSpeed < Standard
+			def initialize(msg="Speed must be between 3 and 255")
+					super(msg)
+			end
+		end
+		class SPIWrongMode < Standard
+			def initialize(msg="Mode must be between 0 and 3")
+					super(msg)
+			end
+		end
+
+		class SPIWrongPayloadSize < Standard
+			def initialize(msg="Size of the data need to be less than 4000")
+					super(msg)
+			end
+		end
+
+		class WrongStartAddress < Standard
+			def initialize(msg="Start address can't be negative and not more than size max - 1")
+					super(msg)
+			end
+		end
+
+		class SpiError < Standard
+			def initialize(msg="Error during SPI processing")
+					super(msg)
+			end
+		end
+
+		class USB_PACKET_IS_TOO_LARGE < Standard
+			def initialize(msg="USB_PACKET_IS_TOO_LARGE")
+					super(msg)
+			end
+		end
+
+		class USB_ERROR < Standard
+			def initialize(msg="USB ERROR")
+					super(msg)
+			end
+		end
+
+		class SWD_ERROR < Standard
+			def initialize(msg="SWD ERROR, WAIT, FAUL, ACK or something like that")
+					super(msg)
+			end
+		end
+
+		class UART_WrongSettings < Standard
+			def initialize(msg="Wrong UART settings")
+					super(msg)
+			end
+		end
+
+		class UART_WrongTxPayloadSize < Standard
+			def initialize(msg="Wrong TX payload size")
+					super(msg)
+			end
+		end
+
+		class UART_WrongPayloadSize < Standard
+			def initialize(msg="Size of the data need to be less than 4000")
+					super(msg)
+			end
+		end
+	end
+end