Skip to content

Connecting to Your Machine

Awesome! 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.

  1. Connect your LumenPnP to your computer using the included USB cable

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

Com Port and Baud Rate

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, check the Baud and Port settings.

  5. Set the Baud to 115200
  6. On Windows, Set the Port to the option in the format: COM2.
  7. On Mac, Set the Port to the option in the format: cu.usbmodem<a-lot-of-numbers>
  8. 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.

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

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.

Camera Connection Issues (v2 Hardware)

Because the motherboard in v2 LumenPnP kit machines has a built in USB hub you can plug both of the webcams into the motherboard, and then connect the motherboard to your computer with a single one USB cable. This keeps cables tidy, but it sends a lot of data through one single USB port on your computer.

Unfortunately, from reports we've gotten from users, it seems that not all computer manufacturers include high-quality internal USB hubs. The lower quality hubs included in these computers can't handle the bandwidth requirements of two webcams plus the motherboard all on a single USB port. If this is the case for your computer, one or both of the webcams will be missing from the configuration list in OpenPnP or any other camera application.

If you have this problem, you will need to plug at least one of the webcams directly into your computer via a separate USB port. Occasionally this can cause the webcam's name to be incorrect, but you'll still be able to select it from the drop-down list with a little trial and error.

  1. 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

  2. Again, navigate to the Machine Setup tab.

  3. Again, click the "Expand" checkbox if necessary.
  4. Click on Cameras > OpenPnpCaptureCamera Bottom. Finding the Bottom Camera Settings

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

  6. 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 on Windows seeing two of the same camera name in their Open PnP drop down menu. If this happens to you, use trial and error to identify which camera is which in the list. Sorry for any inconvenience.

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

  8. 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

  9. Adjust the exposure to make the camera feed more reasonable. On some computers, you can toggle Automatic Exposure on, and then back off again to set it correctly. Do not keep auto exposure turned on. You can come back to adjust the exposure later at any time. Adjust exposure

Top Camera Config

  1. Again, navigate to the Machine Setup tab.
  2. Again, click the "Expand" checkbox if necessary.
  3. Navigate to Heads > ReferenceHead H1 > Cameras > OpenPnPCaptureCamera Top. Finding the Top 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 Top Camera. Selecting the correct device for the Bottom Camera

  6. In the Format drop-down, choose the 1280x720 10fps setting. setting top 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. Saving changes to the Top Camera Config

  8. Adjust the exposure to make the camera feed more reasonable. Both cameras should now be working. Adjust exposure

Connecting to the LumenPnP

  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 port and baud rate. having successfully connected to the LumenPnP and cameras

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

Next Steps

Next, we'll work on the the camera's Fisheye Calibration.