PIR – BLE Frequency Analyzer

IDS: Code analyzing BLE advertising emissions frequency of surrounding objects
See Releases »

Research Paper · Test Results · See Global Usage

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
   • Execution
4. Tree Structure
5. Credits
6. Contact

---

About The Project

This code will be used in order to study the different ways to detect BLE attacks.

Built With

• Python

Getting Started

Prerequisites

• Install the latest version of pyenv (https://github.com/pyenv/pyenv-installer [ UNIX ], https://pyenv-win.github.io/pyenv-win/ [ WINDOWS ]) or update it with the following command:

  pyenv update

• Install the latest version of pipenv (https://pipenv.pypa.io/) or update it with the following command:

  pip install pipenv --upgrade

Installation

1. Clone the project

   git clone https://github.com/PIR-IDS/ble-frequency-analyzer.git

2. Install the dependencies by typing the following command while being in the project root:

   pipenv install --dev

⚠️ If you are using pyenv-win (WINDOWS) : If you do not have the version of Python used in the project, it is possible that pipenv does not detect pyenv, preventing you from using it directly. To solve this problem, first install the desired version pyenv install 3.10.0 and then instead of the above command use this one: pipenv --python %USERPROFILE%\.pyenv\pyenv-win\versions\3.10.0\python.exe install --dev

3. The project is now ready to run.

Usage

The user can employ the four functions to obtains different informations from <file_to_read> situated in the <folder>.

The function calcul_frequency return the BLE advertising emissions frequency of an object based on it <mac_address>.

The function rssi_analyse return the rssi of a BLE object at each advertising emission based on it <mac_address>.

Execution

To use the functions, it is needed to modify the file using print.
To execute the file, run the following instructions:

pipenv run run 

Tree Structure

TODO

Credits

Amélie Muller [ GitHub ] – Co-developer

Contact

Project Link : https://github.com/PIR-IDS/ble-frequency-analyzer

Organization Link : https://github.com/PIR-IDS