First-run setup¶
The first time you launch FocuZ, the Device Setup window opens automatically. It also re-opens if you try to Run or Trace before the device is configured. You can revisit it any time from Device ▸ Device Setup.
Marking is blocked until the device is configured
FocuZ won't let you Run or Trace until you've imported a markcfg7. This prevents marking
with an unconfigured axis mapping.

Everything is on one page: a Device Setup section on top, Lens Setup below it, and an optional Rotary Setup at the bottom.
Device Setup¶
Select your laser type, then import your markcfg7 to configure the device.
- Laser type — choose JCZ Fiber (the supported type today).
- Click Import markcfg7… and select your machine's
markcfg7file (the same file EZCad2 uses). This loads the device settings — galvo X/Y axis mapping and the device's speed and timing defaults — and marks the device configured, which unlocks Run and Trace. - The status line confirms "Device configured (markcfg7 imported)."
What markcfg7 import sets — and doesn't
This section imports device-level settings only. Per-lens correction (the .cor file or
manual values) is configured in the Lens Setup section, and rotary axis settings in the
Rotary Setup section. FocuZ remembers the imported markcfg7, so lens and rotary setup can
reuse it without asking for the file again.
Lens Setup¶
Configure the lens you'll mark with. Set its correction (a .cor file or manual values).
- Pick the Lens you're using (L1–L8). FocuZ keeps correction settings per lens, so each lens has its own field size, scale/angle, and correction.
- Click Corrections… to open the correction dialog and either:
- load a
.corfile (recommended — the lens map EZCad2/LightBurn use), or - enter manual correction values — typed in directly, imported with From device markcfg7 (reuses the file you imported above, no re-picking), or imported from any file with Choose markcfg7….
- load a
- (Later) set the lens's focal Z height on the Jog ▸ Lens Offset screen — see Lenses, Corrections & Calibration.
See Lenses, Corrections & Calibration for what each correction setting does.
Rotary Setup (optional)¶
If you use a rotary, import its axis settings.
If your machine has a rotary axis, pull its settings in here too:
- From device markcfg7 — reuses the
markcfg7you imported above (no re-picking). - Choose markcfg7… — imports from any other
markcfg7file. - Defaults… — opens the full Rotary Setup dialog, where you can also enter default part diameter, split size, and overlap values for new 2D Rotary actions.
Either way, only the motor parameters are read from the file — steps per rotation, direction, and speeds. FocuZ-side rotary settings (chuck/roller mode, gear ratio, roller size, the part/split defaults) keep their current values — gear ratio describes your rotary attachment, so it's never taken from the file. The line below the buttons shows the rotary values currently in use.
Click Finish when you're done. You can fine-tune lenses any time via the Corrections dialog, and set focal Z heights on the Jog tab.
Next: Your first mark.