Learn/GcodePilot/Jogging & control
Pendants
Updated v2.6.1At a glance
- Promach Pendant, stock XHC WHB04B-4 / -6 and wired LHB04B work out of the box
- Every key and Fn+key is customizable, with a live diagram and printable cheat sheet
- Experimental: Centroid WMPG-4 (Acorn) / WMPG-6, older XHC HB04, ShuttleXpress/PRO and gamepads
- Test Torch follows fire_torch automatically or uses direct-output, spindle-style or custom MDI commands
- THC volts up/down use the same AVTHC control as the keyboard, with a per-cut limit
- Shuttle Mode turns every capable wheel, Jog ± / Y± control, Contour ring or gamepad Y stick into path motion
- A separate PointTrace key layer captures a whole trace from the pendant while the PointTrace dialog is open
- Follows the active machine — and keeps working while you design in another tab
GcodePilot works with the common CNC pendants. Turn the pendant on under Machine Config → Pendant, pick the pendant that matches the labels on your keys, and plug in its receiver or cable.
Supported pendants
- Promach Pendant — the pendant supplied with Promach machines. Machines that already used a pendant stay on this layout automatically.
- XHC WHB04B-4 / WHB04B-6 (and the wired LHB04B) with the standard keys: Reset aborts, Stop is a feed hold, Start/Pause starts or pauses, Feed± sets the feed override, M-Home homes, Safe-Z raises Z, W-Home goes to work zero and Probe-Z runs your Z touch-off. On plasma tables Spindle± adjusts THC volts and S-On/Off tests the torch; on routers and mills those keys run the spindle. Hold Fn for a second layer: Zero X/Y/Z, Dry Run, Park, work/machine coordinates, Shuttle and more.
- Experimental: Centroid Plasma WMPG-4 (Acorn) and WMPG-6, older XHC HB04/WHB04 pendants, Contour ShuttleXpress/ShuttlePRO, and Xbox/PlayStation gamepads. Use Learn keys to teach JetCad3 each key on your unit, then check every action before cutting. Gamepads only move the machine while you hold the deadman button (LB / L1).
- Keyboard-style pendants: every pendant action is also a keyboard shortcut under Settings → Keyboard → GcodePilot → Pendant actions.
What the controls do
The wheel jogs the axis selected on the axis knob, at the step or speed on the right knob. In continuous mode, hold a jog key to move for as long as you hold it; in step mode a tap moves one increment.
Turn on Shuttle Mode from GcodePilot, a configured Shuttle key, or the WHB04B Fn + S-On/Off binding. Once GcodePilot accepts the mode, every capable pendant follows the loaded program instead of free-jogging: handwheels and dials set path direction and feed, generic Jog ± and Y± buttons hold forward/back motion, the Contour ring uses direction and deflection, and a gamepad uses its Y stick with the normal deadman. X and Z directional inputs are ignored while Shuttle is active, matching the keyboard behavior. Centering or releasing a control, losing its watchdog, disconnecting, or leaving Shuttle stops the correct motion. Plain S-On/Off on the stock WHB04B remains Test Torch.
The Pendant settings show a live diagram of your pendant and what each key does. Change any key, restore the preset, print a one-page cheat sheet, and set up four macros that send your own G-code when the machine is idle.
PointTrace keys
While the PointTrace dialog is open, the pendant switches to a second set of keys so you can capture points, choose constructions, close loops and undo without leaving the table. Stock XHC WHB04B-4/-6 pendants and gamepads come with suggested keys. Other pendants start empty, so they behave exactly as before until you assign keys. Set them under Machine Config → Pendant → PointTrace keys. Keys that stop the machine (Reset, Stop, Start/Pause, and Abort/Feed hold on a gamepad) are locked and never change. A key left on "Normal" keeps its usual job. The printed cheat sheet adds a PointTrace page whenever PointTrace keys are assigned.
Test Torch setup
Choose how Test Torch controls this machine under Machine Config → Pendant:
- Auto — fire_torch (Recommended) reads the Torch Output P index already configured in your
fire_torchroutine. It pulses that output directly; it does not call the routine, probe, touch off or move Z. - Digital output sends
M64 P…to turn the selected output on andM65 P…to turn it off. - Spindle-style sends
M3 S…followed byM5. This supports GRBL-style plasma tables that use a fixed setting block or manual torch height instead of an automatic touch-off cycle. - Custom MDI sends your separate ON and OFF command lists exactly as entered.
The settings show the resolved commands before you save. Auto sends nothing if fire_torch cannot supply
a valid output; choose an explicit strategy instead. Test Torch only runs while the machine is connected
and Idle. If the controller disconnects before OFF is acknowledged, JetCad3 reports that the output state
is unknown so you can verify the machine before continuing.
THC volts while cutting
On AVTHC machines the pendant THC keys use the same target-voltage control as the on-screen and keyboard +/− controls. During a cut, pendant adjustments are limited to ±10 V per cut by default. Between cuts they adjust the override target through that same AVTHC path.
Follows your focus
The pendant drives the machine whose GcodePilot tab is focused — and keeps driving the most recent one while you work in another workspace, since jobs keep running in the background. It reconnects automatically when the receiver reappears.