xTool D1 Pro + LightBurn Setup Guide
The xTool D1 Pro connects to LightBurn via USB. Import the official xTool-D1ProV3.lbdev config file from xTool's support centre — it sets the 430 × 390 mm work area, homing, scanning offsets, and S-value automatically. Then open the LightBurn console and send $32=1 to enable laser mode. Focus with the included focal bar, and test-engrave basswood at 65% power, 3,000 mm/min to confirm everything works. Total setup time: about 20 minutes. — Laser Tinkerer, 2026
What you need before you start
- LightBurn — download the 30-day free trial from lightburnsoftware.com (Core licence is $99 one-time after trial; no subscription)
- CH340 USB driver — required for Windows and older macOS versions; the xTool D1 Pro uses a CH340 USB-to-serial chip
- xTool D1 Pro config file —
xTool-D1ProV3.lbdev, downloaded from xTool's support centre (support.xtool.com) - A quality USB cable — use the included cable first; if you get disconnections, replace it with a short shielded USB-A to USB-B cable
- Safety glasses (OD7+, 450 nm) — wear them any time the laser is powered on
Step 1 — Install the CH340 USB driver
Before you plug in the D1 Pro, install the CH340 driver for your operating system. Without it, your computer sees an "Unknown device" and LightBurn cannot find the machine.
| OS | Driver source | Common issue |
|---|---|---|
| Windows 10/11 | WCH official site or xTool's support centre | Windows Update sometimes installs an old version — use the WCH version instead |
| macOS 13+ | WCH signed driver for Apple Silicon / Intel | Must grant security extension permission in System Settings → Privacy & Security after install |
| Linux | Built into the kernel (3.12+) | Add your user to the dialout group: sudo usermod -a -G dialout $USER, then log out and in |
After installing, plug in the D1 Pro via USB. The machine should power on and the laser head should begin homing (moving to the rear-left corner). In LightBurn, the COM port will appear in the device bar at the bottom of the screen.
Step 2 — Import the xTool D1 Pro config file
xTool publishes an official LightBurn device file that configures all the machine-specific parameters in one step. Do not use File → Import Prefs — that path overwrites unrelated LightBurn settings and can break your existing configuration.
- Go to support.xtool.com and search for "D1 Pro LightBurn" to find the config file download page
- Download
xTool-D1ProV3.lbdev - In LightBurn, open Devices (the laser icon in the top toolbar, or Edit → Devices)
- Click Import and select the .lbdev file
- The D1 Pro appears in your device list. Select it and click OK
- Verify the work area shown in LightBurn matches your machine: 430 × 390 mm for the 20W, 430 × 400 mm for the 10W
The config file automatically sets: work area dimensions, homing direction (rear-left), S-value max (1000), scanning offset corrections, and the device profile. You should not need to enter any of these manually.
Step 3 — Enable laser mode: send $32=1
The single most common setup mistake with any GRBL diode laser is forgetting to enable laser mode. Some D1 Pro units ship with $32=0, which means the laser runs at constant power — burning extra-dark at every corner and direction change.
| Parameter | Correct value | What it does | How to set |
|---|---|---|---|
$32 |
1 | Laser mode — scales power with head speed (M4). Without it: constant-power burns at corners | Type $32=1 in the console, press Enter |
$30 |
1000 | S-value max — maps LightBurn's 100% power to S1000. If set to 255, power percentages are wrong | Type $30=1000 in the console |
$13 |
0 | Report distances in mm (not inches). Prevents confusing mixed-unit coordinates | Type $13=0 in the console |
To open the console in LightBurn: click the small terminal icon at the top right, or go to Window → Console. Type each command and press Enter. GRBL replies with ok for each successful command.
These settings are stored in the D1 Pro's firmware flash memory and persist between sessions. You only need to set them once — unless you flash new firmware.
$$ — type $$ in the console to print all current GRBL settings. Scroll down to confirm $32=1, $30=1000, and $13=0. This is also useful for diagnosing problems reported on LightBurn's forum — always include your $$ output when asking for help.
Step 4 — Focus with the focal bar
The xTool D1 Pro uses a physical focal bar rather than a fixed focal length setting. The bar slides between the laser head and the material and physically positions the head at the correct focal distance — you do not need to measure or calculate anything.
- Place your material on the work surface
- Jog the laser head over the material using LightBurn's Move panel (or the arrow keys on the D1 Pro's control panel)
- Slide the included focal bar between the underside of the laser module and the top surface of your material
- Loosen the head height lock, lower the head until it gently rests on the focal bar, then re-tighten
- Remove the focal bar — the head is now at the correct focal distance
For cutting: focus on the surface (as above). For thick materials you want to cut through: some users focus slightly inside the material (raise the work surface by half the material thickness). This is an advanced technique — start with surface focus.
Step 5 — Frame and run your first job
Before you press Start on any job, use LightBurn's Frame function to preview the job boundary. The D1 Pro's positioning laser (the crosshair) traces the bounding box — you can see exactly where the job will land before it burns anything.
- Draw a 20 × 20 mm square in LightBurn (use the rectangle tool)
- Set mode to Fill, speed 3,000 mm/min, power 65% (good starting point for 3mm basswood at 10W)
- Place a piece of basswood or scrap wood in the work area
- Click Frame — the head traces the boundary with the positioning laser. Adjust position if needed
- Put on your OD7+ safety glasses
- Click Start
How the D1 Pro modules differ (5W / 10W / 20W)
All three D1 Pro modules use the same GRBL parameters and LightBurn setup steps. The differences are in what each module can cut and engrave, not in software configuration.
| Module | Work area | Diodes | Spot size | Best for | 3mm plywood |
|---|---|---|---|---|---|
| 5W | 430 × 400 mm | 2 | ~0.08 × 0.10 mm | Engraving, thin card/fabric | 4–6 passes |
| 10W | 430 × 400 mm | 2 (higher current) | ~0.08 × 0.10 mm | Engraving + light cutting | 2–3 passes |
| 20W | 430 × 390 mm | 4 combined | 0.08 × 0.10 mm | Cutting up to 6 mm plywood, faster engraving | 1–2 passes |
Modules are interchangeable without any software change. If you upgrade from a 10W to a 20W head, keep the same LightBurn device profile — just re-focus with the focal bar (the focal distance is the same) and adjust your speed/power settings for the higher wattage. Use the Laser Tinkerer Energy Index to convert your existing 10W settings to a 20W starting point.
xTool Creative Space as an alternative to LightBurn
If you only engrave (not cut) and want a simpler experience, xTool Creative Space (XCS) is a solid choice. It auto-detects the D1 Pro, requires no GRBL configuration, and is free. Its limitations: no scanning offset control, fewer file format options, and it only supports xTool machines. See our xTool Creative Space vs LightBurn comparison for a full feature breakdown to help you decide.
Common xTool D1 Pro + LightBurn problems
| Problem | Most likely cause | Fix |
|---|---|---|
| Machine not found / no COM port | CH340 driver not installed or wrong version | Install the WCH CH340 driver from wch-ic.com; on Mac grant the security extension in Privacy & Security |
| Engraving burns extra-dark at corners | $32=0 (laser mode disabled) |
Open LightBurn console, type $32=1, press Enter. This must be done once per machine, not per session. |
| Power seems wrong (100% looks like 10%) | $30 S-value max mismatch |
Type $30=1000 in console; verify LightBurn's S-value max also shows 1000 in Device Settings |
| Engraving is offset / shifted left | Scanning offsets not configured | Use the official xTool-D1ProV3.lbdev config file — it has the correct scanning offsets pre-loaded. If you set up the device manually, the offsets are missing. |
| Disconnects mid-job | USB cable or port issue | Replace the cable (use under 1.5 m, shielded); use a rear USB port directly on the computer, not a hub; disable USB selective suspend on Windows |
| Machine homes to wrong corner | Config file not imported (or wrong device selected) | Re-import xTool-D1ProV3.lbdev; confirm the D1 Pro device is selected in LightBurn's device list (bottom toolbar) |
| Laser fires but doesn't engrave | Out of focus or power too low | Re-focus with the focal bar; confirm power is above 20% (below this the beam is too faint for most materials); run the material test grid |
| Homing alarm on startup | Limit switch blocked or disconnected | Check that the laser head can reach the rear-left corner freely (nothing in the way); type $X in console to clear the alarm and try homing again with $H |
Frequently asked questions
Does LightBurn work with the xTool D1 Pro?
Yes — the D1 Pro runs GRBL firmware and LightBurn supports GRBL natively. Import xTool-D1ProV3.lbdev from xTool's support centre, send $32=1 in the console, and you are ready. LightBurn works on Windows, Mac, and Linux, making it the top choice for Mac users (LaserGRBL is Windows-only).
What is the xTool D1 Pro work area?
The 20W model has 430 × 390 mm; the 5W and 10W models have 430 × 400 mm. The config file (.lbdev) sets this automatically in LightBurn — you do not need to enter it manually.
What does $32=1 do?
It enables M4 dynamic laser power mode. In M4, the laser scales power with actual head speed — preventing over-burning at corners and slow moves. Without it ($32=0), the laser runs at constant power and leaves charred marks at every direction change. Send it once; it persists in firmware.
Can I use xTool Creative Space instead of LightBurn?
Yes. XCS is simpler, free, and auto-detects the D1 Pro without GRBL setup. LightBurn is preferred for cutting, advanced workflows, rotary engraving, and Mac/Linux use. See our comparison guide.
Can I upgrade from a 10W to 20W module?
Yes — the modules are hot-swappable. Keep the same LightBurn device profile. Re-focus with the focal bar after swapping (the focal distance is the same). Adjust your power/speed settings — the 20W module cuts at roughly half the power and double the speed compared to the 10W for equivalent results, as a starting point confirmed with a material test grid.
Gear for your xTool D1 Pro setup
- OD7+ 450 nm laser safety glasses — essential before any laser power-on
- Honeycomb work surface 430mm — lifts material off the bed for clean underside cuts
- Air assist pump — included with some D1 Pro kits; improves cut quality and removes smoke
- Basswood sheets for test burns — consistent material for calibrating new settings
As an Amazon Associate I earn from qualifying purchases.
Related guides
- LightBurn first-time setup (general GRBL guide)
- xTool Creative Space vs LightBurn — which software should I use?
- LaserGRBL vs LightBurn comparison
- Diode laser focus methods — focal bar, ramp test, Z-height scan
- Material Test Grid Generator — find your settings in one burn
- Basswood engraving settings (all wattages)
- Laser Tinkerer Energy Index — translate settings between wattages
Sources
- xTool Support: Operate xTool D1 Pro with LightBurn (manufacturer official, retrieved 2026-07-09)
- xTool Support: Use LightBurn to Operate xTool D1 Pro (manufacturer official, retrieved 2026-07-09)
- LaserUser.com: xTool D1 LightBurn tutorial (independent editorial, retrieved 2026-07-09)
- CNCSourced: xTool D1 Pro 5W vs 10W vs 20W (independent review, specifications, retrieved 2026-07-09)
Settings are aggregated from manufacturer documentation and independent community sources and presented as starting points. Confirm with a test burn on your specific machine and material batch. Operate at your own risk — follow your machine manual.