当前文档版本为 v0.4.1，您可以访问当前页面的 开发中 版本以获取最近可能的更新。

App Launcher for PAN1080 工具介绍

1 概述

Zephyr App Launcher (以下简称ZAL) 是 Shanghai Panchip Microelectronics Co.,Ltd. 为PAN1080 SDK提供的入口界面软件，其设计目标是以Windows GUI的方式，简化PAN1080 SDK中App（例程与测试用例等）的编译烧录过程，同时提供了通向IDE集成开发环境（VS Code）的入口。

2 获取并打开软件

  1. ZAL是绿色软件，无需安装，默认集成到PAN1080 Development Kit中，位于<PAN1080-DK>\05_TOOLS目录下：

    image

    ZAL工具目录

  2. 进入ZAL-win32-x64子目录，找到ZephyrAppLauncher.exe：

    image

    找到ZAL可执行文件

  3. 双击ZephyrAppLauncher.exe，打开后界面如下：

    image

    打开ZAL主界面

注：

  1. ZAL目前只提供Windows x64版本；

  2. 为后续使用方便，可以采用如下方式为ZAL创建快捷入口（以Win10系统为例）：

    • 固定到任务栏：直接将ZephyrAppLauncher.exe文件拖拽到Window任务栏；

    • 固定到开始菜单：在ZephyrAppLauncher.exe图标上点击右键，选择固定到“开始”屏幕；

    • 创建桌面快捷方式：在ZephyrAppLauncher.exe图标上点击右键，选择发送到 -> 桌面快捷方式；

3 功能介绍

下面详细介绍Zephyr App Launcher for PAN1080（ZAL）的具体功能及使用方法。

3.1 工具配置

第一次使用，需要先指定如下两个路径信息：

  1. 配置PAN1080编译工具链Toolchain的路径；

  2. 配置PAN1080 DK开发包的路径；

image

ZAL工具配置

3.1.1 编译工具链选择

  1. 点击Toolchain Path行末的...按钮，打开目录选择对话框；

  2. 点击路径一栏，进入05_TOOLS目录下的Toolchain子目录；

  3. 点击右下角选择文件夹按钮；

image

指定编译工具链所在的目录

如果配置成功，则可以看到Toolchain Path的路径框背景颜色变为白色：

image

成功识别编译工具链

3.1.2 PAN1080 DK选择

  1. 点击PAN1080-DK Path行末的...按钮，打开目录选择对话框；

  2. 点击路径一栏，进入PAN1080-DK根目录；

  3. 点击右下角选择文件夹按钮；

image

指定PAN1080-DK所在的目录

如果配置成功，则可以看到PAN1080-DK Path的路径框背景颜色变为白色，同时下方的Board选择、Project选择、Build、Rebuild、Flash、Open IDE等按钮变为可操作状态：

image

成功识别PAN1080-DK

3.2 Board选择

Board下拉列表中显示了<PAN1080-DK>\01_SDK\zephyr\boards\arm目录下的所有开发板：

image

Board选择

以上图为例，可以看到当前选择的PAN1080-DK开发包中，默认支持的2个EVB开发板：

  • pan1080a_afld_evb：表示主控是封装为LQFP64、Flash大小为1MB的PAN1080A EVB

  • pan1080a_afx_evb：表示主控是封装为QFN32、Flash大小为1MB的PAN1080A EVB

3.3 Project 与 Config 选择

Project下拉列表中显示了<PAN1080-DK>\01_SDK\zephyr\samples_panchip及<PAN1080-DK>\01_SDK\zephyr\tests_panchip目录下的所有的 App Project：

image

Project选择

Config下拉列表中显示了当前 App Project 的所有普通 Config 或 Overlay Config 文件：

image

Config选择

注：Config 选择菜单右侧有一个名为 U 的小按钮，可以用于 Update Board/Project/Config 列表，例如当我们在 samples_panchip 目录下新增了一个 Project，在不重新打开 ZAL 工具的条件下，点击此按钮即可将新增的 Project 更新至列表中。

3.4 输出目录

在执行Build/Rebuild操作时，ZAL会自动创建输出目录；在执行Flash操作时，ZAL会从自动创建的输出目录中查找编译生成的Image文件进行烧录。

ZAL根据不同的Board和Project选择生成不同名称的输出目录，规则为output_folder = <PAN1080-DK>\01_SDK\build\<app_name>_<conf_name>_<board_name>，其中：

  1. <PAN1080-DK>表示前面工具配置阶段设置的PAN1080-DK Path目录；

  2. <app_name>表示前面Project选择阶段设置目录，例如当我们选择Project为<01_SDK\zephyr\samples_panchip\basic\synchronization>时，<app_name>表示synchronization；

  3. <conf_name>表示前面Config选择阶段设置的App Config（*.conf）文件名；

  4. <board_name>表示前面Board选择阶段设置的Board名称；

3.5 基本功能：Build

Board和Project选择完成后，点击Build按钮，即可开始编译（增量编译），软件底部Log窗口会显示编译过程，完成后如下图所示：

image

Build按钮功能

注：

  1. Build按钮含有增量编译的功能，即如果当前选择的Board+Project+Config：

    1. 之前没有编译过，则会执行重新编译命令；

    2. 如果之前编译过，则会执行增量编译命令；

  2. Build输出目录

3.6 基本功能：Rebuild

点击Rebuild按钮，即可开始重新编译，软件底部Log窗口会显示编译过程，完成后如下图所示：

image

Rebuild按钮功能

3.7 基本功能：Flash

点击Flash按钮，即可开始烧录，软件底部Log窗口会显示烧录指令，稍后会弹出JLink烧录过程对话框，如下图所示：

image

Flash按钮功能

3.8 基本功能：Erase

点击Erase按钮，即可开始擦除全部Flash，软件底部Log窗口会显示擦除指令，稍后会弹出JLink擦除过程对话框，如下图所示：

image

Erase按钮功能

3.9 基本功能：Open IDE

点击Open IDE按钮，即可使用Toolchain中自带的VS Code打开当前选择的App工程，如果打开成功，则软件状态栏右下角会提示“Open VS Code success”，如下图所示：

image

Open IDE 按钮功能

VS Code打开成功：

image

成功打开VS Code

注：第一次打开VS Code的速度可能会比较慢，只要状态栏提示打开成功，就说明VS Code程序已被成功唤起，只需耐心等待片刻即可。

3.10 快捷键

ZAL支持常用操作的快捷键功能。在软件主界面中，按住键盘Alt键，可以看到菜单栏和功能按钮名称中的某个字符下方出现下划线，即表示此菜单或功能按钮支持快捷键：

image

工具快捷键

目前软件支持的快捷键功能及其对应键位如下：

功能

快捷键

Build

Alt + B

Rebuild

Alt + R

Flash

Alt + F

Erase

Alt + E

Open IDE

Alt + O

Update

Alt + U

Help

Alt + H

4 Tips

  1. ZAL第一次打开后，会在自身目录中创建一个配置文件，用来记录软件的一些设置，比如配置的路径信息、当前选择的Board和Project信息、甚至软件的窗口大小和位置等，以方便软件后续打开使用。

  2. ZAL是绿色软件，其本身可以被拷贝到任何目录中，只需注意把ZAL所在的目录（名为ZAL-win32-x64）整体拷贝即可。

  3. 在SDK快速入门文档中编译工具链配置部分我们提到，编译工具链Toolchain目录，需要解压缩到<PAN1080-DK>\05_TOOLS目录下方能正常使用；而实际上，此要求是为了保证命令行编译功能（<PAN1080-DK>\01_SDK\PAN1080 SDK CLI）和快速编译脚本（<PAN1080-DK>\01_SDK\quick_build_samples）能够正常使用而提出的。而对于ZAL工具来说，Toolchain目录可以存放在PC中的任意目录中（需要注意路径中不能有中文或空格），例如，我们可以把Toolchain目录解压到与<PAN1080-DK>同级的目录中：

    image

    将编译工具链目录移动到其他地方

    然后在ZAL中配置修改后的Toolchain目录即可：

    image

    重新指定编译工具链目录

    注：将Toolchain移到<PAN1080-DK>外面，带来的好处是不需要每次更新PAN1080-DK的时候，都重新解压一份Toolchain放到<PAN1080-DK>\05_TOOLS目录下，而是可以直接使用ZAL，只需配置正确的路径即可。但需要注意，这样做将使得我们后面只能使用ZAL来编译App程序，无法再使用命令行编译或快速编译脚本进行编译。

  4. 当点击Open IDE按钮，打开VS Code时，若当前选择的Project是第一次打开，则会默认打开当前App的main.c文件；若当前选择的Project不是第一次打开，则会恢复上一次Project关闭时的文件打开状态。