~KB - Kill Battery
Runs the printer's rechargeable battery flat so it can be reconditioned.
~KB puts a portable printer into battery discharge mode, where it drains the
rechargeable battery and prints nothing. A regular discharge keeps a nickel-based
pack's capacity from drift, which is why the command exists.
Syntax
~KBSupport
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 performs battery maintenance on hardware this renderer does not have. 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
~KB takes no arguments.
Behavior
The guide notes that discharge mode ends when a format arrives or an operator presses a control panel key. The battery then recharges automatically if the charger is connected. The power LED flashes in groups of three while the mode runs.
This API has no battery, so the renderer ignores this command. The next format ends
discharge mode on hardware too, so a ~KB ahead of a label changes nothing there
either.
Example
Discharge mode requested, then a label. The label renders unchanged:
^XA
~KB
^FO50,50^A0N,40,40^FDDischarge^FS
^XZ
Related commands
~JFSet Battery ConditionChooses whether a battery-powered printer pauses when the battery is nearly flat.~JBReset Optional MemoryReinitializes the B: drive, the operation a printer needs after its memory-card battery fails.