pymetawear 0.5.2

PyMetaWear

Python package for connecting to and using MbientLab’s MetaWear boards.

PyMetawear is meant to be a thin wrapper around the MetaWear C++ API, providing a more Pythonic interface. It has support for several different Python packages for Bluetooth Low Energy communication:

• pygatt

• pybluez with gattlib

• bluepy (not completely functional yet)

PyMetaWear can be run with Python 2 or 3 with both backends, but only with the pygatt backend for Python 3.5. It builds and runs on Linux systems, and can be built on Windows, given that Visual Studio Community 2015 has been installed first, but there is no working backend for Windows BLE yet.

$ pip install pymetawear

$ pip install pymetawear[pybluez]

$ pip install pymetawear[bluepy]

$ python setup.py build

$ pip install -e .

from pymetawear.client import MetaWearClient
backend = 'pygatt'  # Or 'pybluez' or 'bluepy'
c = MetaWearClient('DD:3A:7D:4D:56:F0', backend)

pattern = c.led.load_preset_pattern('blink', repeat_count=10)
c.led.write_pattern(pattern, 'g')
c.led.play()

from ctypes import byref
from pymetawear import libmetawear
from pymetawear.mbientlab.metawear.peripheral import Led

pattern = Led.Pattern(repeat_count=10)
libmetawear.mbl_mw_led_load_preset_pattern(byref(pattern), Led.PRESET_BLINK)
libmetawear.mbl_mw_led_write_pattern(c.board, byref(pattern), Led.COLOR_GREEN)
libmetawear.mbl_mw_led_play(c.board)

from pymetawear.client import discover_devices
out = discover_devices()
print out
[(u'DD:3A:7D:4D:56:F0', u'MetaWear'), (u'FF:50:35:82:3B:5A', u'MetaWear')]

v0.5.2 (2016-10-13)

• Temperature Module

• Using Pygatt 3.0.0 (including PR from PyMetaWear contributors)

• Builds on Windows

v0.5.1 (2016-09-15)

• Corrections to make it distributable via PyPI.

v0.5.0 (2016-09-15)

• Using MetaWear-CppAPI version 0.5.22

• Changed building procedure to handle ARM processors

• Updated requirements to make pygatt default, all others extras

• Bluepy backend implemented and partially working

• BL interface selection for all backends

• Magnetometer module

• Barometer module

• Ambient Light module

• Modifying notification wrappers to accommodate Epoch value in the data.

• High speed sampling for accelerometer and gyroscope

v0.4.4 (2016-04-28)

• Updated MetaWear-CppAPI submodule version.

• Removed temporary build workaround.

v0.4.3 (2016-04-27)

• Critical fix for switch notifications.

• Updated MetaWear-CppAPI submodule version.

• Now using the new setup_metawear method.

• Restructured the IS_64_BIT usage which is still needed.

v0.4.2 (2016-04-27)

• Critical fix for timeout in pybluez/gattlib backend.

• Added Gyroscope module.

• Added soft reset method to client.

• Updated examples.

• Updated documentation.

v0.4.1 (2016-04-20)

• Cleanup of new modules sensor data parsing.

• Bug fix related to accelerometer module.

• Timeout parameter for client and backends.

v0.4.0 (2016-04-17)

• Major refactorisation into new module layout.

• New examples using the new module handling.

• Accelerometer convenience methods shows strange lag still.

v0.3.1 (2016-04-10)

• Critical fix for data signal subscription method.

• Setup.py handling of building made better,

• Documentation improved.

v0.3.0 (2016-04-09)

• Major refactoring: all BLE comm code practically moved to backends.

• Backend pybluez with gattlib now works well.

• Travis CI problems with Python 2.7 encoding led to that we are now building on 2.7.11

v0.2.3 (2016-04-07)

• Changed from using gattlib on its own to using pybluez with gattlib

• Travis CI and Coveralls

• Travis CI deploys documentation to gh-pages.

• Some documentation written.

v0.2.2 (2016-04-06)

• Convenience method for switch.

• Sphinx documentation added.

• Docstring updates.

v0.2.1 (2016-04-04)

• Refactoring in moving functionality back to client from backends.

• Enable BlueZ 4.X use with pygatt.

• Disconnect methods added.

• Example with switch button notification.

v0.2.0 (2016-04-02)

• Two backends: pygatt and gattlib

• pygatt backend can be fully initialize, i.e. handles notifications.

• gattlib backend cannot fully initialize, i.e. does not handles notifications.

v0.1.1 (2016-03-30)

• Fix to support Python 3

v0.1.0 (2016-03-30)

• Initial release

• Working communication, tested with very few API options.