~RV - Configure RFID Reporting
Turns on or off the unsolicited result message the printer sends after each encode attempt.
~RV turns on an unsolicited message that the printer sends after every format
that touched a tag: whether the encode succeeded, and how many labels it voided.
It is the cheapest way for a host to notice that a run quietly scraps media, and
the counter matters more than the sign.
Syntax
~RVaSupport
Accepted and skipped, because it configures the printer rather than the label. It cannot change the rendered output, and Labelary skips it too.
Controls a message the printer sends over the host channel after an encode. This service has no encode and no host channel. 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
aEnable reportingoptional · one of a setWhether the printer sends an encode result to the host after each format completes. The result is a signed count, _+,2_ for a success that voided two labels and _-,3_ for a failure that voided three.
- Default
- E
- 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 (E, D).
E- Enable reporting. (default)
D- Disable reporting.
Behavior
The result arrives as a signed count between underscores. _+,2_ means the encode
succeeded after two voided labels, and _-,3_ means it failed altogether after
three. A run can therefore report success and still consume twice the media it
needs.
As a ~ command it acts when the printer reads it, and not with the format around
it, so a host normally sends it once ahead of a batch. Nothing about it reaches
the label, and there is no host channel to report on here.
Tested behavior
Example
The guide's example, turned into a write so the label is not blank:
~RVE
^XA
^RS8,0,,3
^RMY
^FO50,50^A0N,40,40^FDencode attempted^FS
^RFW,H^FD1234ABCD^FS
^XZ
Related commands
^RSSet Up RFID ParametersSets the tag type, the programming position and what the printer does when encoding fails.^HL / ~HLReturn RFID Data Log to HostReturns the printer's log of RFID read and write operations to the host.^RFRead or Write RFID FormatReads a tag, encodes a tag, or declares the access password used by later lock commands.