General

Thunder Bolt Ramp Test and Setting Autofocus Height for Best Engraving Results

Step-by-step guide to performing a ramp test on the Thunder Bolt laser to determine and set the correct autofocus focal distance and manual focus tool length.

6 min readUpdated Jul 2026
Applies toBoltTopicGeneral

Preface: This article will cover the steps to perform a ramp test to be able to set the autofocus height and the length of the manual focus tool. For this procedure, it is assumed that you are already connected to the machine and ready to run. This article was written with screenshots from Lightburn 1.4.00 if you are using a different version then your screens may look different.

Tools and Materials that you will need

Tools and materials needed
  • 1.5mm Allen Wrench
  • Manual Focus Tool
  • Lightburn installed and configured
  • Consistent Material (MDF as an example)

Before You Begin

Let's start at your computer that is connected to your Bolt and take a backup of your Machine Settings.

In Lightburn, go to Edit > Machine Settings (will be under Laser Tools > Machine Settings if you are on v2.0 or newer Lightburn)

Lightburn Machine Settings menu

Then use the "Save to File" button to save a copy in your desired location (save the file with _Original attached to the name). Do not close out the machine settings window, it will be used in the first step of the process of doing the ramp test.

Save to File button in Machine Settings

A bit more info on settings that can be backed up with Lightburn: Backing Up Machine and LightBurn Settings

The Process

Follow these steps in order. Each step assumes that the previous step was completed.

Step 1: Reset the Focal Length

While still in the Machine Settings, scroll down until you find the value for "Focal Distance" under the Miscellaneous. In this case, the value is currently 1.7mm. Set the value to 0.00mm and then use the "Write" button to send the change to the controller.

Focal Distance set to 0.00mm in Machine Settings

Step 2: Enable Z Moves in Lightburn

We need to enable Z moves so that the honeycomb table position can be changed on the fly for the ramp test.

In Lightburn, select the icon that is a Wrench and Screwdriver, highlighted below.

Wrench and Screwdriver icon in Lightburn

The Device Settings Prompt will open up and you will need to set the following to Green under the Z Control section:

  • Enable Z Axis
  • Relative Z moves only
  • Optimize Z moves
Z Control settings enabled in Device Settings

Step 3: Do a Coarse Ramp Test

Let's go back to the laser machine and perform Autofocus to the surface of your material. The lens will be a little closer now that the Focus Distance is set to 0.00mm in the machine settings.

Here is how:

First, jog your laser head using the Laser control screen buttons so that the red dot pointer is over the top of your material.

Laser control screen jog buttons

Like so:

Red dot pointer positioned over material

Then press the AF button on the touch screen.

AF button on touch screen

Then click OK on the screen prompt to do the Auto Focus. The machine will raise the material to the Auto Focus position with a 0.00mm offset.

Auto Focus confirmation prompt

Then, back at your computer, set Lightburn to "User Origin" with the "Top Left radio button" selected as the assigned relative location.

User Origin set to Top Left in Lightburn

Open the Focus Test Tool in Lightburn from the Laser Tools menu.

Focus Test Tool in Laser Tools menu

Configure the test as shown below:

Focus Test configuration settings

Preview the test:

Focus Test preview

Next we will focus on setting up the machine origin and framing it to make sure it fits on the selected material.

Jog the Laser Head to your material.

Jogging laser head to material

Then set the User Origin using the Origin button on the Laser Touch screen.

Origin button on Laser Touch screen

Frame the Focus Tool Job from the Focus Tool Prompt in Lightburn and verify that the Frame is on your material.

Framing the Focus Tool job

Start the Focus Tool job using the Start button in the Lightburn Focus Tool Prompt:

Before you start the job, be prepared to watch the Z Honeycomb bed move and understand that it is normal. If the laser looks like it may crash, be ready on the Estop button.
Start button in Focus Tool Prompt

Observe the results. The Finest line value will be used for the next step for the Fine Ramp Test.

Coarse ramp test results
In this example, the 1.6 and 1.8 reading look similar and the best; we will use 1.7 as the median value for the next test.

Step 4: Do a Fine Ramp Test

Using 1.7mm for this example as the median value, the test was set up as shown below, with a target range of 1.2mm to 2.2mm and 20 steps still.

Fine Ramp Test configuration Fine Ramp Test preview
Before you run this Focal Test, be sure to set your new origin (or move the material) and frame the job to verify it is on the material and not overlapping the previous test.

Run the job as before and observe the results.

Fine ramp test results

In this case, 1.65mm looks to be the most crisp and will be used as the Focal Distance for the 1.5" lens on this machine.

Step 5: Set the New Focal Distance

In Lightburn, go to Edit > Machine Settings and scroll down to find the Focal Distance setting which should be at 0.00mm. Type in the new value, in this case 1.65mm, and use the "Write" button to send them to the laser machine. Do not close out the "Machine Settings" screen just yet.

Focal Distance set to 1.65mm in Machine Settings

Step 6: Backup the New Machine Settings

Press the "Read" button and then the "Save to File" button to save a copy to your computer (add something to the end of the file to differentiate it from the previously saved Original).

Save to File button after updating Focal Distance

Step 7: Disable Z Moves in Lightburn

In Lightburn, select the icon that is a Wrench and Screwdriver, highlighted below.

Wrench and Screwdriver icon in Lightburn

The Device Settings Prompt will open up and you will need to set the following to Red under the Z Control section:

  • Enable Z Axis
  • Optimize Z moves
Z Control settings disabled in Device Settings

Step 8: Do a Sample Engrave Test

Setup your new material, Auto Focus it and set the User Origin. Run a high detail engrave and observe the results. An example is attached to this article; you may need to adjust based on your material.

Sample engrave test result

Step 9: Set Up the Manual Focus Tool

Place the material under the laser head and initiate an AutoFocus.

Initiating AutoFocus on material

Place the manual Focus T Bar on the knurled Knob (Notice how it is a little raised/crooked).

Manual Focus T Bar placed on knurled knob

Then use the 1.5mm Allen wrench to loosen the set screw on the Manual Focus Tool Shaft.

Loosening set screw with 1.5mm Allen wrench

Reinstall the Manual Focus Tool and let the shaft rest on the material and then tighten the set screw.

Manual Focus Tool shaft resting on material

Focal Distance Vs Home Offset

If you run into the case where Focal Distance would need to be negative, you can adjust the value of Home Offset down and carry that adjustment over to the Focal Distance. The two settings work in conjunction to give the total distance away from the Focus Post. If you remove distance from one, add it to the other and then make your final correction so that Focal Distance is a value greater than or equal to 0.

A picture may better help explain. In this example, the values were 5.0mm for Home Offset and 1.7mm for focal distance for a total of 6.7mm. The values could be split to 3mm for home offset and 3.7mm for Focal distance. Then, when a ramp test is completed, the new focal distance can be set.

Focal Distance vs Home Offset diagram

Still stuck?

No bots, no runaround. Talk to a U.S.-based laser tech who knows your Bolt inside out.