Skip to content

Connecting to Your Machine

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.

  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.
  3. Connect your LumenPnP to your computer using the included USB cable.

    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.

  4. Connect both cameras to your computer using the USB cables.

    Use separate USB ports directly into your computer. The cameras require a lot of USB bandwidth, and many USB hubs aren't capable of handling it. For best results, make sure each camera is plugged into a different USB port directly into your computer, ideally on different interal USB hubs.

  5. Open OpenPnP on your computer. You should now see the OpenPnP UI: OpenPnP's basic UI

Linux

On Linux you'll need to join the dialout and video groups, or provide udev rules for the LumenPnP's usb devices.

Serial Port Configuration

Before connecting to the LumenPnP, you need to set which USB port to use for communication in OpenPnP.

  1. Click on the Machine Setup tab. Machine Setup Tab

  2. Click on the "Expand" checkbox to open all of the features. Expanding the Machine Config options

  3. Under Drivers click on GcodeDriver GcodeDriver. Below the list of machine settings you'll find the details of the GcodeDriver. Reviewing the GcodeDriver options

  4. In the Configuration tab, select the Port for your LumenPnP.

    1. On Windows, the Port will look like COM2 or COM3.
    2. On Mac, the Port will be in the format: cu.usbmodem<a-lot-of-numbers>
    3. On Linux, Set the Port to the option in the format: ttyACM0. Changing the Port and Baud Rate

      Port Not Found

      If your machine's port does not show up in the drop down, check that your USB cable is plugged in to both your computer and the LumenPnP. Also check that the motherboard is powered on. If you still cannot find the port, try pressing the reset button on the motherboard and closing and reopening OpenPnP.

  5. Click Apply in the lower right corner to save your changes. Apply baud rate and port

Establishing Serial Connection

  1. Click the green power button in the Machine Controls section of the UI to connect to your machine. Connect to the LumenPnP

  2. The power button will turn red when OpenPnP has connected to your machine. If this doesn't work, check your serial port. having successfully connected to the LumenPnP and cameras

  3. Save your OpenPnP settings with File > Save Configuration. saving the machine config

  4. Turn on your machine's Ring Lights. Click the LED button under the Actuators tab under Machine Controls. Click On in the popup.

Bottom Camera Config

Now we'll set up the cameras. The big red "X" in the camera views means that OpenPnP isn't receiving the webcam feed. We'll specify which webcam is which.

Note

More recent LumenPnP machines ship with a more recessed bottom camera, shown below. The images in our setup guides mostly show an older mounting solution, but either is totally fine. recessed bottom camera

Tip

You may find it easier to calibrate your cameras if you use the optional Nozzle Holder Flange 3D prints.

  1. Remove both camera's lens caps. They pull up and off. (They're already removed in the image below) Lens cap locations

  2. In the top-left corner, change the camera view to one of the "Show All" options. You should then see two camera feeds that are black, and have red X's on them. show both camera feeds

  3. Under the Machine Setup tab, click on Cameras > OpenPnpCaptureCamera Bottom. Finding the Bottom Camera Settings

  4. In the lower detail pane, switch to the Device Settings tab. Switching to the camera device settings

  5. In the Device drop-down, choose PnP Bottom Camera. Selecting the correct device for the Bottom Camera

    Duplicate Camera Names

    There have been a few reports of users seeing two of the same camera name in their OpenPnP drop down menu. This is a bug with how OpenPnP enumerates cameras. If the first one you pick is incorrect, use the other option of the same name.

  6. In the Format drop-down, choose the 1280x720 10fps setting. setting bottom camera resolution

  7. Click the Apply button in the bottom right. You should then see the camera display start showing the feed from the camera, or at least see the red X disappear. We'll fix the exposure next. Saving changes to the Bottom Camera Config Bottom camera is now on

  8. Quickly adjust the exposure to make the image visible. By toggling "Automatic Exposure" on, and then back off again, we'll let auto exposure run, then keep it pinned to the settled value. Do not keep auto exposure turned on. You can also adjust the slider manually after toggling "Automatic Exposure" to get a clearer picture. Later on we'll set the exposure more accurately.

    Adjust exposure

    For Mac Users

    Due to an issue with the camera driver in OpenPnP, some Mac users might notice that the image settings are greyed out for you. There's a fantastic open-source application called CameraController that can be used to edit these settings.

Top Camera Config

  1. Under the Machine Setup tab, click on Heads > ReferenceHead H1 > Cameras > OpenPnpCaptureCamera Top. Finding the Top Camera Settings

  2. In the lower detail pane, switch to the Device Settings tab. Switching to the camera device settings

  3. In the Device drop-down, choose PnP Top Camera. Selecting the correct device for the Bottom Camera

  4. In the Format drop-down, choose the 1280x720 10fps setting. setting top camera resolution

  5. Click the Apply button in the bottom right. You should then see the camera display start showing the feed from the camera, or at least see the red X disappear. Saving changes to the Top Camera Config

  6. Quickly adjust the exposure to make the image visible like you did for the Bottom Camera. By toggling "Automatic Exposure" on, and then back off again, we'll let auto exposure run, then keep it pinned to the settled value. Do not keep auto exposure turned on. You can also adjust the slider manually after toggling "Automatic Exposure" to get a clearer picture. Later on we'll set the exposure more accurately. Adjust exposure

Next Steps

Next, we'll work on the camera's the Homing Fiducials.