com.zebra.sdk.btleComm

Class MultichannelBluetoothLeConnection

Object

com.zebra.sdk.comm.MultichannelConnection

com.zebra.sdk.btleComm.MultichannelBluetoothLeConnection

All Implemented Interfaces:

Connection, ConnectionWithWriteLogging

public class MultichannelBluetoothLeConnection
extends MultichannelConnection

Establishes a Bluetooth® Low Energy label and status connection to a printer

package test.zebra.android.comm.examples;
 
 import com.zebra.sdk.btleComm.BluetoothLeConnection;
 import com.zebra.sdk.comm.Connection;
 import com.zebra.sdk.comm.ConnectionException;
 
 import android.app.Activity;
 import android.content.Context;
 import android.os.Bundle;
 
 public class BluetoothLeConnectionExample extends Activity {
 
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
 
         String theBtMacAddress = "00:11:BB:DD:55:FF";
         Context context = getApplicationContext();
         sendZplOverBluetoothLe(theBtMacAddress, context);
     }
 
     private void sendZplOverBluetoothLe(final String theBtMacAddress, final Context context) {
         new Thread(new Runnable() {
             public void run() {
                 Connection thePrinterConn = null;
                 try {
                     // Instantiate connection for given Bluetooth® MAC Address.
                     thePrinterConn = new BluetoothLeConnection(theBtMacAddress, context);
 
                     // Open the connection - physical connection is established here.
                     thePrinterConn.open();
 
                     // This example prints "This is a ZPL test." near the top of the label.
                     String zplData = "^XA^FO20,20^A0N,25,25^FDThis is a ZPL test.^FS^XZ";
 
                     // Send the data to printer as a byte array.
                     thePrinterConn.write(zplData.getBytes());
 
                     // Make sure the data got to the printer before closing the connection
                     Thread.sleep(500);
                 } catch (Exception e) {
                     // Handle communications error here.
                     e.printStackTrace();
                 } finally {
                     // Close the connection to release resources.
                     if (null != thePrinterConn) {
                         try {
                             thePrinterConn.close();
                         } catch (ConnectionException e) {
                             e.printStackTrace();
                         }
                     }
                 }
             }
         }).start();
     }
 
 }

Note: In order to connect to a device with Bluetooth® Low Energy, the device must be discoverable, authentication must be enabled, and the authentication pin must be set (1-16 alphanumeric characters).
The encryption type and whether or not it is used is determined by the device initiating the connection and not device being connected to.

Constructor Summary

Constructors

Constructor and Description
MultichannelBluetoothLeConnection(String macAddress, android.content.Context context) Initializes a new instance of the MultichannelBluetoothLeConnection class.
MultichannelBluetoothLeConnection(String macAddress, int maxTimeoutForRead, int timeToWaitForMoreData, android.content.Context context) Initializes a new instance of the MultichannelBluetoothLeConnection class.
MultichannelBluetoothLeConnection(String macAddress, int printingChannelMaxTimeoutForRead, int printingChannelTimeToWaitForMoreData, int statusChannelMaxTimeoutForRead, int statusChannelTimeToWaitForMoreData, android.content.Context context) Initializes a new instance of the MultichannelBluetoothLeConnection class.

Method Summary

Methods

Modifier and Type	Method and Description
String	getSimpleConnectionName() Return the MAC address as the description.
String	toString() Returns BluetoothLe_MULTI:[MAC Address]:[Friendly Name]. The friendly name is obtained from the device when this connection is opened.

Methods inherited from class com.zebra.sdk.comm.MultichannelConnection

addWriteLogStream, bytesAvailable, close, closePrintingChannel, closeStatusChannel, getConnectionReestablisher, getMaxTimeoutForRead, getPrintingChannel, getStatusChannel, getTimeToWaitForMoreData, isConnected, open, openPrintingChannel, openStatusChannel, read, read, readChar, sendAndWaitForResponse, sendAndWaitForResponse, sendAndWaitForValidResponse, sendAndWaitForValidResponse, setMaxTimeoutForRead, setTimeToWaitForMoreData, waitForData, write, write, write

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MultichannelBluetoothLeConnection

public MultichannelBluetoothLeConnection(String macAddress,
                                 android.content.Context context)

Initializes a new instance of the MultichannelBluetoothLeConnection class. This constructor will use the default timeouts for com.zebra.sdk.comm.Connection.read(). The default timeout is a maximum of 5 seconds for any data to be received. If no more data is available after 500 milliseconds the read operation is assumed to be complete.
To specify timeouts other than the defaults, use:
MultichannelBluetoothLeConnection(String, int, int, Context) or MultichannelBluetoothLeConnection(String, int, int, int, int, Context).

Parameters:

macAddress - the device's MAC address.

context - Android™ application context.

MultichannelBluetoothLeConnection

public MultichannelBluetoothLeConnection(String macAddress,
                                 int maxTimeoutForRead,
                                 int timeToWaitForMoreData,
                                 android.content.Context context)

Initializes a new instance of the MultichannelBluetoothLeConnection class. This constructor will use the specified timeouts for com.zebra.sdk.comm.Connection.read() for both channels. The timeout is a maximum of maxTimeoutForRead milliseconds for any data to be received. If no more data is available after timeToWaitForMoreData milliseconds the read operation is assumed to be complete. If you wish to specify different timeouts for each channel, use MultichannelBluetoothLeConnection(String, int, int, int, int, Context).

Parameters:

macAddress - the device's MAC address.

context - Android™ application context.

maxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received.

timeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read.

MultichannelBluetoothLeConnection

public MultichannelBluetoothLeConnection(String macAddress,
                                 int printingChannelMaxTimeoutForRead,
                                 int printingChannelTimeToWaitForMoreData,
                                 int statusChannelMaxTimeoutForRead,
                                 int statusChannelTimeToWaitForMoreData,
                                 android.content.Context context)

Initializes a new instance of the MultichannelBluetoothLeConnection class. This constructor will use the specified timeouts for com.zebra.sdk.comm.Connection.read() for the channels. The timeout is a maximum of printingChannelMaxTimeoutForRead/statusChannelMaxTimeoutForRead milliseconds for any data to be received on the printing/status channels respectively. If no more data is available after printingChannelTimeToWaitForMoreData/statusChannelTimeToWaitForMoreData milliseconds on the printing/status channels respectively the read operation is assumed to be complete.

Parameters:

macAddress - the device's MAC address.

context - Android™ application context.

printingChannelMaxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received on the printing channel.

printingChannelTimeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read on the printing channel.

statusChannelMaxTimeoutForRead - the maximum time, in milliseconds, to wait for any data to be received on the status channel.

statusChannelTimeToWaitForMoreData - the maximum time, in milliseconds, to wait in-between reads after the initial read on the status channel.

Method Detail

toString

public String toString()

Returns BluetoothLe_MULTI:[MAC Address]:[Friendly Name].
The friendly name is obtained from the device when this connection is opened. If the friendly name changes on the device, it will not be refreshed until the connection is closed and reopened.

Specified by:

toString in interface Connection

Overrides:

toString in class Object

Returns:

the connection description string.

See Also:

Connection.toString()

getSimpleConnectionName

public String getSimpleConnectionName()

Return the MAC address as the description.

Returns:

a human-readable description of the connection.

See Also:

Connection.getSimpleConnectionName()