Printing: Star Micronics Printer Settings

Star Micronics Printer Settings

General Settings

Barcode & QR Code Settings

Connected Cash Drawer Settings

JavaScript API Documentation

Related Settings

Common Questions


Overview

Kiosk Pro Enterprise includes support for many of Star Micronics’ thermal kiosk printers. In conjunction with this version of the app, these printers are capable of printing text, images, several types of UPC barcodes and QR codes.

Default: Off

Sample code demonstrating these different types of printing  can be found here and full documentation of the JavaScript API calls for communicating with Star printers is available here.

Kiosk Pro has been tested with successfully with the following models:

  • TSP650BTi
  • TSP700ii
  • TSP800ii
  • TSP100III

For more information about Star printers, you can visit Star Micronics' website.

In addition, Star has several utility apps available through the iTunes App Store that can be used for testing and configuration; particularly helpful is the  Star Setting Utility, available for free on the App Store.

Printing without the API

You can print without adding the API to your page by using either the JavaScript call  window.print(); or the Print Icon in Kiosk Pro's Navigation Bar.


Select Printer

Added in version 7.5

This setting allows you to select from a list of Star printers that are currently available and then automatically fills the correct Model Name, Model Family, and Port Name for that printer in the app's settings.


Port Name

This setting allows you to define the IP address assigned to the printer when it is configured with an Ethernet connection or the printer name when it is configured with a Bluetooth connection. It can be automatically filled out using the 'Select Printer' setting.

If using an Ethernet-connected Star printer, the IP address can be verified by printing a self-test page from the printer by:

  1. Turning the printer’s power switch to the OFF position
  2. Pressing and holding the paper feed switch (SW1)
  3. Turning the printer’s power switch to the ON position
  4. Releasing the paper feed switch (SW1)

In the setting field, the IP address must be prefaced by ‘TCP:’ as in ‘TCP:165.146.1.100’ with no space between the colon and the IP address.

If using a Bluetooth-connected Star printer, the printer name can be verified under iOS Settings > Bluetooth as the device name. By default, this is 'Star Micronics' for most models. The printer name can be modified using the Star Setting Utility, available for free on the App Store. In the setting field, the printer name must be prefaced by ‘BT:’ as in ‘BT:Star Micronics’ with no space between the colon and the printer name.


Port Settings

The standard default port for Star printers is '9100', unless there is something unique about your configuration.


Port Connection Timeout

This setting allows you to define how long Kiosk Pro should attempt to connect to the port before timing out and is expressed in milliseconds.

Default: 10000


Paper Width

This setting determines the width of the paper that you will be printing on.

Options:

  • 2 inches
  • 3 inches (default)
  • 4 inches


Pixel per Inch

This setting determines how many pixels should fit inside an inch.

Default: 192


Cut Paper

This setting allows you to decide whether to automatically cut the paper when a job is complete or to print multiple jobs continuously until the command to cut paper is issued by a custom JavaScript function.

Options:

  • Automatically (default)
  • Using JavaScript Parameter


Cut Style (if supported)

This setting allows you to determine the cut style of the printer if the printer supports it.

Options:

  • Full Cut (default)
  • Partial Cut


UPC 39, 93, & 128 Barcode Settings

Barcode Height

This setting allows you to determine the height of the barcode printed in standard characters. The default is 80. The maximum, 255, is equal to the width of the paper being printed.

Barcode Width

UPC 39 - These barcodes consist of various combinations of narrow and wide black and white bars. This setting allows you to control the width ratio between the narrow and wide bars, affecting the width and appearance of the resulting barcode.

UPC 93 & 128 - This setting allows you to control the width of the modules that make up the lines of the barcode, affecting the width and appearance of the resulting barcode.

Show Characters Under Barcode

This setting determines whether to print the alphanumeric characters making up the barcode directly beneath as is traditional with UPC barcodes on products. It also allows you to set whether to print a line feed directly following the barcode to separate it from other things on the page.

Barcode Alignment

Added in version 7.0

This setting allows you to set whether a barcode will be left, center or right aligned when printed.


QR Code Settings

Correction Level

The QR specification defines the block size so that no more than 30 error-correction symbols appear in each block. The code blocks are then interleaved together, making it less likely that localized damage to a QR symbol will overwhelm the capacity of any single block.

This setting allws you to define the error correction level for the QR code generated. The higher the error correction level, the less storage capacity.

Version

The version of the QR code defines the dimensions of the code in terms of how many cells make up the code. This app can support printing Version 1 (21x21 cells) and Version 2 (25x25 cells) QR codes. The more cells, the more information that can be encoded.

Cell Size

This setting allow you to control the size of each individual cell making up the QR code, affecting the overall size of the printed code.

Barcode Alignment

This setting allows you to set whether a barcode will be left, center or right aligned when printed.


Drawer Port Name

The app supports connecting to a cash drawer through a Star Micronics printer and allows you to trigger the cash drawer and check its current status using specific calls included in our Javascript API.

The standard Port Settings for Star printers is 9100, unless there is something unique about your configuration. If this setting is left empty, the cash drawer will use the same port as the Star printer Port Name configured in the app settings.


Drawer Port Settings

The standard Port Settings for Star printers is 9100, unless there is something unique about your configuration. If this setting is left empty, the cash drawer will use the same port as the Star printer Port Settings configured previously in settings.


Common Questions

Printing Images

Images should have a width of 576px when printed on 3-inch printers, and a width of 832px when printed on 4-inch printers. PNG and JPG formats are supported, SVT is not supported.

We highly recommend testing images for contrast to make sure details aren't lost when printed in black and white.

Still stuck? How can we help? How can we help?