跳到主要内容
版本：Next

3.3.4：ZPKG 如何使用

1：zpkg 是什么？​

zpkg 为 pkg （package） 文件的二次封装，在pkg 文件的基础上，封装 更多的信息 为独立的一个文件，通过此文件，开发者可以直接将 zpkg文件通过邮件或者其他途径，发送给最终用户或者烧录厂家，除打包此文件的开发者之外，其他成员将无法看到此文件的任何数据，在一定程度上可以满足特殊的需求，zpkg 支持以下特性：

  • （推介）zpkg 文件支持设置密码：包含密码信息的zpkg 加载到设备后，从设备读回工程文件需要密码验证才能打开。
  • （推介）zpkg 文件支持禁止回读：禁止回读后，将无法从设备读回工程文件。
  • （推介）zpkg 文件支持绑定到特定设备机器码：绑定机器码之后的zpkg 仅允许单次加载到特定设备，未授权的设备或重复加载均将无法完成。

zpkg 虽然在某些特殊的使用场景下有一定的用途，但是仍然存在某些局限，需要特别的注意，具体汇总如下：

警告
  • 因 密码和项目文件被整体 打包：意味着存在一定被攻击的风险，PowerWriter® 将尽可能的防止zpkg 文件被攻击而导致密码泄露，除了某些特殊的场景必须使用zpkg 格式之外，大部分通用的场景，仍然推介使用pkg 文件 + ICWorkshop 平台进行项目交付。
  • 请严格知晓以上缺陷，如不清楚，请不要使用此功能。
提示

绑定zpkg 到认证码的方式目前仅限 PWX1 设备支持，设备购买链接请参考本页面右上角商城入口。

2：如何保存为zpkg？​

2.1：基础用法​

保存zpkg 文件的方法和 保存pkg 文件的方法一致，动画演示如下：

zpkg_1

2.2：机器码绑定​

绑定zpkg 到特定 PowerWriter 设备的机器码，可实现zpkg 单次下载，通过显示工程文件的编程次数，实现脱机交付能力，PowerWriter 设备支持 8个通道的机器码，如下图所示：

image-20260109135304504

  • 认证码：PowerWriter 设备的机器认证码（唯一码）,认证码只能通过更新的方式进行生成，设备将自动生成认证码。
  • 校验码：通道数据的校验信息，仅展示。
  • 状态：当前认证码是否有效，有效的认证码才可以执行复制，并绑定到zpkg 文件，无效的认证码绑定到zpkg 文件将无法加载。
  • 更新：更新当前通道的认证码。
  • 复制：复制认证码到剪贴板。

2.2.1：认证码生成​

在设备端生成认证码之前，需要连接设备到PowerWriter 应用软件，操作方式如下所示：

zpkg_1

提示

生成认证码之后，将认证码复制到剪贴板，并提供给 zpkg 的发布者，进行设备与zpkg 文件进行绑定。

2.2.2：认证码绑定​

zpkg 项目发布方，将用户提供的设备认证码与zpkg 进行绑定，操作方式如下所示：

zpkg_1

提示

绑定设备认证码的zpkg 文件发回给生产方加载到设备进行生产，加载时设备只允许加载一次，加载完成后认证码将失效，无法重复加载同一个zpkg 文件。

3：如何加载zpkg到Writer？​

加载zpkg 文件到烧录器的流程和加载pkg 到烧录器的流程，动画演示如下：

zpkg_1

4：补充说明​

  • 绑定认证码的 zpkg 文件，一般也需要同步设置脱机编程次数限制，否则无法达到次数控制的效果。
  • 绑定认证码的 zpkg 文件，使用工厂模式进行在线烧录时：
    • 如开启了编程次数限制，工厂模式在线编程将会被禁用，只能进行脱机下载。
    • 如未开启编程次数限制，工厂模式在线编程将会验证设备的认证码，验证失败的设备将无法进行在线编程。