Jumper BLE Logger

Introduction

The BLE Logger is part of Jumper Insights- a full visibility platform for IoT systems. The BLE Logger is a process that runs on Linux gateways and logs data from BLE devices that are connected to the gateway via BLE and are using the Jumper uLogger.

Prerequisites

Gateway:

• Linux based device as a central BLE device
• Python2.7 and Pip installed
• LE connection to the BLE peripheral

Peripherals

• Jumper's uLogger should be installed
• BLE - Currently, only GATT protocol is supported.

Installation

• Install prerequisits:
  • gatttool (Ubuntu: sudo apt-get install bluez)
  • pip (Ubuntu: sudo apt install python-pip python-dev)
  • libffi-dev and libssl-dev (Ubuntu: sudo apt-get install libffi-dev libssl-dev)
• Install the logger: sudo -H pip install jumper-ble-logger

Getting Started

Check out our sample project for the Nordic nRF52 development kit.

Usage

First Time Usage

• Create a project on Jumper Insight's
• Add you project id and write key to "/etc/jumper_ble_logger/config.json"
• Run hciconfig and check your current available HCI devices
• Start the BLE Logger: sudo service jumper-ble start
• Run hciconfig again to see your newly created HCI device
• Start your gateway program as usual. Make sure to connect to the newly created HCI device. The BLE Logger will start logging as soon as you connect to a peripheral and discover its characteristics.

More Options

• Create new event types by editing "/etc/jumper_ble_logger/events_config.json"
• Stop the service: sudo service jumper-ble stop
• Stop the service: sudo service jumper-ble stop
• Get service status: sudo service jumper-ble status

How it Works

If you just want to get started, feel free to skip this step

When the BLE Logger is started, it will connect to your current HCI device (usually "hci0") and will create a new proxied HCI device (usually "hci1") which you will set your gateway program to connect to.

The new "hci1" device can be used just like the original "hci0", as all commands and events will transparently pass on to it. When logging notifications are received from the peripheral, the BLE Logger will send them to the Jumper Insights cloud system and will not pass them on to "hci1" (gateway program).

This is the process of how it works (GATT only):

1. The BLE Logger recognizes established LE connections.
2. When the gateway program is discovering characteristics, the BLE Logger recognizes Jumper's GATT service.
3. The BLE Logger reads the current timestamp from the device and synchronizes it with the real world time.
4. The BLE Logger writes to the notifications handle to enable logging notifications.
5. When a logging notification is being received, the BLE Logger will write it to the Jumper Insights cloud system.

The user/gateway program is not being affected by steps 3-4 and they are being filtered out from 'hci1'

Troubleshooting

Check out the logs:

• Systemd: journalctl -u jumper-ble
• SysVinit:
  • "/var/log/jumper-ble.err"
  • "/var/log/jumper-ble.log"

Contribute

Feel free to open issues and send us your pull requests.

Contact Us

We are happy to help! Feel free to contact us about any issue and give us your feedback at [email protected]