一、安装 OpenPnP

OpenPnP 是旨在控制拾取和放置机器的开源软件。它支持各种机器，具有高端商业软件中的许多功能。您可以在此处了解更多信息。

---

推荐的硬件和作系统

OpenPnP 设计为在许多不同类型的主机上运行。但是，USB 驱动程序和内部 USB 集线器带宽可能因计算机而异。为了实现 LumenPnP 相机的可靠连接和曝光控制，我们建议使用运行 Ubuntu 20.04 LTS 或 Ubuntu 22.04 LTS 的联想 Thinkpad（任何型号都应该没问题）。

---

下载并安装 OpenPnP

仅使用以下说明中链接的 OpenPnP 版本。OpenPnP 会经历频繁的更新，这些更新可能会改变、破坏或消除功能。坚持使用我们建议的版本 （2023-04-05 版本） 可确保一切正常运行，并且本文档保持可靠。此版本还与 LumenPnP 馈线兼容。

由于 OpenPnP 最近开始创建稳定版本，因此我们将适应最新版本，我们可以确认该版本可以正常工作。此页面将更新，以反映该更改。在此之前，请使用本页推荐的版本。

尽可能使用 Linux

我们强烈建议使用 Ubuntu Linux 作为运行 OpenPnP 的作系统，因为它可以很好地处理与摄像机的通信。

---

Linux（Ubuntu 安装指南）)

1. 下载并安装适用于 Linux 的 OpenPnP。
   • ((Download .deb）或 （Download .tar.gz)使用此版本的 OpenPnP。这是我们使用的版本，也是所有这些文档的基础版本。
   Linux 用户Linux 需要两个快速配置步骤才能允许 OpenPnP 运行：
   1. 要使 OpenPnP 与计算机通信，必须将用户添加到组中。这可以通过在终端中输入 （where the user you’re signed with） 并重新启动计算机来完成。dialoutsudo adduser [USERNAME] dialout[USERNAME]OpenPnP 要求安装 Java。这可以通过进入终端轻松完成。sudo apt-get install openjdk-17-jdk
   请注意，如果未安装 Java，当您尝试通过单击图标启动 OpenPnP 时，OpenPnP 将失败并无提示。
2. 启动 OpenPnP 并确保它完全加载。这样做将确保 OpenPnP 在你的计算机上创建一个配置文件夹，我们将在下一步中用到该文件夹。
3. OpenPnP 可能会提示您下载新版本。单击 ，然后转到此提示符。CancelExit
4. 完全关闭 OpenPnP 软件。

---

Windows（不推荐）

1. 下载并安装适用于 Windows 的 OpenPnP。
   • (下载 32 位 .exe)
   • (下载 64 位 .exe)
   • 使用此版本的 OpenPnP。这是我们使用的版本，也是所有这些文档的基础版本。
2. 启动 OpenPnP 并确保它完全加载。这样做将确保 OpenPnP 在你的计算机上创建一个配置文件夹，我们将在下一步中用到该文件夹。
3. OpenPnP 可能会提示您下载新版本。单击 ，然后转到此提示符。CancelExit
4. 完全关闭 OpenPnP 软件。

---

MacOS（不推荐）

1. 下载并安装适用于 Mac 的 OpenPnP。
   • (Download .dmg)
   • 使用此版本的 OpenPnP。这是我们使用的版本，也是所有这些文档的基础版本。
2. 启动 OpenPnP 并确保它完全加载。这样做将确保 OpenPnP 在你的计算机上创建一个配置文件夹，我们将在下一步中用到该文件夹。
3. OpenPnP 可能会提示您下载新版本。单击 ，然后转到此提示符。CancelExit
4. 完全关闭 OpenPnP 软件。

Mac 用户 – 安装问题？

由于 OpenPnP 对其版本进行签名的方式存在错误，使用 ARM 处理器的 Mac 用户在启动时可能会遇到崩溃，或者无法访问相机。您仍然可以通过导航到并右键单击 OpenPnP 应用程序并选择“显示包内容”来运行 OpenPnP：然后导航到并双击以运行 OpenPnP。

注意：我们不建议将 MacOS 与 LumenPnP 一起使用。请仅在没有其他选择的情况下使用。Applications -> OpenPnPContents -> MacOSJavaApplicationStub

LumenPnP V4 用户

要正确使用 OpenPnP 和 LumenPnP V4，您需要使用机器的规格配置软件，例如尺寸、相机设置和其他基本设置。为了简化这一点，我们提供了一组预配置文件。请按照以下步骤正确导入它们。

⚠️ 如果您正在设置 LumenPnP V3，则不能使用此页面。点击此链接访问正确的 V3 配置文件。⚠️

---

一般说明

我们将为您选择的作系统执行以下步骤。

• 在继续之前，请确保 OpenPnP 已完全关闭。
• 从软件更新页面下载最新的 V4 配置文件。
• 将下载的 .zip 文件的内容提取到您可以轻松访问的位置。
• 在替换当前配置文件之前备份它们。
• 按照下面的作系统特定说明查找并替换必要的配置文件。

---

Linux 说明

1. 在继续之前，必须确保 OpenPnP 未运行且完全关闭。
2. 通过转到软件更新页面并返回此页面，下载压缩的 OpenPnP V4 配置文件。LumenPnP V4
3. 将 V4 配置文件解压缩到您会记住的位置，同时确认它包含 a 和 .machine.xmlvision-settings.xml
4. 找到 OpenPnP 的隐藏配置文件夹 （.openpnp2）
   • 打开 Ubuntu 的文件管理器，名为 （Nautilus）
   • 导航到 /home/[username]/（根据您的设置，您可能没有 /[username]/ 文件夹。在这种情况下，请留在 /home/ 中）
   • 按 + 可显示隐藏的文件夹。（或者，转到菜单并选择 Show Hidden Files。CTRLHView
   • 现在，您正在查看的文件夹中应该还有其他文件夹和文件可见。
   • 找到并打开现在可见的文件夹。.openpnp2
5. 在该文件夹中，备份现有文件 、 、 ，并将其复制到安全位置。.openpnp2machine.xmlpackages.xmlparts.xmlvision-settings.xml
6. 将文件夹中的旧 and 文件替换为您之前解压缩的 new 和 files。machine.xmlvision-settings.xml.openpnp2machine.xmlvision-settings.xml

---

Windows 说明

1. 在继续之前，必须确保 OpenPnP 未运行且完全关闭。
2. 通过转到软件更新页面并返回此页面，下载压缩的 OpenPnP V4 配置文件。LumenPnP V4
3. 将 V4 配置文件解压缩到您会记住的位置，同时确认它包含 a 和 .machine.xmlvision-settings.xml
4. 找到 OpenPnP 的隐藏配置文件夹 （.openpnp2）
   • 按照这些说明启用隐藏文件。
   • 导航到：
     • Windows Vista 或更高版本：C:\Users\[username]\.openpnp2
     • Windows XP 或更早版本：C:\Documents and Settings\[username]\.openpnp2
   • 找到并打开现在可见的文件夹。.openpnp2
5. 在该文件夹中，备份现有文件 、 、 ，并将其复制到安全位置。.openpnp2machine.xmlpackages.xmlparts.xmlvision-settings.xml
6. 将文件夹中的旧 and 文件替换为您之前解压缩的 new 和 files。machine.xmlvision-settings.xml.openpnp2machine.xmlvision-settings.xml

---

MacOS 使用说明

1. 在继续之前，必须确保 OpenPnP 未运行且完全关闭。
2. 通过转到软件更新页面并返回此页面，下载压缩的 OpenPnP V4 配置文件。LumenPnP V4
3. 将 V4 配置文件解压缩到您会记住的位置，同时确认它包含 a 和 .machine.xmlvision-settings.xml
4. 找到 OpenPnP 的隐藏配置文件夹 （.openpnp2）
   • 打开 Finder 并导航到 /Users/[用户名]/。
   • 按照这些说明显示隐藏的文件。
   • 现在，您正在查看的文件夹中应该还有其他文件夹和文件可见。
   • 找到并打开现在可见的文件夹。.openpnp2
5. 在该文件夹中，备份现有文件 、 、 ，并将其复制到安全位置。.openpnp2machine.xmlpackages.xmlparts.xmlvision-settings.xml
6. 将文件夹中的旧 and 文件替换为您之前解压缩的 new 和 files。machine.xmlvision-settings.xml.openpnp2machine.xmlvision-settings.xml