¶ Device Info & Camera Errors After Upgrading to LightBurn 2.1.0
This guide explains how to troubleshoot device detection issues, camera calibration errors, unit setting changes, and machine parameter problems that may occur after upgrading to LightBurn 2.1.0. Follow the steps below to restore normal operation and ensure accurate processing performance.
¶ Problem Description
After upgrading LightBurn to version 2.1.0 and reopening the software, you may encounter the following issues:
- Previously connected machines may disappear from the device list, requiring you to search for and add them again.
- Factory machine configuration parameters inside the controller may change, leading to motion control errors or poor processing results.
- The default control and design measurement units may toggle unexpectedly.
- Incorrect selection or accidental swapping of laser tube types on a dual-source laser system.
- Camera calibration files from older versions are automatically converted to a new format, which can introduce alignment errors or offsets.
¶ Cause
A software logic bug in the newly released LightBurn 2.1.0 update causes certain configuration files and user profiles to migrate incorrectly.
¶ Solution
¶ Step 1. Re-discover and Reconnect the Device
If your machine profile has disappeared from the device list in the bottom-right panel, click the "Find My Laser" or "Create Manually" button to rediscover and re-add your machine to restore communication.
¶ Step 2. Correct the Measurement and Control Units
If the machine exhibits control or processing issues (for example: setting the jog distance to 10mm, but the laser head actually moves 70mm), the unit system has likely been altered.
Click the Wrench icon (Device Settings) in the top toolbar. Locate the Control Units section and change it back to your original preference (typically mm/min or mm/sec).
Adjust the "Link Control and Design Units" toggle based on your workflow:
- Toggle ON: Changing the machine's control units will automatically change your measurement units on the canvas toolbar as well.
- Toggle OFF: The design units on your workspace canvas can be switched between mm and in independently without altering the machine's control units.
¶ Step 3. Re-import the Standard Vendor Parameters
Because internal controller settings may have changed, you need to flash the factory-fresh machine parameters:
Contact the ONELASER after-sales technical support team, state your machine model, and request the official standard factory parameters file.
Go to Machine Settings in LightBurn, click Load from File to import the file, and then click Write to save these settings directly to the motherboard.
Note: If you had any personalized or custom adjustments prior to the update, you will need to reconfigure them manually after writing the factory file.
¶ Step 4. Verify Laser Tube Type Configurations (Tube 1 / Tube 2)
After importing the standard factory parameter file, the laser tube types are generally calibrated automatically. However, to rule out any anomalies, you should manually double-check the configuration:
Scroll down to the Laser Settings section and locate Tube 1 Type and Tube 2 Type to confirm their classifications. Example: For the Hydra GEN1, Laser 1 should be configured as a Glass Tube, and Laser 2 should be configured as an RF Tube.
To verify which tube is mapped to each setting, navigate to Menu > Alignment on the machine's control panel. You can manually toggle between Laser 1 and Laser 2. Press the Pulse button to fire a test beam. Observe the hardware directly to see which laser tube fires during the pulse test for each selection.
¶ Step 5. Re-calibrate the Camera
This problem occurs more frequently on Mac systems
Upon launching version 2.1.0, LightBurn will display a pop-up warning stating that your camera configuration file is from an older version and will ask Do you want to convert and import it into the latest format?
Please click Yes to allow the software to import the file.
To eliminate any conversion drift, open the Camera Calibration wizards. Follow the on-screen step-by-step prompts using your original alignment pattern to recalibrate and ensure precision.
Important Reminder:
If these steps do not resolve the issue, please submit a support ticket on ZOHO: https://zohodesk.1laser.com/portal/en/newticket. A technician will then be able to conduct a more in-depth diagnosis and resolve your problem.