Developer Guide

  • 2021.3
  • 11/18/2021
  • Public

Capsule Upload and Apply Script

The data streams optimizer and the cache configurator use this script to copy a capsule to the target system and apply it.
  • Slim Bootloader (SBL)
The script supports the Yocto Project*-based board support package.
You can copy and modify the script to support another firmware or OS. The scripts must meet the following requirements to maintain compatibility with the data streams optimizer:
  • Input: The first parameter is a capsule version. Other parameters are paths to capsules on the host system.
    When a capsule is copied to the target, the capsule name is specified by the
    script, but the destination is specified in the
    field in the environment file.
    Capsule version is important for Windows* operating systems. The data streams optimizer uses capsule version “1” for Linux* operating systems.
    usage: VERSION CAPSULE_FILE_1 CAPSULE_FILE_2 ... CAPSULE_FILE_N VERSION Capsule version to apply CAPSULE_FILE_N Path to the capsule file
  • Output: Return code must be 0 when the capsule is applied successfully.
  • Error handling: Any nonzero value returned from the script will be interpreted as an error. Any additional logging should be printed to STDERR.
Command line: tools/host_scripts/ 1 /home/root/my_on_host_capsule.capsule STDOUT: some-output-there Return value: 0 STDERR: empty

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at