Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
FlUxIuS authored May 30, 2020
1 parent 7f8ee50 commit d8bb4e2
Showing 1 changed file with 1 addition and 83 deletions.
84 changes: 1 addition & 83 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,85 +1,3 @@
# Suppport

This repository is not longer maintened, please use the following link instead: https://github.com/PentHertz/Modmobjam

# Modmobjam

A smart jamming proof of concept for mobile equipments that could be powered with [Modmobmap](https://github.com/PentHertz/Modmobmap)

For more information, this little tool has been presented during SSTIC rump 2018:

- english slides: https://www.synacktiv.com/ressources/sstic_rump_2018_modmobjam.pdf
- french presentation: https://static.sstic.org/rumps2018/SSTIC_2018-06-14_P10_RUMPS_22.mp4

## Warning

You should be warned that Jamming is illegal and you're responsible for any damages when using it on your own.

## Prerequisites

- a radio devices that is enabled to transmit signal (HackRF, USRP, bladeRF, and so on.)
- GNU Radio installed
- Modmobmap to perform automatic smartjamming: https://github.com/PentHertz/Modmobmap

## Usage

### Manual jamming

If you have a HackRF or any device compatible with osmocom drivers, you can directly run the code provided in ``GRC/jammer_gen.py`` as follows:

```sh
$ python GRC/jammer_gen.py
```

For those who want to use another device like USRP, edit the GNU Radio block schema ``GRC/jammer_gen.grc``:

```sh
$ gnuradio-companion GRC/jammer_gen.grc
```

Then you can configure the central frequency with the WX GUI to target a frequency. But this tool has also a feature to do it automatically.

### Automatic smartjamming

To automate jamming, you can first get a list of we the [Modmobmap](https://github.com/Synacktiv/Modmobmap) that saves a JSON file after monitoring surrounding cells in a precise location. This JSON file looks as follows:

```sh
$ cat cells_<generated timestamp>.json
{
"****-***50": {
"PCI": "****",
"PLMN": "208-01",
"TAC": "50****",
"band": 3,
"bandwidth": "20MHz",
"eARFCN": 1850,
"type": "4G"
},
"7-***": {
"PLMN": "208-20",
"arfcn": 1018,
"cid": "***",
"type": "2G"
},
"****:-****12": {
"PLMN": "208-1",
"RX": 10712,
"TX": 9762,
"band": 1,
"type": "3G"
},
[...]
}
```

After generating this file containing cells to jam, you can launch the RPC client that communicate with ``GRC/jammer_gen.py`` as follows:

```sh
$ python smartjam_rpcclient.py -f cells_<generated timestamp>.json
```

Then leverage the gain for transmission and you should observe that a lot of noise is overflowing the targeted cells with gaussian noise.

![Jamming session](https://raw.githubusercontent.com/Synacktiv/Modmobjam/master/imgs/jamming_session.png)

Please note that the delay between each targeted cell can be set with a provided arguments '-d' (see arguments helper).
This repository is no longer maintened, please use the following link instead: https://github.com/PentHertz/Modmobjam

0 comments on commit d8bb4e2

Please sign in to comment.