^RR - Enable Adaptive Antenna Selection

^RR sets the retry count for one block of one tag: how many times the printer repeats a read or a write before the operation counts as failed. This count is not ^RS parameter n, which counts complete labels and not attempts on a single tag. The setting is persistent and applies to the ^RF commands that follow it.

Syntax

^RRn,a

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.

A radio retry policy. Nothing it does appears on 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 and with or without the command. — not pinned by a test

Labelary renders this command.

Parameters

nNumber of retriesoptional · integer

The guide lists this parameter as reserved and states no values or default for it.

Default: not documented; the guide marks the parameter reserved
Invalid value: not documented, and we have not measured it. The renderer does not parse this command or validate its arguments. The guide does not state what a printer does with an out-of-range value.
Test coverage

aAdaptive antenna element selectionoptional · one of a set

Whether the printer retries a failed operation on adjacent antenna elements. Valid only on the ZT400 and ZT600 series, and only on labels 51 mm or longer.

Default: 0
Invalid value: not documented, and we have not measured it. The renderer does not parse this command or validate its arguments. The guide does not state what a printer does with an out-of-range value.
Test coverage: No documented value is exercised by a test (0, 1).

0: None. The printer uses only the current antenna element. (default)
1: Neighbors. The printer tries the elements left, right, above and below, and keeps a successful one for later commands.

Behavior

The guide contradicts itself on the default. Its description says that the printer makes six retries, and its parameter table on the same page says 0. Neither value is measurable here, so this page records the table's value above.

The guide documents the adaptive antenna parameter for firmware later than the 2006 edition. It restricts the parameter to the ZT400 and ZT600 series, and to labels of 51 mm or more. With the parameter on, the printer repeats a failed operation on the elements above, below, left and right of the current element. It keeps a successful neighbor for later commands.

Retries change the reliability of an encode and never change the printed image. The ^RF command that the retries apply to does not print its payload.

Tested behavior

Example

The guide's write-retry example, with a caption:

^XA
^FO50,50^A0N,40,40^FDretries 2^FS
^RR2
^RFW,H^FD1234^FS
^XZ

Open in viewer

^RW Set RF Power Levels for Read and WriteSets the radio power used for reading and writing tags, and picks the antenna element.
^RS Set Up RFID ParametersSets the tag type, the programming position and what the printer does when encoding fails.
^HR Calibrate RFID Tag PositionRuns RFID tag calibration and returns the resulting position and power table to the host.
^HL / ~HL Return RFID Data Log to HostReturns the printer's log of RFID read and write operations to the host.