zpl.tools
Network and wireless

^WI - Change Wireless Network Settings

Sets the wireless print server's addressing, timeout and raw port.

^WI configures the wireless print server's addressing: how it obtains an IP address, the address, mask, gateway and WINS server, the connection timeouts and the raw port it listens on. It is the wireless counterpart of ^NS and takes the same nine arguments in the same order; only the network the settings apply to differs. Which of the two a printer uses follows from the print server it boots with, and ^NB influences that, not this command.

Syntax

^WIa,b,c,d,e,f,g,h,i

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.

IP configuration for the wireless print server; 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

aIP resolutionrequired · one of a set

How the wireless print server obtains its IP address.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
No documented value is exercised by a test (A, B, C, D, G, R, P).
A
All methods
B
BOOTP
C
DHCP and BOOTP
D
DHCP
G
Gleaning only, which the guide advises against when a wireless print server is fitted
R
RARP
P
Permanent. The printer uses the address below as written.
bIP addressrequired · text

The address in xxx.xxx.xxx.xxx form.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
cSubnet maskrequired · text

The mask in xxx.xxx.xxx.xxx form.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
dDefault gatewayrequired · text

The gateway in xxx.xxx.xxx.xxx form.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
eWINS server addressrequired · text

The WINS server in xxx.xxx.xxx.xxx form.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
fConnection timeout checkingrequired · Y or N

Whether the print server times an idle connection out at all.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
No documented value is exercised by a test (Y, N).
Y
Check for timeouts
N
Do not check
gTimeout valuerequired · integer

Seconds of inactivity before the connection drops.

Accepted range
0 to 9999 seconds
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states no default.
Test coverage
No test at the minimum, maximum or one step outside the range.
hARP broadcast intervalrequired · integer

Minutes between the broadcasts that refresh the ARP caches of other devices on the segment.

Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command. The guide states neither a range nor a default.
Test coverage
iBase raw port numberoptional · integer

TCP port the print server listens on for raw ZPL.

Default
9100
Accepted range
0 to 99999
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 first argument selects the resolution method, and the guide advises against G (gleaning only) on a printer with a Wireless Print Server. The address arguments are dotted quads. The timeout is in seconds and the ARP broadcast interval in minutes. Only the raw port number carries a documented default, 9100.

None of it reaches a label. 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

A DHCP-resolved wireless print server with an address, mask and gateway supplied. The label renders as though the command were absent:

^XA
^WID,192.168.0.60,255.255.255.0,192.168.0.1
^FO40,60^A0N,50,50^FDWireless settings^FS
^XZ

Open in viewer