misc updates, clarifications, and rewordings

opulo-inc · Aug 24, 2024 · a503d8c · a503d8c
1 parent a957965
commit a503d8c
Show file tree

Hide file tree

Showing 12 changed files with 29 additions and 16 deletions.
diff --git a/docs/openpnp/calibration/10-vacuum-sensor/index.md b/docs/openpnp/calibration/10-vacuum-sensor/index.md
@@ -13,15 +13,19 @@ While the bottom camera can detect if a part was successfully picked, you can us
   ![Enabling part detection](images/Screen Shot 2023-02-16 at 10.25.43 AM.png)
 
 1. Open the `H1:VAC1` actuator window. Click `On` to turn on your pump and valve, and then click `Read`. You should see a value appear in the `Read Value` text box. Take note of this number.
-   ![vac1 actuator](images/vac1-actuator.png)
-   ![actuator control](images/Screen Shot 2023-02-16 at 10.43.29 AM.png)
+
+    ![vac1 actuator](images/vac1-actuator.png)
+    ![actuator control](images/Screen Shot 2023-02-16 at 10.43.29 AM.png)
 
 2. Now, cover the nozzle with your finger tip. Hit `Read` again. Take note of the new number.
 
 3. Split the difference between these numbers. For example, if your readings were `250` and `246`, choose `248`.
 
 4. Enter this value into the `High Value` field in the `Vacuum Range` setting.
-   ![entering vac threshold value for n045](images/entering-vac-cal.png)
+
+    ![entering vac threshold value for n045](images/entering-vac-cal.png)
+
+1. Hit "Apply" to save your changes.
 
 5. Perform this step again, but using N2 and the N24 nozzle tip.
 

diff --git a/docs/openpnp/calibration/4-homing-fiducial/index.md b/docs/openpnp/calibration/4-homing-fiducial/index.md
@@ -90,6 +90,8 @@ We also detail this process in our [setup video](https://youtube.com/watch?v=CSn
     ![a good histogram](images/correct-exposure.png){: style="width:60%;margin-left:10%;"}
 
 3. Once you've found a good exposure value, **record this value**. OpenPnP does not always reestablish camera settings when reconnecting, so having this value recorded for easily setting your exposure again on boot is important. When doing so, be sure to check, then uncheck the "Auto Exposure" box to put your camera into manual exposure mode, then slide the slider to your recorded value.
+
+1. Turn off the histogram view the same way you turned it on.
 
 ## Test Fiducial Homing
 

diff --git a/docs/openpnp/calibration/5-mm-per-pixel/images/task-interrupted.png b/docs/openpnp/calibration/5-mm-per-pixel/images/task-interrupted.png
diff --git a/docs/openpnp/calibration/5-mm-per-pixel/index.md b/docs/openpnp/calibration/5-mm-per-pixel/index.md
@@ -27,15 +27,19 @@ This next step calibrates the relationship between pixels and millimeters to mak
 
     ![](images/n045-on-n1.png)
 
-1. Your machine will jog the head to the front of the machine for easy tip loading. Slide the N045 nozzle tip (the one with the smaller opening) onto the **left** nozzle (using red tubing). Rotate the nozzle tip as you mount it to the brass holder to ensure the grease works its way into the tip and around the O-rings. It should slide on and off easily after working it in.
+2. Your machine will jog the head to the front of the machine for easy tip loading. OpenPnP will create a pop up window saying "Task interrupted: ...". This is **not** an error; OpenPnP is just notifying you that it's stopped the job if one is running. You can dismiss this pop up.
+
+    ![](images/task-interrupted.png)
+
+3. Slide the N045 nozzle tip (the one with the smaller opening) onto the **left** nozzle (using red tubing). Rotate the nozzle tip as you mount it to the brass holder to ensure the grease works its way into the tip and around the O-rings. It should slide on and off easily after working it in.
 
     ![left nozzle has red tubing getting n045 tip, right has no tip](images/mountingn1.jpg)
 
-1. Now, navigate to the `ReferenceNozzle N2` and select the `Nozzle Tips` tab. This time, check the checkbox in the `Loaded?` column for the `N24` row.
+4. Now, navigate to the `ReferenceNozzle N2` and select the `Nozzle Tips` tab. This time, check the checkbox in the `Loaded?` column for the `N24` row.
 
     ![](images/n24-on-n2.png)
 
-2. Slide the N24 nozzle tip (the one with the larger opening) onto the **right** nozzle (using blue tubing). Rotate the nozzle tip as you mount it to the brass holder to ensure the grease works its way into the tip and around the O-rings. It should slide on and off easily after working it in.
+5. Slide the N24 nozzle tip (the one with the larger opening) onto the **right** nozzle (using blue tubing). Rotate the nozzle tip as you mount it to the brass holder to ensure the grease works its way into the tip and around the O-rings. It should slide on and off easily after working it in.
 
     ![blue tubing right nozzle getting n24 tip, left already has n045](images/mountingn2.jpg)
 
@@ -105,7 +109,7 @@ This next step calibrates the relationship between pixels and millimeters to mak
 
     ![selecting n2 for control](images/select-n2.png)
 
-2. Click on the "Position Nozzle Over Location" button
+2. Click on the "Position the tool over the center of the location" button
 
     ![Position nozzle over camera](images/position-nozzle-over-camera.png)
 

diff --git a/docs/openpnp/install-config/install/index.md b/docs/openpnp/install-config/install/index.md
@@ -41,7 +41,7 @@ OpenPnP is designed to run on many different kinds of host computers. However, U
 
 1. Close OpenPnP.
 
-### Windows
+### Windows (Not Recommended)
 
 1. Download and install OpenPnP for Windows. Use the version here to ensure OpenPnP works with the LumenPnP Feeders: ([Download 32 Bit .exe](https://openpnp.s3-us-west-2.amazonaws.com/test/2023-04-05_08-24-36.0aa4ae8/OpenPnP-windows-x32-test.exe)) ([Download 64 Bit .exe](https://openpnp.s3-us-west-2.amazonaws.com/test/2023-04-05_08-24-36.0aa4ae8/OpenPnP-windows-x64-test.exe))
 
@@ -51,7 +51,7 @@ OpenPnP is designed to run on many different kinds of host computers. However, U
 
 3. Close OpenPnP.
 
-### MacOS
+### MacOS (Not Recommended)
 
 1. Download and install OpenPnP for Mac. Use the version here to ensure OpenPnP works with the LumenPnP Feeders: ([Download .dmg](https://openpnp.s3-us-west-2.amazonaws.com/test/2023-04-05_08-24-36.0aa4ae8/OpenPnP-macos-test.dmg))
 

diff --git a/docs/semi-assembly-4-0/frame/img/IMG_2896.JPG b/docs/semi-assembly-4-0/frame/img/IMG_2896.JPG
diff --git a/docs/semi-assembly-4-0/index.md b/docs/semi-assembly-4-0/index.md
@@ -7,19 +7,19 @@ These are assembly instructions for the **v4** LumenPnP.
 
 ## What is the LumenPnP?
 
-The LumenPnP is an open source Pick and Place project led by [Opulo](https://www.opulo.io/). The LumenPnP is designed to be low cost and suited towards [mid-scale manufacturing](http://stephenhawes.com/level-2-manufacturing/).
+The LumenPnP is an open source Pick and Place project led by [Opulo](https://www.opulo.io/). The LumenPnP is designed to be accessible and suited towards [mid-scale manufacturing](http://stephenhawes.com/level-2-manufacturing/) and rapid in-house prototyping.
 
-![hero image of LumenPnP](hero-v4.png)
+![hero image of LumenPnP](v4-iso-hero.png)
 
-The LumenPnP can reliably place components as small as 0402, and supports both passive and powered feeders. The LumenPnP is completely open source and has an active community with ongoing mechanical, electrical, and software modifications.
+The LumenPnP can reliably place components as small as 0402, and supports both passive and powered feeders. The LumenPnP is completely open source and has an active community with ongoing mechanical, electrical, and software improvements.
 
 ## Before you begin
 
 ### Machine Orientation and Terminology
 
 Throughout this guide we'll be referring to different orientations and directions of the machine as "left, right, front, back, up, and down." In general, these words are in reference to the typical view of the machine, facing it directly, as shown below.
 
-![hero image of LumenPnP](hero-headon-v4.png)
+![hero image of LumenPnP](v4-ortho-hero.png)
 
 We'll also refer to putting the machine "back on its haunches." This refers to a feature of the LumenPnP where it can be lifted up by the front rail and let to rest upright on its back feet. This orientation is tremendously helpful for installing things to the staging plate and plugging things into the motherboard. Whenever putting your machine back, make sure the Y gantry is pushed all the way to the back of the machine to prevent backdriving the Y stepper motor driver.
 

diff --git a/docs/semi-assembly-4-0/unboxing/img/IMG_2734.JPG b/docs/semi-assembly-4-0/unboxing/img/IMG_2734.JPG
diff --git a/docs/semi-assembly-4-0/unboxing/index.md b/docs/semi-assembly-4-0/unboxing/index.md
@@ -1,4 +1,7 @@
-# Unboxing
+---
+title: LumenPnP v4 Assembly - Unboxing
+description: Unboxing the v4 LumenPnP
+---
 
 1. Open the LumenPnP box and look for the `Getting Started` card attached to the top sheet of foam. This has your machine's version number.
 
@@ -47,7 +50,7 @@
 
     ![alt text](img/IMG_2732.JPG)
 
-1. Inside the tool bag you'll find the following items:
+6. Inside the tool bag you'll find the following items:
     * Hobby knife
     * Flush snips
     * 135 degree tweezers

diff --git a/docs/semi-assembly-4-0/v4-iso-hero.png b/docs/semi-assembly-4-0/v4-iso-hero.png
diff --git a/docs/semi-assembly-4-0/v4-ortho-hero.png b/docs/semi-assembly-4-0/v4-ortho-hero.png
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -169,6 +169,7 @@ nav:
 
     - Guides: 
         - Update LumenPnP Firmware: guides/update-firmware/index.md
+        - Updating OpenPnP GCode Macros: guides/update-gcode-macros/index.md
         - Change Motor Current: guides/motor-current/index.md
         - Change Machine Speed: guides/machine-speed/index.md
         - Change Ring Light Brightness: guides/ring-light-settings/index.md
@@ -177,7 +178,6 @@ nav:
         - Second Nozzle Upgrade Guide: guides/second-tool/index.md
         - REV03 Mobo Interposer Guide: guides/rev3-vac-interposer/index.md
         - Collecting OpenPnP Logs: guides/openpnp-logs/index.md
-        - Updating OpenPnP GCode Macros: guides/update-gcode-macros/index.md
         - Find Your OpenPnP Version: guides/get-openpnp-version/index.md
         - Extracting Your Config Files: guides/extracting-your-config-files/index.md