¶ .openpnp2的重要性
伴随OpenPnP软件的安装，会生成一个.openpnp2文件夹，里面存储着贴片机最为核心的配置文件。
其路径在：
- Windows: C:\Users\your_username\.openpnp2
- Linux: /home/your_username/.openpnp2
- Mac OS X: /Users/your_username/.openpnp2
对.openpnp2文件夹的任何操作，务必谨慎小心。在不明确操作结果之前，请对.openpnp2文件夹提前进行备份！！
如果看不到.openpnp2文件夹，请重新运行一次软件，然后再关闭软件。
¶ .openpnp2的加载机制
配置文件并不是实时保存的。
OpenPnP刚刚运行时，会从硬盘中读取.openpnp2文件夹内所有的.xml配置文件，并加载到电脑内存里。
OpenPnP运行期间，所有的配置修改和软件设定，都是停留在内存中，而非实时保存到硬盘里。
只有在手动保存或者正常退出软件时，软件会将硬盘中原有旧的.xml配置文件以拷贝的方式，先备份一份到buckups文件夹中，然后，才会将内存里新的配置信息，写入到硬盘。
非正常的软件关闭，都将导致内存中，实时的配置修改信息丢失，或者导致配置文件的损坏。
手动保存方式：
点击软件左上角 File - Save configuration（文件-保存配置），好处是：无需关闭OpenPnP软件。类似Ctrl+S的方式。
正常退出软件的方式：
点击X/Y的P键，让贴装头前往停靠点后，再去点击软件左上角 File - Exit（文件-退出），或者点击软件右上角的 X。
非正常的软件关闭：
电脑异常断电；ALT+F4快捷键关闭软件；软件运行时异常崩溃；软件还在运行时关闭了操作系统。
¶ .openpnp2的文件结构
以Win10系统为例，文件结构如下图所示：
¶ 1、backups文件夹
可选择性的删除backups文件夹内陈旧的备份文件。
当某种原因导致.xml文件损坏或丢失，或者想回退至某个时间节点的配置时，可以尝试从backups文件夹里，找到相应时间节点的配置文件，拷贝全部的.xml文件，替换至.openpnp2文件夹下即可。
¶ 2、log文件夹
存放运行日志。记录着OpenPnP软件所有的运行信息。这些日志是供开发者使用的，对于咱们用户来说，作用不大。
log文件夹可清空。当前的运行日志文件的文件名为OpenPnP.log。直至关闭软件，才会被转存成为历史日志。
¶ 3、scripts文件夹
存放脚本文件和一些脚本示例，更多信息可以参考官方wiki：Scripting
其中Events文件夹内需要从配置文件中获得适配给TornadoSMT贴片机的底部相机脚本文件：NozzleCalibration.Starting.bsh，用于修正贴片机通电后，底部相机因失焦而出现的图像模糊。该文件只在吸嘴进行同心度校准时才会发挥作用。
新的配置文件中已经提供了该文件，可以用记事本或其他文本编辑工具打开，其代码如下：
import org.pmw.tinylog.Logger;
camFocus = org.openpnp.util.VisionUtils.getBottomVisionCamera().getFocus();
value = 550; // Put the Focus value you want to set here.将您要设置的焦点值放在这里。
camFocus.setValue(value);其中value = 550，将数值550修改至标定阶段时底部相机初级校准所使用到的Focus值。
注意：定焦版本的TornadoSMT贴片机，无需使用该脚本，底部相机的焦距已经是固定焦距的
¶ 4、snapshots文件夹
存储着相机图像的截屏快照。鼠标左键双击相机图像即为拍摄。
¶ 5、themes文件夹
应该是用于修改界面风格的外部主题。官方暂时还没有这部分的内容介绍。
¶ 6、machine.xml
贴片机最为核心的配置文件。
¶ 7、parts.xml
元件库中所有元件的数据库，记录着所有元件的数据信息。
¶ 8、packages.xml
封装库中所有封装的数据库，记录着所有封装的数据信息。
¶ 9、boards.xml和panels.xml
分别记录了最近使用过的单板和拼板文件的路径信息。
¶ 10、vision-settings.xml
所有视觉方案的设定文件，包括：顶部视觉方案，基准视觉方案，底部视觉方案，以及各自视觉通道的设定。
¶ 11、其他文件夹
如果发现某些文件夹的名称很长，以ImageWriteDebug结尾，或者org.openpnp.machine开头，而且打开后发现里面全是一些.png的图像文件。
对于普通用户来说，这些图像文件几乎是无用的，而且随着时间的推移，这些文件会持续激增，占用大量C盘空间。
这些图像文件和文件夹可以删除。
这些图像文件是由视觉管道中的调试属性：ImageWriteDebug 引起的，来自于默认的基准视觉和默认的底部视觉。
在新版的配置文件中，我们已经将其关闭，最大程度上，阻止了这些图像文件的持续生成。
在标定过程中，会伴随一些视觉的自动算法，也会生成这些文件夹和.png文件，可以在完成标定之后，将其删除。
¶ 12、 其他重要信息
- 将贴片机连接至另一台电脑时，需要移植或重新安装相同版本的OpenPnP软件，并且将.openpnp2文件夹复制到新电脑的相同目录下。
- OpenPnP运行期间，如果您对某个功能做了修改，点击软件左上角 File - Save configuration（文件-保存配置），即为手动实时保存。当软件正常关闭或退出时，软件也会在后台自动保存配置。
- 如果电脑主机因突然断电、OpenPnP软件崩溃、或者在没有关闭OpenPnP软件时直接选择电脑关机，均会导致软件运行期间所修改的配置信息丢失。所以，请培养手动实时保存配置和正常关闭OpenPnP软件的使用习惯。
- 对.openpnp2文件夹进行操作前，请提前关闭OpenPnP软件，或者点击File - Save configuration（文件-保存配置）将内存中的配置文件信息及时写入硬盘。
- 建议定期备份.openpnp2文件夹，防止其意外丢失。
¶ 存档技巧
- 标定阶段的教程中，我们会在章节的结尾，要求大家对.openpnp2文件夹内配置文件进行手动备份。
- 有点类似进行游戏存档，将递进的标定过程分割成一个接着一个的存档节点。
- 在后续的环节中，如果想要从之前的某个环节重新开始，只需要在关闭OpenPnP软件的前提下，将.openpnp2文件夹还原至存档节点即可。
- 此外另一层原因是，防止标定期间因为电脑意外断电、软件崩溃、非正常关闭软件等不利因素，导致当前进度配置文件的丢失。
手动存档的操作：
无需关闭OpenPnP软件。
直接点击软件左上角的 File - Save configuration（文件-保存配置），
然后前往.openpnp2文件夹，
选择所有.xml文件（共计6个）和Scripts文件夹，手动备份成一个压缩包，文件名我会在标定教程中推荐给大家。
恢复存档的操作：
务必在关闭OpenPnP软件后，再进行还原操作。
找到想要还原的存档压缩包，将解压得到的全部.xml文件替换到.openpnp2文件夹中，
重新启动OpenPnP，完成寻零或Home点回归后，根据存档压缩包文件名Issue-xx，从第xx章的教程开始进行。
上一章：安装OpenPnP软件 目录 下一章：导入配置文件