Add reference projects as submodules
monmob (WiFi monitor mode), P4wnP1 (USB attack platform), dustcloud-nexmon (Broadcom firmware patches), InternalBlue (Bluetooth firmware patching). Docs updated with descriptions and usage context for each.
This commit is contained in:
12
.gitmodules
vendored
12
.gitmodules
vendored
@@ -1,3 +1,15 @@
|
|||||||
[submodule "tools/rtl_tcp_andro"]
|
[submodule "tools/rtl_tcp_andro"]
|
||||||
path = tools/rtl_tcp_andro
|
path = tools/rtl_tcp_andro
|
||||||
url = https://github.com/signalwareltd/rtl_tcp_andro-.git
|
url = https://github.com/signalwareltd/rtl_tcp_andro-.git
|
||||||
|
[submodule "tools/monmob"]
|
||||||
|
path = tools/monmob
|
||||||
|
url = https://github.com/tuter/monmob.git
|
||||||
|
[submodule "tools/P4wnP1"]
|
||||||
|
path = tools/P4wnP1
|
||||||
|
url = https://github.com/RoganDawes/P4wnP1.git
|
||||||
|
[submodule "tools/dustcloud-nexmon"]
|
||||||
|
path = tools/dustcloud-nexmon
|
||||||
|
url = https://github.com/dgiese/dustcloud-nexmon.git
|
||||||
|
[submodule "tools/internalblue"]
|
||||||
|
path = tools/internalblue
|
||||||
|
url = https://github.com/seemoo-lab/internalblue.git
|
||||||
|
|||||||
@@ -183,6 +183,49 @@ pkg install -y clinfo opencl-headers
|
|||||||
clinfo # Should show PowerVR device
|
clinfo # Should show PowerVR device
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Included Reference Projects
|
||||||
|
|
||||||
|
These are included as submodules in `tools/` to give you a starting point
|
||||||
|
for building custom drivers and firmware. Clone with `--recurse-submodules`
|
||||||
|
to get them.
|
||||||
|
|
||||||
|
### monmob — WiFi Monitor Mode on Android
|
||||||
|
- **Path**: `tools/monmob`
|
||||||
|
- **Repo**: https://github.com/tuter/monmob
|
||||||
|
- **What**: Enables WiFi monitor mode on mobile devices. Useful reference
|
||||||
|
for getting monitor mode working on Broadcom chips without full nexmon.
|
||||||
|
|
||||||
|
### P4wnP1 — USB Attack Platform
|
||||||
|
- **Path**: `tools/P4wnP1`
|
||||||
|
- **Repo**: https://github.com/RoganDawes/P4wnP1
|
||||||
|
- **What**: Turns devices into a flexible USB attack/pentest platform.
|
||||||
|
HID injection, network attacks via USB gadget, Bluetooth. Good reference
|
||||||
|
for USB gadget mode drivers and HID attack payloads on Android.
|
||||||
|
|
||||||
|
### dustcloud-nexmon — Nexmon for Broadcom Chips
|
||||||
|
- **Path**: `tools/dustcloud-nexmon`
|
||||||
|
- **Repo**: https://github.com/dgiese/dustcloud-nexmon
|
||||||
|
- **What**: Nexmon firmware patches adapted for various Broadcom WiFi chips.
|
||||||
|
Reference for porting nexmon to new chips like the BCM4390.
|
||||||
|
|
||||||
|
### InternalBlue — Bluetooth Firmware Patching
|
||||||
|
- **Path**: `tools/internalblue`
|
||||||
|
- **Repo**: https://github.com/seemoo-lab/internalblue
|
||||||
|
- **What**: Bluetooth experimentation framework from the Seemoo Lab
|
||||||
|
(same team behind nexmon). Patches Broadcom/Cypress and some Qualcomm
|
||||||
|
Bluetooth firmware for security research. Supports:
|
||||||
|
- Raw HCI access and LMP monitoring
|
||||||
|
- Firmware patching on Broadcom BT chips
|
||||||
|
- Fuzzing and security testing
|
||||||
|
- Works on Android with root (KernelSU)
|
||||||
|
|
||||||
|
### rtl_tcp_andro — RTL-SDR + HackRF Android Driver
|
||||||
|
- **Path**: `tools/rtl_tcp_andro`
|
||||||
|
- **Repo**: https://github.com/signalwareltd/rtl_tcp_andro-
|
||||||
|
- **What**: Native Android USB driver for RTL-SDR and HackRF. Implements
|
||||||
|
the rtl_tcp protocol via `iqsrc://` intent. Build the APK and any SDR
|
||||||
|
app on Android can use your USB SDR hardware without root.
|
||||||
|
|
||||||
## Kernel Module Loading via KernelSU
|
## Kernel Module Loading via KernelSU
|
||||||
|
|
||||||
KernelSU supports loading `.ko` files. Place them in:
|
KernelSU supports loading `.ko` files. Place them in:
|
||||||
|
|||||||
1
tools/P4wnP1
Submodule
1
tools/P4wnP1
Submodule
Submodule tools/P4wnP1 added at 9c8cc09a65
1
tools/dustcloud-nexmon
Submodule
1
tools/dustcloud-nexmon
Submodule
Submodule tools/dustcloud-nexmon added at 6d3ee499d2
1
tools/internalblue
Submodule
1
tools/internalblue
Submodule
Submodule tools/internalblue added at f524380672
1
tools/monmob
Submodule
1
tools/monmob
Submodule
Submodule tools/monmob added at e16df370da
Reference in New Issue
Block a user