zpl.tools
Network and wireless

^NI - Network ID Number

Assigns this printer its ID on an RS-485 multi-drop network.

^NI gives the printer its own ID on an RS-485 multi-drop network, which later lets ~NC address it individually. The guide requires this before a printer can work on such a network, and the system recognizes the last ^NI sent. Two ^NI commands in one format therefore assign the second, without complaint.

Syntax

^NI###

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.

Identifies a physical printer on a shared bus, not label content. 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

###Network ID numberoptional · integer

The ID to assign, written as exactly three digits. The last ^NI sent wins.

Default
000 (no network ID)
Accepted range
1 to 999
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide requires three digits but does not state what a shorter or out-of-range value does.
Test coverage
No test at the minimum, maximum or one step outside the range.

Behavior

The ID is exactly three digits. Accepted values are 001 to 999, and the default is 000, which means no network ID. The guide does not state what happens to a shorter entry or a value outside that range, so this page claims no rule for it.

The guide restricts ^NI to RS-485 printer communications, with ~NC, ~NR and ~NT. A rendering request carries one format and returns one document, and no bus needs the printer's identity.

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

Assigning ID 005. Nothing about the rendered label depends on it:

^XA
^NI005
^FO40,60^A0N,50,50^FDNetwork ID 005^FS
^XZ

Open in viewer