Replacing the mainboard on a Ray5 mini or Ray5 miniS laser engraver may sound difficult, but the process is straightforward when performed carefully. This guide explains the exact replacement procedure from the official instructions while adding beginner-friendly explanations, safety precautions, troubleshooting advice, and maintenance tips to help you complete the repair successfully.

Table of Contents

1. What This Guide Covers
2. Quick Answer
3. Why This Process Matters
4. Before You Start
5. Requirements
6. Precautions
7. Step-by-Step Tutorial
8. Common Problems and Solutions
9. Tips for Better Results
10. Frequently Asked Questions
11. Final Thoughts

What This Guide Covers

This tutorial explains how to replace the mainboard on the Ray5 mini and Ray5 miniS laser engravers.

You will learn:

• How to safely access the mainboard
• Which cables must be disconnected
• How to reconnect the new board correctly
• How to align the TYPE-C and POWER ports
• How to avoid common installation mistakes
• Basic troubleshooting after replacement

The Ray5 mini and Ray5 miniS use the same mainboard, and the replacement procedure is similar. This guide uses the Ray5 mini X-axis as the example machine.

Quick Answer

To replace the Ray5 mini or miniS mainboard:

1. Remove the front beam cover using a 2.5 mm hex wrench.
2. Remove the existing mainboard.
3. Disconnect the X/Y motors, emergency stop, laser, and limit switch cables.
4. Connect all cables to the new mainboard using the original labels.
5. Install the new board, align the TYPE-C and POWER ports, and secure everything with screws.

Always power off the machine before starting maintenance.

Why This Process Matters

The mainboard is the control center of the laser engraver. It manages:

• Motor movement
• Laser control
• Limit switches
• Emergency stop functions
• USB communication
• Power distribution

If the mainboard becomes damaged or unstable, you may experience:

• Connection failures
• Random alarms
• Motor movement errors
• Laser output problems
• Machine startup issues
• Limit switch errors

Replacing the board correctly helps restore stable machine operation and prevents additional electrical issues.

Before You Start

Before opening the machine, prepare a clean workspace with enough lighting.

Make sure:

• The machine is powered off
• The power cable is disconnected
• The laser module is cool
• Small screws can be safely stored during disassembly

For the Ray5 miniS, you also need additional working space because the acrylic base plate must be removed during the process.

Requirements

Prepare the following tools and items before starting:

• 2.5 mm hex wrench
• 2.5 mm Allen wrench
• Replacement Ray5 mini/miniS mainboard
• Clean working surface
• Screw storage tray or container

Follow official machine specifications or instructions.

Precautions

Before replacing the Ray5 motherboard, carefully review these safety precautions.

Disconnect Power Completely

Always disconnect the machine from power before touching internal electronics. Working on a powered machine may damage the new mainboard.

Avoid Pulling on Wires

When disconnecting cables, pull gently from the connector housing instead of pulling the wires directly.

Keep Track of Cable Labels

The cables are labeled to match the corresponding ports on the mainboard. Incorrect connections may prevent the machine from operating properly.

Prevent Static Electricity

Avoid touching exposed electronic components unnecessarily. Static discharge can damage sensitive circuitry.

Organize Screws Carefully

The front beam cover and mainboard use multiple screws. Store them safely to avoid losing hardware during the repair.

Step-by-Step Tutorial

Step 1: Remove the Front Beam Cover

Action

Use a 2.5 mm hex wrench to loosen the four screws and remove the front beam cover.

For the Ray5 miniS, also remove the acrylic base plate to facilitate operation.

Expected Result

You should now have access to the internal mainboard compartment inside the front beam.

Important Notes

• Keep the screws organized for reinstallation.
• Do not force the cover if it feels stuck.
• Lift the cover carefully to avoid pulling internal cables.

Step 2: Remove the Mainboard

Action

Use a 2.5 mm Allen wrench to loosen the four screws and remove the mainboard.

Expected Result

The existing mainboard should now be free from the mounting position inside the beam.

Important Notes

• Support the board gently while removing screws.
• Do not bend the board during removal.
• Avoid touching exposed electronic components.

Step 3: Disconnect the Mainboard Cables

Action

Disconnect the following cables from the mainboard:

• X-axis motor (X)
• Y-axis motor (Y)
• Emergency stop (MS)
• Laser (PWM)
• X-axis limit switch (X-)
• Y-axis limit switch (Y-)

Expected Result

All required cables should now be disconnected from the old mainboard.

Important Notes

• Disconnect cables one at a time if needed.
• Double-check cable labels before removal.
• Never pull forcefully on connectors.

Step 4: Install the New Mainboard

Action

Connect the cables to the new mainboard, matching each cable label with the corresponding port on the mainboard.

Place the new mainboard inside the front beam, routing the cables through the gap near the Y-axis limit switch.

Make sure the TYPE-C and POWER ports at the front of the beam align correctly with the mainboard connectors.

Expected Result

The new mainboard should sit correctly inside the beam with all cables securely connected.

Important Notes

Cable Routing Matters

Improper cable routing may pinch wires when reinstalling the cover.

Verify Port Alignment

Before tightening screws, confirm:

• TYPE-C port alignment
• POWER port alignment

Misalignment may prevent proper cable connection later.

Check Cable Labels Carefully

The labels should match the ports exactly:

Step 5: Secure the Mainboard and Reinstall the Cover

Action

Use a 2.5 mm hex wrench and screws to secure the mainboard, then reinstall the cover.

This completes the mainboard replacement.

Expected Result

The machine should now be fully reassembled with the new mainboard installed.

Important Notes

• Tighten screws evenly.
• Do not overtighten screws.
• Confirm no cables are trapped beneath the cover.

 Mini:

MiniS:

Common Problems and Solutions

Tips for Better Results

Take Photos Before Disassembly

Photos help beginners remember cable positions and routing.

Label Connectors if Necessary

If cable labels are unclear, add temporary labels before disconnecting anything.

Work Slowly

Most installation mistakes happen when rushing the process.

Test Before Full Reassembly

After connecting the new board, verify the ports align properly before tightening everything completely.

Keep the Interior Clean

Dust and debris inside the beam can affect long-term reliability.

Frequently Asked Questions

Is the Ray5 mini mainboard the same as the Ray5 miniS mainboard?

Yes. The Ray5 mini and Ray5 miniS use the same mainboard, and the replacement procedure is similar.

Do I need special firmware after replacing the mainboard?

Follow official machine specifications or instructions.

Why do I need to remove the acrylic base plate on the miniS?

Removing the acrylic base plate provides easier access during the repair process.

What happens if I connect a cable to the wrong port?

Incorrect cable connections may cause movement errors, limit switch problems, or laser control issues. Always match cable labels carefully.

Can I replace the board without removing the front beam cover?

No. The front beam cover must be removed to access the mainboard.

What tool size is required for this repair?

The official instructions specify a 2.5 mm hex wrench and a 2.5 mm Allen wrench.

Why are the TYPE-C and POWER ports important during installation?

These ports must align correctly with the openings at the front of the beam so the machine can connect properly after reassembly.

What should I do if the machine still shows errors after replacement?

Recheck:

• Cable connections
• Port alignment
• Motor connectors
• Limit switch connectors
• Emergency stop cable

If problems continue, follow official machine specifications or instructions.

Final Thoughts

Replacing the Ray5 mini or Ray5 miniS mainboard is a manageable repair when performed carefully and methodically. The most important part of the process is reconnecting every cable correctly and ensuring the TYPE-C and POWER ports align properly during installation.

By following the official procedure exactly and taking your time during disassembly and reassembly, you can safely restore your laser engraver to normal operation. Proper cable management, organized screws, and careful connector handling will help prevent additional issues during the repair process.

For firmware, electrical specifications, or additional troubleshooting, follow official machine specifications or instructions.

The timing belt is a key component responsible for transmitting motion between the motor and the X/Y axes. Over time, belts can wear out, loosen, or break, leading to issues such as inaccurate positioning, skipped steps, or uneven engraving.

Replacing the timing belt ensures smooth motion, precise alignment, and consistent engraving quality on your Ray5 mini/miniS.

1. Remove the Laser Module

• Disconnect the laser cable
• Loosen the M3×14 screws or L-shaped hand screws
• Remove the laser module

Ray5 mini/miniS 2.5/3.5W

Ray5 mini/miniS 5.5/10W

2. Remove the Top Cover (Ray5 miniS only)

• Remove the top acrylic cover
• Unscrew 12 screws to access internal components

Top acrylic cover

3. Remove the Slider Components

• Use a 2mm hex wrench to loosen the four screws
• Remove:
  • Slider plastic part (mini)
  • Metal slider with plastic part (miniS)

Ray5 mini/miniS 2.5/3.5W 

Ray5 mini/miniS 5.5/10W

4. Remove the Timing Belt

• Use a hex wrench to loosen the screws securing both axes:
  • X-axis: 2 screws
  • Y-axis: 4 screws (2 front + 2 rear)
• Carefully remove the timing belt

⚠️ Important:

• Do not miss the T-slot screws that secure the belt

5. Install the New Timing Belt

• Thread the new belt through the pulleys and connecting shaft in order
• Ensure the belt is properly seated on the shaft

💡 Tip:

• Use a screwdriver to guide the belt
• Slightly move pulleys left and right to help the belt pass smoothly

6. Tension and Secure the Belt

• Insert one T-slot screw into the profile along the X-axis
• Press the belt onto the screw and tighten it
• Pull the belt tight on the opposite side
• Insert the second T-slot screw and tighten

Check after installation:

• The belt should have proper elasticity
• Pulleys should move smoothly without sticking

7. Reinstall Components

• Reinstall the slider and plastic parts
• For Ray5 miniS, reinstall the top acrylic cover

 Mini：

MiniS：

Conclusion

Replacing the timing belt on the Ray5 mini/miniS is essential for maintaining precise motion control and high engraving accuracy. Proper installation ensures smooth operation, reduces mechanical errors, and extends the lifespan of the machine.

Regular inspection and timely replacement of the timing belt will help maintain consistent performance and reliable engraving results.

Ray5 mini and miniS use the same type of ribbon cable, and the replacement method is similar. This guide takes the Ray5 mini as an example.

1. Loosen the Velcro and disconnect the cables for the laser, X/Y-axis motors, and the X-axis limit switch. For the Ray5 miniS, you also need to remove the acrylic base to make the operation easier.

2. Use a 2.5 mm hex wrench to loosen the four screws and remove the front beam cover. 

3. Use a 2.5 mm hex wrench to loosen the four screws and remove the mainboard.

4. Disconnect the X and Y axis motor cables (X, Y), the laser cable (PWM), and the X-axis limit switch cable (X-) from the mainboard.

5. Insert the new combined cable into the mainboard according to the cable labels and the markings on the mainboard. Place the mainboard inside the front beam, routing the cable through the gap near the Y-axis limit switch. Make sure the TYPE-C and POWER ports at the front of the beam align correctly with the mainboard connectors.

6. Secure the mainboard with screws using a 2.5 mm hex wrench, and then install the cover plate.

7. Insert the X-axis motor (X), X-axis limit switch (X), Y-axis motor (Y), and laser according to the cable labels, completing the replacement of the combined cable.

Mini:

MiniS:

Unclear or faint engraving patterns are one of the most common issues when using the Ray5 MiniS. This problem is usually related to focus accuracy, software settings, parameter mismatch, or lens contamination rather than hardware failure.

This guide walks you through a structured troubleshooting process to help restore clear and high-quality engraving results.

1) First make sure the focus is correct.

 Use the focus block to adjust the focal length. 

2) Check if the S value in Lightburn

That is, click Lightburn-Edit-Device Setting and check whether the S-value MAX is 1000.

3) Check the parameters

Check whether the engraving parameters are correct, especially the speed unit; please refer to the parameter table on the official website. And for the LaserGRBL software, the value of S-MAX is 10 times the target laser power, such as when the laser power is 100%, S-MAX needs to be set to 1000%

4) Turn on the constant power

When editing parameters, make sure the laser mode is set to constant power mode, as shown in the figure.

5) Check the window mirror

Check whether the window mirror of the laser head unit is contaminated. If there is contamination, it is recommended to use lens cleaning paper or a dust-free cloth soaked in alcohol to wipe gently to avoid damaging the coating.

Conclusion

Unclear engraving is typically caused by setup or parameter issues rather than hardware defects. By carefully checking focus, software settings, engraving parameters, and lens cleanliness, you can quickly restore sharp and detailed engraving results.

Maintaining proper configuration and routine maintenance will ensure consistent performance and high-quality output from your Ray5 MiniS.

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

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.