Difference between revisions of "Galaxy Series LinuxCNC Configuration"

Latest revision as of 13: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 the Configurator:
+# Copy the <code>Probotix.zip</code> file to the USB thumb drive.
-#* [[Media:Probotix.zip | Probotix.zip]] - ''version 2.4.0 uploaded 20:55, 16 July 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.
-#* '''Do not copy this to the desktop!'''
-# This creates a folder called 'probotix'. Move into the probotix folder by double-clicking it.
-# In this folder you will see a file called 'probotix.sh'. Launch that file by double-clicking it.
 # A dialog will pop up and ask you what you want to do with the file. Chose the "Run in Terminal" option.
-<gallery mode="packed-overlay" heights="200px">
+<gallery mode="packed-overlay">
-File: Thumb_drive1.jpg | Step 3
+File: Thumb_drive1.jpg | Extract
-File: Thumb_drive2.jpg | Step 4
+File: Thumb_drive2.jpg | Folder
-File: Thumb_drive3.jpg | Step 5
+File: Thumb_drive3.jpg | probotix.sh
-File: Thumb_drive4.jpg | Step 6
+File: Thumb_drive4.jpg | Run in Terminal
 </gallery>
-<!--
+== Screen Prompts ==
-== Follow On-Screen Prompts ==
+Type the number of the screen option you wish to select then press ''Enter''
-Step 0: New Install or Upgrade Existing installation?
+<gallery mode="packed-overlay">
-:*New Install: Delete any existing files and reinstall.
+File: config-update.png| Start
-:*Upgrade Existing: Updates the custom Probotix files like our StepConf and our version of Axis.
+File: order-number.png| Order Number
+File: machine-galaxy.png | Machine Model
-Step 1: Enter your order number or 00000.
+File: uprights.png| Upright Type
+File: zbearings.png| Z Bearings
-Step 2a: Choose which machine you have.
+File: units.png| Units of Measure
-:*If you have a custom size machine, you need to enter the X & Y travel here.
+File: spindle.png| Router or Spindle
+File: spid.png| Router SuperPID
-Step 3a: What type of up-rights does your machine have?
+File: Drive_nuts.jpg | ACME Types
-:*The new Tall up-rights have a triangle cut out, the older Short ones do not.
+File: acme-type.png | ACME Screw
-:*All 2018+ machines have Tall up-rights.
+File: driver-type.png| Unipolar or Bipolar
+File: jogger.png| Gamepad or MPG
-Step 3b: How many Z-axis bearings do you have?
+File: sensors.png| Sensors
-:*2018+ machines have four (4) Z bearings, older have two (2) Z bearings.
+File: laser.png| Laser
+File: Short_long_mount.jpg | Mount Types
-Step 4: Do you want the machine to run in inches or mm?
+File: mount-type.png | Mount
+File: rotary.png| 4th Axis Rotary
-Step 5a: Do you use a router or one of the 80mm VFD spindles?
+File: reboot-yes.png| Requires Reboot
+File: reboot-no.png| No Reboot
-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.
+</gallery>
-:*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: 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.
-Step 10a: Accept the default parallel port addressing, or enter custom addressing if instructed by us to do so.
-Step 10b: Here you can 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 v2.0 Interface ==
-[[Image: Axis_probotix_2018.png | thumb | 500px]]
-* New toolbar icon theme!
-* Added two open icons: HDD icon to open <code>/nc_files</code>, and USB icon to open the <code>/media</code> folder to find the inserted drive.
-* [Home Machine] has been moved to the toolbar as a new icon.
-* [Touch-off] has been renamed to [Set Selected Axis Origin]
-* Added Set Origin [X/Y] and [Z] buttons to quick-set touch-offs for current coordinate system.
-* Renamed Mist/Flood/Shop Vac check boxes to describe what they actually control on the Unity.
-* Code preview colors changed to match terminal: green text on black background.
-* Added current coordinate system and spindle state/speed to status bar.
-== 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 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 numb lock key on
+* Installs numlockx to force numlock key on
 * Installs samba for networking
-* Installs g-code-filter.php to clean up .ngc2 files (not sexy, yet - but its gonna be)
+* Installs g-code-filter.php to clean up .ngc2 files
-* Tries to identify secondary parallel port address, copies lspci output to thumb drive incase you need to email it to us
+* 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
 * Disables screensaver and idle screen lock
-* Uninstalls the update manager
+* Removes the update manager to prevent non-Probotix updates from installing
-* Turns line numbers on in gedit
+* Turns on line numbers and  auto-indent in gedit
 * Assigns [q] key to toggle pause/resume - works like feed hold on machining centers