Skip to content

bertoramos/ble_android_capture_server

Repository files navigation


Logo

BLECS

Bluetooth Low Energy Capture Server is an Android app to capture BLE packets from Android.


View Demo · Report Bug · Request Feature

android oreo 8.1 kotlin 1.5.31 gradle 4.2.2

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Contact


About The Project

Ble capture server is an Android application implemented for capturing BLE packets. BLECS allows to generate a database for the study of indoor positioning systems using Bluetooth Low Energy.

(back to top)

Built With

This project was built with android studio and programmed in Kotlin. This app was tested in an Android Oreo 8.1 device.

Additional frameworks:

(back to top)

Getting Started

Prerequisites

For full access to all BLECS functionalities, the client developed in Blender is required.

Alternatively, you can develop a client following the specifications explained in the paper. Link not yet available.

Installation

This project is currently under development, so an APK is not yet available. You can clone this project and open in Android Studio.

(back to top)

Usage

Bluetooth Low Energy Scanner

Reachable ble devices can be discovered by means of the ble scanner functionality. This function scans and lists all BLE signals received from each device, distinguishing by MAC and/or protocol.

The scanner is switched on by clicking on the magnifying glass button in Scanner tab.

ble scanner

Database creation

Database result of server scanning are saved in a SQLite database. User can select database file name using Create campaign button in Server tab. Database file is saved in app internal storage directory (/Android/com.ips.blecapturer/files/)

input text for database file name

White listing

Whitelisting is a strategy under which app filters BLE devices saved in database.

There are two ways to add a device to the white list: by clicking on the devices found by the BLE scanner, or by adding them manually in the whitelist option in the Server tab. If white list is empty all beacon are allowed.

whitelist button whitelist panel
Press White list button to open white list panel. BLE allowed devices are listed here. You can add, remove or clear list. Also you can save and load white list from a file.

white list with ble scanner utility
You can also add discovered BLE devices to white list.

Server

The server allows commands to be sent remotely to the Android device to capture BLE signals for a given time. These signals are stored in the database and are related to a pose sent by the client.

To start the server, press the on/off toggle button on Server tab.

server start button

Please, refer to client repository for more information about how this application can be used together with Blender client.

Contact

Alberto Ramos Sánchez - [email protected]

(back to top)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages