^WS - Set Wireless Card Values

^WS sets the three values that decide which wireless network the card joins and how it talks on that network: the ESSID, infrastructure or ad-hoc mode, and the preamble length. The ESSID argument has a behavior the type cannot show. A blank ESSID does not clear the ESSID; it keeps the current one. ^WS,A,S therefore changes the mode and preamble, and leaves the network name alone.

Syntax

^WSe,o,p

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.

Radio association settings, decided before any format arrives. 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

eESSID valueoptional · text

The network name to associate with, up to 32 characters including spaces and extended ASCII. Blank keeps the current ESSID.

Default: 125
Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage

oOperating modeoptional · one of a set

Whether the card joins an access point or a peer-to-peer network.

Default: I
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 (I, A).

I: Infrastructure (default)
A: Ad hoc

pWireless card preambleoptional · one of a set

Preamble length used on the air.

Default: L
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 (L, S).

L: Long (default)
S: Short

Behavior

The ESSID holds up to 32 characters and can contain spaces and extended ASCII. The guide gives its default as 125, which reads oddly for a network name but is what the guide states.

Operating mode I joins an access point and A forms a peer-to-peer network. The preamble is long (L) or short (S) and must match what the access point expects.

None of this can affect a label image.

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

Joining an access point with a long preamble:

^XA
^WS125,I,L
^FO40,60^A0N,50,50^FDESSID 125^FS
^XZ

Open in viewer

^WA Set Antenna ParametersSelects which physical antenna the radio receives and transmits on.
^WR Set Transmit RateChooses which radio bit rates the card can use, and its transmit power.
^WE Set WEP ModeEnables WEP on the wireless card and loads its four encryption keys.
^WI Change Wireless Network SettingsSets the wireless print server's addressing, timeout and raw port.