Difference between revisions of "Galaxy Series LinuxCNC Configuration"

Latest revision as of 12:28, 26 February 2019

Welcome to the new Galaxy Series Universal Configurator. This script will reconfigure the LinuxCNC software to add or remove features on your machine and has additional functionality to manage the most common problems in the hopes of maximizing uptime on your machine. Follow the on screen prompts carefully, but do not worry if you make a mistake as you can simply re-run the script to correct any errors. Before starting you will need:

Download the Configurator: Probotix.zip - last updated 2019-03-26
Minimum 8GB USB thumb drive formatted as FAT32

Getting Started

Copy the Probotix.zip file to the USB thumb drive.
Insert the thumb drive into the LinuxCNC PC. After a few seconds a window will pop up displaying the contents of the thumb drive. Right click on the Probotix.zip file and choose the "Extract Here" option. Do NOT copy this to the desktop!
Double-click on the newly created Probotix folder to open.
Find and double-click on the probotix.sh file.
A dialog will pop up and ask you what you want to do with the file. Chose the "Run in Terminal" option.

Extract
Folder
probotix.sh
Run in Terminal

Screen Prompts

Type the number of the screen option you wish to select then press Enter

Start
Order Number
Machine Model
Upright Type
Z Bearings
Units of Measure
Router or Spindle
Router SuperPID
ACME Types
ACME Screw
Unipolar or Bipolar
Gamepad or MPG
Sensors
Laser
Mount Types
Mount
4th Axis Rotary
Requires Reboot
No Reboot

Changes made by Configurator

Probotix Axis v1.6

Installs the Galaxy Series version of the Probotix Axis Interface
Changes color of terminal window to classic linux shell green on black
Installs php scripting engine
Installs numlockx to force numlock key on
Installs samba for networking
Installs g-code-filter.php to clean up .ngc2 files
Tries to identify secondary parallel port address, copies lspci -v output to thumb drive in case you need to email it to us
Disables screensaver and idle screen lock
Removes the update manager to prevent non-Probotix updates from installing
Turns on line numbers and auto-indent in gedit
Assigns [q] key to toggle pause/resume - works like feed hold on machining centers

@@ Line 1: / Line 1: @@
-Welcome to the new Galaxy Series Universal Configurator. This script will reconfigure the LinuxCNC software to add or remove features on your machine and has additional functionality to manage the most common problems in the hopes of maximizing uptime on your machine. This script will also be used to install software updates when they are released. Follow the on screen prompts carefully, but do not worry if you make a mistake as you can simply re-run the script to correct any errors.
+[[Category:LinuxCNC Configurations|Galaxy Series]]
-Important: Only run this script when you can afford to have the machine go down temporarily, as you may need to call us if anything goes wrong. We have tested this script several hundred times on as many machines as we could, but as with any software update, results can go not as you planned. If you are concerned, then CALL US TO SCHEDULE A TIME TO DO THE UPGRADE.
+Welcome to the new Galaxy Series Universal Configurator. This script will reconfigure the LinuxCNC software to add or remove features on your machine and has additional functionality to manage the most common problems in the hopes of maximizing uptime on your machine. Follow the on screen prompts carefully, but do not worry if you make a mistake as you can simply re-run the script to correct any errors.
+<!--
+<div class="errorbox">'''This is not for upgrades/updates.''' Regardless of the amount of time that has passed since the last use of your machine, you do not need to update the software. You should continue to use the software that was packaged with the machine as it was specially configured for that machine when built. In the event that you feel it needs to be changed we suggest you call us first.</div>
+<div class="warningbox">'''Important:''' Only run this script when you can afford to have the machine go down temporarily, as you may need to call us if anything goes wrong. We have tested this script several hundred times on as many machines as we could, but as with any software update, results can go not as you planned. If you are concerned, then CALL US TO SCHEDULE A TIME TO DO THE UPGRADE.</div>
+-->
+Before starting you will need:
+* Download the Configurator: [[Media:Probotix.zip | Probotix.zip]] - ''last updated {{RevisionDate| File:Probotix.zip }}''
+* Minimum 8GB USB thumb drive formatted as FAT32
 == Getting Started ==
-# Download this file:
+# Copy the <code>Probotix.zip</code> file to the USB thumb drive.
-#* [[Media:Probotix.zip | Probotix.zip]] - ''version 2.2.1-1.6 uploaded 12:31, 7 March 2018''
+# Insert the thumb drive into the LinuxCNC PC. After a few seconds a window will pop up displaying the contents of the thumb drive. Right click on the <code>Probotix.zip</code> file and choose the "Extract Here" option. '''Do NOT copy this to the desktop!'''
-# Copy the probotix.zip file to a freshly formatted 8GB or larger USB thumb drive. Make sure the thumb drive is formatted FAT32 - NTFS formatted drives will not work.
+# Double-click on the newly created <code>Probotix</code> folder to open.
-# Insert the thumb drive into the LinuxCNC PC. After a few seconds a window will pop up displaying the contents of the thumb drive. Right click on the probootix.zip file and choose the "Extract Here" option.
+# Find and double-click on the <code>probotix.sh</code> file.
-#: [[File:Thumb_drive1.jpg | 500px]]
-# This creates a folder called 'probotix'. Move into the probotix folder by double-clicking it.
-#: [[File:Thumb_drive2.jpg | 500px]]
-# In this folder you will see a file called 'probotix.sh'. Launch that file by double-clicking it.
-#: [[File:Thumb_drive3.jpg | 500px]]
 # A dialog will pop up and ask you what you want to do with the file. Chose the "Run in Terminal" option.
-#: [[File:Thumb_drive4.jpg | 500px]]
-== Follow On-Screen Prompts ==
-Step 0: New Install or Upgrade Existing installation?
-:*New Install: Delete any existing files and reinstall.
-:*Upgrade Existing: Updates the custom Probotix files like our StepConf and our version of Axis.
-Step 1: Enter your order number or 00000.
-Step 2a: Choose which machine you have.
-:*If you have a custom size machine, you need to enter the X & Y travel here.
-Step 3a: What type of up-rights does your machine have?
-:*The new Tall up-rights have a triangle cut out, the older Short ones do not.
-:*All 2018+ machines have Tall up-rights.
-Step 3b: How many Z-axis bearings do you have?
-:*2018+ machines have four (4) Z bearings, older have two (2) Z bearings.
-Step 4: Do you want the machine to run in inches or mm?
-Step 5a: Do you use a router or one of the 80mm VFD spindles?
-Step 5b: If you have a router, you need to choose which mount you have so that we can adjust for the distance to the center of the tool.
-:*Here is a diagram to help decide: [[http://www.probotix.com/wiki/images/9/9b/Short_long_mount.jpg Router Mount Diagram]].
-:*All 2016+ machines have long center distance.
-Step 6: Do you have the older Roton (black drive nuts) or the newer Helix (blue drive nuts) ACME screws?
-:*Here is a diagram to help decide: [[http://www.probotix.com/wiki/images/8/8e/Drive_nuts.jpg Drive Nut Diagram]].
-:*All 2016+ machines have Helix.
-Step 7: Do you have the older Probostep (uni-polar, beige control cabinet) or newer MondoStep (bi-polar, black cabinet or Unity controller) drivers?
-Step 8: Do you use the gamepad jog controller or the MPG Pendant?
-Step 9: Accept the default parallel port addressing, or enter custom addressing if instructed by us to do so.
-Step 10: Do you use the ATLaS tool sensor, the Z-puck, neither or both?
-:*If you use the Z-puck, this step will ask you for the height of your puck. Measure your puck with a set of calipers and enter the inch or mm measurement here.
-:*Here you can also move the Unity parallel cable to the second port for diagnostics if directed by us to do so.
-Step 11: Do you use the rotary axis?
-Step 12: On this step you can swap a motor to the A-axis header. You can do this if you have a driver failure to get back up and running in a hurry while waiting on replacement parts.
-:*You will lose use of the rotary when configured like this.
-:*On older controllers with ProboSteps, the 5-pin connector labeled A is actually Y2, and the unmarked 5 pin is A.
-Step 13: If you are having intermittent limit switch issues from faulty switches or electrical noise, you can configure the machine to use soft limits only.
-== Axis v1.6 Interface ==
-[[File:Axis_rev1.4.jpg|New Axis GUI|thumb|500px|right]]
-*New desktop background and LinuxCNC launch splash screen
-*There is now a folder shortcut to the nc_files directory right on the desktop. Now you can just drag your g-code files onto this shortcut after the windows pops up showing the contents of your USB thumb drive.
-*The new configurator will allow you to set the interface to run natively in metric (mm) mode.
-*LinuxCNC will now run initializing g-code in case your post processor doesn't insert the proper setup codes.
-*[Home All] has been renamed to [Home Machine]
-*[Touch-off] has been renamed to [Set Axis Origin]
-*After homing, the machine used to drive to the center of the table. Now the park after homing position is at absolute machine zero (front/left/up).
-*The G28 Button has been replaced by the [Bring To Front] button. It is now hard coded to be the center of the back of the machine all the way up on the Z. G28 is now free to use for other purposes.
-*The G30 Button has been replaced by the [Park At Rear] button. It is also now hard coded, but to the center of the front of the machine all the way up on the Z. G30 is now free to be used for other purposes.
-*There is a new [Return To Home] button that will bring the machine back to machine zero home.
-*There is a new [Return to X/Y Origin] button that will drive the machine back to the X/Y origin of the part.
-*[Load 1st Tool] has been renamed to [Measure First Tool]. If you do not have the ATLaS tool sensor, this button will no longer appear.
-*There is a new [Set Z Origin] button for quickly setting the current z position to zero for the current coordinate system.
-*If you have the Z-Puck, there is a new button for setting the Z-axis origin using the Z-puck. Click here to learn how to use it:[[Z_Touch-off_Puck]]
-*There is a new [Set X/Y Origin] to quickly set both the X & Y origin to zero for the current coordinate system simultaneously.
-*There is a new [G-code Reset] button that runs the initializing setup codes again. Use this button if you get lost, for instance if you forget what coordinate system you are in. The setup codes are G0 G54 G17 G20 G90 G40 G49 G64 P0.010 for machines configured for inch.
-*Joint number on limit switch errors will now display the axis name instead of the joint number.
-*The ATLaS tool length sensor location is now hard coded in the 100.ngc file. If you have your sensor mounted any place other than the factory location, you will need to manually edit the 100.ngc file.
-*ATLaS tool change routine is now o100 [tool_number] for both inch and mm configs.
+<gallery mode="packed-overlay">
+File: Thumb_drive1.jpg | Extract
+File: Thumb_drive2.jpg | Folder
+File: Thumb_drive3.jpg | probotix.sh
+File: Thumb_drive4.jpg | Run in Terminal
+</gallery>
-*ATLaS tool change routine will now skip driving to the front if the tool has already been measured.
+== Screen Prompts ==
+Type the number of the screen option you wish to select then press ''Enter''
+<gallery mode="packed-overlay">
+File: config-update.png| Start
+File: order-number.png| Order Number
+File: machine-galaxy.png | Machine Model
+File: uprights.png| Upright Type
+File: zbearings.png| Z Bearings
+File: units.png| Units of Measure
+File: spindle.png| Router or Spindle
+File: spid.png| Router SuperPID
+File: Drive_nuts.jpg | ACME Types
+File: acme-type.png | ACME Screw
+File: driver-type.png| Unipolar or Bipolar
+File: jogger.png| Gamepad or MPG
+File: sensors.png| Sensors
+File: laser.png| Laser
+File: Short_long_mount.jpg | Mount Types
+File: mount-type.png | Mount
+File: rotary.png| 4th Axis Rotary
+File: reboot-yes.png| Requires Reboot
+File: reboot-no.png| No Reboot
+</gallery>
-== Other (less sexy) things the configurator does ==
+== Changes made by Configurator ==
-*Changes color of terminal window to classic linux shell (well, kinda sexy).
+[[File:Axis_rev1.4.jpg|thumb|Probotix Axis v1.6]]
-*Installs php scripting engine
+* Installs the Galaxy Series version of the [[Probotix Axis Interface]]
-*Installs numlockx to force numb lock key on
+* Changes color of terminal window to classic linux shell green on black
-*Installs g-code-filter.php to clean up .ngc2 files (not sexy, yet - but its gonna be)
+* Installs php scripting engine
-*Tries to identify secondary parallel port address, copies lspci output to thumb drive incase you need to email it to us
+* Installs numlockx to force numlock key on
-*Disables screensaver and idle screen lock
+* Installs samba for networking
-*Uninstalls the update manager
+* Installs g-code-filter.php to clean up .ngc2 files
-*Turns line numbers on in gedit
+* Tries to identify secondary parallel port address, copies <code>lspci -v</code> output to thumb drive in case you need to email it to us
-*Assigns [q] key to toggle pause/resume - works like feed hold on machining centers
+* Disables screensaver and idle screen lock
+* Removes the update manager to prevent non-Probotix updates from installing
+* Turns on line numbers and  auto-indent in gedit
+* Assigns [q] key to toggle pause/resume - works like feed hold on machining centers