Hardware & Device Setup¶
This page covers connecting to the controller and the device-level settings under the Device menu. If you're setting up for the first time, start with First-run setup; this page is the deeper reference.
Device vs. lens settings
Device settings (here) describe the controller and galvo head — field size, axis mapping, laser timing. Lens settings (correction, focal Z) are per-lens and live in Lenses, Corrections & Calibration.
Connecting (Device ▸ Connection)¶

- Open Device ▸ Connection.
- Pick your controller from the device list and click Connect.
- When connected, FocuZ shows the firmware version and serial number and a green status indicator; the current lens and correction-file status are also shown.
- Refresh re-scans USB. Install Driver appears when a controller is plugged in but has no WinUSB driver — see Installation & driver.
FocuZ can reconnect automatically on startup. The controller must be connected to Trace or Run.
Device Setup Wizard (Device ▸ Setup Wizard)¶
The guided 3-step wizard (laser type + markcfg7 import, lens correction, summary). It's the fastest way
to a working configuration and is covered step-by-step in
First-run setup. Importing a markcfg7 is what marks the device
configured and unlocks Run/Trace.
Laser Setup (Device ▸ Laser Setup)¶
The full device configuration screen. It includes the same connection controls plus:
Importing the device profile¶
- Import markcfg7 — loads device settings from your machine's
markcfg7(field size, field angle, galvo axis mapping). This is the recommended way to configure the device; manual entry is for fine-tuning.
Galvo axis assignment¶
- Galvo 1 / Galvo 2 → X / Y — which physical galvo drives which axis. This comes from
markcfg7; only change it if your art marks transposed (rotated/mirrored axes). - Mirror toggles per galvo — flip an axis direction if the mark is mirrored.
If marks come out rotated or mirrored
The fix is almost always the galvo X/Y assignment or a mirror toggle here. A re-import of the correct
markcfg7 usually sets these for you.
Laser timing & pulse¶
- Open MO delay — delay after opening the laser's master oscillator before marking.
- Enable pulse width — toggles pulse-width control.
- Delays — laser on/off, polygon (corner), and end delays; jump speed and ramp settings. Defaults from
markcfg7are a good starting point; tune for mark quality.
Frequency limits¶
- Min / Max frequency (kHz) — the allowed pulse-frequency range for your laser (1–9999). FocuZ clamps per-layer frequency to this range so you can't drive the laser outside spec.
Path tolerances¶
- Curve tolerance (mm) — how finely curves are approximated into line segments. Smaller = smoother curves but more segments.
- Closed-path tolerance (mm) — how close endpoints must be for a path to count as closed (affects fills).
Power Map (Device ▸ Power Map)¶

A curve that maps requested power → actual output power at 0 %, 10 %, … 100 %. Use it to linearize a laser whose output isn't proportional to the set percentage, or to cap output. Linear resets to a 1:1 map; Reset restores defaults.
Rotary¶
Rotary-axis configuration lives under Device ▸ Rotary Setup and is covered in Rotary Marking.
See also¶
- Lenses, Corrections & Calibration — per-lens field size, correction, focal Z.
- Jog, Homing & Terminal — homing and axis control.
- Troubleshooting & FAQ — controller-not-found, driver issues.