Metadata-Version: 1.2
Name: metawear
Version: 1.0.5
Summary: Python bindings for the MetaWear C++ SDK by MbientLab
Home-page: https://github.com/mbientlab/MetaWear-SDK-Python
Author: MbientLab
Author-email: hello@mbientlab.com
License: UNKNOWN
Description: MetaWear Python SDK
        ###################
        Python SDK for creating MetaWear apps on the Linux platform.  This is a thin wrapper around the `MetaWear C++ API <https://github.com/mbientlab/MetaWear-SDK-Cpp>`_ so you will find the C++ 
        `documentation <https://mbientlab.com/cppdocs/latest/>`_ and `API reference <https://mbientlab.com/docs/metawear/cpp/latest/globals.html>`_ useful.  Also, check out the scripts in the 
        `examples <https://github.com/mbientlab/MetaWear-SDK-Python/tree/master/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 <https://github.com/mbientlab-projects/pymetawear>`_ **.**
        
        Install
        #######
        Use pip to install the metawear package.  It depends on `PyWarble <https://github.com/mbientlab/PyWarble>`_ so ensure your target environment has the necessary `dependencies <https://github.com/mbientlab/Warble#build>`_ installed.  
        
        .. code-block:: bash
        
            pip install metawear
        
        Usage
        #####
        Import the MetaWear class and libmetawear variable from the metawear module and everything from the cbindings module.  
        
        .. code-block:: python
        
            from mbientlab.metawear import MetaWear, libmetawear
            from mbientlab.metawear.cbindings import *
        
        If you do not know the MAC address of your device, use ``PyWarble`` to scan for nearby devices.  
        
        .. code-block:: python
        
            from mbientlab.warble import *
            from mbientlab.metawear import *
            from threading import Event
            
            e = Event()
            address = None
            def device_discover_task(result):
                global address
                if (result.has_service_uuid(MetaWear.GATT_SERVICE)):
                    # grab the first discovered metawear device
                    address = result.mac
                    e.set()
            
            BleScanner.set_handler(device_discover_task)
            BleScanner.start()
            e.wait()
        
            BleScanner.stop()
            
        Once you have the device's MAC address, create a MetaWear object with the MAC address and connect to the device.
        
        .. code-block:: python
        
            device = MetaWear(address)
            device.connect()
        
        Upon a successful connection, you can begin calling any of the functions from the C++ SDK, for example, blinking the LED green.
        
        .. code-block:: python
        
            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)
        
        
Keywords: sensors,mbientlab,metawear,bluetooth le,native
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.4
