zpl.tools
Network and wireless

^KC - Set DHCP Client Identifier

Chooses the client identifier a network device sends with its DHCP requests.

^KC sets the client identifier a network device sends with its DHCP requests. A DHCP server can then recognize the printer by name, and not only by its MAC address. The first argument decides how the last two are read. Modes 0 and 1 read neither the prefix nor the identifier, mode 2 reads both as ASCII, and mode 3 reads both as hexadecimal. The length limits change with the mode.

Syntax

^KCa,b,c,d

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.

DHCP address negotiation happens before a format arrives, and none of it reaches the label. 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

aIdentifier modeoptional · one of a set

Whether the device sends a custom client identifier, and in what form.

Default
0
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (0, 1, 2, 3).
0
Disabled (default)
1
Enabled, with the MAC address
2
Enabled, with the ASCII value given below
3
Enabled, with the hexadecimal value given below
bNetwork deviceoptional · one of a set

Which device the identifier applies to.

Default
1
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (0, 1, 2, 3).
0
All network devices
1
The wireless device (default)
2
The external wired device
3
The internal wired device
cPrefixoptional · text

Optional prefix placed in front of the identifier. Up to 11 ASCII or 22 hexadecimal characters, depending on the mode.

Default
none
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
dClient identifieroptional · text

The identifier itself. Up to 60 ASCII or 120 hexadecimal characters, depending on the mode.

Default
none, because modes 0 and 1 do not read it
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage

Behavior

The ZPL II Programming Guide edition held in this repository (45541L-004, 2006) does not document this command. The parameters above come from Labelary's own command reference, the only available description of ^KC.

DHCP negotiation finishes before a format reaches the printer, and a label image cannot depend on how the printer asked for its address.

The renderer ignores this command and reads no arguments. It reports IGNORED_COMMAND at info severity, which does not reach the X-Warnings header. Labelary is also silent, so the rendered label is identical in both engines.

Example

^KC changes nothing on the label. The text prints exactly as it would without the command:

^XA
^KC1,1
^FO40,60^A0N,50,50^FDDHCP client ID^FS
^XZ

Open in viewer