Troubleshooting
What Tillcast answers
A printer that is turned away gets a bare answer with no text, so that it tells a stranger nothing. What the printer meets tells you where to look. How fast a printer polls again after a refusal has not been measured on a device.
A mistyped secret names no printer, so Tillcast cannot store a hint about it. Compare the URL by hand.
Check in this order
- Compare the URL. Compare the URL in the printer’s settings with the URL you were given, character by character. The customer code is the part before
.print.tillcast.com. The secret is the part after the last/. See Printer URL. - Open the URL in a browser on the same network, or on a phone on the same network. The check page tells you whether the form of the URL is right, or whether there is a typo in the customer code or in the secret. It cannot tell whether the secret exists.
- Use
https. A URL that starts withhttp://fails to connect. - CloudPRNT or Server Direct Print is enabled, the settings are saved and the printer was restarted. Settings apply only after a restart.
- Username and password are empty.
- Date and time are right. The printer needs the right time to validate the HTTPS certificate.
- The network works. The printer needs outgoing HTTPS and working DNS.
- The maker is right. An Epson added as a Star never shows as connected, and the other way round.
GET /v1/printers/{printer}shows thevendor, andvendor_sourcesays where it comes from. A maker that was named (explicit) cannot be changed: delete the printer and add it again. A printer added by its paper width readsstarwithvendor_sourcedefaultuntil it first connects, which is not a mistake. If it has connected and still reads so, withdetectionpending, delete it and add it again with its maker named. - Ask the organization. Is the customer suspended or the location paused? See Suspension and pause. Does the printer’s address name an allowed device? See below.
- Read the printer’s status.
GET /v1/printers/{printer}, or the printer’s page in the dashboard, showsnever_connected,online,offline,wrong_host,mac_mismatch,customer_suspendedorlocation_suspended.wrong_hostmeans the secret was right and the host was not the printer’s.last_seen_atshows when the printer last polled.
The address names an allowed device
When an address names an allowed device, a printer whose MAC address is not that one gets the same bare 403 as a wrong URL. The usual causes are a mistyped MAC, a replaced printer, or a firmware that reports no MAC at all. The status mac_mismatch and the reported_mac appear only when the refused device reported a MAC, and they can take up to an hour to show. Compare the MAC with the label and the self-test print, then fix the field: PATCH /v1/printers/{printer} with the right allowed_mac, or with null to let any device in. A refused printer is let in about 30 seconds after the change, plus its poll interval. See Printer URL.
The printer connects but does not print
- Paper out, cover open or a jam. Check the printer first. A Star reports its condition to Tillcast, and
status_codeinGET /v1/printers/{printer}shows it, for example410 Out of paperor420 Cover open. With its spooler on, an Epson reports nothing after it has accepted a page. Epson lists the spooler per printer, and what the TM-m30III-H reports has not been tried. How a printer treats a waiting job while it has such a condition has not been tested. - The job ended as
failed.reasonandresult_codeof the job (GET /v1/jobs/{job}) say why. On a Star,510or511mean the printer cannot handle the data it was given: look at the printer’sprofilefirst, and try a test print. See Jobs. - The job is
failedwith the reasonresult_missing. This is an Epson. The page was handed to the printer and no result came back within about two minutes. It does not say whether the page printed: look at the paper before you print again. - The job is
failedwith the reasonpayload_unavailable. Tillcast no longer had the job’s bytes when the printer asked for it by name. This happens to a job that was taken and never confirmed, from an hour after itsexpires_at. Ifdelivered_atis set, the printer took the job before and may have printed it: look at the paper before you print again. See Jobs. - The job is
failedwith the reasonrendered_for_other_vendor. The printer was added by its paper width, and the page was queued before its first connection, so it was made for a Star. The printer that connected is an Epson. Nothing printed. Send the page again: it is made for the Epson. See Add a printer by its paper width. - A change of the printer is
409 printer_not_identified. The printer was added by its paper width and its maker is not known yet. Send the change again after the printer has connected. See Add a printer by its paper width. - A job stays
queuedwhile the printer is online. An older job is ahead of it: the oldest is served first. List the waiting jobs withGET /v1/jobs?printer=prn_...&status=pending, and cancel what is no longer needed. - Letters print as garbage or as
?. The profile’s character set is not the one you meant. The default Star profile writes the text in UTF-8 mode, which needs no code page. Acp852profile, orprint_options.encodingset tocp852, sends code page 852, which has the Polish letters. An Epson profile sendsmultilingualunlessencodingsays another: it selects a code page for each character, and the Swedish and the Polish samples printed correctly with it on an Epson TM-m30III-H, the only model checked.cp1252suits Western European text only and loses the Polish letters.cp852suits Central European text, such as Polish and Czech, and loses the Swedish letters. A character the set does not have prints as?, and the job’swarningssay where withcharacter_unmappable. See Profiles and print options. - Lines are cut off or run over the edge. The printer is on a wider profile than its paper. Choose the profile of its paper. For an Epson added by its paper width, check its line width on paper with the calibration sheet in the dashboard. See Set up an Epson printer.
- A line or a whole row is missing. This happens in
receiptlinetext, when a character of the ReceiptLine language is used as text. Read the job’swarnings, and escape your own text. Text in the blocks of adocumentis never markup and needs no escape. See Receipt documents. - Printing is slow over HTTPS. On a Star, each download and each confirmation may wait. Set Encryption Level to
MEDIUMin the printer’s CloudPRNT settings, then Save & Restart. This was seen through a tunnel and not against the production service. See Set up a Star printer. - The job expired. It was not printed within its lifetime. If its
delivered_atisnull, the printer never took it. Ifdelivered_atis set, the printer took it and no confirmation came, so look at the paper before you print again. See Jobs. - A receipt printed twice. Tillcast delivers each job to a Star printer at least once, so after a power cut a Star printer can print the same job twice. An Epson is not offered a job again. See Jobs.
- The printer shows
offline. It has not polled for about 4 minutes: it is switched off, off the network or asleep, or its polling interval is above 60 seconds.last_seen_atsays when it last polled, and the status isonlineagain at its next poll.