Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
all: src/flash_bash.c
gcc -g -lwiringPi -Wall -o flash_bash src/flash_bash.c
gcc -Wall -pthread -o flash_bash src/flash_bash.c -lpigpio -lrt

clean:
rm -rf flash_bash flash_bash.dSYM/
18 changes: 12 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,31 @@
# Flash-BASH
Flash-BASH is a Raspberry Pi based tool that uses a multiplexer to "glitch" a target device into a privileged open state.
<p align="center">
<img src="./images/logo.png?raw=true" alt="Flash Bash Logo" width="500px">
</p>

Flash-BASH is a Raspberry Pi based tool that uses a multiplexer to "glitch" a target device into a privileged open shell.

## Usage

See our blog post at https://www.riverloopsecurity.com/blog/2021/09/introducing-flash-bash/ for information on usage.

## Install/Compile
The easiest way to use this tool without any tweaks is with a Raspberry Pi Model 3 B+.
The easiest way to use this tool without any tweaks is with a Raspberry Pi Type 3 (Model A+, B+, Pi Zero, Pi Zero W, Pi2B, Pi3B, Pi4B).
However, with minor tweaks to the code, any Raspberry Pi, Arduino, or micro-controller should work fine.

Secondly, this tool is based on the dependency Wiring Pi which you can install like so:
Secondly, this tool is based on the dependency pigpio which should be automatically installed on latest version of Raspberry Pi OS but can be installed with:
```
sudo apt-get install wiringpi
sudo apt-get install pigpio python-pigpio python3-pigpio
```
Please visit https://abyz.me.uk/rpi/pigpio for more information on the library.

Third, you will need the Pi Hat and components that are included in the CAD folder in this repository. You could also wire this with jumpers and a breadboard or a prototype-hat, but it will not be as organized!
Third, you will need the Pi Hat and components that are included in the CAD folder in this repository. You could also wire this with jumpers and a breadboard or a prototype-hat.

Last, you will need to compile this pointing to the Wiring Pi library like this
```
gcc -o flash_bash flash_bash.c -lwiringPi
gcc -Wall -pthread -o flash_bash flash_bash.c -lpigpio -lrt
```
or you can just run make in this directory.

That should get you started all you have to do now is run the program!
```
Expand Down
6 changes: 6 additions & 0 deletions cad/BOM
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
"Reference","Value","Datasheet","Footprint","Qty","DNP"
"C1","1uF","~","Capacitor_SMD:C_0805_2012Metric","1",""
"J1","GPIO","","Connector_PinSocket_2.54mm:PinSocket_2x20_P2.54mm_Vertical","1",""
"J2,J3,J5","Conn_01x03","~","Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical","3",""
"J4","Conn_02x03_Odd_Even","~","Connector_PinHeader_2.54mm:PinHeader_2x03_P2.54mm_Vertical","1",""
"U1","TMUX1133PWR","TMUX1133PWR","TMUX1133PWR:PW0016A-MFG","1",""
Binary file removed cad/CAMOutputs.zip
Binary file not shown.
Binary file added cad/FAB.zip
Binary file not shown.
Binary file added cad/FlashBash.zip
Binary file not shown.
12 changes: 11 additions & 1 deletion cad/README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,12 @@
# Flash-BASH Pi HAT Files
Included are Eagle 9.6.1 CAD files so that you can make modifications. Also included are ready-to-fab gerber files in the CAMOutputs.zip file.
<p align="center">
<img src="../images/FlashBash.jpg?raw=true" alt="Flash Bash Logo" width="500px">
</p>

Included are KiCAD 8.0.4 CAD files in the FlashBash.zip so that you can make modifications.

Also included are ready-to-fab gerber files in FAB.zip.

Please also see the footprint and schematic symbol for the multiplexer in the TMUX1133PWR.zip.

Lastly you can verify other components in the BOM csv file.
1,135 changes: 0 additions & 1,135 deletions cad/RasPi-BplusHAT.brd

This file was deleted.

5,830 changes: 0 additions & 5,830 deletions cad/RasPi-BplusHAT.sch

This file was deleted.

Binary file added cad/TMUX1133PWR.zip
Binary file not shown.
Binary file added images/FlashBash.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading