This package contains cputil Ver 1.1.0. cputil is intented to serve and a useful back-end tool to help with implementing CloudPRNT servers that are not .Net or .Net Core based.
cputil can be use on any platform supported by .Net Core 2.1 including:
- Windows x86 and x64
- cputil-win-x86_v110.zip / cputil-win-x64_v110.zip
- Linux x64
- cputil-linux-x64_v110.tar.gz
- Apple Mac OS (OSX) x64 (Except 10.15 or later)
- cputil-osx-x64_v110.tar.gz
- Apple Mac OS (OSX) x64 (10.15 or later)
- cputil-osx-x64_v110.zip
- Linux Arm (Raspberry PI compatible)
- cputil-linux-arm_v110.tar.gz
In all cases, it is possible to build a self contained package that can be run on the desired platform without the need for a .Net Framework or .Net Core installation.
Please refer to SDK documents for details. (https://www.star-m.jp/products/s_print/CloudPRNTSDK/Documentation/en/index.html)
cputil-<Platform Name>_v110.zip(or .tar.gz)
|- Readme_En.txt // Release Notes (English)
|- Readme_Jp.txt // Release Notes (Japanese)
|- SoftwareLicenseAgreement.pdf // Software License Agreement (English)
|- SoftwareLicenseAgreement_Jp.pdf // Software License Agreement (Japanese)
|
+- cputil-<Platform Name>
|- cputil(.exe) // cputil executable file
cputil can be use on any platform supported by .Net Core 2.1 including:
- Windows x86 and x64
- cputil-win-x86_v110.zip / cputil-win-x64_v110.zip
- Linux x64
- cputil-linux-x64_v110.tar.gz
- Apple Mac OS (OSX) x64 (Except 10.15 or later)
- cputil-osx-x64_v110.tar.gz
- Apple Mac OS (OSX) x64 (10.15 or later)
- cputil-osx-x64_v110.zip
- Linux Arm (Raspberry PI compatible)
- cputil-linux-arm_v110.tar.gz
Works with these CloudPRNT client printers:
- mC-Print2
- mC-Print3
- TSP650II with IFBD-HI01X
- TSP700II with IFBD-HI01X
- TSP800II with IFBD-HI01X
- TSP650IISK with IFBD-HI01X(V1.9.0 or later)
- SP700 with IFBD-HI02X
Please refer to each CloudPRNT client printer for details. You can download the manual from Star web site. (https://www.star-m.jp/products/s_print/CloudPRNTSDK/Documentation/en/developerguide/introduction.html)
The example of usages for cputil are like below.
And it also can be refer to SDK documents for details. (https://www.star-m.jp/products/s_print/CloudPRNTSDK/Documentation/en/articles/cputil/cputil_usage.html)
Please unzip/extract cputil-.zip(or .tar.gz) to any specified path on PC. (Installation location and method is entirely the choice of the server administrator)
The below operation is to test this "Usage Example". Please open the terminal or command prompt on each PC and perform following command.
-
Windows
> cd <Extracted Directory Path>\cputil-win-x64_v110\cputil-win-x64or
> cd <Extracted Directory Path>\cputil-win-x86_v110\cputil-win-x86 -
Linux
$ cd <Extracted Directory Path>/cputil-linux-x64 -
macOS
$ cd <Extracted Directory Path>/cputil-osx-x64
Notes: On macOS 10.15 or later, cputil will be installed by Star provided pkg installer. Therefore just input "cputil" is enough when perform cputil command on terminal for below example(No need "./").
Star CloudPRNT devices will report their status in Star ASB format, as a string of 7 or more hexadecimal values. For Example:
> "23 86 00 00 00 00 00 00 00 00 00"
This is not easy to decode in all languages, and do cputil provides a method to convert this into JSON format data, e.g.:
-
Windows
> .\cputil.exe jsonstatus "23 86 00 00 00 00 00 00 00 00 00" -
Linux / macOS
$ ./cputil jsonstatus "23 86 00 00 00 00 00 00 00 00 00"
will generate the output:
> {
> "Online": true,
> "CoverOpen": false,
> "CompulsionSwitch": false,
> "OverTemperature": false,
> "Recoverable": true,
> "CutterError": false,
> "MechanicalError": false,
> "ReceiveBufferOverflow": false,
> "BlackMarkError": false,
> "PresenterPaperJam": false,
> "VoltageError": false,
> "PaperEmpty": false,
> "PaperLow": false
> }
cputil can help with key parts of the CloudPRNT printing process. A server can prepare a print job in a single input format, which may not be natively supported by the \cloudPRNT client device. The server can then use cputil to convert the job, as needed to a format that the CloudPRNT client does support.
Supported input print job media formats are:
- Images
- PNG - image/png
- JPEG - image/jpeg
- BMP - image/bmp
- GIF - image/gif
- Plain Text - text/plain
- Star Document Markup - text/vnd.star.markup
When a CloudPRNT compatible server has a print job ready for a particular client (typically a Star mC-Print2, mC-Print3 or printer with HI0x interface card), the it must:
- wait for a poll request from the client (a JSON request sent by http POST)
- reply to the client with a suitable json response, with at least the fields:
- @jobReady@ set to true.
- @mediaTypes@ an array of media type names in which the job can be provided to the client.
For example:
> {
> "jobReady": true,
> "mediaTypes": ["image/jpeg", "image/png"]
> }
At this point in the job printing negotiation, cputil can be used to prepare the mediaTypes list, based on the input format that the server plans to use.
For example, for a server that will use a PNG image as the initial print job source, use (In this sample, sourceimage.png is the name of the input file. Please prepare and put the file to directory same as cputil executable):
-
Windows
> .\cputil.exe mediatypes sourceimage.png -
Linux / macOS
$ ./cputil mediatypes sourceimage.png
which will generate the JSON ready output:
> ["image/png","image/jpeg","application/vnd.star.raster","application/vnd.star.line","application/vnd.star.starprnt","application/vnd.star.starprntcore"]
After a server has provided a JSON response to the CloudPRNT poll with the jobReady field set to true, and a valid mediaTypes list, the client will recognise that it is there is a job for it to print. It will perfom the following steps:
- select its preferred mediaType, from those available in the list. This is typically selected based on the first format in the list which is supported by the client. However, the exact decision can be client specific.
- perform an http GET to the CloudPRNT server to retrieve the job, specifying the chosen mediaType through a query string parameter.
When the server receives the http GET, it should return the job to be printer encoded with the requested media type.
Servers can prepare the job in a single, internally preferred format and then use cputil to convert it to the requested format.
For example, if a server has prepared a print job as png data, and the client requests it as StarPRNT printer command data (application/vnd.star.starprnt) then cputil can be used:
-
Windows
> .\cputil.exe decode "application/vnd.star.starprnt" sourceimage.png outputdata.bin -
Linux / macOS
$ ./cputil decode "application/vnd.star.starprnt" sourceimage.png outputdata.bin
Which will convert the png input file into printer command data stored in "outputdata.bin". If it is more convenient to write the output data to standard output, then use either "-" ot "[stdout]" as the output file name.
And also, if a server has prepared a print job as star document markup text data(filename extension is ".stm"), and the client requests it as StarPRNT printer command data (application/vnd.star.starprnt) then cputil can be used:
-
Windows
> .\cputil.exe decode application/vnd.star.starprnt starmarkup.stm outputdata.bin -
Linux / macOS
$ ./cputil decode application/vnd.star.starprnt starmarkup.stm outputdata.bin
Which will convert the star document markup input file("starmarkup.stm") into printer command data stored in "outputdata.bin".
And this outputdata.bin can print on the starprnt emulation printer(mC-Print2/3) via 9100 port / CloudPRNT print job etc.
Conversion can include image scaling or cropping and dithering. For scaling and cropping to work, it is necessary to inform cputil of the printer print width. CloudPRNT servers can obtain this information through the CloudPRNT clientAction "PageInfo" request.
To specify the print area size, use one of the following options:
- "thermal2" or "thermal58"
- set the print area to that of a 2inch/58mm printer, such as the mC-Print2.
- "thermal3" or "thermal80"
- set the print area to that of a 3inch/80mm printer, such as a TSP650II or mC-Print3.
- "thermal4" or "thermal112"
- set the print area to that of a 4inch/112mm printer, such as the Star TSP800II.
To specify dithering, use the option "dither".
To specify that the image should be scaled to fit the print area, use the "scale-to-fit" option. Otherwise the image will be unscales, but cropped if it is wider than the print area.
For example, to prepare print data as StarPRNT commands for a 2inch printer from a PNG source, with dithering and the image scaled to fit the page:
-
Windows
-
For 2inch printer(mC-Print2):
> .\cputil.exe thermal2 dither scale-to-fit decode "application/vnd.star.starprnt" sourceimage.png outputdata_2.bin -
For 3inch printer(mC-Print3):
> .\cputil.exe thermal3 dither scale-to-fit decode "application/vnd.star.starprnt" sourceimage.png outputdata_3.bin
-
-
Linux / macOS
-
For 2inch printer(mC-Print2):
$ ./cputil thermal2 dither scale-to-fit decode "application/vnd.star.starprnt" sourceimage.png outputdata_2.bin -
For 3inch printer(mC-Print3):
$ ./cputil thermal3 dither scale-to-fit decode "application/vnd.star.starprnt" sourceimage.png outputdata_3.bin
-
When converting to output formats that are able to include device commands (e.g. application/vnd.star.line, application/vnd.star.starprnt).
It is possible to ask cputil to include commands to trigger a printer connected cash drawer(or buzzer) to open(or ring) with the following options:
-
drawer-start- Open a drawer at the start of the print job.
-
drawer-end- Open a drawer at the end of the print job.
-
drawer-none- Do not open a connected cash drawer (default).
-
buzzer-start X(X is numeric)- Ring a buzzer by specified times at the start of the print job.
-
buzzer-end X(X is numeric)- Ring a buzzer by specified times at the end of the print job.
[Notes] Certain output data formats do not support embeding device commands, such as text/plain, image/png, image/jpeg. In these cases it is possible to use the CloudPRNT protocol to request that a cash drawer is opened via the http print job response header. Alternatively, ensure that your CloudPRNT service uses device command print job formats.
For example, to prepare print data as StarPRNT commands for a 2 inch printer from a PNG source, with cashdrawer open(2inch) and buzzer ring at the end of job:
-
Windows
-
For 2inch printer(mC-Print2):
> .\cputil.exe thermal2 scale-to-fit drawer-end decode "application/vnd.star.starprnt" sourceimage.png outputdata_2.bin -
For 3inch printer(mC-Print3):
> .\cputil.exe thermal3 scale-to-fit buzzer-end 1 decode "application/vnd.star.starprnt" sourceimage.png outputdata_3.bin
-
-
Linux / macOS
-
For 2inch printer(mC-Print2):
$ ./cputil thermal2 scale-to-fit drawer-end decode "application/vnd.star.starprnt" sourceimage.png outputdata_2.bin -
For 3inch printer(mC-Print3):
$ ./cputil thermal3 scale-to-fit buzzer-end 1 decode "application/vnd.star.starprnt" sourceimage.png outputdata_3.bin
-
To enable a hold print feature
This feature is available with TSP650IISK and IFBD-HI01X (Ver 1.9.0 or later). TSP650IISK has hold print feature which can be detected if remains a printed receipt at paper exit. The below options can be specified whehter informs hold print status / enable hold print firmware control (These settings are actually affects after sending current job (from next time print job)).
-
presentstatus-default- Follows printer firmware setting about the informing of hold print status.
-
presentstatus-valid- Enables about the informing the hold print status.
-
presentstatus-invalid- Disables about the informing the hold print status.
-
holdprint-default- Follows printer firmware setting about the controlling the hold print function by hardware.
-
holdprint-valid- Enables about the controlling the hold print function by hardware.
-
holdprint-invalid- Disables about the controlling the hold print function by hardware.
For example, to prepare print data as StarPRNT commands for a 2 inch printer from a PNG source, with enabling hold print status and disabling hold print firmware control:
-
Windows
-
For 2inch printer(mC-Print2):
> .\cputil.exe thermal2 scale-to-fit presentstatus-valid holdprint-invalid decode application/vnd.star.starprnt sourceimage.png outputdata_2.bin -
For 3inch printer(mC-Print3):
> .\cputil.exe thermal3 scale-to-fit presentstatus-valid holdprint-invalid decode application/vnd.star.starprnt sourceimage.png outputdata_3.bin
-
-
Linux / macOS
-
For 2inch printer(mC-Print2):
$ ./cputil thermal2 scale-to-fit presentstatus-valid holdprint-invalid decode "application/vnd.star.starprnt" sourceimage.png outputdata_2.bin -
For 3inch printer(mC-Print3):
$ ./cputil thermal3 scale-to-fit presentstatus-valid holdprint-invalid decode "application/vnd.star.starprnt" sourceimage.png outputdata_3.bin
-
[Notes]
About holdpirnt-XXX options, this option is recommended to set invalid when use software solutions(like CloudPRNT) supporting TSP650IISK feature.
Because these softwares controls the hold print feature by hold print status.
Certain output data formats do not support embeding device commands, such as text/plain, image/png, image/jpeg.
In these cases it is possible to use the CloudPRNT protocol to request that a cash drawer is opened via the http print job response header.
Alternatively, ensure that your CloudPRNT service uses device command print job formats.
- Word wrapping / column command for starmarkup features with Unicode character are only supported by mC-Print2 / mC-Print3 / TSP650II.
cputil package includes these libraries which is included OSS licenses.
- .NET core (MIT License)
- SixLabors.ImageSharpe (Apache License)
- Newtonsoft.Json (MIT License)
Copyright 2019 Star Micronics Co., Ltd. All rights reserved.
-
Ver.1.1.0 (2020/06/17)
- Support the command option of drawer for controlling CashDrawer.
- Support the command option of buzzer for controlling Buzzer.
- Support embedded data urls for
imagemarkup tag. - Support
negativemarkup tag to printing colour inverted text. - Support
invertmarkup tag to support upside-down printing. - Support the command options of holdprint and presentstatus for TSP650IISK model.
-
Ver.1.0.0 (2019/11/05)
- First release.