zpl.tools
Printer configuration

~JF - Set Battery Condition

Chooses whether a battery-powered printer pauses when the battery is nearly flat.

~JF decides what a battery-powered printer does when its battery is nearly flat. The choice is between a half-printed label and a lost one. With the pause enabled, the printer stops before the voltage falls far enough to corrupt the format it holds. With the pause disabled, it runs until it stops working.

Syntax

~JFa

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 manages battery power. This service has no battery and nothing to pause. 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

aPause on low poweroptional · Y or N

Whether the printer stops before the battery dies mid-label. This avoids a half-printed label and does not change a complete one.

Default
Y
Invalid value
not documented, and we have not measured it. The renderer does not parse or measure this command.
Test coverage
No documented value is exercised by a test (Y, N).
Y
Pause when the battery is nearly flat (default)
N
Print until it dies

Behavior

The guide describes two voltage limits. At the first, the printer only flashes a warning light and continues to print, whatever this setting is. ~JF governs the second. ~JFY pauses and shows an error until an operator connects the charger; FEED then prints one label at a time and risks the format. ~JFN continues with no further indication.

N suits a printer on the car battery adapter, where the supply recharges continuously and the low reading is not a real warning. It is the wrong choice on battery alone.

This API has no battery and no print cycle to pause, so the renderer ignores this command.

Example

Pausing enabled, ahead of an ordinary label. The label renders exactly as it would without the command:

^XA
~JFY
^FO50,50^A0N,40,40^FDBattery pause on^FS
^XZ

Open in viewer

  • ~KB Kill BatteryRuns the printer's rechargeable battery flat so an operator can recondition it.
  • ^JZ Reprint After ErrorControls whether the printer reprints a label that an error interrupted, after the error clears.