Skip to content

Commit 1fec220

Browse files
committed
adds validation for nozzle offsets for V3 as well, and adds additional steps for clarity with manual adjustments for nozzle offsets.
1 parent f8bb5d4 commit 1fec220

2 files changed

Lines changed: 137 additions & 11 deletions

File tree

  • docs
    • misc/calibration/6-nozzle-offset
    • openpnp/v4/calibration/6-nozzle-offset

docs/misc/calibration/6-nozzle-offset/index.md

Lines changed: 116 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,67 @@ For these steps, you should be in the `Machine Setup` tab.
8181

8282
---
8383

84+
## Validate Nozzle N1's Offset
85+
86+
Once you have completed the top camera to nozzle tip offset calibration for the first nozzle, you need to validate that the alignment is accurate before continuing to the second one. This ensures that both the camera and nozzle tips are correctly aligned with the homing fiducial before continuing with production.
87+
88+
**Before starting, ensure you have `Nozzle N1` selected in the `Control Center`.**
89+
90+
When speaking of **increasing** values, this is always meaning that we are adding positive value to the number. Meaning a negative (-) number would go closer to zero.
91+
When speaking of **decreasing** values, this is always meaning that we are adding negative value to the number. Meaning a negative (-) number would go further away from zero.
92+
93+
1. **Confirm camera alignment**
94+
* Go to `Machine Setup > Heads > ReferenceHead H1 > Primary Fiducial`<br/><br>
95+
![primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/primary-fid-location.webp)<br/><br>
96+
* Ensure the primary fiducials Z-height field is blank.
97+
* Click the button to bring the Top Camera to the Homing Fiducial.<br/><br>
98+
![camera to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/camera-to-homing-fid-button.webp)<br/><br>
99+
* Check the camera view: the homing fiducial should appear exactly centered.
100+
* ❌ If it is not centered, restart the camera-to-fiducial calibration.
101+
* ✅ Do not continue until the fiducial is showing accurately centered in the camera feed.
102+
<br/><br>
103+
104+
1. **Check nozzle tip alignment**
105+
* Click the button to place the selected nozzle tip on the Homing Fiducial. It is directly beside the button used for the camera in step 1.<br/><br>
106+
![nozzle to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/nozzle-tip-to-homing-fid-button.webp)<br/><br>
107+
* The machine should move the nozzle tip to its calculated position.
108+
* Inspect the nozzle tip visually.
109+
* ✅ If the nozzle tip sits directly on the fiducial, no correction is needed. Proceed to calibrating Nozzle N2's offset.
110+
* ❌ If it is off, **note whether it is left, right, in front, or behind the homing fiducial**.
111+
<br/><br>
112+
113+
1. **Correct nozzle offsets**
114+
* When the nozzle tip does not land perfectly on the fiducial, adjust its offset.
115+
* Go to `Machine Setup > Heads > ReferenceHead H1 > Nozzles > ReferenceNozzle N1` and locate the Offset values on that page.
116+
* Start with fine adjustments to the decimal values so you can dial in the offset gradually. This helps get an idea of how much you need to adjust to get it spot on. Example: If the nozzle tip is sitting to the right of the homing fiducial, change the fake x-value offset of -24.360 to be -24.330, which increases this value, so the nozzle will move to the left.<br/><br>
117+
![offset adjustment area](../../../openpnp/v4/calibration/6-nozzle-offset/images/top-cam-nozzle-offset-adjust.webp)<br/><br>
118+
* Key points to remember:
119+
* Increasing a value will move Nozzle N1 left (X) or forward (Y)
120+
* Decrease a value will move Nozzle N1 right (X) or backward (Y)
121+
* Whether the value is positive or negative, you still “increase” or “decrease” to move in the correct direction.<br/><br>
122+
123+
1. **Visual aid**
124+
* Use the table below to decide which way to change the value.
125+
* Red arrows represent the direction the nozzle is from the fiducial.
126+
* Blue arrows represent the direction the nozzle will move when that given axis value is raised or lowered.<br/><br>
127+
![nozzle offset visual assistance](../../../openpnp/v4/calibration/6-nozzle-offset/images/nozzle-offset-visual-assist.webp)<br/><br>
128+
<br/><br>
129+
130+
1. Once you've adjusted it to be accurate, Validate one last time before moving to the second nozzle.
131+
* Click the button to bring the Top Camera to the Homing Fiducial and confirm it is still accurate.<br/><br>
132+
![camera to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/camera-to-homing-fid-button.webp)<br/><br>
133+
* Click the button to place the selected nozzle tip to our newly adjusted position on the Homing Fiducial, and confirm it is still good.<br/><br>
134+
![nozzle to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/nozzle-tip-to-homing-fid-button.webp)<br/><br>
135+
* If both are accurate, proceed to next step.
136+
137+
1. **Apply and Save Adjusted Nozzle offset**.
138+
* Click `Apply` in the lower right corner to store the calculated offset for the left nozzle.<br/><br/>
139+
![click the apply button](../2-connect-to-machine/images/apply-button.webp)<br/><br/>
140+
* Save your OpenPnP configuration now. `File > Save Configuration`.<br/><br/>
141+
![Save your config now](../2-connect-to-machine/images/save-config.webp)<br/><br/>
142+
143+
---
144+
84145
## Nozzle: N2 Offset (Right Toolhead)
85146

86147
For these steps, you should already be in the `Machine Setup` tab.
@@ -152,12 +213,61 @@ For these steps, you should already be in the `Machine Setup` tab.
152213

153214
---
154215

155-
!!! note
156-
For more information about this step, you can read the OpenPnP docs about it [here](https://github.com/openpnp/openpnp/wiki/Setup-and-Calibration_Nozzle-Setup).
157-
158-
!!! info "Further Adjustment"
159-
If you find that your placement accuracy is slightly incorrect after performing this calibration, you can fine-tune your part placement by adjusting the X and Y offsets in the relevant nozzle settings, as shown below.
160-
![nozzle offsets](../../../openpnp/v4/calibration/6-nozzle-offset/images/17-manually-adjust-nozzle-offset.webp)
216+
## Validate Nozzle N2's Offset
217+
218+
Once you have completed the top camera to nozzle tip offset calibration for the second nozzle, you need to validate that the alignment is accurate before continuing to the next calibration steps. This ensures that both the camera and nozzle tips are correctly aligned with the homing fiducial before continuing with production.
219+
220+
**Before starting, ensure you have `Nozzle N2` selected in the `Control Center`.**
221+
222+
1. **Confirm camera alignment**
223+
* Go to `Machine Setup > Heads > ReferenceHead H1 > Primary Fiducial`<br/><br>
224+
![primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/primary-fid-location.webp)<br/><br>
225+
* Ensure the primary fiducials Z-height field is blank.
226+
* Click the button to bring the Top Camera to the Homing Fiducial.<br/><br>
227+
![camera to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/camera-to-homing-fid-button.webp)<br/><br>
228+
* Check the camera view: the homing fiducial should appear exactly centered.
229+
* ❌ If it is not centered, restart the camera-to-fiducial calibration.
230+
* ✅ Do not continue until the fiducial is showing accurately centered in the camera feed.
231+
<br/><br>
232+
233+
1. **Check nozzle tip alignment**
234+
* Click the button to place the selected nozzle tip on the Homing Fiducial. It is directly beside the button used for the camera in step 1.<br/><br>
235+
![nozzle to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/nozzle-tip-to-homing-fid-button.webp)<br/><br>
236+
* The machine should move the nozzle tip to its calculated position.
237+
* Inspect the nozzle tip visually.
238+
* ✅ If the nozzle tip sits directly on the fiducial, no correction is needed, and both your nozzle tips are validated. Proceed to the next section.
239+
* ❌ If it is off, **note whether it is left, right, in front, or behind the homing fiducial**.
240+
<br/><br>
241+
242+
1. **Correct nozzle offsets**
243+
* When the nozzle tip does not land perfectly on the fiducial, adjust its offset.
244+
* Go to `Machine Setup > Heads > ReferenceHead H1 > Nozzles > ReferenceNozzle N2` and locate the Offset values on that page.
245+
* Start with fine adjustments to the decimal values so you can dial in the offset gradually. This helps get an idea of how much you need to adjust to get it spot on. Example: If the nozzle tip is sitting to the right of the homing fiducial, change the fake x-value offset of 23.350 to be 23.380, which increases this value, so the nozzle will move to the left.<br/><br>
246+
![offset adjustment area](../../../openpnp/v4/calibration/6-nozzle-offset/images/top-cam-nozzle-offset-adjust-n2.webp)<br/><br>
247+
* Key points to remember:
248+
* Increasing a value will move Nozzle N2 left (X) or forward (Y)
249+
* Decrease a value will move Nozzle N2 right (X) or backward (Y)
250+
* Whether the value is positive or negative, you still “increase” or “decrease” to move in the correct direction.<br/><br>
251+
252+
1. **Visual aid**
253+
* Use the table below to decide which way to change the value.
254+
* Red arrows represent the direction the nozzle is from the fiducial.
255+
* Blue arrows represent the direction the nozzle will move when that given axis value is raised or lowered.<br/><br>
256+
![nozzle offset visual assistance](../../../openpnp/v4/calibration/6-nozzle-offset/images/nozzle-offset-visual-assist.webp)<br/><br>
257+
<br/><br>
258+
259+
1. Once you've adjusted it to be accurate, Validate one last time before moving on.
260+
* Click the button to bring the Top Camera to the Homing Fiducial and confirm it is still accurate.<br/><br>
261+
![camera to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/camera-to-homing-fid-button.webp)<br/><br>
262+
* Click the button to place the selected nozzle tip to our newly adjusted position on the Homing Fiducial, and confirm it is still good.<br/><br>
263+
![nozzle to primary fiducial location](../../../openpnp/v4/calibration/6-nozzle-offset/images/nozzle-tip-to-homing-fid-button.webp)<br/><br>
264+
* If both are accurate, proceed to next step.
265+
266+
1. **Apply and Save Adjusted Nozzle offset**.
267+
* Click `Apply` in the lower right corner to store the newly adjusted offset for the right nozzle.<br/><br/>
268+
![click the apply button](../2-connect-to-machine/images/apply-button.webp)<br/><br/>
269+
* Save your OpenPnP configuration now. `File > Save Configuration`.<br/><br/>
270+
![Save your config now](../2-connect-to-machine/images/save-config.webp)<br/><br/>
161271

162272
---
163273

docs/openpnp/v4/calibration/6-nozzle-offset/index.md

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,10 @@ For these steps, you should be in the `Machine Setup` tab.
8484

8585
Once you have completed the top camera to nozzle tip offset calibration for the first nozzle, you need to validate that the alignment is accurate before continuing to the second one. This ensures that both the camera and nozzle tips are correctly aligned with the homing fiducial before continuing with production.
8686

87-
Before starting, ensure you have `Nozzle N1` selected in the `Control Center`.
87+
**Before starting, ensure you have `Nozzle N1` selected in the `Control Center`.**
88+
89+
When speaking of **increasing** values, this is always meaning that we are adding positive value to the number. Meaning a negative (-) number would go closer to zero.
90+
When speaking of **decreasing** values, this is always meaning that we are adding negative value to the number. Meaning a negative (-) number would go further away from zero.
8891

8992
1. **Confirm camera alignment**
9093
* Go to `Machine Setup > Heads > ReferenceHead H1 > Primary Fiducial`<br/><br>
@@ -108,7 +111,8 @@ Before starting, ensure you have `Nozzle N1` selected in the `Control Center`.
108111

109112
1. **Correct nozzle offsets**
110113
* When the nozzle tip does not land perfectly on the fiducial, adjust its offset.
111-
* You'll want to adjust the numbers after the decimal point first, to get an idea of how much you need to adjust to get it spot on. Example: The nozzle tip sits to the right of the homing fiducial. Change the fake x-value offset of -24.360 to be -24.330, which increases this value, so the nozzle will move to the left.<br/><br>
114+
* Go to `Machine Setup > Heads > ReferenceHead H1 > Nozzles > ReferenceNozzle N1` and locate the Offset values on that page.
115+
* Start with fine adjustments to the decimal values so you can dial in the offset gradually. This helps get an idea of how much you need to adjust to get it spot on. Example: If the nozzle tip is sitting to the right of the homing fiducial, change the fake x-value offset of -24.360 to be -24.330, which increases this value, so the nozzle will move to the left.<br/><br>
112116
![offset adjustment area](../6-nozzle-offset/images/top-cam-nozzle-offset-adjust.webp)<br/><br>
113117
* Key points to remember:
114118
* Increasing a value will move Nozzle N1 left (X) or forward (Y)
@@ -127,7 +131,13 @@ Before starting, ensure you have `Nozzle N1` selected in the `Control Center`.
127131
![camera to primary fiducial location](../6-nozzle-offset/images/camera-to-homing-fid-button.webp)<br/><br>
128132
* Click the button to place the selected nozzle tip to our newly adjusted position on the Homing Fiducial, and confirm it is still good.<br/><br>
129133
![nozzle to primary fiducial location](../6-nozzle-offset/images/nozzle-tip-to-homing-fid-button.webp)<br/><br>
130-
* If both are accurate, move on to calibrating the offset for Nozzle N2.
134+
* If both are accurate, proceed to next step.
135+
136+
2. **Apply and Save Adjusted Nozzle offset**.
137+
* Click `Apply` in the lower right corner to store the calculated offset for the left nozzle.<br/><br/>
138+
![click the apply button](../2-connect-to-machine/images/apply-button.webp)<br/><br/>
139+
* Save your OpenPnP configuration now. `File > Save Configuration`.<br/><br/>
140+
![Save your config now](../2-connect-to-machine/images/save-config.webp)<br/><br/>
131141

132142
---
133143

@@ -230,7 +240,8 @@ Once you have completed the top camera to nozzle tip offset calibration for the
230240

231241
1. **Correct nozzle offsets**
232242
* When the nozzle tip does not land perfectly on the fiducial, adjust its offset.
233-
* You'll want to adjust the numbers after the decimal point first, to get an idea of how much you need to adjust to get it spot on. Example: Change the fake x-value offset of 23.350 to be 23.380, which increases this value, so the nozzle will move to the left.<br/><br>
243+
* Go to `Machine Setup > Heads > ReferenceHead H1 > Nozzles > ReferenceNozzle N2` and locate the Offset values on that page.
244+
* Start with fine adjustments to the decimal values so you can dial in the offset gradually. This helps get an idea of how much you need to adjust to get it spot on. Example: If the nozzle tip is sitting to the right of the homing fiducial, change the fake x-value offset of 23.350 to be 23.380, which increases this value, so the nozzle will move to the left.<br/><br>
234245
![offset adjustment area](../6-nozzle-offset/images/top-cam-nozzle-offset-adjust-n2.webp)<br/><br>
235246
* Key points to remember:
236247
* Increasing a value will move Nozzle N2 left (X) or forward (Y)
@@ -249,8 +260,13 @@ Once you have completed the top camera to nozzle tip offset calibration for the
249260
![camera to primary fiducial location](../6-nozzle-offset/images/camera-to-homing-fid-button.webp)<br/><br>
250261
* Click the button to place the selected nozzle tip to our newly adjusted position on the Homing Fiducial, and confirm it is still good.<br/><br>
251262
![nozzle to primary fiducial location](../6-nozzle-offset/images/nozzle-tip-to-homing-fid-button.webp)<br/><br>
252-
* If both are accurate, move on to calibrating the bottom camera position, which is in the next steps.
263+
* If both are accurate, proceed to next step.
253264

265+
1. **Apply and Save Adjusted Nozzle offset**.
266+
* Click `Apply` in the lower right corner to store the newly adjusted offset for the right nozzle.<br/><br/>
267+
![click the apply button](../2-connect-to-machine/images/apply-button.webp)<br/><br/>
268+
* Save your OpenPnP configuration now. `File > Save Configuration`.<br/><br/>
269+
![Save your config now](../2-connect-to-machine/images/save-config.webp)<br/><br/>
254270
---
255271

256272
## Next Steps

0 commit comments

Comments
 (0)