zpl.tools
Printer configuration

^KP - Define Password

Sets the four-digit password guarding the printer's front panel.

^KP sets the four-digit password that guards the printer's control panel switches and its LCD setup mode. It protects the device from the operator at the panel, not the format from anybody.

Syntax

^KPa,b

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.

The command protects a front panel that does not exist. 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

aPasswordoptional · text

The new front-panel password. Must be exactly four digits.

Default
1234
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
bPassword leveloptional · integer

Which group of protected settings the password covers.

Default
3
Accepted range
1 to 4
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No test at the minimum, maximum or one step outside the range.

Behavior

The password is recoverable, and the guide is blunt about the cost. A printer can return to its default setup mode, where 1234 is valid again. That reset also returns every configuration value to its factory default. ^JUF does the same over ZPL.

The level in the second argument decides which settings the password covers. ^MP is the sharper instrument, because it disables individual panel functions instead of a password prompt.

This API has no control panel, so the renderer ignores this command. The password is not secret from anyone who can read the format.

Example

A new panel password at the default level:

^XA
^KP5678,3
^FO50,50^A0N,30,30^FDPassword set^FS
^XZ

Open in viewer