Click File > Open File to add the design to be engraved, and adjust the offset of X and Y in the target image window to change the position of the graphics to make sure it is in the range of the working area.
|
Machine model |
Working Area (mm) |
|
Ray5 mini 2.5/3.5W |
130*140 |
|
Ray5 mini 5.5W |
130*130 |
|
Ray5 miniS 2.5/3.5W |
130*140 |
|
Ray5 miniS 5.5/10W |
130*120 |
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.
1) Check if the emergency stop switch is pressed. If it is pressed, turn it clockwise to open it.
2) Check if the power adapter is connected.
## I. For Windows Systems
### 1. Common Causes & Solutions
**1) System Compatibility Issues**
* Windows 10/11 usually have built-in drivers, but auto-installation may fail.
* **Solution:** Manually download the latest driver from the official site (e.g., [wch.cn](http://www.wch.cn))—file name **CH341SER.EXE**.
**2) Old Driver Conflicts**
* Previously installed CH340/CH341 drivers may block installation.
* **Solution:**
* Open **Device Manager → View → Show Hidden Devices → Ports (COM & LPT)**.
* Right-click and **uninstall all CH340/CH341 devices, and check “Delete the driver software for this device.”
* Reinstall the latest driver.
**3) Driver Signature Issues (Win7 / Some Win10)**
* The system blocks unsigned drivers.
* **Solution:**
* Restart PC → Advanced Startup → Select **Disable Driver Signature Enforcement**.
* Then run the installer.
**4) Insufficient Permissions**
* Administrator rights are required.
* **Solution:** Right-click → **Run as Administrator**.
**5) USB Cable/Port Problems**
* Charging-only cables cannot transfer data; the device won’t be recognized even if the driver installs.
* **Solution:** Use a data-capable USB cable, preferably directly into a USB 2.0 port.
---
### 2. Confirm Successful Installation
* Plug in the device → Open **Device Manager**.
* Under **Ports (COM & LPT)**:
* If you see **USB-SERIAL CH340 (COM3)**, installation succeeded.
* If there’s a yellow exclamation mark → driver failed or conflicts exist.
---
### 3. Alternative Solutions
* Try another computer to rule out system issues.
* Use an **FT232 / CP2102 USB-to-Serial adapter** as a hardware workaround (better compatibility).
---
## II. For macOS Systems
### 1. Check if a Driver is Needed
* macOS 10.13+ sometimes recognizes CH340 chips automatically.
* Plug in the device → open **Terminal**, enter:
```bash
ls /dev/tty.*
```
* If you see something like `/dev/tty.wchusbserial1410` → no driver installation needed.
### 2. If Not Recognized → Install Driver
**1) Download Driver**
* Official: [CH341SER_MAC_ZIP](https://www.wch.cn/downloads/CH341SER_MAC_ZIP.html)
* Recommended open-source version: [GitHub – wchusbserial for macOS](https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver)
**2) Allow Kernel Extension**
* macOS may block installation (“System Extension Blocked”).
* **Solution:**
* Open **System Preferences → Security & Privacy → General**
* Click **Allow** for **WCH Electronics Co., Ltd.**
**3) Restart Computer**
* Must restart after installation to load the driver.
---
## III. Common Troubleshooting
1. **Driver installed but port not found**
* In Terminal, enter:
```bash
ls /dev/tty.*
```
* Re-plug the device to see if a new port appears.
2. **M1/M2 Mac (ARM)**
* Official drivers are often Intel-only; they may be incompatible.
* Use the open-source driver (GitHub – adrianmihalko version) for better compatibility.
3. **Permission Issues**
* Newer macOS versions (Big Sur / Monterey / Ventura) have stricter third-party driver policies.
* If there is no “Allow” option in Security & Privacy:
* Reboot into **Recovery Mode**
* Disable **System Integrity Protection (SIP)**, then install the driver.
---
## IV. Alternative Solutions
* Use an **FTDI USB-to-Serial adapter** (macOS native support, no driver needed).
* Or connect via **Wi-Fi** if your GRBL board supports it.
---
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.
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.
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
Connect your Longer laser engraver to your PC using the included USB cable.
Download and install the CH340 driver. The installation may prompt you to restart your computer.
Follow the on-screen instructions to complete installation.If any error messages appear, please contact Longer technical support for assistance.
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.
Connect your laser engraver to your Mac via the provided USB cable.
Download and install the CH340 driver. You may need to reboot the system.
If installation errors occur, contact Longer technical support.
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.
Open Terminal:
Finder → Applications → Utilities → Terminal
Copy and paste the following command:
sudo kextload /Library/Extensions/usbserial.kext/
Press Enter. If prompted, enter your Mac user password, then press Enter again.
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:
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.
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.
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.
Please download LaserTool from https://github.com/LONGER3D/Longer-Laser and install it. Connect the laser engraver to computer with Type C cable, turn on the engraver.
Enter https://espressif.github.io/esptool-js/ in the browser. This webpage can connect to the serial port to flash the firmware online.Select the baud rate 115200 and connect to the CH340 serial port, then Click “Erase Flash” first, then enter the Flash address 0x0 and select the firmware, then click Program to start burning.
After the engraving machine is connected to the LaserBurn App, click Me→About→Firmware Update→RAY5 mini to upgrade the firmware.
For Windows users, right-click This PC, select Manage, and open Device Manager. Expand the Ports (COM & LPT) section to locate the CH340 driver. Identify the COM port assigned to your Ray5 Mini and select it from the port list in LaserGRBL. Set the baud rate to 115200, then click Connect.
Once connected, the GRBL firmware will respond with a “welcome message” indicating the firmware version. You’ll also see “Status: Idle” displayed in the lower-right corner of the LaserGRBL interface — confirming a successful connection.
For macOS users, navigate to About This Mac → Overview → System Report, then click USB under the Hardware section. If the driver has installed automatically, you’ll find “USB Serial” listed under connected devices.
If no COM port appears in the dropdown list, it means the engraver was not detected. This could be due to an unplugged USB cable, the engraver being powered off, or a missing driver. To fix this, go to Tools → Install CH340 Driver within LaserGRBL to install the necessary driver.
Once the Ray5 Mini is properly connected, you can start setting up your engraving project.
Click File → Open File to import the image or design you want to engrave. Set the quality to 10 lines/mm, then click Next. Refer to your material’s parameter chart to define the optimal engraving power (S-MAX) and speed.
Make sure to select M4 – Dynamic Power Mode for laser operation.
💡 Tip: The S-MAX value should be 10 times the target laser power.
For 100% laser power, set S-MAX = 1000
For 60% power, set S-MAX = 600
Next, resize your image to fit the desired engraving area. If the design extends beyond the workspace, you can fine-tune its position using XY offset adjustments.
After importing the file and configuring parameters, use the focusing block to set the correct laser focus distance on the Ray5 Mini. Then, click the Frame button to confirm the engraving position on your material. Finally, press Start to begin the engraving process.
By following these steps, you can achieve precise, high-quality results with your Ray5 Mini laser engraver using LaserGRBL software — whether for DIY creations, small-scale production, or detailed material testing.
This detailed guide walks you through connecting the LONGER Ray5 Mini laser engraver to LaserBurn software on both mobile and desktop. From Wi-Fi setup and file management to engraving workflows and real-time controls, it covers everything you need to start engraving with confidence. Whether you're a beginner or just need a quick reference, this how-to makes setup fast and frustration-free.
!
