UniPRT.Sdk.Comm.BTClassicConnection Class Reference

Class that implements the Bluetooth Classic specific communication and extends the AComm class. More...

Inheritance diagram for UniPRT.Sdk.Comm.BTClassicConnection:

Public Member Functions
	BTClassicConnection (long macAddress)
	Initialize new class instance based on macAddress. Bluetooth pairing with the printer is required before connecting. More...
	BTClassicConnection (string descriptor)
	Initialize new class instance based on descriptor string. More...
override void	Close ()
	Closes a connection.
override void	Open ()
	Opens a connection.
override byte[]	Read ()
	Read all bytes available.
virtual void	Read (BinaryWriter binDataIn)
	Reads all bytes available into the stream passed in.
virtual void	WaitForData (int msTimeOut)
	Waits until data available BytesAvailable in current thread. Current thread sleeps until data received or timeout reached. Blocking call. More...
virtual void	Write (BinaryReader binReader)
	Write from input stream to output stream More...
override void	Write (byte[] dataOut)
	Writes all bytes from the array passed in.
virtual void	WriteAndWaitForResponse (BinaryWriter binDataIn, BinaryReader binDataOut, int responseStartTimeOut, int responseEndTimeOut, string completetionToken)
	Write binDataOut stream data to output stream and return data received in binDataIn stream. Data returned is any data received or up to completion token if received. Wait for response timeout before returning. More...
virtual byte[]	WriteAndWaitForResponse (byte[] dataOut, int responseStartTimeOut, int responseEndTimeOut, string completetionToken)
	Write byte data to output stream and return data received. Data returned is any data received or up to completion token if received. Wait for response timeout before returning. More...

Static Public Member Functions
static long	DescriptorValidate (string descriptorHint)
	Validate descriptor string from descriptorHint that may or may not have a v_id and p_id. Returns tuple. More...

Public Attributes
override string	Descriptor => $"BT:MAC Address:{_bt_address.ToString("X12")}"
	Returns a string description of the connection. Format: "BT:MAC Address:_bt_mac" e.g. "BT:MAC Address:0080A3123456". More...

Properties
override int	BytesAvailable [get]
override bool	Connected [get]

Detailed Description

Class that implements the Bluetooth Classic specific communication and extends the AComm class.

Examples

using System;
using System.IO;
using System.Text;
using UniPRT.Sdk.Comm;  // imports SDK namespace
 
namespace Snippets
{
    class MyComm
    {
        public static void MainComm(string[] args)
        {
            SendPrintFile();     // send file over BT Classic
            SendPrintString();   // send print data over BT Classic           
        }
 
        public static void SendPrintFile()  // send file over usb
        {
            string fileName = @"C:\testFiles\Hello.pgl";
            BTClassicConnection BTClassicComm = new BTClassicConnection(0x8CDE5294F30F);
            try
            {
                BTClassicComm.Open();
                if (File.Exists(fileName))
                {
                    using (BinaryReader binReader = new BinaryReader(File.Open(fileName, FileMode.Open)))
                    {
                        Console.WriteLine($"Sending \"{fileName}\" to printer");
                        BTClassicComm.Write(binReader);
                    }
                }
                else
                {
                    Console.WriteLine($"File \"{fileName}\" not found");
                }
            }
            catch (Exception e)
            {
                Console.WriteLine($"Exception Msg: {e.Message}");
            }
 
            finally
            {
                BTClassicComm.Close();
            }
        }
 
 
        public static void SendPrintString()    // send print data over BT Classic
        {
            string dataToPrint =
@"~CREATE;C39;72
    SCALE;DOT
    PAGE;30;40
    ALPHA
    C10;1;33;0;0;@HELLO@
    C16;54;37;0;0;@*World*@
    STOP
    BARCODE
    C128C;XRD3:3:6:6:9:9:12:12;H6;10;32
    @World@
    STOP
    END
    ~EXECUTE;C39
    ~NORMAL
 
    ";
 
            BTClassicConnection BTClassicComm = new BTClassicConnection(0x8CDE5294F30F);
            try
            {
                BTClassicComm.Open();
 
                if (BTClassicComm.Connected)
                {
                    //byte[] outBytes = Encoding.UTF8.GetBytes(dataToPrint);
                    byte[] outBytes = Encoding.ASCII.GetBytes(dataToPrint);
                    BTClassicComm.Write(outBytes);
                }
                else
                {
                    Console.WriteLine($"Not connected to printer");
                }
            }
            catch (Exception e)
            {
                Console.WriteLine($"Exception Msg: {e.Message}");
            }
 
            finally
            {
                BTClassicComm.Close();
            }
        }
    }
}

Constructor & Destructor Documentation

BTClassicConnection() [1/2]

UniPRT.Sdk.Comm.BTClassicConnection.BTClassicConnection

(

string

descriptor

)

Initialize new class instance based on descriptor string.

Parameters

[in]

descriptor

Acceptable Formats: "BT:MAC Address:<_bt_mac>" _bt_mac is hexadecimal Stringb>. e.g. MAC Address:0080A3123456

BTClassicConnection() [2/2]

UniPRT.Sdk.Comm.BTClassicConnection.BTClassicConnection

(

long

macAddress

)

Initialize new class instance based on macAddress. Bluetooth pairing with the printer is required before connecting.

Parameters

[in]

macAddress

Specify the printer to be connected via the Bluetooth MAC address of the printer. e.g. 0x0080A3123456

Member Function Documentation

DescriptorValidate()

static long UniPRT.Sdk.Comm.BTClassicConnection.DescriptorValidate ( string  descriptorHint )

static

Validate descriptor string from descriptorHint that may or may not have a v_id and p_id. Returns tuple.

descriptorHint accepted values:

• "BT:MAC Address:<_bt_mac>"
  • _bt_mac is hexadecimal Stringb>. e.g. MAC Address:0080A3123456

WaitForData()

virtual void UniPRT.Sdk.Comm.AComm.WaitForData ( int  msTimeOut )

virtualinherited

Waits until data available BytesAvailable in current thread. Current thread sleeps until data received or timeout reached. Blocking call.

Parameters

[in]

msTimeOut

Millisecond timeout before return if no data received.

Implements UniPRT.Sdk.Comm.IComm.

Write()

virtual void UniPRT.Sdk.Comm.AComm.Write ( BinaryReader  binReader )

virtualinherited

Write from input stream to output stream

Parameters

[in]

binReader

Source data to send

Implements UniPRT.Sdk.Comm.IComm.

WriteAndWaitForResponse() [1/2]

virtual void UniPRT.Sdk.Comm.AComm.WriteAndWaitForResponse ( BinaryWriter  binDataIn, BinaryReader  binDataOut, int  responseStartTimeOut, int  responseEndTimeOut, string  completetionToken  )

virtualinherited

Write binDataOut stream data to output stream and return data received in binDataIn stream. Data returned is any data received or up to completion token if received. Wait for response timeout before returning.

Parameters

[out]	binDataIn	Destination stream to store response received from connection.
[in]	binDataOut	Source stream data to write to connection.
[in]	responseStartTimeOut	Timeout, milliseconds, to wait for first data to be received. Time to first byte.
[in]	responseEndTimeOut	Timeout, milliseconds, of no new data received. Time after last byte.
[in]	completetionToken	String token denoting the end of the response expected. This can be empty string if simply want to wait for response after writing data to connection.

Implements UniPRT.Sdk.Comm.IComm.

WriteAndWaitForResponse() [2/2]

virtual byte [] UniPRT.Sdk.Comm.AComm.WriteAndWaitForResponse ( byte[]  dataOut, int  responseStartTimeOut, int  responseEndTimeOut, string  completetionToken  )

virtualinherited

Write byte data to output stream and return data received. Data returned is any data received or up to completion token if received. Wait for response timeout before returning.

Return values

byte[]

Array of bytes received from connection. Data returned is any data received or up to completetionToken if token received

Parameters

[in]	dataOut	Source byte array to write to connection.
[in]	responseStartTimeOut	Timeout, milliseconds, to wait for first data to be received. Time to first byte.
[in]	responseEndTimeOut	Timeout, milliseconds, of no new data received. Time after last byte.
[in]	completetionToken	String token denoting the end of the response expected. This can be empty string if simply want to wait for response after writing data to connection.

Implements UniPRT.Sdk.Comm.IComm.

Member Data Documentation

Descriptor

override string UniPRT.Sdk.Comm.BTClassicConnection.Descriptor => $"BT:MAC Address:{_bt_address.ToString("X12")}"

Returns a string description of the connection. Format: "BT:MAC Address:_bt_mac" e.g. "BT:MAC Address:0080A3123456".

Format returned:

• BT:MAC Address:<_bt_mac>
  • _bt_mac is Stringb>. e.g. MAC Address:0080A3123456