[{"data":1,"prerenderedAt":533},["ShallowReactive",2],{"header-article-translation-en-section-none":3,"wiki-en-getting-started-driver-setup":4,"wiki-tree-en":395},null,{"id":5,"title":6,"body":7,"category":379,"description":380,"extension":381,"locale":382,"meta":383,"navigation":384,"order":385,"path":386,"seo":387,"slug":388,"source":389,"stem":392,"updatedAt":393,"__hash__":394},"wiki\u002Fwiki\u002Fen\u002Fgetting-started\u002Fdriver-setup.md","Driver Configuration",{"type":8,"value":9,"toc":360},"minimark",[10,15,19,74,80,84,87,92,112,116,124,129,133,136,147,151,159,163,168,200,204,258,262,276,286,290,298,302,321,326,330,341,353,356],[11,12,14],"h2",{"id":13},"system-requirements-️","System Requirements 🖥️",[16,17,18],"p",{},"Before installing and using the driver, please ensure your system meets the following requirements:",[20,21,22,38,54,64],"ul",{},[23,24,25,29,30],"li",{},[26,27,28],"strong",{},"Operating System Support",":\n",[20,31,32,35],{},[23,33,34],{},"Windows 10 \u002F 11 (64-bit)",[23,36,37],{},"macOS 11 and above",[23,39,40,29,43],{},[26,41,42],{},"Hardware Requirements",[20,44,45,48,51],{},[23,46,47],{},"At least 4 GB RAM",[23,49,50],{},"USB 2.0 or higher interface",[23,52,53],{},"SSD storage recommended to speed up data transfer",[23,55,56,29,59],{},[26,57,58],{},"Network Requirements",[20,60,61],{},[23,62,63],{},"Stable internet connection",[23,65,66,29,69],{},[26,67,68],{},"Display Resolution",[20,70,71],{},[23,72,73],{},"1080p or higher recommended for the best interface experience",[75,76,77],"blockquote",{},[16,78,79],{},"The current version does not support Linux systems. For Linux support, please follow future version updates.",[11,81,83],{"id":82},"supported-machine-models-and-firmware-️","Supported Machine Models and Firmware 🛠️",[16,85,86],{},"The following device models have been verified as compatible with the driver:",[88,89,91],"h3",{"id":90},"cnc-series","🧱 CNC Series",[20,93,94,97,100,103,106,109],{},[23,95,96],{},"3020 Nova",[23,98,99],{},"3018 Pro Max",[23,101,102],{},"3018 Pro Ultra",[23,104,105],{},"4040 Turbo",[23,107,108],{},"4040 Titan",[23,110,111],{},"1325 Pro",[88,113,115],{"id":114},"laser-series","🔥 Laser Series",[20,117,118,121],{},[23,119,120],{},"4040 Lite",[23,122,123],{},"4040 Pro",[75,125,126],{},[16,127,128],{},"In addition to the above models, the driver also supports other devices using the GRBL protocol. Please ensure the control board is connected via serial port and running standard GRBL firmware (recommended version ≥ 1.1).",[11,130,132],{"id":131},"detailed-installation-steps","Detailed Installation Steps 📦",[16,134,135],{},"Driver installation consists of the following three steps:",[20,137,138,141,144],{},[23,139,140],{},"Download the driver",[23,142,143],{},"Install the driver",[23,145,146],{},"Verify the installation result",[88,148,150],{"id":149},"download-the-driver","Download the Driver",[16,152,153,154],{},"See ",[155,156,158],"a",{"href":157},"\u002Fwiki\u002Fappendix\u002Fdownload-center","Download Center",[88,160,162],{"id":161},"install-the-driver","Install the Driver",[164,165,167],"h4",{"id":166},"windows-installation-process","Windows Installation Process",[169,170,171,182,191],"ol",{},[23,172,173,174,177],{},"Double-click to run the driver",[175,176],"br",{},[178,179],"img",{"alt":180,"src":181},"Windows installer window showing a progress bar while it prepares the installation","\u002Fmedia\u002Fwiki\u002Fgetting-started\u002Fdriver-setup\u002Fwindows_install1_v1.webp",[23,183,184,185,187],{},"Follow the installation wizard and click “Next”",[175,186],{},[178,188],{"alt":189,"src":190},"Laetoly Driver setup wizard, welcome page with a Next button","\u002Fmedia\u002Fwiki\u002Fgetting-started\u002Fdriver-setup\u002Fwindows_install2_v1.webp",[23,192,193,194,196],{},"After installation is complete, click “Finish” to launch the driver",[175,195],{},[178,197],{"alt":198,"src":199},"Laetoly Driver setup wizard, finish page with a Finish button","\u002Fmedia\u002Fwiki\u002Fgetting-started\u002Fdriver-setup\u002Fwindows_install3_v1.webp",[164,201,203],{"id":202},"macos-installation-process","macOS Installation Process",[169,205,206,209,244,251],{},[23,207,208],{},"Double-click to open the installer package",[23,210,211,212],{},"If a security prompt appears, follow these steps to allow installation:",[20,213,214,220,226,232,238],{},[23,215,216,217],{},"Click the Apple menu in the top-left corner and select ",[26,218,219],{},"System Settings",[23,221,222,223],{},"In the sidebar, click ",[26,224,225],{},"Privacy & Security",[23,227,228,229],{},"In the “Security” section, click ",[26,230,231],{},"Open",[23,233,234,235],{},"Click ",[26,236,237],{},"Open Anyway",[23,239,240,241],{},"Enter your login password, then click ",[26,242,243],{},"OK",[23,245,246,247,250],{},"Reopen the installer package, wait a few seconds, then click ",[26,248,249],{},"Next"," in the installation interface",[23,252,253,254,257],{},"After installation is complete, click ",[26,255,256],{},"Finish"," to launch the driver",[88,259,261],{"id":260},"verify-driver-installation-success","Verify Driver Installation Success",[169,263,264,267],{},[23,265,266],{},"Log in to Laetoly",[23,268,269,270,272],{},"Wait a few seconds, the page will display the following prompt, indicating Laetoly has successfully connected to the driver:",[175,271],{},[178,273],{"alt":274,"src":275},"Projects page with a \"Connected successfully\" banner, confirming the driver is connected","\u002Fmedia\u002Fwiki\u002Fgetting-started\u002Fdriver-setup\u002Fwebsocket_connected.webp",[75,277,278],{},[16,279,280,281,285],{},"✅ If verification fails, please refer to ",[155,282,284],{"href":283},"\u002Fwiki\u002Ffaq\u002Finstallation_setup","Installation & Setup",".",[11,287,289],{"id":288},"usb-driver-and-port-configuration","USB Driver and Port Configuration",[16,291,292,293,295,296,285],{},"After installing the driver, Laetoly will automatically detect and list the available serial port devices on your system.",[175,294],{},"\nIf you encounter device connection or driver installation issues, please refer to ",[155,297,284],{"href":283},[88,299,301],{"id":300},"windows","Windows",[16,303,304,305,309,310,313,314,317,318,320],{},"On Windows 10 or 11 systems, serial port names usually start with ",[306,307,308],"code",{},"COM",", such as ",[306,311,312],{},"COM3",", ",[306,315,316],{},"COM5",", etc.",[175,319],{},"\nAs shown below:",[322,323],"figure",{"alt":324,"src":325},"Port drop-down in the Device panel listing COM1 and COM9 on Windows","\u002Fmedia\u002Fwiki\u002Fgetting-started\u002Fdriver-setup\u002Fwindows_serial_port.webp",[88,327,329],{"id":328},"macos","macOS",[16,331,332,333,336,337,340],{},"On macOS systems, serial port names usually start with ",[306,334,335],{},"cu."," or ",[306,338,339],{},"tty.",", common formats include:",[20,342,343,348],{},[23,344,345],{},[306,346,347],{},"cu.usbmodem*",[23,349,350],{},[306,351,352],{},"tty.usbmodem*",[16,354,355],{},"These serial port names can be automatically recognized and listed in Laetoly’s device connection interface. As shown below:",[322,357],{"alt":358,"src":359},"Port drop-down on macOS with the usbserial ports highlighted","\u002Fmedia\u002Fwiki\u002Fgetting-started\u002Fdriver-setup\u002Fmac_serial_port.webp",{"title":361,"searchDepth":362,"depth":362,"links":363},"",2,[364,365,370,375],{"id":13,"depth":362,"text":14},{"id":82,"depth":362,"text":83,"children":366},[367,369],{"id":90,"depth":368,"text":91},3,{"id":114,"depth":368,"text":115},{"id":131,"depth":362,"text":132,"children":371},[372,373,374],{"id":149,"depth":368,"text":150},{"id":161,"depth":368,"text":162},{"id":260,"depth":368,"text":261},{"id":288,"depth":362,"text":289,"children":376},[377,378],{"id":300,"depth":368,"text":301},{"id":328,"depth":368,"text":329},"getting-started","System requirements, supported machines, and how to install the Laetoly Driver and set up the serial port on Windows and macOS.","md","en",{},true,20,"\u002Fwiki\u002Fen\u002Fgetting-started\u002Fdriver-setup",{"title":6,"description":380},"driver-setup",{"wikijsId":390,"wikijsPath":391},74,"getting-started\u002Fdriver-setup","wiki\u002Fen\u002Fgetting-started\u002Fdriver-setup","2026-09-14","8jWN7LK6ecs6JX70qHE0EtS73uRwgaxT0gAGF3tJUgY",[396,415,444,459,478,508],{"category":379,"pages":397},[398,403,405,410],{"title":399,"category":379,"slug":400,"order":401,"path":402},"Welcome to Laetoly","welcome-to-laetoly",10,"\u002Fwiki\u002Fgetting-started\u002Fwelcome-to-laetoly",{"title":6,"category":379,"slug":388,"order":385,"path":404},"\u002Fwiki\u002Fgetting-started\u002Fdriver-setup",{"title":406,"category":379,"slug":407,"order":408,"path":409},"Your First Project","your-first-project",30,"\u002Fwiki\u002Fgetting-started\u002Fyour-first-project",{"title":411,"category":379,"slug":412,"order":413,"path":414},"Video Tutorial","video-tutorial",40,"\u002Fwiki\u002Fgetting-started\u002Fvideo-tutorial",{"category":416,"pages":417},"design",[418,422,426,430,434,439],{"title":419,"category":416,"slug":420,"order":401,"path":421},"Importing","importing","\u002Fwiki\u002Fdesign\u002Fimporting",{"title":423,"category":416,"slug":424,"order":385,"path":425},"Drawing Tools","drawing-tools","\u002Fwiki\u002Fdesign\u002Fdrawing-tools",{"title":427,"category":416,"slug":428,"order":408,"path":429},"Editing & Transformation","editing-transformation","\u002Fwiki\u002Fdesign\u002Fediting-transformation",{"title":431,"category":416,"slug":432,"order":413,"path":433},"Properties","properties","\u002Fwiki\u002Fdesign\u002Fproperties",{"title":435,"category":416,"slug":436,"order":437,"path":438},"Libraries","libraries",50,"\u002Fwiki\u002Fdesign\u002Flibraries",{"title":440,"category":416,"slug":441,"order":442,"path":443},"Others","others",60,"\u002Fwiki\u002Fdesign\u002Fothers",{"category":445,"pages":446},"preview-run",[447,451,455],{"title":448,"category":445,"slug":449,"order":401,"path":450},"3D Preview","3D-preview","\u002Fwiki\u002Fpreview-run\u002F3D-preview",{"title":452,"category":445,"slug":453,"order":385,"path":454},"Running Jobs","running-jobs","\u002Fwiki\u002Fpreview-run\u002Frunning-jobs",{"title":456,"category":445,"slug":457,"order":408,"path":458},"Real-Time Monitoring","real-time-monitoring","\u002Fwiki\u002Fpreview-run\u002Freal-time-monitoring",{"category":460,"pages":461},"system-config",[462,466,470,474],{"title":463,"category":460,"slug":464,"order":401,"path":465},"Add Device","add-device","\u002Fwiki\u002Fsystem-config\u002Fadd-device",{"title":467,"category":460,"slug":468,"order":385,"path":469},"Settings","settings","\u002Fwiki\u002Fsystem-config\u002Fsettings",{"title":471,"category":460,"slug":472,"order":408,"path":473},"User Panel","user-panel","\u002Fwiki\u002Fsystem-config\u002Fuser-panel",{"title":475,"category":460,"slug":476,"order":413,"path":477},"G-code Console","g-code-console","\u002Fwiki\u002Fsystem-config\u002Fg-code-console",{"category":479,"pages":480},"faq",[481,483,487,491,495,499,503],{"title":284,"category":479,"slug":482,"order":401,"path":283},"installation_setup",{"title":484,"category":479,"slug":485,"order":385,"path":486},"Connection","connection","\u002Fwiki\u002Ffaq\u002Fconnection",{"title":488,"category":479,"slug":489,"order":408,"path":490},"Design & Files","design_files","\u002Fwiki\u002Ffaq\u002Fdesign_files",{"title":492,"category":479,"slug":493,"order":413,"path":494},"Toolpath & G-code","toolpath_g-code","\u002Fwiki\u002Ffaq\u002Ftoolpath_g-code",{"title":496,"category":479,"slug":497,"order":437,"path":498},"Engraving Quality","engraving_quality","\u002Fwiki\u002Ffaq\u002Fengraving_quality",{"title":500,"category":479,"slug":501,"order":442,"path":502},"Device Operation","device_operation","\u002Fwiki\u002Ffaq\u002Fdevice_operation",{"title":504,"category":479,"slug":505,"order":506,"path":507},"Safety Guidelines","safety_guidelines",70,"\u002Fwiki\u002Ffaq\u002Fsafety_guidelines",{"category":509,"pages":510},"appendix",[511,513,517,521,525,529],{"title":158,"category":509,"slug":512,"order":401,"path":157},"download-center",{"title":514,"category":509,"slug":515,"order":385,"path":516},"Release Notes","release-notes","\u002Fwiki\u002Fappendix\u002Frelease-notes",{"title":518,"category":509,"slug":519,"order":408,"path":520},"Glossary","glossary","\u002Fwiki\u002Fappendix\u002Fglossary",{"title":522,"category":509,"slug":523,"order":413,"path":524},"G-Code Commands","g-code-commands","\u002Fwiki\u002Fappendix\u002Fg-code-commands",{"title":526,"category":509,"slug":527,"order":437,"path":528},"Bit & Material Reference","bit-material-reference","\u002Fwiki\u002Fappendix\u002Fbit-material-reference",{"title":530,"category":509,"slug":531,"order":442,"path":532},"Credit System Guide","credit-system-guide","\u002Fwiki\u002Fappendix\u002Fcredit-system-guide",1792396296081]