When the laser module hits the edge during the Return to Home process, it usually indicates a limit switch or homing issue. This can affect positioning accuracy and may cause repeated mechanical stress on the machine if not resolved.

This guide helps you identify and fix the most common causes of this issue on the Ray5 MiniS.

1. Check the Limit Cable Connection

• Inspect the limit switch cable connection
• If the cable is loose or partially disconnected:
  • Secure and tighten the connection
• Ensure all connectors are firmly plugged into the mainboard

2. Check the Limit Switch Position

• Verify whether the limit switch position is too far back
• If the switch is not triggered at the correct time during homing:
  • The laser may continue moving and hit the edge

How to Fix:

• Adjust the limit switch position so it is triggered just as the machine reaches Home
• Ensure proper alignment between the switch and the trigger point

 Mini:

MiniS:

Conclusion

Laser module edge collisions during homing are typically caused by loose limit switch connections or improper switch positioning. By ensuring secure cable connections and correctly positioning the limit switches, you can restore safe and accurate homing behavior.

Proper calibration of the homing system helps prevent mechanical damage and ensures precise positioning for all engraving tasks.

During engraving, the Ray5 MiniS may trigger errors or alarms related to limit switches or motion control. These alarms are typically caused by operational actions, software settings, or homing issues rather than hardware failure.

This guide explains the most common causes and how to resolve them step by step.

Table of Contents

• What This Guide Covers
• Quick Answer
• Why This Process Matters
• Before You Start
  • Requirements
  • Precautions
• Step-by-Step Tutorial
  • Step 1: Prevent Limit Triggering During Engraving
  • Step 2: Understand Stop Button Error Reporting
  • Step 3: Fix Overscan and Soft Limit Errors
  • Step 4: Resolve Zeroing Abnormalities
• Common Problems and Solutions
• Tips for Better Results
• Frequently Asked Questions
• Final Thoughts

---

What This Guide Covers

This tutorial explains how to troubleshoot common engraving errors and alarms on the LONGER Ray5 MiniS laser engraver.

You will learn how to:

• Prevent limit trigger alarms
• Understand normal alarm behavior after stopping engraving
• Fix overscan-related soft limit errors
• Adjust coordinate settings properly
• Resolve homing and zeroing abnormalities
• Improve engraving stability and workflow reliability

The procedures below follow the original operating sequence and troubleshooting methods provided for the Ray5 MiniS.

---

Quick Answer

If your Ray5 MiniS displays engraving alarms or motion control errors:

• Do not manually move the laser during engraving
• Alarm reporting after pressing Stop is normal
• Change coordinates to absolute coordinates if overscan triggers soft limits
• Reduce the pattern size and place it in the middle if needed
• Turn off the overscan function when necessary
• Confirm the XY axis does not continue pressing the limit switch after zeroing

Most Ray5 MiniS engraving errors are caused by software settings or operation behavior rather than defective hardware.

---

Why This Process Matters

Laser engravers rely on accurate positioning and coordinated movement to complete engraving tasks safely and precisely. When the Ray5 MiniS detects unexpected movement, excessive travel range, or abnormal limit switch signals, it may stop the engraving process and report an alarm.

Understanding these alarms is important because it helps:

• Prevent interrupted engraving jobs
• Protect the machine from positioning errors
• Improve engraving consistency
• Reduce material waste
• Avoid repeated homing failures
• Maintain accurate motion control

Many beginners assume that engraving alarms indicate hardware damage. In most cases, the issue is related to machine operation, coordinate setup, or overscan configuration.

---

Before You Start

Requirements

Before troubleshooting Ray5 MiniS engraving errors, prepare the following:

• LONGER Ray5 MiniS laser engraver
• Connected engraving software
• Properly powered machine
• Stable working surface
• Correctly installed limit switches
• Engraving design file for testing

Follow official machine specifications or instructions.

---

Precautions

Before performing troubleshooting procedures, keep these precautions in mind:

• Do not manually force the laser module during engraving
• Keep hands away from moving parts
• Monitor the engraving process continuously
• Verify coordinate settings before engraving
• Ensure the machine frame moves smoothly
• Avoid interrupting engraving unnecessarily

Incorrect movement or positioning may trigger unnecessary alarms and stop the engraving process.

---

Step-by-Step Tutorial

Step 1: Prevent Limit Triggering During Engraving

Original Step

1. Manually moving the laser position during engraving causes limit triggering.

Action

Do not manually move the laser position while engraving is active.

Expected Result

The engraving process should continue normally without triggering a limit alarm.

Important Notes

The Ray5 MiniS continuously tracks the laser head position during operation. If the laser module is manually pushed or repositioned while engraving, the controller may detect abnormal movement and trigger a limit alarm.

This issue commonly occurs when users attempt to adjust material positioning during engraving.

If the machine reports a limit error:

1. Stop the engraving process
2. Reposition the laser correctly
3. Restart the engraving job if necessary

Avoid touching the laser assembly during operation.

 

Step 2: Understand Stop Button Error Reporting

Original Step

When you click Stop during engraving, this error will be reported, which is normal.

Action

If you press the Stop button during engraving and an error appears, understand that this behavior is expected.

Expected Result

The engraving stops immediately and the system reports an alarm or error message.

Important Notes

This is normal machine behavior rather than a hardware malfunction.

When engraving is interrupted manually, the controller detects the interruption and reports the stop condition as an error or alarm.

After stopping:

• Clear the alarm if required
• Reset the engraving position if necessary
• Restart the engraving task

If alarms continue after restarting, verify the coordinate settings and engraving area configuration.

 

Step 3: Fix Overscan and Soft Limit Errors

Original Step

3. When engraving an image or vector filling at the current position, if the overscan function is turned on, the soft limit may be triggered, and the engraving may not be possible. You need to change the coordinates to absolute coordinates. If you do not change the coordinate system, then reduce the pattern and put it in the middle, or turn off the overscan function.

Action

Adjust the coordinate system or overscan settings when soft limit alarms occur during image engraving or vector filling.

Expected Result

The engraving process should complete without triggering soft limit errors.

Important Notes

This is one of the most common Ray5 MiniS engraving problems in engraving software.

Overscan allows smoother acceleration and deceleration by extending movement slightly beyond the engraving boundary. However, when the design is placed too close to the machine edge, overscan movement may exceed the available work area and trigger a soft limit alarm.

Follow the original troubleshooting sequence exactly:

1. Change the coordinates to absolute coordinates
2. If the coordinate system is not changed, reduce the pattern
3. Put the pattern in the middle
4. Turn off the overscan function if necessary

Do not modify additional machine parameters unless instructed in official documentation.

Follow official machine specifications or instructions.

 

 

Step 4: Resolve Zeroing Abnormalities

Original Step

4. The machine continuously detects the signal of the limit switch, resulting in a zeroing abnormality. The solution is to confirm that the XY axis does not hit the limit switch after the XY axis completes zeroing.

Action

Check the XY axis position after zeroing completes.

Expected Result

The machine should complete homing normally without repeatedly triggering the limit switch.

Important Notes

This issue occurs when the controller continues receiving a limit switch signal after the homing process finishes.

Possible causes include:

• The XY axis remaining pressed against the limit switch
• Mechanical obstruction
• Incorrect positioning after homing
• Axis movement restriction

Carefully inspect the machine after zeroing completes.

Verify that:

• The XY axis moves away from the limit switch normally
• The carriage is not stuck
• The machine frame moves freely
• No obstruction blocks axis movement

If homing abnormalities continue:

• Restart the machine
• Recheck the limit switch area
• Confirm smooth axis movement

Avoid manually forcing the carriage while the machine is powered on.

 

Common Problems and Solutions

---

Tips for Better Results

• Position designs away from workspace edges
• Use absolute coordinates for larger designs
• Check overscan settings before vector filling
• Test engraving boundaries before starting production jobs
• Keep the machine frame clean and unobstructed
• Monitor homing movement during startup
• Avoid interrupting engraving unless necessary
• Ensure cables and limit switches remain secure

Proper software configuration and operating practices can significantly reduce unnecessary engraving alarms.

---

Frequently Asked Questions

Why does my Ray5 MiniS trigger a soft limit alarm?

Soft limit alarms usually occur when overscan movement exceeds the machine’s available work area during engraving.

---

Is it normal to see an error after pressing Stop?

Yes. When Stop is clicked during engraving, the machine reports an error normally because the process was interrupted intentionally.

---

What is overscan in laser engraving?

Overscan extends movement slightly beyond the engraving area to improve motion smoothness during image engraving and vector filling.

---

Why does my machine fail during homing?

The controller may continuously detect the limit switch signal after zeroing. Confirm that the XY axis does not remain pressed against the limit switch.

---

Should I disable overscan completely?

You may turn off the overscan function if it causes soft limit alarms. Alternatively, reposition the design or change coordinates to absolute coordinates.

---

Can manual movement interrupt engraving accuracy?

Yes. Moving the laser manually during engraving can trigger alarms and affect positioning accuracy.

---

Does this mean my Ray5 MiniS hardware is damaged?

Usually not. Most engraving alarms are caused by operational actions, software settings, or coordinate configuration issues.

---

Final Thoughts

Engraving errors or alarms on the Ray5 MiniS are usually related to user operation, software configuration, or limit switch behavior. By following proper usage practices and adjusting settings such as coordinate systems and overscan, most issues can be quickly resolved.

Maintaining correct operation procedures and system calibration ensures stable engraving performance and reduces unnecessary error triggers.

Properly positioning your engraving design is essential to ensure it fits within the machine’s working area and avoids boundary errors. In LaserGRBL, you can adjust the graphic position by modifying the X and Y offsets before starting the engraving process.

This guide explains how to correctly place your design within the working area of the Ray5 MiniS.

Table of Contents

• What This Guide Covers
• Why Graphic Positioning Matters
• Before You Start
• Requirements
• Precautions
• Step-by-Step Tutorial
• Ray5 MiniS Working Area Reference
• Common Problems and Solutions
• Tips for Better Results
• Frequently Asked Questions
• Conclusion

What This Guide Covers

This tutorial explains how to:

• Adjust graphic position in LaserGRBL
• Modify X and Y offsets
• Keep designs within the engraving area
• Avoid boundary and positioning errors
• Understand the working area limitations of Ray5 Mini and Ray5 MiniS models

Quick Answer

To adjust graphic position in LaserGRBL:

1. Open the engraving file in LaserGRBL
2. Modify the X and Y offsets in the target image window
3. Ensure the graphic stays within the machine’s working area
4. Preview the placement before engraving

Correct positioning helps prevent engraving failures and improves engraving accuracy.

Why Graphic Positioning Matters

Graphic positioning is a critical part of laser engraving preparation. If the design exceeds the machine’s working area, the engraving process may fail or produce inaccurate results.

Correctly adjusting the X and Y offsets helps:

• Prevent boundary errors
• Keep the design within the engraving area
• Improve engraving precision
• Reduce material waste
• Ensure consistent results

For beginners, understanding how LaserGRBL handles graphic positioning is essential for successful engraving projects.

Before You Start

Before adjusting the graphic position in LaserGRBL, make sure your machine and software are ready.

Requirements

You will need:

• Ray5 Mini or Ray5 MiniS laser engraver
• Computer with LaserGRBL installed
• USB connection to the machine
• Engraving file or image
• Material placed securely on the work surface

Follow official machine specifications or instructions.

Precautions

Before operating the laser engraver, follow these safety precautions:

• Wear appropriate laser safety glasses
• Ensure proper ventilation
• Keep flammable materials away from the machine
• Confirm the engraving material is secured
• Verify the machine is operating normally before starting

Incorrect positioning may cause the laser to move outside the valid engraving area.

Step-by-Step Tutorial

Step 1: Open the Engraving File

Action

Click File > Open File to add the design to be engraved.

Expected Result

The selected design appears in the LaserGRBL workspace and target image window.

Important Notes

• Confirm the file imports correctly before continuing.
• Check the design dimensions to ensure they are appropriate for the machine’s working area.

Step 2: Adjust the X and Y Offsets

Action

Adjust the offset of X and Y in the target image window to change the position of the graphics.

Expected Result

The graphic position changes within the workspace according to the selected offset values.

Important Notes

• Adjust the offsets carefully to avoid exceeding the working area.
• Small offset changes can significantly affect final placement.
• Position the design fully within the valid engraving range.

Step 3: Make Sure the Design Is Within the Working Area

Action

Check the design placement and make sure it is in the range of the working area.

Expected Result

The entire design fits within the available engraving area of the selected machine model.

Important Notes

• Designs outside the working area may trigger boundary errors.
• Always verify placement before starting engraving.
• Use preview and positioning checks whenever possible.

 

 

 

 

 

 

 

 

 

 

Ray5 MiniS Working Area Reference

Use the following working area specifications when positioning graphics in LaserGRBL.

 

 

Common Problems and Solutions

Problem	Possible Cause	Solution
Boundary error during engraving	Graphic exceeds working area	Reduce offsets or reposition the design
Design partially engraves	Incorrect graphic placement	Confirm the design fits within the workspace
Graphic appears off-center	X or Y offset set incorrectly	Readjust the X and Y offsets
Laser head moves outside expected range	Improper positioning setup	Recheck the target image window settings
Engraving starts in the wrong location	Incorrect design alignment	Verify placement before starting
Graphic does not fit material	Design size too large	Resize the graphic within the allowed area
Preview does not match expected location	Incorrect offset values	Reset and adjust offsets carefully

Tips for Better Results

Check the Working Area Before Importing Files

Knowing the maximum engraving dimensions helps avoid positioning errors.

Use Small Offset Adjustments

Minor offset changes provide more accurate positioning control.

Preview the Design Placement

Always verify the engraving area before starting the laser job.

Keep the Material Properly Aligned

Straight material placement improves engraving consistency.

Test Positioning on Scrap Material

Testing placement first can help prevent wasted materials and failed engravings.

Avoid Positioning Too Close to Edges

Leaving some margin space can reduce alignment issues during operation.

Frequently Asked Questions

What are X and Y offsets in LaserGRBL?

X and Y offsets control the horizontal and vertical position of the engraving graphic within the workspace.

Why do I get a boundary error in LaserGRBL?

Boundary errors usually occur when part of the design exceeds the machine’s working area.

How do I know if my design fits the working area?

Compare the design dimensions with the machine’s maximum working area listed in the specifications table.

Can I reposition the graphic after importing the file?

Yes. You can modify the X and Y offsets in the target image window before engraving.

Why is my engraving not centered on the material?

The X and Y offsets may not be adjusted correctly, or the material may not be aligned properly.

What happens if the design exceeds the working area?

The machine may generate a boundary error or fail to engrave correctly.

Should I preview the engraving position before starting?

Yes. Previewing helps confirm the design fits within the valid engraving range.

Conclusion

Adjusting the graphic position in LaserGRBL is a simple but essential step to ensure accurate engraving results. By properly setting X and Y offsets and keeping your design within the working area, you can avoid errors and achieve precise, high-quality outputs.

Consistent use of preview and positioning checks will help improve engraving efficiency and reduce failed jobs.

Connection issues between your computer and the Ray5 MiniS can prevent proper control of the machine and interrupt engraving tasks. These issues are usually related to drivers, port conflicts, baud rate settings, or incorrect software configuration rather than hardware failure.

This guide provides a structured troubleshooting process to help you quickly restore a stable connection using LightBurn or LaserGRBL.

1) Can't find CH340 driver

For Windows systems, it needs to right-click the computer and select Manage, click Device Manager, click to expand Ports (COM & LPT), find the port corresponding to the CH340 driver, and then select this port in LightBurn or LaserGRBL.

For MacOS, please go to About this Mac > Overview > System Report, select USB under Hardware (there will be USB Serial if the driver is installed automatically), and select the cu.wchusbserial14230 port in LightBurn or LaserGRBL.

If no ports are listed in the expanded Ports (COM & LPT), it means that no engravers were found, which could mean that it is not plugged in correctly, isn't powered, or the PC is missing a driver. It needs to download the CH340 driver from the link and double-click it to install:

https://drive.google.com/drive/folders/1Sc-TKuez-mz--38Vp6DeL-pGmQcQdHW4.

How to install CH340 driver of LightBurn for MacOS Sequoia system:

https://www.youtube.com/watch?v=JX-XsjLFei0

How to install CH340 driver of LightBurn for MacOS system:

https://www.youtube.com/watch?v=FBd1uEA9QUw

2) CH340 driver port is occupied

Before connecting, please make sure that the CH340 port is not occupied by software such as serial communication tools, cura, etc.

3) The Baud rate setting error

The baud rate should be set to 115200. The wrong baud rate will cause the connection to the engraving machine to fail.  

4) The configuration file is not imported or damaged

For LightBurn, click "Devices" in the laser control module to import the engraver. Click ‘Import,’ select the RAY5 mini.lbdev file, and click OK to add the RAY5 mini configuration to LightBurn. The macro commands will be successfully added in the Console window, and RAY5 mini device will appear in the list of devices to the right of the 'Devices' button in the Laser window when the configuration file is imported successfully.

Conclusion

Most connection issues with the Ray5 MiniS are caused by driver installation problems, incorrect port selection, or improper software settings. By verifying the CH340 driver, ensuring the correct COM port, setting the baud rate to 115200, and importing the correct configuration file, you can quickly restore stable communication between your computer and the engraving machine.

Maintaining proper connection setup ensures reliable control and smooth engraving performance.

If your Ray5 MiniS does not respond after turning on the power switch, the issue is usually related to basic power supply or safety mechanisms rather than complex hardware failure.

This guide covers the most common causes and quick checks to help you restore normal operation.

Troubleshooting Steps

1. Check the Emergency Stop Switch

• Inspect whether the emergency stop button is pressed
• If pressed:
  • Rotate it clockwise to release it

⚠️ Note:

• When engaged, the emergency stop will completely cut off machine operation

2. Check the Power Adapter Connection

• Ensure the power adapter is properly connected:
  • Plugged into a working wall outlet
  • Firmly connected to the machine
• Check for:
  • Loose connections
  • Damaged cables
  • Indicator lights (if available on the adapter)

Mini:

MiniS:

Conclusion

When the Ray5 MiniS fails to start, the most common causes are a pressed emergency stop switch or an improperly connected power adapter. By performing these quick checks, you can usually resolve the issue within minutes.

Ensuring proper power connections and safety switch status is the first step in maintaining reliable machine operation.

The CH340/CH341 USB driver is essential for communication between your computer and devices like the Ray5 MiniS. If the driver fails to install or work properly, your machine may not be recognized by software such as LightBurn or LaserGRBL.

This guide provides a complete troubleshooting process for both Windows and macOS systems.

I. Windows Systems

1. Common Causes & Solutions

① System Compatibility Issues

• Windows 10/11 usually includes built-in drivers, but auto-install may fail

✅ Solution:

• Manually download the latest driver from the official site:
  • http://www.wch.cn
• Install file: CH341SER.EXE

② Old Driver Conflicts

• Previously installed drivers may block new installations

✅ Solution:

• Open Device Manager → View → Show Hidden Devices
• Expand Ports (COM & LPT)
• Uninstall all CH340/CH341 devices
• ✔ Check “Delete the driver software for this device”
• Reinstall the latest driver

③ Driver Signature Issues (Win7 / Some Win10)

• Windows may block unsigned drivers

✅ Solution:

• Restart → Advanced Startup
• Select Disable Driver Signature Enforcement
• Install the driver again

④ Insufficient Permissions

• Installation requires admin rights

✅ Solution:

• Right-click installer → Run as Administrator

⑤ USB Cable / Port Issues

• Charging-only cables cannot transmit data

✅ Solution:

• Use a data-capable USB cable
• Prefer USB 2.0 ports
• Avoid hubs when possible

2. Confirm Successful Installation

• Plug in the device
• Open Device Manager → Ports (COM & LPT)

✔ Successful:

• USB-SERIAL CH340 (COM3) appears

❌ Failed:

• Yellow warning icon → reinstall or resolve conflicts

3. Alternative Solutions

• Try another computer to rule out system issues
• Use a USB-to-serial adapter (better compatibility):
  • FT232 USB-to-Serial Adapter
  • CP2102 USB-to-Serial Adapter

II. macOS Systems

1. Check if Driver Is Needed

• macOS 10.13+ may auto-detect CH340

Check via Terminal:

✔ If you see:
/dev/tty.wchusbserialxxxx → Driver is already working

2. If Not Recognized → Install Driver

① Download Driver

• Official: https://www.wch.cn/downloads/CH341SER_MAC_ZIP.html
• Recommended (better compatibility):
  • https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver

② Allow System Extension

• macOS may block installation

✅ Solution:

• Go to System Settings → Security & Privacy → General
• Click Allow for WCH Electronics Co., Ltd.

③ Restart the Computer

• Required to load the driver properly

3. macOS Troubleshooting

① Driver Installed but No Port

• Run:

• Replug device and check for new port

② Apple Silicon (M1/M2/M3 Macs)

• Official drivers may not be fully compatible

✅ Solution:

• Use the open-source GitHub driver (recommended)

③ Permission Issues (Big Sur / Monterey / Ventura)

• macOS restricts third-party drivers

✅ Advanced Solution:

• Boot into Recovery Mode
• Temporarily disable System Integrity Protection (SIP)
• Install driver, then re-enable SIP

III. Alternative Solutions

If CH340 issues persist:

• Use a native-supported adapter:
  • FTDI USB-to-Serial Adapter (best macOS compatibility)
• Or:
  • Use Wi-Fi connection (if your controller supports it)

Important Notes

• Always use a data USB cable, not charging-only one
• Restart your system after installing drivers
• Ensure only one software accesses the COM port at a time
• Keep drivers updated for stability

Conclusion

CH340 driver installation issues are typically caused by system compatibility, driver conflicts, permission restrictions, or hardware connection problems. By systematically checking drivers, ports, cables, and permissions, most connection issues can be resolved quickly.

For long-term stability—especially on macOS—consider using alternative USB-to-serial adapters with native support.

Wi-Fi connection issues on the Ray5 MiniS can prevent wireless control through software such as LightBurn or LaserGRBL. These problems are typically caused by signal strength, network compatibility, or incorrect configuration.

This guide helps you quickly identify and resolve the most common Wi-Fi connection issues.

1. Weak Wi-Fi Signal

In LightBurn or LaserGRBL, enter $wifi/listAPs in the console to search for available Wi-Fi networks.
In the list of detected Wi-Fi networks, the number shown after SIGNAL represents signal strength, with 100 being the strongest.

If the signal is too weak, the connection may fail.
Possible causes and solutions:

The Wi-Fi antenna on the motherboard may be loose. In this case, remove the front beam cover of the RAY5 mini and reconnect the antenna securely.

The antenna may be damaged. If so, replace the antenna with a new one.

2. Wi-Fi Frequency Band Is 5 GHz Instead of 2.4 GHz

The Longer laser engraver can only detect 2.4 GHz Wi-Fi networks.
If your Wi-Fi is using the 5 GHz band, the machine will not be able to find or connect to it.

3. Incorrect Wi-Fi Name or Password

Check carefully to ensure that the Wi-Fi name (SSID) and password are entered correctly.

video tutorial:

Conclusion

Wi-Fi connection failures on the Ray5 MiniS are usually caused by weak signals, unsupported 5 GHz networks, or incorrect credentials. By checking signal strength, ensuring a 2.4 GHz connection, and verifying network details, most issues can be resolved quickly.

A stable Wi-Fi connection enables convenient wireless control and improves workflow efficiency.

To make sure your Longer laser engraver works with your computer, check that the CH340 driver is installed and working well. If not, please download and install the appropriate driver for your device.

Step 1: Check the CH340 Driver Installation

• A. The connection issue may occur if the required CH340 driver is missing or improperly installed.

• B. For macOS 10.15 or later, the CH340 driver is already built-in and does not require manual installation.

• C. If installation is needed, download the driver package from the link below:
  👉 CH340 Driver Download

Video Tutorials:

• How to Install CH340 Driver for LightBurn on macOS Sequoia

• How to Install CH340 Driver for LightBurn on macOS

Step 2: Verify COM Port Detection

For Windows Users

1. Connect your Longer laser engraver to your PC using the included USB cable.

2. Download and install the CH340 driver. The installation may prompt you to restart your computer.

3. Follow the on-screen instructions to complete installation.If any error messages appear, please contact Longer technical support for assistance.

4. To confirm successful installation:

Right-click This PC, select Manage → Device Manager → Ports (COM & LPT).

If you see CH340 listed under COM ports, the system has successfully recognized your device.

For macOS Users

1. Connect your laser engraver to your Mac via the provided USB cable.

2. Download and install the CH340 driver. You may need to reboot the system.

   • If installation errors occur, contact Longer technical support.

3. After restarting, go to:
   System Preferences → Security & Privacy → General → Allow

   • Approve the CH340 driver installation when prompted (you may need to restart again).

   • Reconnect your laser engraver. Now LaserBurn, LightBurn, or LaserGRBL should automatically detect your device.

     

   • If the “Allow” button does not respond, follow the terminal method below.

Step 3: Load the Driver Manually via Terminal

1. Open Terminal:
   Finder → Applications → Utilities → Terminal

2. Copy and paste the following command:

   
   

   sudo kextload /Library/Extensions/usbserial.kext/

3. Press Enter. If prompted, enter your Mac user password, then press Enter again.

   

4. Once the command executes successfully, you will see a confirmation message in the Terminal window.

After completing these steps, your system should recognize the Longer laser engraver correctly. You can now connect and control your device through LaserBurn, LightBurn, or LaserGRBL without connection errors.

The Nano Duo comes equipped with a built-in camera that helps users precisely locate materials and designs before engraving.
In LightBurn, if you wish to use the camera feature, it must first be calibrated and aligned. The steps are as follows:

1. Focusing the Nano Duo

Before performing camera calibration and alignment, make sure to focus the Nano Duo properly.
Failure to do so may cause discrepancies between the designed and actual engraving sizes — resulting in engraved patterns appearing larger or smaller than intended.

2. Camera Calibration

Open LightBurn and select "Calibrate Camera Lens" in laser tools. 

Selecting "USB Camera" and "Standard Lens" in the interface, click "Next".

Place the calibration card in the camera view as shown, turn off "Honeycomb check enable", clik "Capture" button, and when "Next" lights up, proceed to the next step. Repeat the same operation multiple times.

Note: A 90-degree rotation of the image is normal and does not affect camera calibration. Position the calibration card according to the diagram; the orientation of the device does not matter.

Until the interface as shown and click "Align Camera", and the lens calibration is completed. 

3. Camera alignment

At the end of section 2, click "Align Camera" ,select "USB Camera", and click "Next".

In addition, you can also enter through "Calibrate Camera Alignment" in lasertools.

Place the wooden board, adjust the focus, set the engraving parameters, click "Frame" to confirm the engraving range is within the wooden board, and then click Engraving, and click "Next" after engraving.

Note: When carving thick materials like wood, refocusing is required.

Click the "Capture Image" button to capture. When the image is clear in the camera view, click "Next". If it is not clear, recapture it or return to the previous step and engraving it again. 

Pan and zoom to find the four corner marks, and double-click in the center of each one as precisely as you can. It is important that you mark the corners in their numbered order(1, 2, 3, 4).

When you have marked all four corners, click "Next" to continue.

Updating your RAY5 Mini firmware can improve machine stability, fix software-related problems, and ensure compatibility with the latest features. This guide explains the official firmware update methods step by step using MKSLaserTool, ESPTool Web, and the LaserBurn App.

All procedures, settings, menu names, and operational sequences in this guide follow the original official instructions exactly.

---

Table of Contents

1. What This Guide Covers
2. Quick Answer
3. Why Firmware Updates Matter
4. Before You Start
5. Requirements
6. Precautions
7. Step-by-Step Firmware Update Tutorial
8. Method 1: Update by MKSLaserTool Software
9. Method 2: Update by ESPTool Web
10. Method 3: Update by LaserBurn App
11. Common Problems and Solutions
12. Tips for Better Results
13. Frequently Asked Questions
14. Final Thoughts

---

What This Guide Covers

This tutorial explains:

• How to locate the correct CH340 serial port
• How to update firmware using MKSLaserTool
• How to flash firmware using ESPTool Web
• How to upgrade firmware using the LaserBurn App
• Correct baud rate and Flash size settings
• Common firmware update troubleshooting steps

This guide is beginner-friendly while preserving the original official firmware update process exactly.

---

Quick Answer

You can update the RAY5 Mini firmware in three official ways:

1. Update by MKSLaserTool software
2. Update by ESPTool Web
3. Update by LaserBurn App

For MKSLaserTool updates:

• Connect the engraver with a Type C cable
• Select the CH340 port
• Set baud to 25000
• Set Flash size to 8MB
• Select ESP32 S3
• Click Start to flash the firmware

---

Why Firmware Updates Matter

Firmware controls the communication between the laser engraver hardware and software. Updating the firmware can help:

• Improve machine performance
• Fix firmware-related bugs
• Improve communication stability
• Enhance compatibility
• Support newer software functions
• Resolve connection issues

Using the latest official firmware helps maintain reliable engraving performance.

---

Before You Start

Before updating the firmware, carefully prepare your machine and software environment.

Firmware flashing requires:

• Stable USB connection
• Correct serial port selection
• Correct firmware file
• Stable power during installation

Interrupting the flashing process may cause firmware installation failure.

---

Requirements

Prepare the following before starting:

• RAY5 Mini laser engraver
• Computer with Windows or compatible browser
• Type C cable
• Official firmware file
• MKSLaserTool software or ESPTool Web access
• CH340 driver installed
• Stable internet connection for web flashing

If compatibility information is unclear, follow official machine specifications or instructions.

---

Precautions

Use the Correct Firmware

Always use firmware designed specifically for the RAY5 Mini.

Installing incompatible firmware may cause startup or communication problems.

Keep Power Stable

Do not disconnect the machine or turn off the power during flashing.

Confirm the Correct Serial Port

Selecting the wrong COM port may prevent firmware flashing.

Avoid Disconnecting the USB Cable

Keep the Type C cable securely connected during the entire process.

---

Step-by-Step Firmware Update Tutorial

Locate the CH340 Serial Port in Windows

Action

For Windows, right-click the computer and select Manage, click Device Manager, click to expand Ports, find the port corresponding to the CH340 driver.

Expected Result

The correct COM port for the laser engraver is identified successfully.

Important Notes

• The CH340 driver must be installed correctly.
• The port name may change depending on the USB connection.
• Keep the engraver powered on while checking Device Manager.

---

Method 1: Update by MKSLaserTool Software

Step 1: Download and Install MKSLaserTool

Action

Please download LaserTool from
LONGER3D GitHub Repository
and install it.

Connect the laser engraver to computer with Type C cable, turn on the engraver.

Expected Result

The software installs successfully and the engraver connects to the computer.

Important Notes

• Use a stable Type C cable.
• Ensure the engraver remains powered on during flashing.
• Some computers may require driver installation before detection.

---

Step 2: Open the Firmware Flashing Tool

Action

Run the MKSLaserTool and click MKS ESP32 Download Tool.

Expected Result

The ESP32 firmware flashing interface opens successfully.

---

Step 3: Select the Correct Port and Firmware

Action

Select the right port which is corresponding to CH340 driver and the update firmware.

Expected Result

The software recognizes the selected COM port and firmware file.

Important Notes

• Double-check the COM port before proceeding.
• Verify the firmware file matches your machine model.

---

Step 4: Configure Flashing Settings

Action

Set baud to 25000, Flash size to 8MB, and select ESP32 S3.

Expected Result

The correct flashing configuration is prepared.

Important Notes

Do not modify these values unless official instructions specifically require different settings.

---

Step 5: Start Firmware Flashing

Action

Click Start.

Expected Result

It will prompt firmware successfully flashed after the update is completed.

Important Notes

• Do not disconnect the machine during flashing.
• The flashing process may take several minutes.
• Wait for the completion message before closing the software.

 

Method 2: Update by ESPTool Web

Step 1: Open ESPTool Web

Action

Enter
ESPTool Web
in the browser.

This webpage can connect to the serial port to flash the firmware online.

Expected Result

The ESPTool Web interface loads successfully in the browser.

Important Notes

• Use a compatible browser.
• Keep the engraver connected through the Type C cable.

---

Step 2: Connect to the CH340 Serial Port

Action

Select the baud rate 115200 and connect to the CH340 serial port.

Expected Result

The browser connects successfully to the engraver serial port.

Important Notes

If the serial port does not appear, reconnect the USB cable and verify the CH340 driver installation.

---

Step 3: Erase Existing Flash

Action

Click “Erase Flash” first.

Expected Result

The previous firmware data is erased successfully.

Important Notes

Do not disconnect the engraver during this process.

---

Step 4: Select Firmware and Flash Address

Action

Enter the Flash address 0x0 and select the firmware.

Expected Result

The firmware file is prepared for flashing.

Important Notes

Ensure the Flash address remains set to 0x0 exactly as instructed.

---

Step 5: Program the Firmware

Action

Click Program to start burning.

Expected Result

The firmware flashing process begins and completes successfully.

Important Notes

• Wait until the process fully completes.
• Avoid closing the browser during flashing.

 

Method 3: Update by LaserBurn APP

Step 1: Connect the Engraving Machine

Action

After the engraving machine is connected to the LaserBurn App, click Me→About→Firmware Update→RAY5 mini to upgrade the firmware.

Expected Result

The LaserBurn App starts the firmware update process successfully.

Important Notes

• Keep the app connected during the update.
• Ensure stable network and power conditions.
• Do not close the app during installation.

Common Problems and Solutions

---

Tips for Better Results

Use a High-Quality USB Cable

Poor-quality cables may interrupt serial communication.

Close Other Serial Port Software

Programs using the COM port may interfere with firmware flashing.

Verify Firmware Before Flashing

Double-check the firmware version and machine compatibility.

Keep the Computer Awake

Avoid sleep mode or automatic shutdown during firmware installation.

Follow Official Firmware Instructions

If firmware release notes include additional requirements, follow official machine specifications or instructions.

---

Frequently Asked Questions

1. What is the CH340 driver?

The CH340 driver allows the computer to communicate with the engraver through the USB serial connection.

---

2. Why can’t I see the COM port?

The driver may not be installed correctly, or the USB cable connection may be unstable.

---

3. What baud rate should I use for MKSLaserTool?

Set baud to 25000 exactly as specified in the official instructions.

---

4. What Flash size should I choose?

Set Flash size to 8MB.

---

5. Which ESP32 option should I select?

Select ESP32 S3 during the firmware flashing process.

---

6. Can I disconnect the machine during flashing?

No. Disconnecting the machine during firmware installation may cause flashing failure.

---

7. Why do I need to erase flash first in ESPTool Web?

The “Erase Flash” process clears previous firmware data before installing the new firmware.

---

8. Can I update firmware directly from the LaserBurn App?

Yes. The official process supports firmware updates through the LaserBurn App using:

Me→About→Firmware Update→RAY5 mini

---

Final Thoughts

Updating the RAY5 Mini firmware helps maintain machine stability and compatibility with the latest features. Whether you choose MKSLaserTool, ESPTool Web, or the LaserBurn App, carefully follow the official settings and procedures throughout the process.

Always use the correct firmware, maintain a stable connection, and avoid interrupting the flashing process. If additional information is needed, follow official machine specifications or instructions.