{ "info": { "author": "Jumper Team", "author_email": "info@jumper.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Build Tools" ], "description": "# Jumper BLE Logger\n## Introduction\nThe 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](https://github.com/Jumperr-labs/jumper-ulogger).\n\n## Prerequisites\n**Gateway:**\n\n- Linux based device as a central BLE device\n- Python2.7 and Pip installed\n- LE connection to the BLE peripheral\n\n**Peripherals**\n\n- Jumper's uLogger should be installed\n- BLE - Currently, only GATT protocol is supported.\n\n## Installation\n - Install prerequisits:\n - gatttool (Ubuntu: `sudo apt-get install bluez`)\n - pip (Ubuntu: `sudo apt install python-pip python-dev`)\n - libffi-dev and libssl-dev (Ubuntu: `sudo apt-get install libffi-dev libssl-dev`)\n - Install the logger: `sudo -H pip install jumper-ble-logger`\n\n## Getting Started\nCheck out our [sample project for the Nordic nRF52 development kit](https://github.com/Jumperr-labs/jumper-ulogger/tree/master/samples/nrf52-ble-sample-project).\n\n## Usage\n- Make sure Jumper's Logging Agent is running\n`sudo service jumper-agent start`\n- Modify _\"/etc/jumper_ble_logger/events_config.json\"_ to create new types of events if needed\n- Run `hciconfig` and check your current available HCI devices\n- Start the BLE Logger: `sudo service jumper-ble start`\n- Run `hciconfig` again to see your newly created HCI device\n- 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.\n\n## How it Works\n*If you just want to get started, feel free to skip this step*\n\nWhen the BLE Logger is started, it will connect to your current HCI device (usually \"hci0\") and will create a new \nproxied HCI device (usually \"hci1\") which you will set your gateway program to connect to.\n\nThe new \"hci1\" device can be used just like the original \"hci0\", as all commands and events will transparently pass on to it.\nWhen logging notifications are received from the peripheral, the BLE Logger will send them to Jumper's Logging Agent and will not pass them on to \"hci1\" (gateway program).\n\nThis is the process of how it works (GATT only):\n\n1. The BLE Logger recognizes established LE connections.\n2. When the gateway program is discovering characteristics, the BLE Logger recognizes Jumper's GATT service.\n3. The BLE Logger reads the current timestamp from the device and synchronizes it with the real world time.\n4. The BLE Logger writes to the notifications handle to enable logging notifications.\n5. When a logging notification is being received, the BLE Logger will write it to the Logging Agent.\n\nThe user/gateway program is not being affected by steps 3-4 and they are being filtered out from 'hci1'\n\n## Troubleshooting\nCheck out the following files for logs:\n- /var/log/jumper-ble.err\n- /var/log/jumper-ble.log\n- /var/log/jumper-agent.err\n- /var/log/jumper-agent.log\n\n## Contact Us\nWe are happy to help! Feel free to contact us about any issue and give us your feedback at [info@jumper.io](mailto:info@jumper.io)", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/Jumperr-labs/jumper-ble-logger/archive/0.1.3.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Jumperr-labs/jumper-ble-logger", "keywords": "ble,bluetooth,nrf52,gatt,logging,jumper", "license": "Apache 2.0", "maintainer": null, "maintainer_email": null, "name": "jumper-ble-logger", "package_url": "https://pypi.org/project/jumper-ble-logger/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/jumper-ble-logger/", "project_urls": { "Download": "https://github.com/Jumperr-labs/jumper-ble-logger/archive/0.1.3.tar.gz", "Homepage": "https://github.com/Jumperr-labs/jumper-ble-logger" }, "release_url": "https://pypi.org/project/jumper-ble-logger/0.1.3/", "requires_dist": null, "requires_python": null, "summary": "Jumper GATT proxy for logging BLE traffic", "version": "0.1.3" }, "last_serial": 2943950, "releases": { "0.0.23": [ { "comment_text": "", "digests": { "md5": "2854082e62c3a2db52a37905e7bc9971", "sha256": "e40c5a1e211500c86347d4c68941686dc8e2920cbd94be4e6cbeed914eca5bdb" }, "downloads": -1, "filename": "jumper-ble-logger-0.0.23.tar.gz", "has_sig": false, "md5_digest": "2854082e62c3a2db52a37905e7bc9971", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19624, "upload_time": "2017-06-07T11:36:41", "url": "https://files.pythonhosted.org/packages/8e/f8/e40c8ed1cc36fda1467a0134ade77484b2db8fcaeb61f3541546dd30ba98/jumper-ble-logger-0.0.23.tar.gz" } ], "0.0.24": [ { "comment_text": "", "digests": { "md5": "3f9d4629c6ae8f55e00b03d0df8721d4", "sha256": "f832e408301dc4d9e343a49d134d3a9b6c4ce9713c2c8a75a96f8f8ca6b693a2" }, "downloads": -1, "filename": "jumper-ble-logger-0.0.24.tar.gz", "has_sig": false, "md5_digest": "3f9d4629c6ae8f55e00b03d0df8721d4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20497, "upload_time": "2017-06-07T11:51:40", "url": "https://files.pythonhosted.org/packages/71/b8/a5c89fa8f673825a92c580aab0cb0b214e136194cb307101bbfafa89ffcb/jumper-ble-logger-0.0.24.tar.gz" } ], "0.0.25": [ { "comment_text": "", "digests": { "md5": "aa648b9ed6868437680f7ae4763e4428", "sha256": "46194d164e2853bfe120dcc1b3207a8e6a459b32e3a605075076b91765157a2e" }, "downloads": -1, "filename": "jumper-ble-logger-0.0.25.tar.gz", "has_sig": false, "md5_digest": "aa648b9ed6868437680f7ae4763e4428", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20493, "upload_time": "2017-06-07T12:01:08", "url": "https://files.pythonhosted.org/packages/ae/1e/b74aed63331c76670fc16d1cfa6610fa498e921995c163ec48356562c805/jumper-ble-logger-0.0.25.tar.gz" } ], "0.0.26": [ { "comment_text": "", "digests": { "md5": "230c0606e6f9044502bc5f6fae722da3", "sha256": "1fcc160641821a293ec25848658bbe4cd78f64053532546b8741799b40fbddab" }, "downloads": -1, "filename": "jumper-ble-logger-0.0.26.tar.gz", "has_sig": false, "md5_digest": "230c0606e6f9044502bc5f6fae722da3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20510, "upload_time": "2017-06-07T12:11:13", "url": "https://files.pythonhosted.org/packages/68/a9/80c2210a87e16de93485727bb5ed693179eef01425abd4e29369be29d33e/jumper-ble-logger-0.0.26.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "6be1968d9fd46c720df2baae078d5c76", "sha256": "d1cbb82b9088f4bfe34f8929ebc5cb54d0795bae39e12fa45921db2cc8ab586a" }, "downloads": -1, "filename": "jumper-ble-logger-0.1.1.tar.gz", "has_sig": false, "md5_digest": "6be1968d9fd46c720df2baae078d5c76", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20488, "upload_time": "2017-06-07T12:51:49", "url": "https://files.pythonhosted.org/packages/50/61/50ef2e9333c36f8197ead39f40ce1207a56dfa37c153ffe071c1ba3516be/jumper-ble-logger-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "7ee49dd72985c92394b23327d965c0d1", "sha256": "d7bef196cfff067a82929160535cc5c9c7ab17274bd28bc24ac0430294085902" }, "downloads": -1, "filename": "jumper-ble-logger-0.1.2.tar.gz", "has_sig": false, "md5_digest": "7ee49dd72985c92394b23327d965c0d1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21075, "upload_time": "2017-06-08T13:32:00", "url": "https://files.pythonhosted.org/packages/d6/e2/eb089b55b0007b3ff7ffdf3e4250498bc5732556534a5ea22fd6a39f4a10/jumper-ble-logger-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "44c44b5e009c2e272b441ecdab897876", "sha256": "2500c39fa03d1d771cbd41926bb4d049dd101a6da90d5d7c9ad3f4e2a7b81136" }, "downloads": -1, "filename": "jumper-ble-logger-0.1.3.tar.gz", "has_sig": false, "md5_digest": "44c44b5e009c2e272b441ecdab897876", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21964, "upload_time": "2017-06-12T11:44:15", "url": "https://files.pythonhosted.org/packages/0e/89/1ca091c716d16fb069d7a8c4ecc9fe3ba7f9c580a202a87a73168a4419e4/jumper-ble-logger-0.1.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "44c44b5e009c2e272b441ecdab897876", "sha256": "2500c39fa03d1d771cbd41926bb4d049dd101a6da90d5d7c9ad3f4e2a7b81136" }, "downloads": -1, "filename": "jumper-ble-logger-0.1.3.tar.gz", "has_sig": false, "md5_digest": "44c44b5e009c2e272b441ecdab897876", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21964, "upload_time": "2017-06-12T11:44:15", "url": "https://files.pythonhosted.org/packages/0e/89/1ca091c716d16fb069d7a8c4ecc9fe3ba7f9c580a202a87a73168a4419e4/jumper-ble-logger-0.1.3.tar.gz" } ] }