Star PassPRNT (hereafter referred to as PassPRNT) is a printing application made by Star Micronics co., Ltd.
PassPRNT is called by the host application using a function called URL scheme, accepts the printing data, and then outputs it to a Star Micronics-brand printer.
This manual describes the functions of PassPRNT and the application interactions between PassPRNT and the host application.
The application interaction of this software uses the Windows 10 UWP standard URI scheme (including path and query).
The printing layout is defined using HTML or PDF. Other printer settings use the queries described in this manual.
Accordingly, this manual is intended for application/system developers who use HTML and Windows C# UWP. A basic understanding of HTML, C# and so on are assumed for the users of this manual and software.
1.1. Functions of PassPRNT
The functions of PassPRNT are described below.
(A) Starting the Software
Selecting ‘Print’ will start the software in conjunction with the host application. After printing is completed, the host application is automatically displayed. (After printing is completed, PassPRNT will send any error codes to the host application.)
Selecting ‘Settings’ will be displayed as the Configuration screen when the application is started.
PassPRNT is called by the host application using a URI scheme, accepts the printing data, and then the data can be printed from a Star Micronics printer.
(C) Setting Method
There are two setting methods: settings can be made from the PassPRNT settings screen, or settings can be configured using queries from the host application.Settings made using queries are given priority.For information on making settings using queries, refer to Queries.
- Designation of “Peripheral (Drawers, etc…)” (excluding mobile printers)
The activation timing is for the timing before printing and after printing.
(D) Screen Configuration
On the settings screen, the settings described in C)-1 can be made.
View/select a printer from a list of available printers (The “Search” function can be used)
Select the communication interface
When selecting “Desktop”/”mCollection”, the interface selection window is displayed (LAN/Bluetooth/All).
Show detected printers in search results
Firmware version acquisition is performed after the printer is selected
Check the selected printer supports Firmware version, and then the result (*1) is displayed. The following screen (*2) will be displayed if a communication conformation error occurs.
Based on the above result, the emulation is also determined.
Check communication with the selected printer
Check communication with the selected printer.
The following factors are considered to be the main causes of a communication confirmation error.
The device and the printer are not paired correctly
The printer is offline (the power is off or there is no paper in the printer)
Too far away from the Bluetooth printer, or poor signal conditions
In this case, the printing item will be cleared to “None configured”. Check communication with the new printer.
Settings made using queries override the above settings. If the value is not included in the query, this setting will be enabled.
If selecting drawer configuration as “before printing” and printer was offline, drawer is opened after recovering online except mPOP.
The settings made are saved in the application until it is uninstalled.
This application supports the following 2 languages. If the language setting of this device is not set to Japanese, it will be set to English.
- Data storage period
The period from when PassPRNT is launched by the host application until the transition back to the host application.
The received printing data cannot be printed unless there are instructions from the user (select “retry” during printing).
- Canceling Application
Do not hold down the “home” button to cancel the operation when printing. If the application has been canceled, the operating system may close the application even when printing. Therefore, the printing result cannot be sent to the host application.
- Tablet-mode Disabled
PassPRNT can be used for Windows 10 unlike Android and iOS, by disabling tablet-mode. When printing data is sent continuously from the host application with tablet-mode disabled, PassPRNT discards data until the previous printing process is complete. Check that the current printing process is complete, and then send the next data.
- URI Scheme Limit
URI schemes can send and receive up to 2 KBs of data for specifications similar to Android and iOS. If the maximum amount of data that can be sent and received is 2 KBs, the PDF printing function will be excluded from Windows specifications as the amount of data is not sufficient enough to create PDF files.
Printing error due to settings failure
When “Printer” are not selected on the settings screen, PassPRNT will connect to “Desktop” as the desired printer. The printer being used is one of the paired Star printers. Consequently, if printing to Portable and mCollection, make sure to select “Type” and “Printer” on the settings screen or through the query settings.