为了让 OpenPnP 正确适配 LumenPnP V4，需要导入针对该机型的配置文件。 我们提供了一套预配置文件，请按以下步骤导入。

⚠️ 注意：如果你使用的是 LumenPnP V3，请勿按照本页面操作。请前往 V3 配置文件页面 获取对应文件。

通用说明

我们将根据你所选择的操作系统，执行以下步骤：

1. 继续操作前，请确保 OpenPnP 已完全关闭。

2. 从软件更新页面下载最新的V4 配置文件。

3. 将下载的 .zip 压缩包解压到你方便访问的位置。

4. 替换配置文件前，请先备份你当前的配置文件。

5. 按照下方对应操作系统的说明，找到并替换所需的配置文件。

Linux 操作说明

在继续之前，务必确保 OpenPnP 已完全关闭，没有在后台运行。

1. 前往软件更新页面，下载适用于 LumenPnP V4 的 OpenPnP V4 配置压缩包，下载完成后返回本页面。

2. 解压 V4 配置文件到容易找到的位置，并确认里面包含 machine.xml 和 vision-settings.xml。

1. 找到 OpenPnP 的隐藏配置文件夹（.openpn2）：

   • 打开 Ubuntu 文件管理器（Nautilus）

   • 进入路径：/home/[用户名]/

     （如果你的系统没有 [用户名] 文件夹，直接在 /home/ 下即可）

   • 按 Ctrl+H 显示隐藏文件

     （或在「查看」菜单中勾选「显示隐藏文件」）

   • 找到并打开显示出来的 .openpnp2 文件夹。

2. 在 .openpnp2 文件夹中，将现有的

   machine.xml、packages.xml、parts.xml、vision-settings.xml

   复制到安全位置备份。

3. 用之前解压得到的新的 machine.xml 和 vision-settings.xml，替换掉 .openpnp2 文件夹里的旧文件。

Windows 操作说明

1. 开始前务必确保 OpenPnP 已完全关闭，没有后台运行。

2. 前往软件更新页面（https://docs.opulo.io/software-updates/），下载 LumenPnP V4 对应的 OpenPnP V4 配置压缩包，解压到好找的位置，并确认里面有machine.xml 和vision-settings.xml 。

1. 打开系统显示隐藏文件（https://support.microsoft.com/en-us/windows/show-hidden-files-0320fe58-0117-fd59-6851-9b7f9840fdb2），按系统版本进入配置文件夹：

   • Windows Vista 及更高版本：C:\Users\[用户名]\.openpnp2

   • Windows XP 及更早版本：C:\Documents and Settings\[用户名]\.openpnp2

2. 先备份 .openpnp2 里的 machine.xml、packages.xml、parts.xml、vision-settings.xml。

3. 再用解压得到的新文件替换旧的 machine.xml 和 vision-settings.xml。

macOS 操作说明

1. 在继续操作之前，请务必确保 OpenPnP 已完全关闭，不在后台运行。

2. 前往软件更新页面（https://docs.opulo.io/software-updates/），下载适用于 LumenPnP V4 的 OpenPnP V4 配置文件压缩包，下载完成后返回本页面。

1. 将 V4 配置文件解压到便于查找的位置，并确认压缩包内包含 machine.xml 和 vision-settings.xml 文件。

2. 打开访达，进入 /Users/[用户名]/ 目录，按说明显示隐藏文件（https://www.macworld.com/article/671158/how-to-show-hidden-files-on-a-mac.html），找到并打开 .openpnp2 文件夹。

3. 在 .openpnp2 文件夹中，将现有的 machine.xml、packages.xml、parts.xml 和 vision-settings.xml 复制到安全位置进行备份。

4. 用之前解压得到的新文件，替换 .openpnp2 文件夹中原有的 machine.xml 和 vision-settings.xml。