Click or drag to resize

BluetoothStatusConnection Class

Establishes a Bluetooth® status only connection to a Link-OS printer. (Windows 10 only)
Inheritance Hierarchy

Namespace:  Zebra.Sdk.Comm
Assembly:  SdkApi_Desktop (in SdkApi_Desktop.dll) Version: 2.14.1869
Syntax
public class BluetoothStatusConnection : ConnectionStatusA

The BluetoothStatusConnection type exposes the following members.

Constructors
  NameDescription
Public methodBluetoothStatusConnection(String)
Constructs a new Bluetooth® connection with the given macAddress.
Public methodBluetoothStatusConnection(String, Int32, Int32)
Constructs a new status only Bluetooth® connection with the given macAddress and timeout values.
Top
Properties
  NameDescription
Public propertyConnected
Returns true if the connection is open.
(Inherited from ConnectionA.)
Public propertyFriendlyName
Returns the friendly name of the Bluetooth® connection.
Public propertyMACAddress
Returns the MAC address which was passed into the constructor.
Public propertyManufacturer
See the classes which implement this property for the format of the printer manufacturer string.
(Inherited from ConnectionA.)
Public propertyMaxDataToWrite
Gets or sets the maximum number of bytes to write at one time
(Inherited from ConnectionA.)
Public propertyMaxTimeoutForRead
Gets or sets the maximum time, in milliseconds, to wait for any data to be received.
(Inherited from ConnectionA.)
Public propertySimpleConnectionName
Return the MAC address and friendly name of the status port as the description.
(Overrides ConnectionASimpleConnectionName.)
Public propertyTimeToWaitForMoreData
Gets or sets the maximum time, in milliseconds, to wait in-between reads after the initial read.
(Inherited from ConnectionA.)
Top
Methods
  NameDescription
Public methodAddWriteLogStream
Sets the stream to log the write data to.
(Inherited from ConnectionA.)
Public methodBytesAvailable
Returns an estimate of the number of bytes that can be read from this connection without blocking.
(Overrides ConnectionABytesAvailable.)
Public methodClose
Closes the Bluetooth® connection.
(Overrides ConnectionAClose.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodGetConnectionReestablisher
Returns a ConnectionReestablisher which allows for easy recreation of a connection which may have been closed.
(Inherited from ConnectionA.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodOpen
Opens a status only Bluetooth® connection as specified in the constructor.
(Overrides ConnectionAOpen.)
Public methodRead
Reads all the available data from the connection. This call is non-blocking.
(Inherited from ConnectionA.)
Public methodRead(Int32)
Reads maxBytesToRead of the available data from the connection.
(Overrides ConnectionARead(Int32).)
Public methodRead(BinaryWriter)
Reads all the available data from the connection.
(Inherited from ConnectionA.)
Public methodRead(Int32, Boolean)
Reads maxBytesToRead of the available data from the connection.
(Inherited from ConnectionA.)
Public methodReadChar
Reads the next byte of data from the connection.
(Overrides ConnectionAReadChar.)
Public methodSendAndWaitForResponse(Byte, Int32, Int32, String)
Sends dataToSend and returns the response data.
(Inherited from ConnectionA.)
Public methodSendAndWaitForResponse(BinaryWriter, BinaryReader, Int32, Int32, String)
Sends data from sourceStream and writes the response data to destinationStream.
(Inherited from ConnectionA.)
Public methodSendAndWaitForValidResponse(Byte, Int32, Int32, ResponseValidator)
Sends dataToSend and returns the response data.
(Inherited from ConnectionA.)
Public methodSendAndWaitForValidResponse(BinaryWriter, BinaryReader, Int32, Int32, ResponseValidator)
Sends data from sourceStream and writes the response data to destinationStream.
(Inherited from ConnectionA.)
Public methodSetReadTimeout
Sets the underlying read timeout value.
(Inherited from ConnectionA.)
Public methodToString
Returns Bluetooth_STATUS:[MAC Address]:[Friendly Name].
(Overrides ConnectionAToString.)
Public methodWaitForData
Causes the currently executing thread to sleep until BytesAvailable > 0, or for a maximum of maxTimeout milliseconds.
(Inherited from ConnectionA.)
Public methodWrite(Byte)
Writes data.Length bytes from the specified byte array to this output stream.
(Inherited from ConnectionA.)
Public methodWrite(BinaryReader)
Writes all available bytes from the data source to this output stream.
(Inherited from ConnectionA.)
Public methodWrite(Byte, Int32, Int32)
Writes length bytes from data starting at offset.
(Inherited from ConnectionA.)
Top
Remarks
A BluetoothConnection must be actively open before this connection can be used.
This connection requires Link-OS firmware 2.5 or higher. This channel will not block the printing channel, nor can it print. If you wish to print, see BluetoothConnection.
Note: In order to connect to a device with Bluetooth®, 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 the device being connected to.
Examples
using System;
using Zebra.Sdk.Comm;
using Zebra.Sdk.Printer;

public class BluetoothStatusConnectionExample {

    public static void Main(string[] args) {
        BluetoothStatusConnectionExample example = new BluetoothStatusConnectionExample();

        string theBtMacAddress = "00:11:BB:DD:55:FF";
        example.SendJSONOverStatusChannel(theBtMacAddress);
    }

    private void SendJSONOverStatusChannel(string theBtMacAddress) {
        Connection printConn = null;
        Connection statusConn = null;
        try {
            // The printing channel must be opened before the status channel.
            // Instantiate a printing connection for given Bluetooth® MAC Address.
            printConn = new BluetoothConnection(theBtMacAddress);

            // Open the connection - physical connection is established here.
            printConn.Open();

            // Instantiate a status connection for given Bluetooth® MAC Address.
            statusConn = new BluetoothStatusConnection(theBtMacAddress);

            // Open the connection - physical connection is established here.
            statusConn.Open();

            // This sends down JSON to the status channel to retrieve the 'appl.name' setting
            string firmwareVersion = SGD.GET("appl.name", statusConn);

            Console.WriteLine($"The firmware version is: {firmwareVersion}");
        } catch (Exception e) {
            // Handle communications error here.
            Console.WriteLine(e.ToString());
        } finally {
            // Close the connections to release resources.
            if (statusConn != null) {
                statusConn.Close();
            }

            if (printConn != null) {
                printConn.Close();
            }
        }
    }
}
See Also