ZTATP - Revision history

DS26: /* Hardware installation and wiring */

2022-07-02T22:32:14Z

Hardware installation and wiring

DS26: /* Hardware installation and wiring */

2022-07-02T22:30:35Z

Hardware installation and wiring

Haytham: Updated entry to restrict by hardware type, and not firmware version

2022-01-25T09:33:02Z

Updated entry to restrict by hardware type, and not firmware version

Haytham: /* Run a probing sequence for all tools */

2020-08-24T01:42:58Z

Run a probing sequence for all tools

Haytham: /* Run a probing sequence */

2020-08-24T01:41:39Z

Run a probing sequence

Haytham: /* Runtime parameters */

2020-08-24T01:40:27Z

Runtime parameters

Haytham: /* Runtime parameters */

2020-08-24T01:40:03Z

Runtime parameters

Haytham: /* Differences between ZTATP on RRF2 and RRF3 */

2020-08-24T01:38:25Z

Differences between ZTATP on RRF2 and RRF3

Haytham at 01:37, 24 August 2020

2020-08-24T01:37:58Z

Haytham: /* Start probing sequence */

2020-08-24T01:36:53Z

Start probing sequence

@@ Line 34: / Line 34: @@
 * ZTATP requires a conductive touch plate that is fixed to the bed that can be reached by BOTH the nozzle on each and every tool, and by the Z-Probe. This can be slightly (a few mm) above or below the actual printable surface of the bed.
 * The touch plate must be grounded, to any ground in the Duet system.
-* There are three ways to wire the nozzles:
+* There are four ways to wire the nozzles:
 :Each nozzle has a wire, leading back to a “Y” harness that leads them all into ‘io5.in’ (or any other endstop connector, if you change the script). This is basically a parallel connection from each tool back to the probe input pin.
 ::'''OR'''
 :You can arrange any number of “spring” mechanisms that contact the nozzle ''just before'' the nozzle contacts the touch plate, similar in operation to a CNC pressure foot.
 ::'''OR'''
-:You use the [https://jubilee3d.com/index.php?title=Community_Mods#Z-offset_KnobProbe_.2F_Doorknob-probe Z-offset doorknob probe] by TypQxQ (The tool touches a spring loaded doorknob -> a ball connected to the knob breaks connection with 3 contacts)
+:You use the [https://jubilee3d.com/index.php?title=Community_Mods#Z-offset_KnobProbe_.2F_Doorknob-probe Z-offset doorknob probe] by TypQxQ (The tool touches a spring loaded doorknob -> a ball connected to the knob breaks connection with 3 contacts. No extra wires going to the tools.)
 ::'''OR'''
 :''(default and easiest wiring method)'' You can have a single probe wire that you connect to each tool manually in sequence. The script will pause between tools during the probing sequence until you hit <code>Enter</code> to resume probing.

@@ Line 38: / Line 38: @@
 ::'''OR'''
 :You can arrange any number of “spring” mechanisms that contact the nozzle ''just before'' the nozzle contacts the touch plate, similar in operation to a CNC pressure foot.
 ::'''OR'''
 :''(default and easiest wiring method)'' You can have a single probe wire that you connect to each tool manually in sequence. The script will pause between tools during the probing sequence until you hit <code>Enter</code> to resume probing.

@@ Line 15: / Line 15: @@
 * May run on Duet3+Pi; does NOT require that configuration, run on any Pi.
-= ZTATP Differences between RRF2 and RRF3 =
+= ZTATP Differences between Duet 2 and Duet 3 Boards =
-== RRF 2.x.x ==
+== Duet 2 Boards ==
 ZTATP will default its probe input pin definition for the touch plate to the ''Z_PROBE_IN'' and ''GND'' pins, and these currently cannot be re-assigned to another endstop on an RRF2 board. This may be changed in a later release.
 The exact definition of this probe type in RRF 2.x.x is <code>M558 P5 I1 F200 H50</code>
-== RRF 3.x.x ==
+== Duet 3 Boards ==
 ZTATP will default the probing pin input to ''!io5.in'' (notice the inverted logic). You can re-assign this input by specifying an RRF3-style input name to any other input pin you want that would be compatible. Keep in mind, however, that ZTATP uses a ''normally open'' endstop configuration (usually RRF has normally closed endstops), and the circuit will close and trigger the endstop once the nozzle tip comes into contact with the probe plate.

@@ Line 75: / Line 75: @@
 ::If you do perform an e-stop, you'll need to reboot your Duet board (to restore endstop settings!), re-home all your axes, and restart this ZTATP procedure from the first step all over again.
 ::''Remember to remove your touch plate if you're going to home your axes!!''
-:6. The script will park the current tool using <code>T-1</code>, and prompt you to connect the probe for the next tool. Repeat step 5 and 6 until all of your tools have been run through ZTATP.
+:6. The script will park the current tool using <code>T-1</code>, lower the bed by 50 (relative coordinates), and prompt you to connect the probe for the next tool. Repeat step 5 and 6 until all of your tools have been run through ZTATP.
 :7. Once all tools have been measured, ZTATP applies the newly measured Z offsets to your running configuration by performing a set of <code>G10</code> commands.
 ::You will need to apply these new Z offsets to your <code>config.g</code> file, either by copying and pasting the <code>G10</code> commands from the terminal at the end of your configuration file, or by modifying your <code>M563</code> tool definition statements.
 :8. You can now remove your tool plate and probe wires, and you will need to '''re-home the Z axis''' ''(or all axes)'' before starting any new jobs on the printer.

@@ Line 62: / Line 62: @@
 # Choose the fixed coordinates for the center of your touch plate. Typically the center of your bed, or if using your build plate itself as a touch plate, then a position reachable by all tools without any collisions with other tools or the ends of your movement axes in X and Y. Write these coordinates down as you'll need to pass them as a parameter to the ZTATP script. You may, or may not, have to temporarily attach your touch plate to the build plate to prevent it from sliding around.
-== Run a probing sequence ==
+== Run a probing sequence for all tools ==
 :1. Run ZTATP by running the command:
 ::<code>python ZTATP.py -duet ''hostname_or_IP_address'' -touchplate ''x_coordinate'' ''y_coordinate'' [-pin ''pin_name''] [-tool ''tool_index'']</code>

@@ Line 46: / Line 46: @@
 :''Default value:'' <code>'''0.0 0.0'''</code>
 :''(required)'' Used to specify the X and Y coordinates for location of the center of the grounded touch plate used to calibrate Z offsets
-* <code>-pin ''pin_name''</code> '''RRF 3.x.x only'''
+* <code>-pin ''pin_name''</code> '''(RRF 3.x.x only)'''
 :''Default value:'' <code>'''!io5.in'''</code>
 :''(optional)'' Used to specify the input pin the probe wires are connected to. Typically a normally-open definition indicated by inverting the logic of the pin using an exclamation point at the start of the name.

@@ Line 41: / Line 41: @@
 == Runtime parameters ==
 * <code>-duet ''xxx.xxx.xxx.xxx''</code> or <code>-duet ''hostname''</code>
-:''Default value:'' '''localhost'''
+:''Default value:'' <code>'''localhost'''</code>
 :''(optional)'' Used to specify the IP address or hostname of the Duet controller you're connecting to. If running ZTATP on the local Pi directly connected to a Duet 3 board, you can omit this parameter.
 * <code>-touchplate ''x.xxx y.yyy''</code>
-:''Default value:'' '''0.0 0.0'''
+:''Default value:'' <code>'''0.0 0.0'''</code>
 :''(required)'' Used to specify the X and Y coordinates for location of the center of the grounded touch plate used to calibrate Z offsets
 * <code>-pin ''pin_name''</code> '''RRF 3.x.x only'''
-:''Default value:'' '''!io5.in'''
+:''Default value:'' <code>'''!io5.in'''</code>
 :''(optional)'' Used to specify the input pin the probe wires are connected to. Typically a normally-open definition indicated by inverting the logic of the pin using an exclamation point at the start of the name.
 * <code>-tool ''tool_number''</code>

← Older revision		Revision as of 01:37, 24 August 2020
Line 79:		Line 79:
	::You will need to apply these new Z offsets to your <code>config.g</code> file, either by copying and pasting the <code>G10</code> commands from the terminal at the end of your configuration file, or by modifying your <code>M563</code> tool definition statements.		::You will need to apply these new Z offsets to your <code>config.g</code> file, either by copying and pasting the <code>G10</code> commands from the terminal at the end of your configuration file, or by modifying your <code>M563</code> tool definition statements.
	:8. You can now remove your tool plate and probe wires, and you will need to '''re-home the Z axis''' ''(or all axes)'' before starting any new jobs on the printer.		:8. You can now remove your tool plate and probe wires, and you will need to '''re-home the Z axis''' ''(or all axes)'' before starting any new jobs on the printer.
−
−	~~== Entering the coordinates of the touch plate ==~~
−
−	~~Edit the following in the beginning of the script:~~
−
−	~~<pre>################################~~
−	~~# Edit these for your printer. #~~
−	~~################################~~
−	~~tl = [0,1] # List of tools to be compared~~
−	~~yc = 225 # Y line that will clear parked tools when moving in X~~
−
−	~~xz = 288 # X coord of tool nozzle over flat plate to probe Z. 15x15mm area recommended.~~
−	~~yz = 285 # Y coord of tool nozzle over flat plate to probe Z. 15x15mm area recommended.~~
−
−	~~# Note: The particular probe command we use does NOT apply probe offsets.~~
−	~~xp = 253 # X coord of Z-Probe over flat plate to probe Z. 15x15mm area recommended.~~
−	~~yp = 340 # Y coord of Z-Probe over flat plate to probe Z. 15x15mm area recommended.</pre>~~
−	~~Note: The printer MUST define Z with a PROBE in config.g. Even if it is really an endstop switch, it is OK to define that as a probe.~~
−
−	~~== Running ==~~
−
−	* No VNC or graphics needed.
−	* cd to the directory where TAMV was installed. <code>./ZTATP.py</code>
−
−	~~Everything is automated, the ultimate output is G10 commands (containing only a Znnn) that should be placed in config.g.~~