adds a few formatting tweaks, note to plug in barrel jack first, note…

… to level heads before homing
opulo-inc · May 7, 2024 · 948a19b · 948a19b
1 parent 0556b3d
commit 948a19b
Show file tree

Hide file tree

Showing 5 changed files with 20 additions and 4 deletions.
diff --git a/docs/feeders/3-software-update/index.md b/docs/feeders/3-software-update/index.md
@@ -12,8 +12,11 @@ LumenPnP feeders require a specific version of OpenPnP (the 2023-04-05 release),
 
 !!! danger "Mac Users"
     Because of [a bug with how OpenPnP signs their releases](https://github.com/openpnp/openpnp/issues/1559), Mac users with ARM processors might experience a crash on boot. You can still run OpenPnP by navigating to `Applications -> OpenPnP` and right clicking on the OpenPnP app and selecting "Show Package Contents":
+
     ![Show package contents on the openpnp app](img/opnp-show-package-contents.png)
+
     Then navigate to `Contents -> MacOS` and double click on `JavaApplicationStub` to run OpenPnP.
+
     ![clicking on javaapplicationstub](img/boot-opnp-java-stub.png)
 
 ## Update LumenPnP Firmware

diff --git a/docs/openpnp/calibration/2-connect-to-machine/index.md b/docs/openpnp/calibration/2-connect-to-machine/index.md
@@ -3,11 +3,15 @@
 Now we've got OpenPnP installed on your computer, and we've got the default configuration loaded up. Our next step is getting connected to the machine and getting familiar with OpenPnP's UI. See also our [setup video](https://youtube.com/watch?v=CSnczX6VJ7M&si=EnSIkaIECMiOmarE&t=102).
 
 1. Make sure OpenPnP is closed.
-2. Plug in your LumenPnP via the barrel jack. It's important you do this before USB is plugged in to ensure the proper power-up sequence.
+2. Plug in your LumenPnP via the barrel jack.
+
+    !!! danger "Always Plug In Barrel Jack First"
+         It's important you always plug in the barrel jack before USB power. This ensures the proper power up sequence for the LumenPnP motherboard. When plugging in the barrel jack, *always* make sure the USB type B connector is unplugged.
+
 3. Connect your LumenPnP to your computer using the included USB cable.
 
     !!! warning "Plug in USB before opening OpenPnP"
-        It's important that you plug your LumenPnP USB cable into your computer **before** launching OpenPnP. If OpenPnP is already open, it might have a hard time finding the correct communication port. Make sure OpenPnP is closed before plugging in your USB cable. 
+        It's important that you plug your LumenPnP USB cable into your computer **before** launching OpenPnP. If OpenPnP is already open, it might have a hard time finding the correct communication port. Make sure OpenPnP is closed before plugging in your USB cable.
 
 4. Connect both cameras to your computer using the USB cables.
 

diff --git a/docs/openpnp/calibration/4-homing-fiducial/images/level-nozzles.JPG b/docs/openpnp/calibration/4-homing-fiducial/images/level-nozzles.JPG
diff --git a/docs/openpnp/calibration/4-homing-fiducial/index.md b/docs/openpnp/calibration/4-homing-fiducial/index.md
@@ -2,7 +2,10 @@
 
 Now we can set up the datum board. The datum board is a reference point for everything else you'll do with the machine. The center dot of the datum board will be the most important calibration point for the machine. It'll be used to fine-tune the LumenPnP's XY position after homing to account for any errors in the limit switches. See also our [setup video](https://youtube.com/watch?v=CSnczX6VJ7M&si=EnSIkaIECMiOmarE&t=705).
 
-1. Run a rough home routine by pressing the Home button (shaped like a house). The machine will move to the X, Y, and Z zero positions.
+1. Before pressing the homing button (now and every time in the future), make sure that your nozzles are level. OpenPnP is not capable of keeping track of previous homing status per axis and making movement decisions based on that, so it's required to make sure the heads are level first to make sure there is no collision.
+  ![level nozzles](images/level-nozzles.JPG)
+
+2. Run a rough home routine by pressing the Home button (shaped like a house). The machine will move to the X, Y, and Z zero positions.
   ![Home the machine](images/Connect-and-home.png)
 
 !!! danger "If your machine does not move fully to the front left"
@@ -13,7 +16,7 @@ Now we can set up the datum board. The datum board is a reference point for ever
 1. Navigate to  `Machine Setup > Heads > ReferenceHead H1`.
   ![Reviewing the ReferenceHead options](images/Select-Reference-Head-H1.png)
 
-1. In the Configuration tab, change the `Homing Method` to `ResetToFiducialLocation`. This will let us adjust Homing Fiducial settings. 
+1. In the Configuration tab, change the `Homing Method` to `ResetToFiducialLocation`. This will let us adjust Homing Fiducial settings.
   ![Switch to using the homing fiducial](images/Select-ResetToFiducialLocation.png)
 
 1. Click `Apply` to save this change.

diff --git a/docs/semi-assembly-3-1/wiring-3-1/index.md b/docs/semi-assembly-3-1/wiring-3-1/index.md
@@ -82,6 +82,9 @@ In this step, you will mount and connect all the wiring and pneumatic tubing.
 
 1.  Tighten left Z gantry zip tie to secure the LM cable in place.
 
+    !!! danger "This zip tie is not optional"
+        This zip tie provides critical strain relief for the cable harness and motor connector. Failure to do so will result in excessive wear on your cable harness. Please be sure that you install it.
+
     ![Zip tie securing left motor cable](images/zip-lh-4.JPG)
 
     !!! danger "Warning"
@@ -103,6 +106,9 @@ In this step, you will mount and connect all the wiring and pneumatic tubing.
 
 5.  Tighten the right Z gantry zip tie to secure the RM cable in place.
 
+    !!! danger "This zip tie is not optional"
+        This zip tie provides critical strain relief for the cable harness and motor connector. Failure to do so will result in excessive wear on your cable harness. Please be sure that you install it.
+
     ![Right motor cable secured with zip tie](images/zip-rh-3.JPG)
 
     !!! danger "Warning"