Brings Doc refresh, fixes random broken links, and makes corrections. Also brings more validations for each section with more explanations to educate better.

Author: Mitchwich

docs/guides/design-for-lumenpnp/index.md

@@ -2,9 +2,9 @@
 
 While the LumenPnP is capable of populating the vast majority of PCBs, there are general design guidelines that will help make population as smooth and automated as possible.
 
-All machine capabilities can also be found in the v3.1 [brochure](https://cdn.shopify.com/s/files/1/0570/4256/7355/files/LumenPnP-v3.1-brochure.pdf?v=1698263482).
+All machine capabilities can also be found in the LumenPnP V4 [brochure](https://cdn.shopify.com/s/files/1/0570/4256/7355/files/LumenPnP-v3.1-brochure.pdf?v=1698263482).
 
-Also be sure to check out the [Midscale Website](https://midscale.io/) for information and resources for midscale manufacturing.
+Also be sure to check out the page for [Setting Up An SMT Line](https://www.opulo.io/pages/set-up) or [Hardware.cafe](https://hardware.cafe/) for information and resources for midscale manufacturing.
 
 ## Components
 

docs/misc/calibration/10-vacuum-sensor/index.md

@@ -2,7 +2,7 @@
 
 ![](../../calibration/img/lumenpnp-v3-docs-logo-small.png)
 
-When picking up parts with the LumenPnP, it’s important to verify that a part has been successfully picked. While the bottom camera can confirm this visually, using the LumenPnP's vacuum sensors provides a faster way to detect a successful pick.
+When picking up parts with the LumenPnP, it’s important to verify that a part has been successfully picked. While the bottom camera also confirms this visually, using the LumenPnP's vacuum sensors provides a faster way to detect a successful pick, preventing it from having to bring the component to the bottom camera first to detect the part. Because the bottom camera does checks the part, even if slightly slower, you can freely disable the vacuum part detection with confidence that you'll still be able to place your parts.
 
 ---
 
@@ -44,7 +44,7 @@ Each nozzle has a different vacuum reading due to variations in nozzle tip size.
      ![Enabling part detection](../../../openpnp/v4/calibration/10-vacuum-sensor/images/03-n045-part-detection-tab.webp)
 <br/><br/>
 
-1. **Measure the Vacuum Pressure**.
+1. **Measure the Vacuum Pressure While Open**.
     * In `Machine Controls`, navigate to the `Actuators` tab.
     * Select `H1:VAC1` to open the vacuum pressure window.
     * Click `On` to activate the pump and valve. <br/><br/>
@@ -54,8 +54,8 @@ Each nozzle has a different vacuum reading due to variations in nozzle tip size.
      ![actuator control](../../../openpnp/v4/calibration/10-vacuum-sensor/images/05-read-vacuum-sensor-n045.webp)
 <br/><br/>
 
-1. **Measure the Vacuum Pressure with a Sealed Nozzle**.
-    * Cover the nozzle tip completely with your fingertip.
+1. **Measure the Vacuum Pressure While Covered**.
+    * **Take one of the components from the strip of components included with your LumenPnP kit**, or a component from your BOM that is an appropriate size for this nozzle, and **hold it up to the nozzle tip**. The vacuum pressure should be able to pick up and hold the part on its own.
     * Click `Read` again. This represents the vacuum pressure when a part is picked, or "**covered**".<br/><br/>
      ![Turn on punp](../../../openpnp/v4/calibration/10-vacuum-sensor/images/06-reading-with-finger-covering-n045.webp)<br/><br/>
     * **Take note of the new value**. We will also need it later.
@@ -76,6 +76,7 @@ Each nozzle has a different vacuum reading due to variations in nozzle tip size.
     !!! caution
         The difference between uncovered and covered readings may be small, but **even a single-digit change can indicate a successful pick**. Nozzle sizes affect these readings, so expect variations between nozzles.
 <br/><br/>
+
 1. **Apply and Save**
     * Click `Apply` in the lower right corner to save your changes to the **N045** nozzle tip.<br/><br/>
      ![apply](../../../openpnp/v4/calibration/2-connect-to-machine/images/apply-button.webp)<br/><br/>
@@ -118,7 +119,7 @@ Each nozzle has a different vacuum reading due to variations in nozzle tip size.
 <br/><br/>
 
 1. **Measure the Vacuum Pressure with a Sealed Nozzle**.
-    * Cover the nozzle tip completely with your fingertip.
+    * **Take a component** from your BOM that is an appropriate size for this nozzle **and hold it up to the nozzle tip**. The vacuum pressure should be able to pick up and hold the part on its own. If you do not have a component large enough for this nozzle tip, you may use your fingertip as a fallback. However, **using an actual component will provide the most accurate results**.
     * Click `Read` again. This represents the vacuum pressure when a part is picked, or "**covered**".<br/><br/>
      ![Vacuum Pump Reading for N24](../../../openpnp/v4/calibration/10-vacuum-sensor/images/14-n24-reading-covered.webp)<br/><br/>
     * **Take note of the new value**. We will also need it later.

docs/misc/calibration/2-connect-to-machine/index.md

@@ -2,6 +2,8 @@
 
 ![](../img/lumenpnp-v3-docs-logo-small.png)
 
+*(**V2 Users**, you can use these docs for your machine as well. For anything specific to V2, we will add notes pointing it out).*
+
 **Now that OpenPnP is installed and the LumenPnP configuration files have been placed in the hidden system folder, OpenPnP can start with some basic preconfigured settings. The next step is to connect your LumenPnP and get familiar with OpenPnP’s user interface.**.
 
 **Then, we will install the N045 and N24 nozzle tips to help us with calibration**.
@@ -45,7 +47,7 @@ Follow these steps in order:
 
 ---
 
-## Configuration the Serial Port
+### Configuration the Serial Port
 
 **Before OpenPnP can communicate with the LumenPnP, we need to set the correct serial port**.
 
@@ -94,7 +96,7 @@ Follow these steps in order:
 
 ---
 
-## Establishing a Serial Connection
+### Establishing a Serial Connection
 
 1. **Connect OpenPnP to Your Machine**
     * Click the **green power button** in the `Machine Controls` section (Bottom left of OpenPnP).<br/><br/>
@@ -140,8 +142,10 @@ Follow these steps in order:
 1. Before we home the LumenPnP, it is very important that we check a couple of settings.
     * Go to `Machine Setup > Nozzle Tips >N045 > Calibration Tab > Auto Recalibration`
     * Ensure `Auto Recalibration` is set to `Manual`.<br/><br/>
+     ![Set nozzle N045 to manual](../../../openpnp/v4/calibration/2-connect-to-machine/images/set-n045-to-manual.webp)<br/><br/>
     * Then, go to `Machine Setup > Nozzle Tips >N24 > Calibration Tab > Auto Recalibration`
     * Ensure `Auto Recalibration` is set to `Manual`.<br/><br/>
+     ![Set nozzle N24 to manual](../../../openpnp/v4/calibration/2-connect-to-machine/images/set-n24-to-manual.webp)<br/><br/>
 
 1. Once the nozzle tips are set to `Manual`, click the **Home button** to perform a rough homing sequence.
     * The Nozzles will move to X, Y, and Z zero positions **(front-left corner of the LumenPnP)** and park there.
@@ -155,7 +159,7 @@ Follow these steps in order:
 
 ---
 
-## Install the Nozzle Tips
+### Install the Nozzle Tips
 
 1. **Locate Your Nozzle Tips and SuperLube tube**.
     * Find and remove the `N045` and `N24` nozzle tips in the nozzle rack that is mounted on the staging plate.<br/><br/>
@@ -197,7 +201,7 @@ Follow these steps in order:
 
 ## Configuring the Bottom Camera
 
-Before calibration, the bottom camera and exposure must be set up properly. **We will need to install a nozzle tip and position it above the bottom camera to properly adjust the exposure**.
+Before calibration begins, the bottom camera and exposure must be set up properly. **We will need to install a nozzle tip and position it above the bottom camera to properly adjust the exposure**.
 
 !!! tip "Which Reticle should I use?"
     We use the "**Ruler**" Reticle in the following steps. If you prefer to use the same **reticle style** that we use, right-click on the **top or bottom camera feed** and choose `Reticle`, then "`Ruler`" to match our docs photos best.<br/><br/>
@@ -232,13 +236,14 @@ Before calibration, the bottom camera and exposure must be set up properly. **We
 <br/><br/>
 
 1. **Apply and Verify**
-    * Click `Apply` to save the **Bottom Camera** settings. One of the red "X"s in the camera feed should disappear. The image might be entirely black, but we'll fix that in the following steps.<br/><br/>
+    * Click `Apply` to save the **Bottom Camera** settings. One of the red "X"s in the camera feed should disappear. The image might be entirely black, but we'll fix that in the following steps.
+    * Save your OpenPnP configuration so OpenPnP will remember this when opened. `File > Save Configuration`.<br/><br/>
      ![Saving changes to the Bottom Camera Config](../../../openpnp/v4/calibration/2-connect-to-machine/images/23-apply-and-save-bottom-cam-settings-gif.gif)
 <br/><br/>
 
 ---
 
-## Adjust Bottom Camera Exposure
+### Adjust Bottom Camera Exposure
 
 !!! warning "Other Camera Settings"
     In the following step, **do not** modify any camera settings other than exposure. The default values should remain unchanged.
@@ -285,7 +290,7 @@ Before calibration, the bottom camera and exposure must be set up properly. **We
     !!! Warning "🚨 Important 🚨"
         The reference image above is just an example. **Your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster, or peak, to the left. Adjust gradually until the image is clear and well-exposed.
 
-1. **Set the Correct Exposure**.
+1. **Find the Correct Exposure**.
     * Adjust the exposure slider, or enter varying manual exposure values, to ensure the camera can clearly detect the dark hole in the nozzle tip for calibration. The exposure should be balanced. Meaning, sbright enough to distinguish the nozzle tip from the background but not so bright that the hole becomes difficult to detect. Aim for a setting where the brightest areas are visible but do not appear completely white, and the darker areas remain well-defined. Use the following images as a reference for adjusting exposure:<br/><br/>
      ![exposure too high](../../../openpnp/v4/calibration/2-connect-to-machine/images/33-exposure-too-high.webp)<br/><br/>
      ![exposure too low](../../../openpnp/v4/calibration/2-connect-to-machine/images/34-exposure-too-low.webp)<br/><br/>

docs/misc/calibration/4-homing-fiducial/index.md

@@ -45,6 +45,11 @@ Now that your bottom camera exposure has been fine-tuned, the same thing needs t
 
 ## Preparing for Homing
 
+1. Confirm the following settings before homing the LumenPnP.
+   * Go to Machine Setup > Heads > ReferenceHead H1 > `Homing Method` is set to `None`
+   * Go to Machine Setup > Nozzle Tips > ReferenceNozzleTip N045 > Calibration Tab > **Auto Recalibration**: `Manual`
+   * Go to Machine Setup > Nozzle Tips > ReferenceNozzleTip N24 > Calibration Tab > **Auto Recalibration**: `Manual`
+
 1. **Level the nozzles before homing**.
 
     !!! danger "🚨 Critical Warning: Level Nozzles Before Homing 🚨"
@@ -135,8 +140,6 @@ Now that your bottom camera exposure has been fine-tuned, the same thing needs t
 
 In order for OpenPnP to reliably detect the LumenPnP's homing fiducial, we'll need to **set the exposure and camera settings for your top camera** correctly.
 
-We also detail this process in our [setup video](https://youtu.be/h3mtEQfGMlM?t=842).
-
 1. Navigate to `Machine Setup > Heads > ReferenceHead H1 > Cameras > OpenPnPCaptureCamera Top`.<br/><br/>
       ![Finding the Top Camera Settings](../../../openpnp/v4/calibration/4-homing-fiducial/images/22-back-to-top-cam-again.webp)
 <br/><br/>
@@ -188,7 +191,6 @@ We also detail this process in our [setup video](https://youtu.be/h3mtEQfGMlM?t=
 
 1. If you receive the error `FIDUCIAL-HOME no matches found`, OpenPnP was not able to find your homing fiducial. You need to adjust your [Homing Fiducial Pipeline](../../../openpnp/v4/vision-pipeline-adjustment/2-homing-fiducial-pipeline.md).<br/><br/>
       ![A first attempt at homing the LumenPnP](../../../openpnp/v4/calibration/4-homing-fiducial/images/33-fiducial-home-no-match-found.webp)
-<br/><br/>
 
 ---
 

docs/misc/calibration/5-mm-per-pixel/index.md

@@ -4,9 +4,11 @@
 
 This next step calibrates the relationship between pixels and millimeters to make our cameras more accurate.
 
+The main reason for needing to perform the mm to pixel calibration is to translate pixel data into accurate, real-world measurements (like millimeters). This allows for reliable sizing of objects, quality control, and dimensional analysis in computer vision by correcting for lens distortions and establishing a precise scale factor, which is crucial for tasks needing quantifiable results beyond just visual identification.
+
 ---
 
-## Top Camera Calibration
+## Top Camera MM/Pixel Calibration
 
 In this step, we will calibrate the mm/pixels for the **Top Camera**. This requires us to set the dimensions and use a virtual bounding box to outline and measure one of the squares on the datum board, known as a golden guideline square. This allows us to calibrate the **top camera’s Units per pixel**, giving us accurate top camera movement.
 <br/><br/>
@@ -59,15 +61,23 @@ In this step, we will calibrate the mm/pixels for the **Top Camera**. This requi
       ![Save your config now](../../../openpnp/v4/calibration/2-connect-to-machine/images/save-config.webp)
 <br/><br/>
 
-1. **Confirm Top Camera Calibration**.
-    * First, ensure your top camera view is fully zoomed out.
+---
+
+## Validate Top Camera Calibration
+
+Lets verify the top camera calibration was successful. This will ensure the top camera's millimeter per pixel is accurate so it is moving the correct amount for a given command.
+
+1. Ensure your top camera view is fully zoomed out.
+    * Hover over the top camera's feed, and scroll with the mouse wheel or trackpad to zoom all the way out.
+
+1. Confirm top camera is calibrated correctly.
     * Click and drag the center reticle (located in the middle of the camera feed) to one of the corners of the Golden Guideline Square.
     * If the mm/pixel calibration is correct, the **Top Camera** will move to be precisely over your chosen corner.
      ![Confirm Top Camera Calibration](../../../openpnp/v4/calibration/5-mm-per-pixel/images/09-confirm-top-cal-is-correct.gif)
 
 ---
 
-## Bottom Camera Calibration
+## Bottom Camera MM/Pixel Calibration
 
 The following steps will calibrate the mm/pixels for the **Bottom Camera**. This requires us to set the dimensions and use a virtual bounding box to outline the nozzle tip. This allows us to calibrate the **bottom camera’s Units per pixel**, giving us accurate bottom camera movement.
 
@@ -134,8 +144,16 @@ The following steps will calibrate the mm/pixels for the **Bottom Camera**. This
       ![Save your config now](../../../openpnp/v4/calibration/2-connect-to-machine/images/save-config.webp)
 <br/><br/>
 
-1. **Confirm Bottom Camera Calibration**.
-    * First, ensure your bottom camera view is fully zoomed out.
+---
+
+## Validate Bottom Camera MM/Pixel Calibration
+
+Lets verify the bottom camera calibration was successful. This will ensure the bottom camera's millimeter per pixel is accurate so it is moving the correct amount for a given command.
+
+1. Ensure your bottom camera view is fully zoomed out.
+    * Hover over the top camera's feed, and scroll with the mouse wheel or trackpad to zoom all the way out.
+
+1. Confirm bottom camera is calibrated correctly.
     * Click and drag the center reticle (located in the middle of the camera feed) to the edge of the nozzle tip and then back to the center of the tip.
     * The **Bottom Camera** should now be centered on the nozzle tip again.<br/><br/>
      ![Test your Bottom camera Units Per Pixel](../../../openpnp/v4/calibration/5-mm-per-pixel/images/20-testing-bottom-cam-units-per-pixel.gif)<br/><br/>