معرفی شرکت ها
beacontools-2.1.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A Python library for working with various types of Bluetooth LE Beacons.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | beacontools-2.1.0 |
| نام | beacontools |
| نسخه کتابخانه | 2.1.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Felix Seele |
| ایمیل نویسنده | fseele@gmail.com |
| آدرس صفحه اصلی | https://github.com/citruz/beacontools |
| آدرس اینترنتی | https://pypi.org/project/beacontools/ |
| مجوز | MIT |
BeaconTools - Universal beacon scanning
=======================================
|PyPI Package| |Build Status| |Coverage Status| |Requirements Status|
A Python library for working with various types of Bluetooth LE Beacons.
Currently supported types are:
* `Eddystone Beacons <https://github.com/google/eddystone/>`__
* `iBeacons <https://developer.apple.com/ibeacon/>`__ (Apple and Cypress CYALKIT-E02)
* `Estimote Beacons (Telemetry and Nearable) <https://github.com/estimote/estimote-specs>`__
* Control-J Monitor (temp/humidity/light)
* `COVID-19 Exposure Notifications <https://www.apple.com/covid19/contacttracing>`__
The BeaconTools library has two main components:
* a parser to extract information from raw binary beacon advertisements
* a scanner which scans for Bluetoth LE advertisements using bluez and can be configured to look only for specific beacons or packet types
Installation
------------
If you only want to use the **parser** install the library using pip and you're good to go:
.. code:: bash
pip3 install beacontools
If you want to perfom beacon **scanning** there are a few more requirements.
First of all, you need a supported OS: currently that's Linux with BlueZ, and FreeBSD.
Second, you need raw socket access (via Linux capabilities, or by running as root).
On a typical Linux installation, it would look like this:
.. code:: bash
# install libbluetooth headers and libpcap2
sudo apt-get install python3-dev libbluetooth-dev libcap2-bin
# grant the python executable permission to access raw socket data
sudo setcap 'cap_net_raw,cap_net_admin+eip' "$(readlink -f "$(which python3)")"
# install beacontools with scanning support
pip3 install beacontools[scan]
Usage
-----
See the `examples <https://github.com/citruz/beacontools/tree/master/examples>`__ directory for more usage examples.
Parser
~~~~~~
.. code:: python
from beacontools import parse_packet
tlm_packet = b"\x02\x01\x06\x03\x03\xaa\xfe\x11\x16\xaa\xfe\x20\x00\x0b\x18\x13\x00\x00\x00" \
b"\x14\x67\x00\x00\x2a\xc4\xe4"
tlm_frame = parse_packet(tlm_packet)
print("Voltage: %d mV" % tlm_frame.voltage)
print("Temperature: %d °C" % tlm_frame.temperature)
print("Advertising count: %d" % tlm_frame.advertising_count)
print("Seconds since boot: %d" % tlm_frame.seconds_since_boot)
Scanner
~~~~~~~
.. code:: python
import time
from beacontools import BeaconScanner, EddystoneTLMFrame, EddystoneFilter
def callback(bt_addr, rssi, packet, additional_info):
print("<%s, %d> %s %s" % (bt_addr, rssi, packet, additional_info))
# scan for all TLM frames of beacons in the namespace "12345678901234678901"
scanner = BeaconScanner(callback,
# remove the following line to see packets from all beacons
device_filter=EddystoneFilter(namespace="12345678901234678901"),
packet_filter=EddystoneTLMFrame
)
scanner.start()
time.sleep(10)
scanner.stop()
.. code:: python
import time
from beacontools import BeaconScanner, IBeaconFilter
def callback(bt_addr, rssi, packet, additional_info):
print("<%s, %d> %s %s" % (bt_addr, rssi, packet, additional_info))
# scan for all iBeacon advertisements from beacons with the specified uuid
scanner = BeaconScanner(callback,
device_filter=IBeaconFilter(uuid="e5b9e3a6-27e2-4c36-a257-7698da5fc140")
)
scanner.start()
time.sleep(5)
scanner.stop()
# scan for all iBeacon advertisements regardless from which beacon
scanner = BeaconScanner(callback,
packet_filter=IBeaconAdvertisement
)
scanner.start()
time.sleep(5)
scanner.stop()
Customizing Scanning Parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Some Bluetooth dongle don't allow scanning in Randomized MAC mode. If you don't receive any scan results, try setting the scan mode to PUBLIC:
.. code:: python
from beacontools import BeaconScanner, BluetoothAddressType
scanner = BeaconScanner(
callback,
scan_parameters={"address_type": BluetoothAddressType.PUBLIC}
)
For all available options see ``Monitor.set_scan_parameters``.
Changelog
---------
Beacontools follows the `semantic versioning <https://semver.org/>`__ scheme.
* 2.1.0
* Added support for extended BLE commands for devices using HCI >= 5.0 (Linux only, thanks to `idaniel86 <https://github.com/idaniel86>`__)
* 2.0.2
* Improved prefiltering of packets, fixes #48
* 2.0.1
* Removed (unused) rfu field from the Eddystone UID packet, fixes #39
* 2.0.0
* Dropped support for Python 2.7 and 3.4
* Added support for COVID-19 Exposure Notifications
* Added support for FreeBSD and fixed temperature parsing (thanks to `myfreeweb <https://github.com/myfreeweb>`__)
* Added support for Control-J Monitor beacons (thanks to `clydebarrow <https://github.com/clydebarrow>`__)
* Added support for Estimote Nearables (thanks to `ShaunPlummer <https://github.com/ShaunPlummer>`__)
* 1.3.1
* Multiple fixes and internal refactorings, including support for Raspberry Pi 3B+ (huge thanks to `cereal <https://github.com/cereal>`__)
* Updated dependencies
* 1.3.0
* Added support for Estimote Telemetry packets (see examples/parser_example.py)
* Relaxed parsing constraints for RFU and flags field
* Added temperature output in 8.8 fixed point decimal format for Eddystone TLM
* 1.2.4
* Added support for Eddystone packets with Flags Data set to 0x1a (thanks to `AndreasTornes <https://github.com/AndreasTornes>`__)
* Updated dependencies
* 1.2.3
* Fixed compatibility with construct >=2.9.41
* 1.2.2
* Moved import of bluez so that the library can be used in parsing-only mode, without having bluez installed.
* 1.2.1
* Updated dependencies
* 1.2.0
* Added support for Cypress iBeacons which transmit temp and humidity embedded in the minor value (thanks to `darkskiez <https://github.com/darkskiez>`__)
* Updated dependencies
* 1.1.0
* Added support for Eddystone EID frames (thanks to `miek <https://github.com/miek>`__)
* Updated dependencies
* 1.0.1
* Implemented a small tweak which reduces the CPU usage.
* 1.0.0
* Implemented iBeacon support
* Added rssi to callback function.
* 0.1.2
* Initial release
.. |PyPI Package| image:: https://badge.fury.io/py/beacontools.svg
:target: https://pypi.python.org/pypi/beacontools/
.. |Build Status| image:: https://travis-ci.org/citruz/beacontools.svg?branch=master
:target: https://travis-ci.org/citruz/beacontools
.. |Coverage Status| image:: https://coveralls.io/repos/github/citruz/beacontools/badge.svg?branch=master
:target: https://coveralls.io/github/citruz/beacontools?branch=master
.. |Requirements Status| image:: https://requires.io/github/citruz/beacontools/requirements.svg?branch=master
:target: https://requires.io/github/citruz/beacontools/requirements/?branch=master
نیازمندی
| مقدار | نام |
|---|---|
| <2.11,>=2.9.52 | construct |
| ==1.6.1 | ahocorapy |
| - | check-manifest |
| ~=2.1 | coveralls |
| ~=6.0 | pytest |
| ~=2.10 | pytest-cov |
| ~=4.0 | mock |
| - | check-manifest |
| - | pylint |
| - | readme-renderer |
| - | docutils |
نحوه نصب
نصب پکیج whl beacontools-2.1.0:
pip install beacontools-2.1.0.whl
نصب پکیج tar.gz beacontools-2.1.0:
pip install beacontools-2.1.0.tar.gz