跳转到主要内容

连接到MbientLab的MetaWear板卡的Python客户端

项目描述

https://img.shields.io/pypi/v/pymetawear PyPI - License https://dev.azure.com/hbldh/github/_apis/build/status/hbldh.pymetawear?branchName=master https://coveralls.io/repos/github/hbldh/pymetawear/badge.svg?branch=master

PyMetaWear是由 Henrik Blidh 发起的一个社区开发的Python SDK。MbientLab不为此SDK提供支持。

用于连接和使用MbientLab的MetaWear板卡的Python包。

从0.11.0版本开始,PyMetaWear可以在Windows和Linux上使用。这要归功于现在metawear包依赖一个新的BLE库,称为PyWarble,而不是gattlib。有关如何在Windows上构建的详细信息,请参阅安装说明。

功能和限制

PyMetaWear之前是MetaWear C++ API的包装器,提供了一个更Pythonic的接口。在0.9.0版本中,它变成了MetaWear官方Python SDK的包装器,执行完全相同的事情。官方SDK处理实际的板卡连接和通信,而PyMetaWear旨在消除与MetaWear板卡交互的低级感觉。

安装

$ pip install pymetawear

从0.11.0版本开始,pymetawear的安装要求已更改。有关Linux和Windows的要求,请参阅文档

文档

可在此存储库的Github页面上找到。

基本用法

MetaWear客户端可以用两种方式使用:要么作为处理MetaWear板卡的Pythonic便利类,要么作为受libmetawear C++库控制的简单通信客户端。

创建客户端,因此设置与MetaWear板之间的蓝牙连接,对于两个使用配置文件来说都是一样的。

from pymetawear.client import MetaWearClient
c = MetaWearClient('DD:3A:7D:4D:56:F0')

示例

使用便利方法闪烁LED灯可以这样做:

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

或者使用原始的 libmetawear 共享库这样做:

from ctypes import byref
from pymetawear import libmetawear
from mbientlab.metawear.cbindings import LedColor, LedPreset

pattern = Led.Pattern(repeat_count=10)
libmetawear.mbl_mw_led_load_preset_pattern(byref(pattern), LedPreset.BLINK)
libmetawear.mbl_mw_led_write_pattern(c.board, byref(pattern), LedColor.GREEN)
libmetawear.mbl_mw_led_play(c.board)

蓝牙低能耗扫描

您可以通过使用包含的 discover_devices 方法扫描来找到MetaWear板的实际地址。

from pymetawear.discover 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')]

请参阅示例文件夹,了解更多如何使用此客户端的 libmetawear 库的示例。

模块

PyMetaWear客户端可以用来使用MetaWear C++ API的所有功能,并且为简化使用添加了一些模块的便利方法。以下是一个已编写便利方法的模块列表和一个等待关注的模块列表。

已完成模块

未实现模块

加速度计

GPIO

陀螺仪

NeoPixel

触觉

颜色检测器

开关

湿度

LED

iBeacon

气压计

I2C

磁力计

温度

设置

环境光

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分布

pymetawear-0.12.0.tar.gz (45.8 kB 查看哈希值)

上传时间

构建分布

pymetawear-0.12.0-py3-none-any.whl (37.9 kB 查看哈希值)

上传时间 Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面