StarXpand SDK for Android
is a software development kit for supporting application development for Star Micronics devices.
This software development kit provides the StarIO10 library (StarIO10.aar) as a library to control the Star Micronics devices.
Please refer here for StarXpand SDK documentation.
Documentation includes an overview of the SDK, how to build a sample application, how to use the API, and a API reference.
Platform | Version | Arch |
---|---|---|
Android | Android 9.0 or later | arm64-v8a, armeabi-v7a, x86, x86_64 |
In order to integrate the StarIO10 library into your Android application, Use Maven repository. Add the following dependencies to the dependencies
block in app/build.gradle
.
The VERSION_NUMBER
part is the version of the library. Please refer to app/build.gradle for the latest version of the library.
dependencies {
implementation 'com.starmicronics:stario10:VERSION_NUMBER'
...
}
For more information on how to integrate a library into your application, please refer to the following URL.
https://developer.android.com/studio/build/dependencies
Refer to sample code and obtain BLUETOOTH_CONNECT permission before starting to communicate with or discover printers.
When communicating with a USB printer, a dialog box will appear asking for connection permission. This permission is reset when the USB cable is plugged in or unplugged (including when the printer is turned on or off).
If you do not want to display the connection permission dialog every time the USB cable is plugged in or unplugged, configure the following settings. This setting will also allow the application to start automatically when the USB cable is plugged.
Add the following <intent-filter>
and <meta-data>
elements to AndroidManifest.xml.
<intent-filter>
<action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
<action android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" />
</intent-filter>
<meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" android:resource="@xml/device_filter" />
<meta-data android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" android:resource="@xml/accessory_filter" />
Store the following resource files under res/xml
with the names device_filter.xml
and accessory_filter.xml
.
<?xml version="1.0" encoding="utf-8"?>
<resources>
<usb-device class="255" subclass="66" protocol="1" />
<usb-device vendor-id="1305" product-id="0003" /> <!--TSP100IIU+/IIIU/IV/IV SK-->
<usb-device vendor-id="1305" product-id="0071" /> <!--mC-Print3-->
<usb-device vendor-id="1305" product-id="0073" /> <!--mC-Print2-->
<usb-device vendor-id="1305" product-id="0025" /> <!--mC-Label3-->
<usb-device vendor-id="1305" product-id="0023" /> <!--mPOP-->
<usb-device vendor-id="1305" product-id="0001" /> <!--TSP650II/TSP650II SK/TSP700II/TSP800II/SP700-->
<usb-device vendor-id="1305" product-id="0027" /> <!--BSC10II-->
<usb-device vendor-id="1305" product-id="0075" /> <!--SK1-211/221/V211-->
<usb-device vendor-id="1305" product-id="0077" /> <!--SK1-311/321/V311-->
<usb-device vendor-id="1305" product-id="0079" /> <!--SK5-31-->
<usb-device vendor-id="1305" product-id="0081" /> <!--SK1-41-->
</resources>
<?xml version="1.0" encoding="utf-8"?>
<resources>
<usb-accessory model="Star TSP143IV-UE" manufacturer="STAR"/>
<usb-accessory model="Star TSP143IV-UE SK" manufacturer="STAR"/>
<usb-accessory model="mC-Print3" manufacturer="Star Micronics"/>
<usb-accessory model="mC-Label3" manufacturer="Star Micronics"/>
<usb-accessory model="mPOP" manufacturer="Star Micronics"/>
<usb-accessory model="BSC10II" manufacturer="Star Micronics"/>
</resources>
StarXpand SDK includes an example application that can be used in combination with the printer to check its operation. Please use it in conjunction with the explanations of each function in the linked pages.
The sample code and printed result images are also available here.
:warning: Some printer models may not be able to print some samples. Please adjust the layout accordingly when using this samples.
fun getStatus() {
// Specify your printer connection settings.
val settings = StarConnectionSettings(interfaceType.Lan, "00:11:62:00:00:00")
val printer = StarPrinter(settings, applicationContext)
val job = SupervisorJob()
val scope = CoroutineScope(Dispatchers.Default + job)
scope.launch {
try {
// Connect to the printer.
printer.openAsync().await()
// Get printer status.
val status = printer.getStatusAsync().await()
Log.d("Status", "${status}")
} catch (e: Exception) {
// Exception.
Log.d("Status", "${e.message}")
} finally {
// Disconnect from the printer.
printer.closeAsync().await()
}
}
}
fun monitor() {
val job = SupervisorJob()
val scope = CoroutineScope(Dispatchers.Default + job)
scope.launch {
// Specify your printer connection settings.
val settings = StarConnectionSettings(interfaceType.Lan, "00:11:62:00:00:00")
printer = StarPrinter(settings, applicationContext)
// Callback for printer state changed.
printer?.printerDelegate = object : PrinterDelegate() {
override fun onReady() {
super.onReady()
Log.d("Monitor", "Printer: Ready")
}
// ...
// Please refer to document for other callback.
}
printer?.drawerDelegate = object : DrawerDelegate() {
override fun onOpenCloseSignalSwitched(openCloseSignal: Boolean) {
super.onOpenCloseSignalSwitched(openCloseSignal)
Log.d("Monitor", "Drawer: Open Close Signal Switched: ${openCloseSignal}")
}
// ...
// Please refer to document for other callback.
}
printer?.inputDeviceDelegate = object : InputDeviceDelegate() {
override fun onDataReceived(data: List<Byte>) {
super.onDataReceived(data)
Log.d("Monitor", "Input Device: DataReceived ${data}")
}
// ...
// Please refer to document for other callback.
}
printer?.displayDelegate = object : DisplayDelegate() {
override fun onConnected() {
super.onConnected()
Log.d("Monitor", "Display: Connected")
}
// ...
// Please refer to document for other callback.
}
try {
// Connect to the printer.
printer?.openAsync()?.await()
} catch (e: Exception) {
// Exception.
Log.d("Monitor", "${e.message}")
}
}
}
Copyright 2022 Star Micronics Co., Ltd. All rights reserved.