~RO - Reset Advanced Counters

Zeroes one of the printer's resettable counters of labels printed and media used.

~RO zeroes one of the printer's resettable counters: the running totals of labels printed and media used. They appear on the printer configuration label and feed the early-warning and maintenance limits. A reset starts a fresh count after an operator changes a consumable or a printhead.

Syntax

~ROc

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.

The command zeroes an odometer that appears on the printer configuration label and drives the maintenance warnings. A render keeps no such counter. 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

cCounterrequired · one of a set

Which resettable counter to zero. Counters 3 and 4 exist only on RFID printers, which document four counters where a plain printer has two.

Invalid value: not documented, and we have not measured it. The renderer does not parse or measure this command. The printer ignores a command with no value. The guide does not state what a value outside the set does.
Test coverage: No documented value is exercised by a test (1, 2, 3, 4).

1: Counter 1
2: Counter 2
3: Valid RFID label counter, on RFID printers
4: Voided RFID label counter, on RFID printers

Behavior

A plain printer has two of these counters; an RFID printer documents four, and adds a count of valid RFID labels and a count of voided ones. The guide notes that a single error in a tag write makes that label count as voided.

The guide states that the printer ignores the command when no counter number is given. This API has no odometer, so the renderer ignores this command, and ^JH and ^MA, which read these counters, are equally inert.

Example

Counter 1 reset:

^XA
~RO1
^FO50,50^A0N,30,30^FDCounter reset^FS
^XZ

Open in viewer

^JH Early Warning SettingsConfigures the consumable and maintenance warnings the printer reports as media, ribbon and printhead wear out.
^MA Set Maintenance AlertsSchedules the maintenance alert labels the printer prints itself as the printhead wears.
~HQ Host QuerySends one of ten named printer reports back to the host.