客制化启动

• 自定义烧录

  Boot ROM 升级模式不支持烧录 Flash。 如果不使用 Luban-Lite SDK 的 BootLoader 烧录方案，则需要自定义烧录功能。

  开发者需要本节介绍如何自行实现一个自定义一个带烧录功能的程序，如 flashwriter.aic ，通过 USB/UART/SD 卡等方式运行后起来，然后将 app.aic 烧录到指定的存储介质中。

  • 通过 USB/UART 烧录:
    1. 通过 USB/UART，使用 upgcmd.exe write 命令将 app.aic 先写入到一个预设的 SRAM 空间。在命令行中执行以下命令：

       upgcmd.exe write /path/to/app.aic /path/to/sram_storage

    2. 下载运行 flashwriter.aic ，由 flashwriter.aic 从该位置 SRAM 存储中读取 app.aic 的数据，并写入将其烧录到 Flash。

  • 通过 SD 卡烧录：

    1. 将 SD 卡插入开发板，并将 flashwriter.aic 烧录到 SD 卡的 FAT32 文件系统中。

    2. 启动开发板，使其从 SD 卡启动并运行 flashwriter.aic。

    3. flashwriter.aic 程序从 SD 卡的文件系统中读取 app.aic 的数据，并写入将其烧录到 Flash。

    烧录位置可能因存储介质类型而异：

    • 对于 SPINOR，只需将 app.aic 直接烧录到 Flash 的最开始位置即可，即 Flash 0 位置。

    • 对于 SD/eMMC，开始处需要预留 17K Byte 的 GPT 分区头，因此从第 34 个 Sector 的位置烧录 app.aic。

    对于 SPINAND，由于需要坏块管理等，处理比较复杂，建议使用 SDK 的 BootLoader 进行烧录，此处不进行描述。

• 使用 SDK 的 BootLoader 烧录

  使用 SDK 的 BootLoader 烧录是一种较为简便的方法，参考下面的配置流程，可以将 app.aic 烧录到指定的分区。

  参考下面的配置，可以完成将 app.aic 烧录到指定的分区。

  1. 编译一个对应项目的 BootLoader。以 SPINOR 的方案为例，根据相近配置板子的项目，修改配置后，编译生成 BootLoader 程序。

     例如 output/d13x_demo88-nor_baremetal_bootloader/images/d13x.bin

     即为编译后的 BootLoader 程序，可重命名为 bootloader.bin。

     对于没有 PSRAM 的项目，可以参考 G73x 的项目编译 BootLoader。

  2. 生成烧录镜像。需要准备下列工具和文件：

     • 工具:

       1. tools/scripts/mk_image.py/mk_image.exe

       2. tools/scripts/gen_partition_table.py

       3. tools/scripts/mk_private_resource.py

     • 文件: 参考相近存储的 demo 板的配置，如 demo88-nor，如果没有 PSRAM，可参考 G73x 的对应文件

       1. bsp/artinchip/sys/d13x/d13x.pbp

       2. target/d13x/demo88-nor/pack/image_cfg.json

       3. target/d13x/demo88-nor/pack/pbp_cfg.json

     • 修改 image_cfg.json 配置文件，详情可查看image_cfg.json 参考配置。

     • 将下列文件放到一个目录：

       • mk_image.py/mk_image.exe

       • gen_partition_table.py

       • mk_private_resource.py

       • d13x.pbp

       • image_cfg.json

       • pbp_cfg.json

       • app.bin

  3. 执行命令生成烧录镜像：

     gen_partition_table.py -c image_cfg.json -o partition.h -j partition.json
     mk_private_resource.py -l pbp_cfg.json,partition.json pbp_cfg.bin
     mk_image.py -v -d . -c image_cfg.json

  4. 使用 AiBurn 或者执行下列 upgcmd.exe 进行烧录。AiBurn 烧录，与 SDK 镜像文件烧录方法一致。

     upgcmd.exe image  d13x_demo88-nor_v1.0.0.img

     注意，上述配置下，烧录完成后，重启时 Boot ROM 直接运行 app.aic ，因此如果需要重新进入 Boot ROM 升级模式， 需要通过短接 Flash 引脚，让芯片读取 Flash 内容失败然后进入升级模式。

如果 SDMC1 对应的卡座上插入了 SD 卡，上电启动过程中，总是优先检查 SD 卡，因此将 app.aic 放到 SD 卡中总是会被执行。具体如下：

1. 准备一张市面上常见的 SD 卡，即 TF 卡。

2. 格式化为 FAT32/exFAT 文件系统，确保只有一个分区。

3. 参照下面的格式写一个 bootcfg.txt 文件，并且将 bootcfg.txt 和 app.aic 一起复制到 SD 卡文件系统的根目录。

   boot0=app.aic  # 此处 boot0 是一个关键字，app.aic 可根据实际情况修改
   

   注：

   bootcfg.txt 中如有换行符，请确保使用 UNIX 格式的换行符，即 ‘\n’，不能是 ‘\r\n’。

4. 插卡到 SDMC1 对应的卡座，重启板子，即可运行 app.aic。