3.5. StarBluetoothManager¶

Class to set Bluetooth settings

Warning

It can not be used with StarIOPort Class at the sime time.

Constant

Name

Contents

StarDeviceType

Constants of Printer Type

StarBluetoothSecurity

Constants of Bluetooth security type

StarBluetoothSettingCapability

Constants of enable / disable information of the Bluetooth security type

Constructor

Name

Contents

StarBluetoothManager

Creates the instance.

Method

Name

Contents

open

Opens a port for communicating with the printer.

loadSetting

Gets the value specified from the printer.

close

Closes a port for communicating with the printer.

apply

Set the specified value to the printer

getBluetoothDeviceNameCapability

This method gets the setting enable / disable information of the Bluetooth device name.

getBluetoothDeviceName

This method gets the Bluetooth device name.

setBluetoothDeviceName

This method sets the Bluetooth device name.

getiOSPortNameCapability

This method gets the setting enable / disable information of the iOSPort name.

getiOSPortName

This method gets the iOS port name.

setiOSPortName

This method sets the iOS port name.

getPinCodeCapability

This method gets the setting enable / disable information of the Pin Code.

getPinCode

This method gets the PIN code.

setPinCode

This method sets the PIN code.

getAutoConnectCapability

This method gets the setting enable / disable information of the Auto Connection.

getAutoConnect

Gets the value of Auto Connection.

setAutoConnect

This method sets the Auto Connection.

getSecurityTypeCapability

This method gets the setting enable / disable information of the Bluetooth security type.

getSecurityType

This method gets the Bluetooth security type.

setSecurityType

This method sets the Bluetooth security type.

getPortName

This method gets the port name specified by the constructor.

getPortSettings

This method gets the port setting specified by the constructor.

getTimeoutMillis

This method gets the TimeoutMillis specified by the constructor.

getDeviceType

Gets the device type specified by the constructor.

isOpened

This method acquires the port status.

Supported Method / Parameter for each model.

Model/Emulation	mC-Print2	mC-Print3	mPOP	FVP10	TSP100IIIW	TSP100IIIBI	TSP100IIIU	TSP100ECO	TSP100U	TSP100GT	TSP100LAN	TSP650II	TSP650IISK	TSP700II	TSP800II	TUP500	SM-S210i		SM-S220i		SM-S230i		SM-T300i/T300		SM-T400i		BSC10	SM-L200	SM-L300	SP700	SK1-211/221/V211	SK1-211/221/V211 Presenter	SK1-311/321/V311	SK1-311/V311 Presenter
Model/Emulation	StarPRNT	StarPRNT	StarPRNT	StarLine	StarGraphic	StarGraphic	StarGraphic	StarGraphic	StarGraphic	StarGraphic	StarGraphic	StarLine	StarLine	StarLine	StarLine	StarLine	StarPRNT	EscPosMobile[1]	StarPRNT	EscPosMobile[1]	StarPRNT	EscPosMobile[1]	StarPRNT	EscPosMobile[1]	StarPRNT	EscPosMobile[1]	EscPos	StarPRNT	StarPRNT	StarDotImpact	StarPRNT	StarPRNT	StarPRNT	StarPRNT
open	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
loadSetting	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
close	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
apply	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getBluetoothDeviceNameCapability	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getBluetoothDeviceName	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
setBluetoothDeviceName	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getiOSPortNameCapability	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getiOSPortName	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	-	-	✔	-	-	-	-
setiOSPortName	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	-	-	✔	-	-	-	-
getPinCodeCapability	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getPinCode	-	-	-	✔	-	-	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
setPinCode	-	-	-	✔	-	-	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getAutoConnectCapability	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getAutoConnect	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	-	-	✔	-	-	-	-
setAutoConnect	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	-	-	✔	-	-	-	-
getSecurityTypeCapability	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getSecurityType	-	-	-	✔[2]	-	-	-	-	-	-	-	✔[2]	✔[2]	✔[2]	✔[2]	-	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	-	✔[3]	✔[3]	✔[2]	-	-	-	-
setSecurityType	-	-	-	✔[2]	-	-	-	-	-	-	-	✔[2]	✔[2]	✔[2]	✔[2]	-	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	✔[3]	-	✔[3]	✔[3]	✔[2]	-	-	-	-
getPortName	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getPortSettings	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getTimeoutMillis	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
getDeviceType	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-
isOpened	✔	✔	✔	✔	-	✔	-	-	-	-	-	✔	✔	✔	✔	-	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	-	✔	✔	✔	-	-	-	-

[1]	F/W Version 3.0 or later is required.

[2]	The SecurityType that can be set and acquired is PIN code or SSP.

[3]	The SecurityType that can be set and retrieved is PIN code or Disable.

3.5.1. Bluetooth setting change flow using StarBluetoothManager¶

Using the StarBluetoothManager class, follow the steps below to change the printer’s Bluetooth settings.

StarBluetoothManager manager = null;

try {
    // Get StarBluetoothManager
    manager = StarBluetoothManagerFactory.getManager(portName, portSettings, 10000, emulation);

    // Port open
    manager.open();

    // Loading Bluetooth settings
    manager.loadSetting();

    // Set Bluetooth settings
    // Example) When setting the device name to "Star Micronics"
    manager.setBluetoothDeviceName("Star Micronics");

    // Apply Bluetooth settings
    manager.apply();
}
catch (StarIOPortException e) {
    // Error
}
finally {
    if (manager.isOpened()) {
    try {
        // Port close
        manager.close();
    }
    catch (StarIOPortException e) {}
    }
}

Refer to BluetoothSettingFragment.java.

3.5.2. StarDeviceType¶

Constants of Printer Type.

Declaration

public enum StarDeviceType {
    StarDeviceTypeDesktopPrinter,
    StarDeviceTypePortablePrinter
}

Constants

Name Contents

StarDeviceTypeDesktopPrinter Desktop Printer

StarDeviceTypePortablePrinter Portable Printer

Constant for each model.

Model	Emulation	Constants
mC-Print2	StarPRNT	StarDeviceTypePortablePrinter
mC-Print3	StarPRNT	StarDeviceTypePortablePrinter
mPOP	StarPRNT	StarDeviceTypePortablePrinter
FVP10	StarLine	StarDeviceTypeDesktopPrinter
TSP100IIIBI	StarGraphic	StarDeviceTypeDesktopPrinter
TSP650II	StarLine	StarDeviceTypeDesktopPrinter
TSP650IISK	StarLine	StarDeviceTypeDesktopPrinter
TSP700II	StarLine	StarDeviceTypeDesktopPrinter
TSP800II	StarLine	StarDeviceTypeDesktopPrinter
SM-S210i	StarPRNT	StarDeviceTypePortablePrinter
SM-S210i	EscPosMobile	StarDeviceTypePortablePrinter
SM-S220i	StarPRNT	StarDeviceTypePortablePrinter
SM-S220i	EscPosMobile	StarDeviceTypePortablePrinter
SM-S230i	StarPRNT	StarDeviceTypePortablePrinter
SM-S230i	EscPosMobile	StarDeviceTypePortablePrinter
SM-T300i/T300	StarPRNT	StarDeviceTypePortablePrinter
SM-T300i/T300	EscPosMobile	StarDeviceTypePortablePrinter
SM-T400i	StarPRNT	StarDeviceTypePortablePrinter
SM-T400i	EscPosMobile	StarDeviceTypePortablePrinter
SM-L200	StarPRNT	StarDeviceTypePortablePrinter
SM-L300	StarPRNT	StarDeviceTypePortablePrinter
SP700	StarDotImpact	StarDeviceTypeDesktopPrinter

3.5.3. StarBluetoothSecurity¶

Constants of Bluetooth security type.

Declaration

public enum StarBluetoothSecurity {
    PINCODE,
    SSP,
    DISABLE
}

Constants

Name Contents

PINCODE Security by entering PIN code

SSP Security by pressing the interface card button

DISABLE No security

3.5.4. StarBluetoothSettingCapability¶

Constants of enable / disable information of the Bluetooth setting.

Declaration

public enum StarBluetoothSecurity {
    SUPPORT,
    NOSUPPORT
}

Constants

Name Contents

SUPPORT Indicates the items and functions can be set for the printer that is currently connected.

NOSUPPORT Indicates the items and functions can not be set for the printer that is currently connected.

3.5.5. StarBluetoothManager¶

Creates the instance.

Declaration

StarBluetoothManager(String portName, String portSetting, int ioTimeoutMillis, StarBluetoothManager.StarDeviceType starDeviceType);

Parameter

Parameter Contents Type

portName It is the same as the portName of the getPort method. String

portSettings It is the same as the portSetting of the getPort method. String

ioTimeoutMillis Timeout value for internal control and API. int

starDeviceType Constants of Printer Type StarDeviceType

Refer to StarDeviceType constant.

Return value

Contents Type

StarBluetoothManager object StarBluetoothManager

Refer to Bluetooth setting change flow using StarBluetoothManager about the procedure of change the Bluetooth Setting.

Note

StarBluetoothManagerFactory included in starioextension.jar can get the appropriate StarBluetoothManager object for the printer emulation.

3.5.6. open¶

Opens a port for communicating with the printer.

Important

Get the current settings by loadSetting method after conducting open method.

Declaration
public void open();
Parameter

None
Return value

None

Exception

Contents Type

when a communication failure occurs StarIOPortException

Refer to Bluetooth setting change flow using StarBluetoothManager about the procedure of change the Bluetooth Setting.

3.5.7. loadSetting¶

Gets the value specified from the printer.

Declaration
public void loadSetting();
Parameter

None
Return value

None

Exception

Contents Type

when a communication failure occurs StarIOPortException

Refer to Bluetooth setting change flow using StarBluetoothManager about the procedure of change the Bluetooth Setting.

3.5.8. close¶

Closes a port for communicating with the printer.

Declaration
public void close();
Parameter

None
Return value

None

Exception

Contents Type

when a communication failure occurs StarIOPortException

Refer to Bluetooth setting change flow using StarBluetoothManager about the procedure of change the Bluetooth Setting.

3.5.9. apply¶

Set the value specified by the following methods to the printer.

setBluetoothDeviceName
setiOSPortName
setPinCode
setAutoConnect
setSecurityType

Declaration
public void apply();
Parameter

None
Return value

None

Exception

Contents Type

when a communication failure occurs StarIOPortException

Refer to Bluetooth setting change flow using StarBluetoothManager about the procedure of change the Bluetooth Setting.

3.5.10. getBluetoothDeviceNameCapability¶

The setting enable / disable information of the Bluetooth device name.

Declaration

public StarBluetoothManager.StarBluetoothSettingCapability getBluetoothDeviceNameCapability();

Parameter

None

Return value

Contents Type

This method gets the setting enable / disable information of the Bluetooth device name. StarBluetoothSettingCapability

3.5.11. getBluetoothDeviceName¶

The Bluetooth device name.

Declaration

public String getBluetoothDeviceName();

Parameter

None

Return value

Contents Type

Bluetooth device name String

3.5.12. setBluetoothDeviceName¶

This method sets the Bluetooth device name.

To change the iOS port name, execute the apply method after the this method.

Declaration

public void setBluetoothDeviceName(String bluetoothDeviceName);

Parameter

Name Contents Type

bluetoothDeviceName Bluetooth device name String
Return value

None
Exception

Contents Type

when any invalid characters are used

when the length of the set character string is not valid number of characters

StarIOPortException

Valid characters

0-9 a-z A-Z ; : ! ? # $ % & , . @ _ - = Space / * + ~ ^ [ { ( ] } ) | \
Valid number of characters

between 1 to 16 characters

3.5.13. getiOSPortNameCapability¶

The setting enable / disable information of the iOSPort name.

Declaration

public StarBluetoothManager.StarBluetoothSettingCapability getiOSPortName();

Parameter

None

Return value

Contents Type

This method gets the setting enable / disable information of the iOSPort name StarBluetoothSettingCapability

3.5.14. getiOSPortName¶

Acquires and specifies the iOS port name to be used with the StarIO for Bluetooth communication.

Declaration
public String getiOSPortName();

Parameter

None

Return value

Contents Type

iOS Port Name String

3.5.15. setiOSPortName¶

This method sets the iOS port name.

To change the iOS port name, execute the apply method after the this method.

Declaration

public void setiOSPortName(String iOSPortName);

Parameter

Name Contents Type

iOSPortName iOS Port Name String
Return value

None
Exception

Contents Type

when any invalid characters are used

when the length of the set character string is not valid number of characters

StarIOPortException

Valid characters

0-9 a-z A-Z ; : ! ? # $ % & , . @ _ - = Space / * + ~ ^ [ { ( ] } ) | \
Valid number of characters

between 1 to 16 characters

3.5.16. getPinCodeCapability¶

The setting enable / disable information of the PIN code.

Declaration

public StarBluetoothManager.StarBluetoothSettingCapability getPinCodeCapability();

Parameter

None

Return value

Contents Type

This method gets the setting enable / disable information of the Pin Code. StarBluetoothSettingCapability

3.5.17. getPinCode¶

The PIN code.

Declaration
public String getPinCode();

Parameter

None

Return value

Contents Type

Pin Code String

3.5.18. setPinCode¶

This method sets the PIN code.

To change the PIN Code, execute the apply method after the this method.

Declaration

public void setPinCode(String pinCode);

Parameter

Name Contents Type

pinCode Pin Code String
Return value

None
Exception

Contents Type

when any invalid characters are used

when the length of the set character string is not valid number of characters

StarIOPortException

Valid characters
- 0-9 (SM-L200, SM-L300)
- 0-9 a-z A-Z (other models)
Valid number of characters
- 4 characters (SM-L200, SM-L300)
- between 4 to 16 characters (other models)

3.5.19. getAutoConnectCapability¶

The setting enable / disable information of the AutoConnection.

Declaration

public StarBluetoothManager.StarBluetoothSettingCapability getAutoConnectCapability();

Parameter

None

Return value

Contents Type

enable / disable information of the AutoConnection StarBluetoothSettingCapability

3.5.20. getAutoConnect¶

Acquires and specifies the setting of the auto connection function.

Declaration
public boolean getAutoConnect();

Parameter

None

Return value

Contents Type

AutoConnection setting

true … when AutoConnection setting is ON

false … when AutoConnection setting is OFF

boolean

3.5.21. setAutoConnect¶

Sets the Auto Connection.

To change the Auto Connection, execute the apply method after the this method.

Declaration

public void setAutoConnect(boolean autoConnect);

Parameter

Name Contents Type

autoConnect

AutoConnection setting

true … when AutoConnection setting is ON

false … when AutoConnection setting is OFF

boolean
Return value

None

3.5.22. getSecurityTypeCapability¶

The setting enable / disable information of the Bluetooth security type.

Declaration

public StarBluetoothManager.StarBluetoothSettingCapability getSecurityTypeCapability();

Parameter

None

Return value

Contents Type

This method gets the setting enable / disable information of the Bluetooth security type StarBluetoothSettingCapability

3.5.23. getSecurityType¶

Acquires and specifies the Bluetooth security setting.

Declaration

public StarBluetoothManager.StarBluetoothSecurity getSecurityType();

Parameter

None

Return value

Contents Type

Bluetooth security type StarBluetoothSecurity

3.5.24. setSecurityType¶

Sets the Bluetooth security type.

To change the Bluetooth security type, execute the apply method after the this method.

Declaration

public void setSecurityType(StarBluetoothManager.StarBluetoothSecurity securityType);

Parameter

Name Contents Type

securityType Bluetooth security type StarBluetoothSecurity
Return value

None

3.5.25. getPortName¶

This method gets the port name specified by the constructor.

Declaration
public String getPortName();

Parameter

None

Return value

Contents Type

portName specified by the constructor String

3.5.26. getPortSettings¶

This method gets the port setting specified by the constructor.

Declaration
public String getPortSettings();

Parameter

None

Return value

Contents Type

portSettings specified by constructor String

3.5.27. getTimeoutMillis¶

This method gets the TimeoutMillis specified by the constructor.

Declaration
public int getTimeoutMillis();

Parameter

None

Return value

Contents Type

ioTimeoutMillis specified by the constructor int

3.5.28. getDeviceType¶

The type of the printer to be connected.

Declaration

public StarBluetoothManager.StarDeviceType getDeviceType();

Parameter

None

Return value

Contents Type

deviceType specified by the constructor StarDeviceType

3.5.29. isOpened¶

Shows whether the port is opened.

Declaration
public boolean isOpened();

Parameter

None

Return value

Contents Type

port status

true … The port is opened

false … The port is closed

boolean

Name	Contents
PINCODE	Security by entering PIN code
SSP	Security by pressing the interface card button
DISABLE	No security