com.mbientlab.metawear.api

Class MetaWearBleService

java.lang.Object

Service

com.mbientlab.metawear.api.MetaWearBleService

public class MetaWearBleService
extends Service

Service for maintaining the Bluetooth GATT connection to the MetaWear board

Author:

Eric Tsai

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	MetaWearBleService.LocalBinder Dummy class for getting the MetaWear BLE service from its binder

Constructor Summary

Constructors

Constructor and Description
MetaWearBleService()

Method Summary

Methods

Modifier and Type	Method and Description
void	clearLocalBroadcastManager() Clears the stored local broadcast manager, which reverts to using the Service's intent broadcaster
void	close() Deprecated. As of v1.3. Use MetaWearController.close(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)
void	close(boolean notify) Deprecated. As of v1.3. Use MetaWearController.close(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)
void	connect(BluetoothDevice metaWearBoard) Deprecated. As of v1.3. Use MetaWearController.connect() and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)
void	disconnect() Deprecated. As of v1.3. Use MetaWearController.close(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)
static BroadcastReceiver	getMetaWearBroadcastReceiver() Get the broadcast receiver for MetaWear intents.
MetaWearController	getMetaWearController() Deprecated. As of v1.3. Use getMetaWearController(BluetoothDevice) instead
MetaWearController	getMetaWearController(BluetoothDevice mwBoard) Gets a controller for a specific MetaWear board.
static IntentFilter	getMetaWearIntentFilter() Get the IntentFilter for actions broadcasted by the MetaWear service
IBinder	onBind(Intent intent)
void	onDestroy()
void	reconnect() Deprecated. As of v1.3. Use MetaWearController.reconnect(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)
void	useLocalBroadcasterManager(boolean useFlag) Deprecated. As of v1.4, use clearLocalBroadcastManager() and useLocalBroadcastManager(LocalBroadcastManager) instead
void	useLocalBroadcastManager(LocalBroadcastManager localBroadcastMngr) Has the service broadcast intents with a android.support.v4.content.LocalBroadcastManager

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MetaWearBleService

public MetaWearBleService()

Method Detail

getMetaWearIntentFilter

public static IntentFilter getMetaWearIntentFilter()

Get the IntentFilter for actions broadcasted by the MetaWear service

Returns:

IntentFilter for MetaWear specific actions

See Also:

MetaWearController.ModuleCallbacks, MetaWearController.DeviceCallbacks

getMetaWearBroadcastReceiver

public static BroadcastReceiver getMetaWearBroadcastReceiver()

Get the broadcast receiver for MetaWear intents. An Activity using the MetaWear service will need to register this receiver to trigger its callback functions.

Returns:

MetaWear specific broadcast receiver

getMetaWearController

@Deprecated
public MetaWearController getMetaWearController()

Deprecated. As of v1.3. Use getMetaWearController(BluetoothDevice) instead

Gets a controller for the MetaWear board, in single MetaWear mode. The MetaWearController returned does not support the MetaWearController.connect(), MetaWearController.close(boolean), and MetaWearController.reconnect(boolean) functions. You will need to use the deprecated variants of those functions to modify the connection state.

Returns:

MetaWear controller, in single MetaWear mode, to interact with the board

getMetaWearController

public MetaWearController getMetaWearController(BluetoothDevice mwBoard)

Gets a controller for a specific MetaWear board. Modifying connection state must be done with the MetaWearController.connect(), MetaWearController.close(boolean), and MetaWearController.reconnect(boolean) functions rather than their deprecated variants

Parameters:

mwBoard - MetaWear board to interact with

Returns:

Controller attached to the specific board

useLocalBroadcasterManager

@Deprecated
public void useLocalBroadcasterManager(boolean useFlag)

Deprecated. As of v1.4, use clearLocalBroadcastManager() and useLocalBroadcastManager(LocalBroadcastManager) instead

Set how intents are broadcasted from the service. Default behaviour is to broadcast to all receivers

Parameters:

useFlag - True if android.support.v4.content.LocalBroadcastManager should be used to broadcast intents

clearLocalBroadcastManager

public void clearLocalBroadcastManager()

Clears the stored local broadcast manager, which reverts to using the Service's intent broadcaster

useLocalBroadcastManager

public void useLocalBroadcastManager(LocalBroadcastManager localBroadcastMngr)

Has the service broadcast intents with a android.support.v4.content.LocalBroadcastManager

Parameters:

localBroadcastMngr - Local broadcast manager to use

connect

@Deprecated
public void connect(BluetoothDevice metaWearBoard)

Deprecated. As of v1.3. Use MetaWearController.connect() and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)

Connect to the GATT service on the MetaWear device. This version of the function is for the old single MetaWear mode.

Parameters:

metaWearBoard - MetaWear board to connect to

reconnect

@Deprecated
public void reconnect()

Deprecated. As of v1.3. Use MetaWearController.reconnect(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)

Restarts the connection to a board. This version of the function is for the old single MetaWear mode.

disconnect

@Deprecated
public void disconnect()

Deprecated. As of v1.3. Use MetaWearController.close(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)

Disconnects from the board. This version of the function is for the old single MetaWear mode.

close

@Deprecated
public void close(boolean notify)

Deprecated. As of v1.3. Use MetaWearController.close(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)

Close the GATT service and free up resources. This version of the function is for single MetaWear mode.

Parameters:

notify - True if the MetaWearController.DeviceCallbacks.disconnected() function should be called

close

public void close()

Deprecated. As of v1.3. Use MetaWearController.close(boolean) and retrieve a MetaWearController with getMetaWearController(BluetoothDevice)

Close the GATT service and free up resources. This version of the function is for single MetaWear mode.

onBind

public IBinder onBind(Intent intent)

onDestroy

public void onDestroy()