Samsung_S7/README.md

# Samsung_S7
Code to exploit and research the Exynos Bootrom.

## Setting up

### Python module
Create a venv, and intall ghidra_assistant.
```bash
python3 -m venv venv
. venv/bin/activate
pip install -r requirements.txts
```

### Building the debugger
The debugger needs to be built using [gupje](https://git.herreweb.nl/EljakimHerrewijnen/Gupje). Move the contents of `source/gupje_device` to `Gupje/devices/samsung_s7`. Then proceed to build the debugger.

```bash
mv source/gupje_device/* {your-gupje-root}/devices/samsung_s7
cd {your-gupje-root}
make -f devices/samsung_s7/Makefile
```

Then proceed to move the debugger to `dump/debugger.bin`. To get to work, run `source/exploit/exploit.py`. The launch.json's are located in source/exploit, so its recommended to open this folder in your VSCode/favourite IDE.

### Viewing/building documentation
To view documentation, ensure you have sphinx installed. If not, run `sudo apt install python3-sphinx`. Then proceed to build the documentation by running `make livehtml` in `documentation`.

## Pushing documentation to confluence
Run `sphinx-build -b confluence source _build/confluence` from documentation/ to push docs to confluence. They will appear in the DT_Sphinx space. If running issues, be sure to remove the '_build' folder and try again!
Initial commit 2023-06-05 16:10:04 +00:00			`# Samsung_S7`
add incomplete readme and requirements.txt 2024-08-03 13:37:57 +00:00			`Code to exploit and research the Exynos Bootrom.`
Initial commit 2023-06-05 16:10:04 +00:00
add incomplete readme and requirements.txt 2024-08-03 13:37:57 +00:00			`## Setting up`
Updating readme and adding some necessary binaries to run the exploit 2024-08-20 14:31:49 +00:00
			`### Python module`
add incomplete readme and requirements.txt 2024-08-03 13:37:57 +00:00			`Create a venv, and intall ghidra_assistant.`
			```bash
			`python3 -m venv venv`
			`. venv/bin/activate`
			`pip install -r requirements.txts`
			```

Updating readme and adding some necessary binaries to run the exploit 2024-08-20 14:31:49 +00:00			`### Building the debugger`
			The debugger needs to be built using [gupje](https://git.herreweb.nl/EljakimHerrewijnen/Gupje). Move the contents of `source/gupje_device` to `Gupje/devices/samsung_s7`. Then proceed to build the debugger.

			```bash
			`mv source/gupje_device/* {your-gupje-root}/devices/samsung_s7`
			`cd {your-gupje-root}`
			`make -f devices/samsung_s7/Makefile`
			```

			Then proceed to move the debugger to `dump/debugger.bin`. To get to work, run `source/exploit/exploit.py`. The launch.json's are located in source/exploit, so its recommended to open this folder in your VSCode/favourite IDE.
Update repository readme, requirements and add more flexible gitignore for frederics exynos-usbdl 2024-08-07 17:11:56 +00:00
Updating readme and adding some necessary binaries to run the exploit 2024-08-20 14:31:49 +00:00			`### Viewing/building documentation`
Adding DT_Sphinx confluence push. Fixing some errors in the documentation. 2024-09-17 16:28:35 +00:00			To view documentation, ensure you have sphinx installed. If not, run `sudo apt install python3-sphinx`. Then proceed to build the documentation by running `make livehtml` in `documentation`.

			`## Pushing documentation to confluence`
			Run `sphinx-build -b confluence source _build/confluence` from documentation/ to push docs to confluence. They will appear in the DT_Sphinx space. If running issues, be sure to remove the '_build' folder and try again!