Custom firmware - App DFU package

本章节说明如何生成一个可通过 Vision APP 更新 fixture 的 .bin file。如果已经按照 Custom Firmware instructions 操作，可以按以下步骤生成该 file。

首先在 Windows 上打开 Vision App。如果还不熟悉该步骤，请先查看：
https://server.kk-t.eu/ExternalVision/TestPreparations
按照以下步骤将 application 切换到 Test Mode。这样可以使用和查看尚未 registered 的 development fixtures：

• 点击顶部 gear，进入 Settings：
  
• 点击 App Settings：
  
• 点击 App Software Version label（例如 0.0.5.0）两次。随后会出现 prompt。输入 PIN 7248，Test Mode 即会 activated。
  

现在 App 中会显示必要 functions。再次进入 settings tab。

现在应能看到 Developer Tools。

然后点击 DFU File Generator：

现在进入 DFU File Generator。在这里选择您的 Application .bin file，并输入 RDM Manufacturer Model 和 RDM Device Model ID。两者都使用 decimal，不是 hexadecimal。

Attention:
DFU 使用 RDM Manufacturer 和 Device Model ID 进行 protection。创建 product 时，请使用该 unique information secure firmware，确保 firmware 只能 uploaded 到对应 fixture type。这样可以防止 wrong firmware 导致 fixture bricked。请务必确保这些 values 始终正确。

还需要输入 Application Firmware Version。Vision app 要求 standardized versioning format：x.x.x.x。

第一个为 Major，表示与 previous firmware 不兼容的 function change。
第二个为 Minor，表示相对 previous firmware added feature。
第三个为 Patch，表示相对 previous firmware 的 bugfix。
第四个为 Release，标记 public firmware release。Public versions 请始终保持为 255。

这称为 Semantic Versioning：https://semver.org/

如果您按照 "Project Artery IC" 或 "Project STM32 IC" instructions 操作，可以打开 Keil，并在 ReleaseBL target configuration 下 build Application Project。

对于 Keil，需要在 Target User Settings 中添加以下内容：
在 "User" command column 中添加：
fromelf.exe --bin --output .\Listings\@L.bin !L
Attention: 复制该 line 时可能会损坏 hyphen。请确保这里是 double hyphen。

填写 data 后应类似如下。Manufacturer 61450 和 RDM Device Model ID 2 只是 example values，不应在您的 product 中使用。

然后点击 Generate DFU File 获取 file。

该 file 现在可以上传到我们的 webservice，或在 APP 中手动选择用于 update process：

关于 upload process 的更多信息，请查看：
https://server.kk-t.eu/ExternalVision/ProductionFixture 中的 Software Upload。