3. Python

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 GitHub examples folder for full sample code.

3.1. 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

3.2. 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)