3.4. SMBluetoothManager

Class to set Bluetooth settings

Warning

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

  • 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

Supported Method / Parameter for each model.

Model/Emulation

mC-Print2 mC-Print3 mPOP FVP10 TSP100IIIW TSP100IIIBITSP100IIIU TSP100ECO TSP100U TSP100GTTSP100LAN TSP650II TSP650IISK TSP700II TSP800IISM-S210i SM-S220i SM-S230i SM-T300i/T300 SM-T400i BSC10 SM-L200 SM-L300 SP700
StarPRNT StarPRNT StarPRNT StarLine StarGraphic StarGraphic StarGraphic StarGraphic StarGraphic StarGraphic StarGraphic StarLine StarLine StarLine StarLine StarPRNT EscPosMobile[1] StarPRNT EscPosMobile[1] StarPRNT EscPosMobile[1] StarPRNT EscPosMobile[1] StarPRNT EscPosMobile[1] EscPos StarPRNT StarPRNT StarDotImpact

open

- - - - - - -

loadSetting

- - - - - - -

close

- - - - - - -

apply

- - - - - - -

deviceNameCapability

- - - - - - -

deviceName

- - - - - - -

iOSPortNameCapability

- - - - - - -

iOSPortName

- - - - - - - - -

pinCodeCapability

- - - - - - -

pinCode

- - - - - - - - - - -

autoConnectCapability

- - - - - - -

autoConnect

- - - - - - - - -

securityTypeCapability

- - - - - - -

security

- - - [2] - - - - - - - [2] [2] [2] [2] [3] [3] [3] [3] [3] [3] [3] [3] [3] [3] - [3] [3] [2]

portName

- - - - - - -

portSettings

- - - - - - -

timeoutMillis

- - - - - - -

deviceType

- - - - - - -

opened

- - - - - - -
[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.4.1. Bluetooth setting change flow using StarBluetoothManager

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

../_images/bluetooth_flow.png

3.4.2. SMDeviceType

Constants of Printer Type.

  • Declaration

    typedef enum _SMDeviceType {
        SMDeviceTypeDesktopPrinter,
        SMDeviceTypePortablePrinter,
    } SMDeviceType;
    
  • Constants

    Name Contents
    SMDeviceTypeDesktopPrinter Desktop Printer
    SMDeviceTypePortablePrinter Portable Printer

Constant for each model.

Model

Emulation

Constants

mC-Print2 StarPRNT

SMDeviceTypePortablePrinter

mC-Print3 StarPRNT

SMDeviceTypePortablePrinter

mPOP StarPRNT

SMDeviceTypePortablePrinter

FVP10 StarLine

SMDeviceTypeDesktopPrinter

TSP100IIIBI StarGraphic

SMDeviceTypeDesktopPrinter

TSP650II StarLine

SMDeviceTypeDesktopPrinter

TSP650IISK StarLine

SMDeviceTypeDesktopPrinter

TSP700II StarLine

SMDeviceTypeDesktopPrinter

TSP800II StarLine

SMDeviceTypeDesktopPrinter

SM-S210i StarPRNT

SMDeviceTypePortablePrinter

EscPosMobile
SM-S220i StarPRNT

SMDeviceTypePortablePrinter

EscPosMobile
SM-S230i StarPRNT

SMDeviceTypePortablePrinter

EscPosMobile
SM-T300i/T300 StarPRNT

SMDeviceTypePortablePrinter

EscPosMobile
SM-T400i StarPRNT

SMDeviceTypePortablePrinter

EscPosMobile
SM-L200 StarPRNT

SMDeviceTypePortablePrinter

SM-L300 StarPRNT

SMDeviceTypePortablePrinter

SP700 StarDotImpact

SMDeviceTypeDesktopPrinter

3.4.3. SMBluetoothSecurity

Constants of Bluetooth security type.

  • Declaration

    typedef enum _SMBluetoothSecurity {
        SMBluetoothSecurityDisable,
        SMBluetoothSecuritySSP,
        SMBluetoothSecurityPINcode
    } SMBluetoothSecurity;
    
  • Constants

    Name Contents
    SMBluetoothSecurityPINcode Security by entering PIN code
    SMBluetoothSecuritySSP Security by pressing the interface card button
    SMBluetoothSecurityDisable No security

3.4.4. SMBluetoothSettingCapability

Constants of enable / disable information of the Bluetooth setting.

  • Declaration

    typedef enum _SMBluetoothSettingCapability {
        SMBluetoothSettingCapabilitySupport,
        SMBluetoothSettingCapabilityNoSupport
    } SMBluetoothSettingCapability;
    
  • Constants

    Name Contents
    SMBluetoothSettingCapabilitySupport Indicates the items and functions can be set for the printer that is currently connected.
    SMBluetoothSettingCapabilityNoSupport Indicates the items and functions can not be set for the printer that is currently connected.

3.4.5. portName

This method gets the port name specified by the constructor.

  • Declaration

    open var portName: String! { get }
    

3.4.6. deviceType

The type of the printer to be connected.

  • Declaration

    open var deviceType: SMDeviceType { get }
    

3.4.7. opened

Shows whether the port is opened.

  • Declaration

    open var opened: Bool { get }
    

3.4.8. deviceName

The Bluetooth device name.

To change setting, execute the apply method after this property changed.

  1. Valid characters

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

  2. Valid number of characters

    between 1 to 16 characters

  1. Notes

    In case of Bluetooth Low Energy, the changed Bluetooth names are effective after turning the device off and on and connecting again.

  • Declaration

    open var deviceName: String!
    

3.4.9. iOSPortName

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

To change setting, execute the apply method after this property changed.

  1. Valid characters

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

  2. Valid number of characters

    between 1 to 16 characters

  • Declaration

    open var iOSPortName: String!
    

3.4.10. autoConnect

Acquires and specifies the setting of the auto connection function.

To change setting, execute the apply method after this property changed.

  • Declaration

    open var autoConnect: Bool
    

3.4.11. security

Acquires and specifies the Bluetooth security setting.

To change setting, execute the apply method after this property changed.

  • Declaration

    open var security: SMBluetoothSecurity
    

3.4.12. pinCode

The PIN code.

It is not possible to acquire the current setting value.

To change setting, execute the apply method after this property changed.

  1. Valid characters

    • 0-9 (SM-L200, SM-L300)
    • 0-9 a-z A-Z (other models)
  2. Valid number of characters

    • 4 characters (SM-L200, SM-L300)
    • between 4 to 16 characters (other models)
  • Declaration

    open var pinCode: String!
    

3.4.13. deviceNameCapability

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

  • Declaration

    open var deviceNameCapability: SMBluetoothSettingCapability { get }
    

3.4.14. iOSPortNameCapability

The setting enable / disable information of the iOSPort name.

  • Declaration

    open var iOSPortNameCapability: SMBluetoothSettingCapability { get }
    

3.4.15. autoConnectCapability

The setting enable / disable information of the AutoConnection.

  • Declaration

    open var autoConnectCapability: SMBluetoothSettingCapability { get }
    

3.4.16. securityTypeCapability

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

  • Declaration

    open var securityTypeCapability: SMBluetoothSettingCapability { get }
    

3.4.17. pinCodeCapability

The setting enable / disable information of the PIN code.

  • Declaration

    open var pinCodeCapability: SMBluetoothSettingCapability { get }
    

3.4.18. initWithName

Creates the instance.

  • Declaration

    public init!(portName: String!, deviceType: SMDeviceType)
    
  • Parameter

    Parameter Contents Type
    portName It is the same as the portName of the getPort method. String
    deviceType Constants of Printer Type SMDeviceType
  • Return value

    Contents Type
    SMBluetoothManager object
    It returns nil when failed.
    SMBluetoothManager

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

Note

SMBluetoothManagerFactory included in StarIO_Extension.framework can get the appropriate SMBluetoothManager object for the printer emulation.

3.4.19. open

Opens a port for communicating with the printer.

Important

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

  • Declaration

    open func open() -> Bool
    
  • Parameter

    None

  • Return value

    Contents Type
    succeeded or failure Bool

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

3.4.20. loadSetting

Gets the value specified from the printer.

  • Declaration

    open func loadSetting() -> Bool
    
  • Parameter

    None

  • Return value

    Contents Type
    succeeded or failure Bool

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

3.4.21. close

Closes a port for communicating with the printer.

  • Declaration

    open func close()
    
  • Parameter

    None

  • Return value

    None

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

3.4.22. apply

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

  • Declaration

    open func apply() -> Bool
    
  • Parameter

    None

  • Return value

    Contents Type
    succeeded or failure Bool

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