Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/seemoo-lab/wisec2017_nexmon_jammer
This project contains the nexmon-based source code required to repeat the experiments of our WiSec 2017 paper.
https://github.com/seemoo-lab/wisec2017_nexmon_jammer
Last synced: 8 days ago
JSON representation
This project contains the nexmon-based source code required to repeat the experiments of our WiSec 2017 paper.
- Host: GitHub
- URL: https://github.com/seemoo-lab/wisec2017_nexmon_jammer
- Owner: seemoo-lab
- License: other
- Created: 2017-05-08T09:18:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-09-06T15:54:11.000Z (about 7 years ago)
- Last Synced: 2024-10-29T16:19:10.721Z (15 days ago)
- Language: C
- Size: 79.1 KB
- Stars: 49
- Watchers: 7
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WiSec 2017 Nexmon Jammer
At the 10th ACM Conference on Security and Privacy in Wireless and Mobile Networks (WiSec 2017)
we publish a paper on "Massive Reactive Smartphone-Based Jamming using Arbitrary Waveforms and
Adaptive Power Control". This repository contains source code required to repeat the
experiments we did for our paper. Additionally, it allows fellow researches to base their own
research on our results.
# Extract from our License
Any use of the Software which results in an academic publication or
other publication which includes a bibliography must include
citations to the nexmon project (1) and the paper cited under (2):
1. "Matthias Schulz, Daniel Wegemer and Matthias Hollick. Nexmon:
The C-based Firmware Patching Framework. https://nexmon.org"
2. "Matthias Schulz, Francesco Gringoli, Daniel Steinmetzer, Michael
Koch and Matthias Hollick. Massive Reactive Smartphone-Based
Jamming using Arbitrary Waveforms and Adaptive Power Control.
Proceedings of the 10th ACM Conference on Security and Privacy
in Wireless and Mobile Networks (WiSec 2017), July 2017."
# Getting Started
To compile the source code, you are required to first checkout a copy of the original nexmon
repository that contains our C-based patching framework for Wi-Fi firmwares. That you checkout
this repository as one of the sub-projects in the corresponding patches sub-directory. This
allows you to build and compile all the firmware patches required to repeat our experiments.
The following steps will get you started on Xubuntu 16.04 LTS:
1. Install some dependencies: `sudo apt-get install git gawk qpdf adb`
2. **Only necessary for x86_64 systems**, install i386 libs:
```
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386
```
3. Clone the nexmon base repository: `git clone https://github.com/seemoo-lab/nexmon.git`.
4. Checkout tag 2.2.1 as branch wisec2017: `git checkout tags/2.2.1 -b wisec2017`. Tag 2.2.1 ensures compatibility with this repository.
5. Download and extract Android NDK r11c (use exactly this version!).
6. Export the NDK_ROOT environment variable pointing to the location where you extracted the ndk so that it can be found by our build environment.
7. Navigate to the previously cloned nexmon directory and execute `source setup_env.sh` to set a couple of environment variables.
8. Run `make` to extract ucode, templateram and flashpatches from the original firmwares.
9. Navigate to utilities and run `make` to build all utilities such as nexmon.
10. Attach your rooted Nexus 5 smartphone running stock firmware version 6.0.1 (M4B30Z, Dec 2016).
11. Run `make install` to install all the built utilities on your phone.
12. Navigate to patches/bcm4339/6_37_34_43/ and clone this repository: `git clone https://github.com/seemoo-lab/wisec2017_nexmon_jammer.git`
13. Enter the created subdirectory wisec2017_nexmon_jammer and run `make install-firmware` to compile our firmware patch and install it on the attached Nexus 5 smartphone.
# References
* Matthias Schulz, Francesco Gringoli, Daniel Steinmetzer, Michael Koch and Matthias Hollick. **Massive Reactive Smartphone-Based Jamming using Arbitrary Waveforms and Adaptive Power Control**. Proceedings of the *10th ACM Conference on Security and Privacy in Wireless and Mobile Networks (WiSec 2017)*, July 2017.
* Matthias Schulz, Daniel Wegemer and Matthias Hollick. **Nexmon: The C-based Firmware Patching Framework**. https://nexmon.org
[Get references as bibtex file](https://nexmon.org/bib)
# Contact
* [Matthias Schulz](https://seemoo.tu-darmstadt.de/mschulz)
* [Francesco Gringoli](http://netweb.ing.unibs.it/~gringoli/)
# Powered By
## Secure Mobile Networking Lab (SEEMOO)
## Networked Infrastructureless Cooperation for Emergency Response (NICER)
## Multi-Mechanisms Adaptation for the Future Internet (MAKI)
## Technische Universität Darmstadt
## University of Brescia
