1. ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
  2. ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
  3. ZPL Network Commands
  4. ^WX
  • ZPL II, ZBI 2, Set-Get-Do, Mirror, WML Programming Guide
^WX

^WX

Use this command to configure the wireless security settings for your printer. Values entered for this command must match what is configured on your WLAN and must be supported by the wireless radio card that you are using.

Configure Wireless Securities

The
^WX
 command replaces individual ZPL commands for different security types.
When using certificate files, your printer supports:
  • Using Privacy Enhanced Mail (PEM) formatted certificate files.
  • Using the client certificate and private key as two files, each downloaded separately.
  • Using exportable PAC files for EAP-FAST.
  • The supporting parameters that are required vary based on the security type that you select. See
    Supporting Parameters for Different Security Types on page 429
     for instructions for each security type.
The values 2, 3 for the security type (a) parameter, b, c, d, e, f, g and h parameters are ignored for printer running Link-OS 6.0 or later versions.
important:
 When using certificate files, the time on the printer must be set correctly for the websocket connection to succeed, as the time is used in the certificate validation.
Format:
^WXa,[zero or more supporting parameters]
Parameters
Details
a = security type
Enter the two-digit code for the security type that your WLAN uses. For which supporting parameters (b through n) to use with the different security types, see
Supporting Parameters for Differnt Security Types on page 429
.
Configuring the printer for WPA also allows the printer to be used in WPA2 environments.
Values:
01
 to
15
01
 - No wireless security is active
02
 = WEP 40-bit
03
 = WEP 128-bit
04
 = EAP-TLS
05
 = EAP-TTLS
06
 = EAP-FAST
07
 = PEAP
08
 = LEAP
09
 = WPA PSK (R6x15.x, R53.15.x, ZSPx, and later.)
10
 = WPA EAP-TLS
11
 = WPA EAP-TTLS
12
 = WPA EAP-FAST
13
 = WPA PEAP
14
 = WPA LEAP
15
 = Kerberos
Default:
01
b = WEP encryption index*
Specifies which encryption key to use for WEP encryption. A value must be specified if using WEP 40-bit or WEP 128-bit.
Values:
1, 2, 3, 4
Default:
1
c= WEP authentication type*
Enables the WEP key authentication type. A value must be specified if using WEP 40-bit or WEP 128-bit.
Values:
O
 or
S
O
 = open system
S
 = shared key
Default:
O
d = WEP key type*
Specifies the format of the WEP key. A value must be specified if using WEP 40‑bit or WEP 128-bit.
Values:
H
 or
S
H
 = hex key storage
S
 = string key storage
Default:
S
e,f,g,h = WEP encryption keys 1 through 4*
Specifies the actual values of any WEP encryption keys to be used. A value must be specified for at least one WEP encryption key if you specify 40-bit or 128-bit WEP encryption for the security type.
important:
 Be careful to include the exact number of commas required for this command when setting encryption keys (parameters
e
 through
h
). A missing or extra comma will cause the keys to be stored in the wrong slots and can prevent the printer from joining the wireless network.
The encryption mode affects what can be entered for the encryption keys:
  • For 40-bit, encryption keys can be set to any 5 hex pairs or any 10 alphanumeric characters.
  • For 128-bit, encryption keys can be set to any 13 hex pairs or any 26 alphanumeric characters.
When using hex storage, do not add a leading 0x on the WEP key.
Values:
The actual value for the encryption key
Default:
None
  • i = user ID*
Specifies a user ID for security types that require one. A value must be specified if using the following security types:
  • EAP-TTLS
  • LEAP
  • WPA LEAP
  • PEAP
  • WPA PEAP
  • WPA EAP-TTLS
  • Kerberos
Values:
The actual value for the user ID.
Default:
user
  • j = password*
Specifies a password for security types that require one. A value must be specified if using the following security types:
  • EAP-TTLS
  • LEAP
  • WPA LEAP
  • PEAP
  • WPA PEAP
  • WPA EAP-TTLS
  • Kerberos
Values:
The actual value for the password.
Default:
password
  • k = optional private key password*
Specifies an optional private key password for security types that require one. A value must be specified if using the following security types:
  • EAP-TLS
  • EAP-FAST
  • WPA EAP-TLS
  • WPA EAP-FAST
Values:
The actual value for the optional private key.
Default:
None
  • l = realm*
Specifies the realm for security types that require it. A value must be specified if using Kerberos.
Values:
The actual value for the realm.
Default:
kerberos
  • m = Key Distribution Center (KDC)*
Specifies the KDC for security types that require it. A value must be specified if using Kerberos.
Values:
The actual value for the KDC.
Default:
krbtgt"
  • n
     = Pre-Shared Key (PSK) value*
Enter the PSK value. This value is calculated and must be the same for each device on the WLAN. Use ZebraNet Bridge to generate the PSK value. A value must be specified if using WPA PSK.
important:
 Do not enter a pass phrase for this field in this command. To use a pass phrase, use the ZebraNet Bridge Enterprise Wireless Setup Wizard.
Values:
a minimum of 64 hexadecimal digits
Default:
None
* Not used for all security types

Supporting Parameters for Different Security Types

The supporting parameters required for this command vary based on the security type that you select. You should not use all of the supporting parameters each time that you use this command, nor will you use extra commas to separate unused fields. Follow the example and format for your specific security type in this section, substituting your own wireless network data.

Security Type 01: No Wireless Security Active

Format:
^WX01
Example:
This example turns off all wireless securities controlled under this command, but it does not reset the printer’s wireless settings to their defaults.
^XA
^WX01
^JUS^XZ

Security Type 02: WEP 40-Bit

Format:
^WX02,b,c,d,e,f,g,h
Example:
This example configures the printer for WEP 40-bit encryption using index key 1, open authentication, and a hexadecimal WEP key with a value of “
A1B2C3D4F5
.”
^XA
^WX02,1,O,H,A1B2C3D4F5,,,
^JUS
^XZ
This is no longer valid for Link OS 6 printers.

Security Type 03: WEP 128-Bit

Format:
^WX03,b,c,d,e,f,g,h
Example:
This example configures the printer for WEP 128-bit encryption using index key 2, open authentication, and four hexadecimal WEP keys.
^XA
^WX03,2,O,H,
001122334455667788,112233445566778899,223344556677889900,334455667788990011
^JUS
^XZ
This command is not valid for printers running Link OS 6 or later versions.

Security Type 04: EAP-TLS

Format:
^WX04,k
Example:
This example configures the printer for EAP-TLS authentication with an optional private key password with a value of “
private
.”
^XA
^WX04,private
^JUS
^XZ

Security Type 05: EAP-TTLS

Format:
^WX05,i,j
Example:
This example configures the printer for EAP-TTLS authentication, including a user ID of “
user
” and a password of “
password
.”
^XA
^WX05,user,password
^JUS
^XZ

Security Type 06: EAP-FAST

Format:
^WX06,i,j,k
Example:
This example configures the printer for EAP-FAST authentication, including a user ID of “
user
,” a password of “
password
,” and an optional private key of “
private
.”
^XA
^WX06,user,password,private
^JUS
^XZ

Security Type 07: PEAP

Format:
^WX07,i,j
Example:
This example configures the printer for PEAP authentication, including a user ID with a value of “
user
” and a password with a value of “
password
.”
^XA
^WX07,user,password
^JUS
^XZ

Security Type 08: LEAP

Format:
^WX08,i,j
Example:
This example configures the printer for LEAP authentication, including a user ID with a value of “
user
” and a password with a value of “
password
.”
^XA
^WX08,user,password
^JUS
^XZ

Security Type 09: WPA PSK

Configuring the printer for WPA also allows the printer to be used in WPA2 environments (R6x15.x, R53.15.x, ZSPx, and later.)
Format:
^WX09,n
Example:
This example configures the printer for WPA PSK authentication with a PSK value of all zeroes (64 hexadecimal digits).
^XA
^WX09,
00000000...
^JUS
^XZ

Security Type 10: WPA EAP-TLS

Configuring the printer for WPA also allows the printer to be used in WPA2 environments.
Format:
^WX10,k
Example:
This example configures the printer for WPA EAP-TLS authentication with an optional private key password with a value of “
private
.”
^XA
^WX10,private
^JUS
^XZ

Security Type 11: WPA EAP-TTLS

Configuring the printer for WPA also allows the printer to be used in WPA2 environments.
Format:
^WX11,i,j
Example:
This example configures the printer for WPA EAP-TTLS authentication, including a user ID with a value of “
user
” and a password with a value of “
password
.”
^XA
^WX11,user,password
^JUS
^XZ

Security Type 12: WPA EAP-FAST

Configuring the printer for WPA also allows the printer to be used in WPA2 environments.
Format:
^WX12,i,j,k
Example:
This example configures the printer for WPA EAP-FAST authentication, including a user ID of “
user
,” a password of “
password
,” and an optional private key of “
private
.”
^XA
^WX12,user,password,private
^JUS
^XZ

Security Type 13: WPA PEAP

Configuring the printer for WPA also allows the printer to be used in WPA2 environments.
Format:
^WX13,i,j
Example:
This example configures the printer for WPA PEAP authentication, including a user ID with a value of “
user
” and a password with a value of “
password
.”
^XA
^WX13,user,password
^JUS
^XZ

Security Type 14: WPA LEAP

Configuring the printer for WPA also allows the printer to be used in WPA2 environments.
Format:
^WX14,i,j
Example:
This example configures the printer for WPA LEAP authentication, including a user ID with a value of “
user
” and a password with a value of “
password
.”
^XA
^WX14,user,password
^JUS
^XZ

Security Type 15: Kerberos

Format:
^WX15,i,j,l,m
Example:
This example configures the printer for Kerberos encryption, including a Kerberos user ID with a value of “
user
,” a Kerberos password with a value of “
password
,” a realm of “
zebra
,” and a KDC of “
krbtgt
.”
^XA
^WX15,user,password,zebra,krbtgt
^JUS
^XZ