LinuxCNC V2.7.15-22-g3231675, 2021-01-22 i LinuxCNC V2.7.15-22-g3231675, 2021-01-22 LinuxCNC V2.7.15-22-g3231675, 2021-01-22 ii Contents I Contents 1 II About LinuxCNC2 1 Introduction 3 2 LinuxCNC History 4 2.1 Origin.........................................................4 2.2 Name Change.....................................................5 2.3 Additional Info....................................................5 III Using LinuxCNC6 3 General Info 7 3.1 User Foreword....................................................7 3.2 LinuxCNC User Introduction.............................................8 3.2.1 How LinuxCNC Works............................................8 3.2.2 Graphical User Interfaces..........................................9 3.2.2.1 Additional Features........................................ 15 3.2.3 Virtual Control Panels............................................ 15 3.2.4 Languages.................................................. 17 3.2.5 Thinking Like a Machine Operator...................................... 17 3.2.6 Modes of Operation............................................. 17 3.3 Important User Concepts............................................... 18 3.3.1 Trajectory Control.............................................. 18 3.3.1.1 Trajectory Planning........................................ 18 3.3.1.2 Path Following........................................... 18 3.3.1.3 Programming the Planner..................................... 18 3.3.1.4 Planning Moves.......................................... 19 3.3.2 G Code.................................................... 20 LinuxCNC V2.7.15-22-g3231675, 2021-01-22 iii 3.3.2.1 Defaults.............................................. 20 3.3.2.2 Feed Rate............................................. 20 3.3.2.3 Tool Radius Offset......................................... 20 3.3.3 Homing.................................................... 20 3.3.4 Tool Changes................................................. 20 3.3.5 Coordinate Systems............................................. 21 3.3.5.1 G53 Machine Coordinate..................................... 21 3.3.5.2 G54-59.3 User Coordinates.................................... 21 3.3.5.3 When You Are Lost........................................ 21 3.3.6 Machine Configurations........................................... 21 3.4 Starting LinuxCNC.................................................. 23 3.4.1 Running LinuxCNC............................................. 23 3.4.1.1 Configuration Selector....................................... 24 3.5 CNC Machine Overview............................................... 24 3.5.1 Mechanical Components........................................... 24 3.5.1.1 Axes................................................ 24 3.5.1.2 Spindle.............................................. 24 3.5.1.3 Coolant.............................................. 24 3.5.1.4 Feed and Speed Override..................................... 24 3.5.1.5 Block Delete Switch........................................ 25 3.5.1.6 Optional Program Stop Switch.................................. 25 3.5.2 Control and Data Components........................................ 25 3.5.2.1 Linear Axes............................................ 25 3.5.2.2 Rotational Axes.......................................... 25 3.5.2.3 Controlled Point.......................................... 25 3.5.2.4 Coordinated Linear Motion.................................... 25 3.5.2.5 Feed Rate............................................. 26 3.5.2.6 Coolant.............................................. 26 3.5.2.7 Dwell............................................... 26 3.5.2.8 Units............................................... 26 3.5.2.9 Current Position.......................................... 26 3.5.2.10 Selected Plane........................................... 26 3.5.2.11 Tool Carousel........................................... 26 3.5.2.12 Tool Change............................................ 27 3.5.2.13 Pallet Shuttle............................................ 27 3.5.2.14 Path Control Mode........................................ 27 3.5.3 Interpreter Interaction with Switches..................................... 27 3.5.3.1 Feed and Speed Override Switches................................ 27 3.5.3.2 Block Delete Switch........................................ 27 LinuxCNC V2.7.15-22-g3231675, 2021-01-22 iv 3.5.3.3 Optional Program Stop Switch.................................. 27 3.5.4 Tool Table.................................................. 27 3.5.5 Parameters.................................................. 28 3.6 Running LinuxCNC.................................................. 28 3.6.1 Invoking LinuxCNC............................................. 28 3.6.2 Configuration Launcher........................................... 28 3.6.3 Next steps in configuration.......................................... 31 3.6.4 Simulator Configurations........................................... 31 3.6.5 Configuration Resources........................................... 32 3.7 Stepper Configuration Wizard............................................ 32 3.7.1 Introduction.................................................. 32 3.7.2 Start Page................................................... 33 3.7.3 Basic Information............................................... 34 3.7.4 Latency Test................................................. 35 3.7.5 Parallel Port Setup.............................................. 37 3.7.6 Parallel Port 2 Setup............................................. 38 3.7.7 Axis Configuration.............................................. 39 3.7.7.1 Test This Axis........................................... 40 3.7.8 Spindle Configuration............................................ 42 3.7.8.1 Spindle Speed Control....................................... 42 3.7.8.2 Spindle-synchronized motion................................... 43 3.7.8.3 Determining Spindle Calibration................................. 43 3.7.9 Options.................................................... 44 3.7.10 Machine Configuration Complete...................................... 44 3.7.11 Axis Travel and Home............................................ 45 3.7.11.1 Operating without Limit Switches................................. 45 3.7.11.2 Operating without Home Switches................................ 45 3.7.11.3 Home and Limit Switch wiring options.............................. 45 3.8 Mesa Configuration Wizard.............................................. 46 3.8.1 Step by Step Instructions........................................... 48 3.8.2 Create or Edit................................................. 48 3.8.3 Basic Machine Information.......................................... 49 3.8.4 External Configuration............................................ 51 3.8.5 GUI Configuration.............................................. 53 3.8.6 Mesa Configuration.............................................. 56 3.8.7 Mesa I/O Setup................................................ 57 3.8.8 Parport configuration............................................. 61 3.8.9 Axis Configuration.............................................. 62 3.8.10 Spindle Configuration............................................ 69 LinuxCNC V2.7.15-22-g3231675, 2021-01-22 v 3.8.11 Advanced Options.............................................. 71 3.8.12 HAL Components.............................................. 72 3.8.13 Advanced Usage Of PNCconf........................................ 73 3.9 Linux FAQ...................................................... 74 3.9.1 Automatic Login............................................... 74 3.9.2 Automatic Startup.............................................. 74 3.9.3 Terminal................................................... 74 3.9.4 Man Pages.................................................. 74 3.9.5 List Modules................................................. 75 3.9.6 Editing a Root File.............................................. 75 3.9.6.1 The Command Line Way..................................... 75 3.9.6.2 The GUI Way........................................... 75 3.9.6.3 Root Access............................................ 75 3.9.7 Terminal Commands............................................. 75 3.9.7.1 Working Directory......................................... 75 3.9.7.2 Changing Directories....................................... 76 3.9.7.3 Listing files in a directory..................................... 76 3.9.7.4 Finding a File........................................... 76 3.9.7.5 Searching for Text......................................... 76 3.9.7.6 Diagnostic Messages....................................... 77 3.9.8 Convenience Items.............................................. 77 3.9.8.1 Terminal Launcher......................................... 77 3.9.9 Hardware Problems.............................................. 77 3.9.9.1 Hardware Info........................................... 77 3.9.9.2 Monitor Resolution........................................ 77 3.9.10 Paths..................................................... 77 3.10 Lathe User Information................................................ 78 3.10.1 Lathe Mode.................................................. 78 3.10.2 Lathe Tool Table............................................... 78 3.10.3 Lathe Tool Orientation............................................ 78 3.10.4 Tool Touch Off...............................................