Support Center

How to integrate Quetzal with printers

Abstract

This article describes how to use the administration screen's printer integration panel to specify the addresses of your receipt and label printer. It also tells you about the available settings, printer languages, page sizes and test printing options.

Quetzal philosophy

Quetzal communicates over the network to industry standard printers. Quetzal is certified to work with a tested and confirmed set of rugged and robust receipt and label printers. Once your printers are hooked up to power and the network, and have had their IP address configured, you tell each iPad running Quetzal which printer you want it to print to by address. This is the most straightforward way to allow maximum flexibility for more than one iPad to share a label printer while they each have their own receipt printer, or any combination that suits your needs.

Connecting Quetzal to a printer

This article assumes that you have already connected a printer to power and to the network, and that you have already assigned the printer a static IP address. If you have not performed those steps, please refer to the following articles first:

Each iPad running Quetzal must be configured individually to specify the printer(s) that it will be able to print to. Quetzal enables an iPad to be configured to print to one receipt printer and one label printer.

In order to configure Quetzal to be integrated with printers, you must have access rights to the administration screen.

Authenticate into the administration screen, and tap on the integrations tab on the left hand side. Next tap on printers from the list of integrations. The panel is divided into three sections, receipt printer, label printer and iPad internet settings. Each of the three sections is described below.

Receipt Printer Configuration

To configure a receipt printer enter the static IP address of the receipt printer into the IP address field of the receipt printer section.

There are two types of receipt printers, the ones that use the Star Micronics language, and the ones that use ESC/POS, which is the language of Epson and Epson compatible printers. If you have a star printer, set the type to STAR. If you have an Epson printer, set the type to ESC/POS. The PRP-300 is an Epson compatible printer, configure it as type ESC/POS.

After you have input the settings, press the Apply Settings button. Press the Send Test Print button to send a test print job to the printer. The test print will print out width indicators of Narrow, Medium and Wide. Use the indicator on the test print to determine which paper width your receipt printer supports. If necessary, adjust the Paper Width setting and Apply Settings again.

In the example test print above you can see that the Wide indicator wraps the page, and that the Narrow indicator does not reach the far right side of the page, but the Medium width seems to fit across the page just right. In this case the width indicators mean you should set the page width to Medium in Quetzal.

If you are using the Star TSP-700II combo receipt/label printer, please see below for special considerations about how to change the printer between modes and when to change its physical media.

Label Printer Configuration

To configure a label printer enter the static IP address of the label printer into the IP address field of the label printer section.

There are two types of label printer, the ones that use the Star Micronics language, and the ones that use ESC/POS, which is the language of Epson and Epson compatible printers. If you have a star label printer, set the type to STAR. If you have an Epson label printer, set the type to ESC/POS.

There are two label sizes supported by Quetzal, 2"(50.8mm)W x 1"(25.5mm)H and 3"(76.2mm)W x 1"(25.5mm)H. Depending on the size of label media you are going to use, select the correct Paper Width. Press Apply Settings. Press the Send Test Print button to print a test label. If the label prints but does not emerge from the printer you can press the paper feed button on the printer to forward feed the label.

If you are using the Star TSP-700II combo receipt/label printer, please see below for special considerations about how to change the printer between modes and when to change its physical media.

Special Considerations for the Star TSP-700II Receipt/Label Printer

The Star TSP-700II is an excellent choice if you want print labels but do need to have a dedicated printer for both receipts and labels. However, the printer can only be put into one mode at a time. The print media must be changed immediately after changing the printer's mode.

If the wrong media put into the printer before its mode is changed it will enter an error state and cannot be changed mode while it is in an error state.

To configure Quetzal to use the same Star TSP-700II printer as both a label printer an a receipt printer begin by entering the IP address of the printer into both the Receipt Printer and Label Printer sections. Decide which mode you want to use it in now, either receipt or label, and set the type to Star in that section. Set any appropriate paper width settings. Press the Apply Settings button in that section. If both sections are set to the same IP address the type will be temporarily cleared from the other section, to indicate which mode the printer is currently in. You should hear the printer chirp to indicate that it has received the command to change mode. After this chirp, open the lid of the printer, ensure that the correct media, either receipt paper or label paper, is in the printer and close the lid.

Important Notes and Troubleshooting:

If the printer is in label mode and you put label paper in the printer and close the lid, the printer should feed forward two labels and make a cut between labels. If it fails to do this, the printer is still in receipt mode and cannot be used to print labels until it is successfully put into label mode.

If the printer is in label mode and you put receipt paper in the printer and close the lid, the printer will feed out approximately 15" of receipt paper. It will then stop and be in an error state, the error light will be lit or blinking. At this point, you should put label paper in the printer and close the lid again.

The printer cannot be changed modes while in an error state. To clear the error state, either lift the lid and put in the correct media and close the lid, or leave the lid closed and turn the printer off and back on. When it is no longer in an error state you can use Quetzal to set the mode of the printer as described above.

iPad Internet Settings

The bottom of the screen will tell you what your iPad's current IP address is. Sometimes when more than one WiFi network is available in an area the iPad will join a network which the printers are not connected to. The first 3 numbers of the iPad's IP address should always match the first 3 numbers of the static IP addresses of your receipt and label printer.