OpenPnP 安装
小熊diy
编辑于 2026年03月25日 11:21

OpenPnP 是一款用于控制贴片机的开源软件。它支持多种机型,并具备许多高端商用软件才有的功能。

官网下载:https://openpnp.org/downloads/


推荐硬件与操作系统

OpenPnP 设计为可在多种不同类型的主机电脑上运行。然而,不同电脑之间的 USB 驱动程序与内置 USB 集线器带宽可能存在差异。为了实现与 LumenPnP 相机稳定的连接和曝光控制,我们推荐使用运行 Ubuntu 20.04 LTS 或 Ubuntu 22.04 LTS 系统的联想 ThinkPad(任意型号均可)。

macOS 不再兼容

OpenPnP 已不再支持 macOS,我们发现当前面向 Mac 的版本已无法使用。如果你是 Mac 用户,需要切换至受支持的操作系统,或使用旧版 OpenPnP(2023-04-05 版本)。


下载并安装 OpenPnP

OpenPnP 近期已开始发布稳定版本。我们目前支持使用 OpenPnP 最新正式版。

尽量使用 Linux

我们强烈推荐使用 Ubuntu Linux 作为运行 OpenPnP 的操作系统,因为它与相机的通信兼容性极佳。

Linux(Ubuntu 安装指南)

参考官方安装教程: https://ubuntu.com/tutorials/install-ubuntu-desktop#1-overview


下载并安装 Linux 版 OpenPnP

请使用以下版本,这是我们实际使用的版本,本份文档全部基于该版本编写。

  • .deb 包 https://s3-us-west-2.amazonaws.com/openpnp/OpenPnP-linux-main.deb

  • .tar.gz 包 https://s3-us-west-2.amazonaws.com/openpnp/OpenPnP-unix-main.tar.gz


Linux 用户注意事项

在 Linux 系统下,需完成两项简单配置才能运行 OpenPnP。


1. 将当前用户加入 dialout 用户组

为使 OpenPnP 与设备通信,需将当前用户加入 dialout 用户组。

在终端中执行以下命令(将 [USERNAME] 替换为你当前登录的用户名),然后重启电脑

代码块
PlainText
自动换行
复制代码
sudo adduser [USERNAME] dialout
复制成功

2. 安装 Java 环境

OpenPnP 需要安装 Java 环境。 在终端中执行以下命令即可完成安装:

代码块
PlainText
自动换行
复制代码
sudo apt-get install openjdk-17-jdk
复制成功

⚠️ 请注意 如果未安装 Java,点击图标启动 OpenPnP 时,程序会无任何提示直接启动失败。


启动与初始化配置

  1. 启动 OpenPnP,并确保程序完整加载。 此操作会让 OpenPnP 在电脑上生成配置文件夹,供下一步使用。

  2. OpenPnP 可能会提示你下载新版本,对此提示请点击 Cancel(取消),然后退出程序。

  3. 彻底关闭 OpenPnP 软件

Windows(不推荐)

下载并安装 Windows 版 OpenPnP。

  • 32 位 .exe 安装包:https://openpnp.s3-us-west-2.amazonaws.com/test/2023-04-05_08-24-36.0aa4ae8/OpenPnP-windows-x32-test.exe

  • 64 位 .exe 安装包:https://openpnp.s3-us-west-2.amazonaws.com/test/2023-04-05_08-24-36.0aa4ae8/OpenPnP-windows-x64-test.exe

请使用此版本的 OpenPnP,这是我们实际使用的版本,本份文档全部基于该版本编写。

  1. 启动 OpenPnP,并确保程序完整加载。 此操作会让 OpenPnP 在电脑上生成配置文件夹,供下一步使用。

  2. OpenPnP 可能会提示你下载新版本,对此提示请点击 Cancel(取消),然后退出程序。

  3. 彻底关闭 OpenPnP 软件


Mac 用户

MacOS 已不再受支持,且无法正常使用 OpenPnP。

在后续开发完成之前,MacOS 只能强制使用旧版本 OpenPnP。

来源:https://docs.opulo.io/openpnp/v4/install-config/install/#linux-ubuntu-install-guide