/MetaWear-SDK-Python

MetaWear Python SDK for Raspberry Pi by MBIENTLAB

Primary LanguagePythonOtherNOASSERTION

MetaWear Python SDK

Python SDK for creating MetaWear apps on the Linux platform. This is a thin wrapper around the MetaWear C++ API so you will find the C++ documentation and API reference useful. Also, check out the scripts in the examples folder for full sample code.

This is not the pymetawear package. That is a community developed Python SDK which you can find over here .

Install

Use pip to install the metawear package. It depends on pygattlib so ensure your Linux environment first has the necessary dependencies installed.

pip install metawear --process-dependency-links

Usage

Import the MetaWear class and libmetawear variable from the metawear module and everything from the cbindings module.

from mbientlab.metawear import MetaWear, libmetawear
from mbientlab.metawear.cbindings import *

If you do not know the MAC address of your device, use pygattlib to scan for nearby devices.

from gattlib import DiscoveryService
service = DiscoveryService("hci0")
devices = service.discover(2)

# grab the first scanned device
address = devices.items()[0][0]

Once you have the device's MAC address, create a MetaWear object with the MAC address and connect to the device.

device = MetaWear(address)
status = device.connect()

Upon a successful connection, you can begin calling any of the functions from the C++ SDK, for example, blinking the LED green.

pattern= LedPattern(repeat_count= Const.LED_REPEAT_INDEFINITELY)
libmetawear.mbl_mw_led_load_preset_pattern(byref(pattern), LedPreset.BLINK)
libmetawear.mbl_mw_led_write_pattern(device.board, byref(pattern), LedColor.GREEN)
libmetawear.mbl_mw_led_play(device.board)