zpl.tools
Host status and queries

~HI - Host Identification

Sends the printer model, firmware version, resolution, memory size and detected options back to the host.

~HI asks the printer to identify itself. The printer replies with one comma-separated line: its model, firmware version, resolution in dots per millimeter, installed memory and any detected options. Software that adapts a format to the printer it found starts here.

Syntax

~HI

Support

Recognised, deliberately skippedparsed: none · state: none · rendered: none

Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.

Returns an identification string over the printer's link. Callers that use it to detect a printer model get nothing here; the API version is the equivalent fact. The renderer does not parse this command. It reports IGNORED_COMMAND at info severity, which does not reach X-Warnings. Labelary is also silent, so the rendered label is identical in both engines. — not pinned by a test

Labelary renders this command.

Parameters

~HI takes no arguments.

Behavior

The guide gives the reply as XXXXXX,V1.0.0,dpm,000KB,X. The fields are model, software version, dots per millimeter (6, 8, 12 or 24), memory in kilobytes, then a field of recognizable options such as a cutter. None of it is a label instruction.

A render request cannot answer, and it settles these facts elsewhere. The resolution is part of the request URL, not a property of a device, and no options exist to detect. The renderer ignores the command, and the page is unchanged. It reports IGNORED_COMMAND at info severity, which does not reach X-Warnings. Labelary is also silent.

Example

Probing for a printer identity and printing in the same format — the probe part does nothing.

^XA
~HI
^FO50,50^A0N,40,40^FDIdentify^FS
^XZ

Open in viewer