3-3 Lightburn Camera Preview Operation Guide

Description

This guide explains how to configure LightBurn for FLUX beamo II, connect the built-in USB camera, calibrate the camera lens with the LightBurn AprilTags pattern, and align the camera preview with the machine workspace.

The procedure and values below were verified with LightBurn Pro 2.1.03. Menu names may vary slightly in other LightBurn versions.

Step 1

Prepare the machine, computer, and materials

Before opening the calibration wizard, prepare the following items:

• A computer with LightBurn installed.
• A network connection to the beamo II and a USB connection to the beamo II camera.
• A printed LightBurn AprilTags lens-calibration pattern. Print it at 100% scale without fitting or resizing.
  (You will be guided to print AprilTags lens-calibration pattern in the steps.)
• Four flat, light-colored 3 mm wooden boards for workspace alignment.
• The firmware version of beamo II RF is v6.1.15 or above.

Step 2

Create a new beamo II device in LightBurn

Open LightBurn. In the Laser panel, click Devices, then choose the option to create a device manually. When the New Device Wizard asks for the controller, select GRBL and click Next.

Step 3

Select the network connection method

For the GRBL connection method, select Ethernet or Wifi/TCP. Click Next.

Confirm that the computer and beamo II are on the same network before continuing.

Step 4

Enter the beamo II IP address

Find your beamo II's IP address on the touch screen.
(If your machine hasn't made a WIFI connection, please refer to this article for setting up a connection.)

Enter the current IP address of your beamo II, then click Next. Find the machine IP address on the beamo II network-information screen.

The test machine used 192.168.1.247. This is an example only; enter the address assigned to your own machine.

Step 5

Set the device name and workspace size

Enter a recognizable device name, such as beamo II WIFI. Select Millimeters and set the work area to:

• X-axis length: 300 mm
• Y-axis length: 210 mm

Click Next.

Step 6

Set the machine origin and finish device setup

Select the rear-left corner as the machine origin. Review the summary and confirm the following values:

• Controller: GRBL
• Connection: Ethernet or Wifi/TCP
• Workspace: 300mm x 210 mm
• Origin: rear-left
• IP address: the current IP of your beamo II

Click Finish. Open Device Settings once more to confirm the values were saved correctly.

Step 7

Verify the machine connection and coordinate mode

Select the new beamo II device in the Laser panel. Open the Move panel and click Home to verify that LightBurn can communicate with the machine.

In the main LightBurn window, set Start From to Absolute Coords. 

Before camera calibration, home the machine and move the Z axis to its home/zero position.

---

Go to "Move" to move the laser head to X=180mm and Y=30mm, then press "Go". The laser head should automatically move to the set position.
(The purpose here is to set the position of the camera to have a wider and better view.)

Step 8

Open the camera setup wizard

Connect the beamo II to the computer by USB-A to USB-B cable.
(The USB-B side is for the machine and the USB-A side is for the computer.)

On the machine’s panel, go to:
Machine > Hardware Settings > Camera Signal Switching > Switch to LightBurn Icon > Save.

Remove the honeycomb.

In the Camera panel on the right side of LightBurn, click Add Camera. Select USB as the connection method.

Step 9

Select the beamo II USB camera

Select USB Camera as the camera source. Choose the following video mode when available:

• Resolution: 3264x2448
• Format: NV12
• Frame rate: 15.0 fps

Confirm that the preview shows the entire beamo II work area and that the image is stable. LightBurn may provide controls for Exposure, Focus, White Balance, Contrast, Hue, and Backlight.

Step 10

Start a new lens calibration

After printing, trim the paper along the lines.

In the camera setup wizard, choose Create a new lens calibration. and Click "Next".

Step 11

Capture the AprilTags pattern at the upper-left

Open the beamo II lid. Place or hold the printed AprilTags pattern in the upper-left capture area shown by LightBurn.

Keep the sheet flat and approximately parallel to the camera. Make sure all four outer corners and every tag are inside the highlighted capture area. Click Capture only after the entire pattern is recognized.

Please turn off the "Auto-Exposure" setting and adjust it to detect as many patterns as possible.

Step 12

Capture the AprilTags pattern at the upper-right

Move the same pattern to the upper-right capture area. Keep the pattern flat, avoid glare, and make sure no tag is cut off by the edge of the camera view. Click Capture.

Step 13

Capture the AprilTags pattern at the lower-right

Move the pattern to the lower-right capture area. Confirm that the complete pattern is visible and sharply focused, then click Capture.

Step 14

Capture the AprilTags pattern at the lower-left

Move the pattern to the lower-left capture area. Keep all tags visible and click Capture.

Step 15

Capture the AprilTags pattern at the center

Place the pattern in the center of the work area and capture the fifth image. Confirm that LightBurn shows five completed captures before continuing.

If a capture is blurred, cropped, overexposed, or affected by glare, retake that position before selecting a calibration model.

Step 16

Select and verify the lens calibration model

Continue to the calibration-model selection screen. Select the model recommended by LightBurn for the captured images and review the score.

• A score of 65% or higher is recommended.
• The beamo II test achieved 67%.

Also inspect the corrected preview. The image edges and AprilTags pattern should be complete and should not show obvious distortion. If the score is below 65%, home the Z axis again, flatten the pattern, improve lighting, remove glare, and repeat the five captures.

Click Finish after the lens calibration passes.

Step 17

Start the camera workspace alignment

After lens calibration, start the camera alignment procedure. Select Overhead-mounted camera, then choose Automatic alignment.

Read the preparation screen carefully. The automatic procedure engraves alignment targets and then uses the camera to locate them.

Step 18

Set the automatic-alignment pattern to:

• Feature Size: 18.0 mm
• Pattern Width: 180.0 mm
• Pattern Height: 120.0 mm
• Preset: Custom

If necessary, click and drag the pattern in the preview so each target lands fully on a board.

Step 19

For the test boards, the following engraving settings were used:

• Speed: 300 mm/sec or 18000 mm/min
• Power: 20.00%

Confirm that the settings are suitable for your material, then press "Start" to begin the engraving. Do not leave the machine unattended while the laser is operating.

Step 20

Capture, verify, and finish the workspace alignment

After engraving is complete, open the lid and refresh the camera image. In the alignment wizard, use Discard or retake the image so LightBurn captures the newly engraved targets.

LightBurn should detect eight targets in total. Continue to the verification screen and confirm that:

• All eight targets are detected.
• No corner target is missing, clipped, or misidentified.
• The grid overlay is visible and follows the full workspace.
• The target positions line up with the engraved marks.

If targets are difficult to recognize, use Adjust Camera Image to change exposure, remove glare, and retake the image. If a target is outside the camera view, reposition the boards and repeat the alignment.

Click Finish when the verification passes. The camera setup summary should show green checks for the camera source, lens calibration, and workspace alignment.

Step 21

Backup the Camera Calibration Data

Exporting the calibration data means you won’t have to recalibrate if you switch computers. Follow these steps: Export: In Cameras >> right-click on USB Camera > Export Camera.

Using the calibrated camera preview

Please move the laser head to the position before using the camera preview.
Go to "Move" to move the laser head to X=180mm and Y=30mm, then press "Go". The laser head should automatically move to the set position.

Return to the Camera panel and click Update Overlay to capture the current work area. Place artwork over the camera image and verify its position before starting a job. Recalibrate if the camera is moved, the mount becomes loose, the machine geometry changes, or the overlay no longer matches the physical workspace.

#END