Top Level Namespace

Includes:
VersionFPGA::VERSION_FPGA, VersionUC::VERSION_UC

Defined Under Namespace

Modules: Ui Classes: Bus, Byte, CType, Chip, ChipType, Chip_clone, Chip_editor, Chip_management, Cmd, Command, Command_editor, Command_table, Console, CreateBuses, CreateBytes, CreateChipTypes, CreateChips, CreateCommands, CreateI2cSettings, CreateManufacturers, CreatePackages, CreateParallelSettings, CreatePins, CreateSignals, CreateSpiSettings, CreateSwdSettings, CreateUartSettings, CreateUses, CustomItem, ErrorMsg, Export, Export_manager, Firmware, Generic_commands, HardsploitAPI, HardsploitAPI_I2C, HardsploitAPI_NRF24L01, HardsploitAPI_PARALLEL, HardsploitAPI_SPI, HardsploitAPI_SPI_SNIFFER, HardsploitAPI_SWD, HardsploitAPI_TEST, HardsploitAPI_UART, Hardsploit_gui, I2C, I2cSetting, I2c_command, I2c_read, I2c_scanner, I2c_settings, I2c_write, Import, Manufacturer, Package, Parallel, ParallelSetting, Parallel_read, Parallel_settings, Parallel_write, Pin, Progress_bar, SWD_DEBUG_PORT, SWD_MEM_AP, SWD_STM32, Signal_mapper, Signall, Spi, SpiSetting, Spi_read, Spi_settings, Spi_sniffer, Spi_write, String, Swd, SwdSetting, Swd_scanner, Swd_settings, UartSetting, Uart_baudrate, Uart_console, Uart_settings, Ui_Chip_clone, Ui_Chip_editor, Ui_Chip_management, Ui_Command_editor, Ui_Export, Ui_Export_manager, Ui_Generic_commands, Ui_Generic_read, Ui_Generic_write, Ui_I2c_command, Ui_I2c_settings, Ui_Import, Ui_Parallel_settings, Ui_Progress_bar, Ui_Signal_mapper, Ui_Signal_scanner, Ui_Spi_settings, Ui_Spi_sniffer, Ui_Swd_settings, Ui_Uart_baudrate, Ui_Uart_console, Ui_Uart_settings, Ui_Wire_helper, UniqPin, Use, VersionFPGA, VersionUC, Wire_helper

Constant Summary collapse

ABSOLUTE_PATH = 
Hardsploit GUI - 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

File.expand_path(File.dirname(__FILE__)) + "/"

Constants included from VersionUC::VERSION_UC

VersionUC::VERSION_UC::UC

Constants included from VersionFPGA::VERSION_FPGA

VersionFPGA::VERSION_FPGA::FPGA

Instance Method Summary collapse

Instance Method Details

#callbackData(receiveData) ⇒ Object 



16
17
18
19
20
21
22
23
 
# File 'lib/hardsploit-api/Examples/testI2C.rb', line 16

def callbackData(receiveData)
	if receiveData != nil then
			puts "received #{receiveData.size}"
	  	p receiveData
	else
			puts "ISSUE BECAUSE DATA IS NIL"
	end
end

#callbackInfo(receiveData) ⇒ Object 



12
13
14
 
# File 'lib/hardsploit-api/Examples/testI2C.rb', line 12

def callbackInfo(receiveData)
	#print receiveData  + "\n"
end

#callbackProgress(percent:, startTime:, endTime:) ⇒ Object

puts “Speed : #receiveData”



28
29
30
31
32
 
# File 'lib/hardsploit-api/Examples/testSPI.rb', line 28

def callbackProgress(percent:,startTime:,endTime:)
	print "\r\e[#{31}mUpload of FPGA firmware in progress : #{percent}%\e[0m"
	#puts "Progress : #{percent}%  Start@ #{startTime}  Stop@ #{endTime}"
	#puts "Elasped time #{(endTime-startTime).round(4)} sec"
end

#callbackSpeedOfTransfert(receiveData) ⇒ Object 



25
26
27
 
# File 'lib/hardsploit-api/Examples/testI2C.rb', line 25

def callbackSpeedOfTransfert(receiveData)
	#puts "Speed : #{receiveData}"
end

#centerWindow(win) ⇒ Object 



89
90
91
92
93
94
95
 
# File 'lib/Hardsploit_gui.rb', line 89

def centerWindow(win)
  desktop = Qt::DesktopWidget.new
  rect  = desktop.screenGeometry(desktop.primaryScreen)
  centerX = (rect.width - win.width ) / 2
  centerY = (rect.height - win.height)  / 2
  win.move(centerX,centerY)
end

#check_for_errors(result) ⇒ Object 



67
68
69
70
71
72
73
74
75
 
# File 'lib/Hardsploit_gui.rb', line 67

def check_for_errors(result)
  return false if result.errors.messages.empty?
  error_message = ""
  result.errors.messages.each do |msg|
    error_message << "Error: #{msg[0]} #{msg[1][0]}\n"
  end
  Qt::MessageBox.new(Qt::MessageBox::Warning, 'Warning', error_message).exec
  return true
end

#draw_rect ⇒ Object 



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
 
# File 'lib/class/Wire_helper.rb', line 103

def draw_rect
  total_pin_nbr = Pin.where(chip_id: @chip.id).count
  pin_by_side = total_pin_nbr / 2
  cHeight = 14 * (pin_by_side + 2) # +2 because we add a space equal to one pin for each corner
  @scene.addRect(Qt::RectF.new(0, 0, cHeight, cHeight))
  # Add the pins + text
  y = 18
  y2 = cHeight - 24
  (1..total_pin_nbr).each do |i|
    # Face 1
    if i <= total_pin_nbr / 2
      ySig = y
      yNum = y
      UniqPin.new(@scene, i, @chip.id, -70, ySig - 12, 0, yNum - 12, 0, y, -20, 6, false)
      y = y + 14
    # Face 2
    else
      xSig = cHeight + 24
      ySig = y2
      yNum = y2

      if i < 10
        xNum = cHeight - 20
      elsif i >= 10 && i < 100
        xNum = cHeight - 25
      else
        xNum = cHeight - 35
      end
      UniqPin.new(@scene, i, @chip.id, xSig, ySig - 12, xNum, yNum - 12, cHeight, y2, 20, 6, false)
      y2 = y2 - 14
    end
  end
end

#draw_square ⇒ Object 



48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/class/Wire_helper.rb', line 48

def draw_square
  total_pin_nbr = Pin.where(chip_id: @chip.id).count
  pin_by_side = total_pin_nbr / 4
  cHeight = 14*(pin_by_side + 4)  # Chip's height (+4 because we add a space equal to one pin for each corner)
  @scene.addRect(Qt::RectF.new(0, 0, cHeight, cHeight))
  y = 32
  y2 = cHeight - 38
  x = 32
  x2 = cHeight - 38
  (1..total_pin_nbr).each do |i|
    # Face 1
    if i <= pin_by_side
      ySig = y
      yNum = y
      UniqPin.new(@scene, i, @chip.id, -70, ySig - 12, 0, yNum - 12, 0, y, -20, 6, false)
      y = y + 14 # Space between each pin
    elsif i > pin_by_side && i <= total_pin_nbr / 2
    # Face 2
      xSig2 = x
      xNum2 = x
      UniqPin.new(@scene, i, @chip.id, xSig2 - 12, cHeight + 55, xNum2 - 12, cHeight, x, cHeight, 6, 20, true)
      x = x + 14
    elsif i > total_pin_nbr / 2 && i <= (total_pin_nbr - (pin_by_side))
    # Face 3
      xSig = cHeight + 24
      ySig = y2
      yNum = y2

      if i < 10
        xNum = cHeight - 20
      elsif i >= 10 && i < 100
        xNum = cHeight - 25
      else
        xNum = cHeight - 35
      end
      UniqPin.new(@scene, i, @chip.id, xSig, ySig - 12, xNum, yNum - 12, cHeight, y2, 20, 6, false)
      y2 = y2 - 14
    else
    # Face 4
      xSig2 = x2
      xNum2 = x2

      if i < 10
        yNum2 = 20
      elsif i >= 10 && i < 100
        yNum2 = 30
      else
        yNum2 = 40
      end
      UniqPin.new(@scene, i, @chip.id, xSig2 - 12, -20, xNum2 - 12, yNum2, x2, 0, 6, -20, true)
      x2 = x2 - 14
    end
  end
end

#i2cCustomInteract ⇒ Object 



83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
 
# File 'lib/hardsploit-api/Examples/testI2C.rb', line 83

def i2cCustomInteract
	begin
		#Create an instance of I2C
		i2c = HardsploitAPI_I2C.new(speed:HardsploitAPI::I2C::KHZ_100)

		testpack = Array.new

		#interact I2C
		# write with even address
		# read with odd address

		#Write 4 bytes at 0x00 0x00
		# testpack.push HardAPI.lowByte(4)  #Count Low  Byte
		# testpack.push HardAPI.highByte(4)   #Count High Byte
		# testpack.push 0xA0
		# testpack.push 41  #First data byte
		# testpack.push 42  #Second data byte
		# testpack.push 43
		# testpack.push 44


		#Write pointer of I2C memorie at 0x00 0x00
		# testpack.push HardsploitAPI.lowByte(word:2)  #Count Low  Byte
		# testpack.push HardsploitAPI.highByte(word:2)   #Count High Byte
		# testpack.push 0xA0
		# testpack.push 0x00
		# testpack.push 0x00

		testpack.push HardsploitAPI.lowByte(word:2)  #Count Low  Byte
		testpack.push HardsploitAPI.highByte(word:2)   #Count High Byte
		testpack.push 0xA0
		testpack.push 0x00
		testpack.push 0x00

		testpack.push HardsploitAPI.lowByte(word:4)  #Count Low  Byte
		testpack.push HardsploitAPI.highByte(word:4)   #Count High Byte
		testpack.push 0xA1




		begin
			#result contient les ACK NACK ou les data si dispo cf wiki
			# https://github.com/OPALESECURITY/hardsploit-api/wiki#i2c-interact
			result = i2c.i2c_Interact(payload:testpack)
			p result
		rescue HardsploitAPI::ERROR::USB_ERROR
			puts "Error during USB communication, please retry"
		end

	rescue HardsploitAPI::ERROR::HARDSPLOIT_NOT_FOUND
		puts "Hardsploit not found"
	end
end

#i2cCustomScan ⇒ Object 



49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
 
# File 'lib/hardsploit-api/Examples/testI2C.rb', line 49

def i2cCustomScan
	begin
		#Create an instance of I2C
		i2c = HardsploitAPI_I2C.new(speed:HardsploitAPI::I2C::KHZ_100)

		#Change the speed
		i2c.speed = HardsploitAPI::I2C::KHZ_100

		#scan I2C
		puts "I2C SCAN :"
		scan_result = i2c.i2c_Scan
		#check parity of array index to know if a Read or Write address
		# Index 0 is write address because is is even
		# Index 1 is read address because it is  odd

		# Index 160 (0xA0) is write address because is is even
		# Index 161 (0xA1) is read address because is is odd

		#If value is 0 slave address is not available
		#If valude is 1 slave address is available

		for i in (0..scan_result.size-1) do
			if scan_result[i] == 1 then
				puts " #{(i).to_s(16)} #{scan_result[i]}"
			end
		end

	rescue HardsploitAPI::ERROR::HARDSPLOIT_NOT_FOUND
		puts "Hardsploit not found"
	rescue HardsploitAPI::ERROR::USB_ERROR
		puts "USB ERRROR"
  end
end

#inputRestrict(lineEdit, type) ⇒ Object 



77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/Hardsploit_gui.rb', line 77

def inputRestrict(lineEdit, type)
  case type
  when 0 ; reg = Qt::RegExp.new("[0-9]+")
  when 1 ; reg = Qt::RegExp.new("^[a-zA-Z_@-]+( [a-zA-Z_@-]+)*$")
  when 2 ; reg = Qt::RegExp.new("^[a-zA-Z0-9_@-]+( [a-zA-Z0-9_@-]+)*$")
  when 3 ; reg = Qt::RegExp.new("^[A-Fa-f0-9]{2}")
  when 4 ; reg = Qt::RegExp.new("^[A-Fa-f0-9]{8}")
  end
  regVal = Qt::RegExpValidator.new(reg, self)
  lineEdit.setValidator(regVal)
end

#spiCustomCommand ⇒ Object

p HardsploitAPI::VERSION::API



51
52
53
54
55
56
57
58
59
60
 
# File 'lib/hardsploit-api/Examples/testSPI.rb', line 51

def spiCustomCommand
	#Speed Range 1-255  SPI clock =  150Mhz / (2*speed) tested from 3 to 255 (25Mhz to about 0.3Khz)

	testpack = Array.new
	for i in (0..10) do
		testpack.push i
	end
	result = @spi.spi_Interact(payload:testpack)
	p result
end

#swdCustomRead ⇒ Object

The current API version p HardsploitAPI::VERSION::API



48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
 
# File 'lib/hardsploit-api/Examples/testSWD.rb', line 48

def swdCustomRead
	begin
		swd = HardsploitAPI_SWD.new(
			memory_start_address: "0x08000000",
			memory_size_address:   "0x1FFFF7E0",
			cpu_id_address:		   "0xE000ED00",
			device_id_address:	   "0x1FFFF7E8"
		)
		#TO OBTAIN ID CODE
		code = swd.obtainCodes
		puts "DP.IDCODE: 	#{code[:DebugPortId].to_s(16)} "
		#puts "AP.IDCODE: 	#{code[:AccessPortId].to_s(16)} "
		#puts "CPU ID : 		#{code[:CpuId].to_s(16)} "
		#	puts "DEVICE ID : #{code[:DeviceId].to_s(16)}"
	rescue
		puts "MCU NOT FOUND"
		#puts "Read ARM Register"
		#swd.readRegs

		#puts "stop"
		#swd.stop

		#TO DUMP FLASH
		#swd.dumpFlash('dumdp.bin')
		#swd.erase
		# ERASE FLASH !!!!!!!!!!  AND WRITE THE CONTENT OF THE FILE ON THE FLASH
		#swd.writeFlash('dumdp2.bin')

	rescue HardsploitAPI::ERROR::HARDSPLOIT_NOT_FOUND
		puts "Hardsploit not found"
	rescue HardsploitAPI::ERROR::USB_ERROR
		puts "USB ERRROR"
	end
end

#swdCustomWrite ⇒ Object 



82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
 
# File 'lib/hardsploit-api/Examples/testSWD.rb', line 82

def swdCustomWrite
	begin

		swd = HardsploitAPI_SWD.new(
			memory_start_address: "0x08000000",
			memory_size_address:  "0x1FFFF7E0",
			cpu_id_address:		  	"0xE000ED00",
			device_id_address:	  "0x1FFFF7E8"
		)
		#TO OBTAIN ID CODE
		code = swd.obtainCodes
		puts "DP.IDCODE: 	#{code[:DebugPortId].to_s(16)} "
		puts "AP.IDCODE: 	#{code[:AccessPortId].to_s(16)} "
		puts "CPU ID : 		#{code[:CpuId].to_s(16)} "

	#TO DUMP FLASH
	#swd.dumpFlash('dumdp.bin')
	#swd.erase
	# ERASE FLASH !!!!!!!!!!  AND WRITE THE CONTENT OF THE FILE ON THE FLASH
	swd.writeFlash('dumdp2.bin')
	#unhalt
	#swd.stop

	rescue HardsploitAPI::ERROR::HARDSPLOIT_NOT_FOUND
		puts "Hardsploit not found"
	rescue HardsploitAPI::ERROR::USB_ERROR
		puts "USB ERRROR"
	end
end

#uartCustomRead ⇒ Object 



68
69
70
71
72
73
74
75
76
77
78
79
80
 
# File 'lib/hardsploit-api/Examples/testUARTFuzzer.rb', line 68

def uartCustomRead
	while 1
		begin
			tab = @uart.sendAndReceived
			print tab.pack('c*')
			rescue HardsploitAPI::ERROR::HARDSPLOIT_NOT_FOUND
				puts "Hardsploit not found"
		  rescue HardsploitAPI::ERROR::USB_ERROR
			  puts "USB ERRROR"
		end
		sleep(0.2)
	end
end

#uartCustomSend ⇒ Object 



51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
 
# File 'lib/hardsploit-api/Examples/testUARTFuzzer.rb', line 51

def uartCustomSend
	begin
		payload = Array.new
		for i in 0..23
			payload.push 0x40
		end
		payload.push 13 #Carriage return

		@uart.write(payload:payload)
		puts payload.pack("C*")
		rescue HardsploitAPI::ERROR::HARDSPLOIT_NOT_FOUND
			puts "Hardsploit not found"
		rescue HardsploitAPI::ERROR::USB_ERROR
		  puts "USB ERRROR"
	end
end