Import Configuration
To use OpenPnP with the LumenPnP, you will need to tell the software about your machine's capabilities, such as it's size, how many cameras it has, etc. We've done the basic work for you and put together a starting set of configuration files that will describe your LumenPnP. To use our defaults, follow the instructions below.
Linux
-
Go to the LumenPnP Releases Page.
-
Find the latest release that is compatible with your hardware.
- If your machine's version begins with
v2
, pick the most recent release starting withv2
. - If your machine's version begins with
v3
, pick the most recent release starting withv3
.
- If your machine's version begins with
-
Download the
LumenPnP-Config-vX.X.X.zip
file for that release, and unzip it.Older Releases
Older releases have the OpenPnP configuration files in the source. If you can't find the OpenPnP config zip in the release, download the
Source Code
from the release, unzip, and open theopenpnp
folder. -
Inside you'll find the two configuration files you need:
machine.xml
andvision-settings.xml
. -
To install these files in OpenPnP, you'll need to find its configuration folder. In the Ubuntu file manager (Nautilus), press
CTRL
+H
to show hidden files, or go to theView
menu and checkShow Hidden Files
. -
Next, navigate to:
/home/[username]/.openpnp2
. -
Double check that OpenPnP is closed.
-
In the
.openpnp2
folder you'll find the currently used configuration files,machine.xml
,packages.xml
,parts.xml
, andvision-settings.xml
. It is a good idea to copy these somewhere as backup whenever you make changes like this. -
Copy the configuration files from the LumenPnP source files into
.openpnp2
and overwrite the old configuration files. Note that if you've already been using OpenPnP, you may want to only replace yourmachine.xml
file, as the other files will overwrite your existing components and vision libraries.
Windows
-
Go to the LumenPnP Releases Page.
-
Find the latest release that is compatible with your hardware.
- If your machine's version begins with
v2
, pick the most recent release starting withv2
. - If your machine's version begins with
v3
, pick the most recent release starting withv3
.
- If your machine's version begins with
-
Download the
LumenPnP-Config-vX.X.X.zip
file for that release, and unzip it.Older Releases
Older releases have the OpenPnP configuration files in the source. If you can't find the OpenPnP config zip in the release, download the
Source Code
from the release, unzip, and open theopenpnp
folder. If you have a v2 LumenPnP kit, you can get yourvision-settings.xml
from the3.0.0
release or later, as it wasn't a part of earlier configuration packages. -
Inside you'll find the two configuration files you need:
machine.xml
andvision-settings.xml
. -
To install these files in OpenPnP, you'll need to find its configuration folder. First, follow these instructions to show hidden folders in Windows Explorer.
-
Navigate to:
- On Windows Vista and newer:
C:\Users\[username]\.openpnp2
. - On Windows XP and older:
C:\Documents and Settings\[username]\.openpnp2
.
- On Windows Vista and newer:
-
Double-check that OpenPnP is closed.
-
In the
.openpnp2
folder you'll find the currently used configuration files,machine.xml
,packages.xml
,parts.xml
, andvision-settings.xml
. It is a good idea to copy these somewhere as backup whenever you make changes like this. -
Copy the configuration files from the LumenPnP source files into
.openpnp2
and overwrite the old configuration files. Note that if you've already been using OpenPnP, you may want to only replace yourmachine.xml
file, as the other files will overwrite your existing components and vision libraries.
MacOS
-
Go to the LumenPnP Releases Page.
-
Find the latest release that is compatible with your hardware.
- If your machine's version begins with
v2
, pick the most recent release starting withv2
. - If your machine's version begins with
v3
, pick the most recent release starting withv3
.
- If your machine's version begins with
-
Download the
LumenPnP-Config-vX.X.X.zip
file for that release, and unzip it.Older Releases
Older releases have the OpenPnP configuration files in the source. If you can't find the OpenPnP config zip in the release, download the
Source Code
from the release, unzip, and open theopenpnp
folder. -
Inside you'll find the two configuration files you need:
machine.xml
andvision-settings.xml
. -
To install these files in OpenPnP, you'll need to find its configuration folder. First, follow these instructions to show hidden folders in Finder.
-
Next, navigate to:
/Users/[username]/.openpnp2
. -
Double check that OpenPnP is closed.
-
In the
.openpnp2
folder you'll find the currently used configuration files,machine.xml
,packages.xml
,parts.xml
, andvision-settings.xml
. It is a good idea to copy these somewhere as backup whenever you make changes like this. -
Copy the configuration files from the LumenPnP source files into
.openpnp2
and overwrite the old configuration files. Note that if you've already been using OpenPnP, you may want to only replace yourmachine.xml
file, as the other files will overwrite your existing components and vision libraries.
Next Steps
Our next step is to dive into calibration.