Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

Mounting an Android Image

The official Kbox demo image provided by Huawei Mirrors repository does not contain the Android Kbox binary. Therefore, containers cannot be normally started using this image. If you use this demo image, download the Android Kbox binary to the local host and use the script to create an original Kbox image that can start containers properly. After mounting the original Kbox image, create a new Kbox image that integrates the NETINT codec library if hardware decoding is required.

Table 1 Obtain images

Image Name + Tag

How to Obtain

Usage

Set by the user

Compiled by the user

Compile the image based on Software Compilation. This image contains the Android Kbox binary, and containers can be started properly.

kbox:demo

Official Kbox demo image provided by Huawei Mirrors repository

This image does not contain the Android Kbox binary, and containers cannot be started properly. The user needs to perform operations in Creating a Kbox Image and Applying Commercial Binaries.

kbox:origin

Created using a script

This image is created based on kbox:demo and the Android Kbox binary, and containers can be started properly.

kbox:latest

Created using a script

This image is created based on kbox:origin and the codec library to enable hardware decoding. Containers can be started properly.

Mounting the Kbox Demo Image

Upload the Kbox demo image package to the ~/dependency directory (this directory is only an example and can be customized) and mount the image package.

You can customize the image name and tag in the format of {Name}:{Tag}. In this example, the image name is kbox:demo.

The image name and tag can contain only digits and letters. The image name must start with a digit or lowercase letter.

1
2
cd ~/dependency
docker import android.tar kbox:demo

Creating a Kbox Image and Applying Commercial Binaries

If you use the official Kbox demo image provided by Huawei Mirrors repository, perform the operations in this part to ensure that the image contains the Android Kbox binary.

If you use an image prepared by yourself:

  • If you adopt configuration scheme 1, skip all steps in this part.
  • If you adopt configuration scheme 2/3/4, skip step 2 in this part.
  1. Decompress Kbox-AOSP11.zip and upload the deploy_scripts directory in the Kbox-AOSP11 folder to the ~/dependency directory on the server.
  2. Upload the Android Kbox binary file package Boostkit-boostcph-kbox_*.zip to ~/dependency/deploy_scripts.
  3. (Hardware configuration scheme 2/3/4) If hardware configuration scheme 2/3/4 is used, decompress the GPU driver package VAGPU-25.03.01.01-RC20.tgz to obtain va_driver.tgz and upload va_driver.tgz to the ~/dependency/deploy_scripts directory on the server.
  4. Create a Kbox image that contains the Android Kbox binary. In the following commands, kbox:demo is the official Kbox demo image imported in the previous step, and kbox:origin is the new image that contains the Android Kbox binary.
    • For configuration scheme 1:
      1
2
3
      cd ~/dependency/deploy_scripts
chmod +x make_image.sh
./make_image.sh kbox:demo kbox:origin
    • For configuration scheme 2/3/4:
      1
2
3
      cd ~/dependency/deploy_scripts
chmod +x make_image.sh
./make_image.sh kbox:demo kbox:origin va_driver.tgz

(Optional for Configuration Scheme 1) Creating a Kbox Image and Enabling Hardware Decoding

If no encoding card is used in the environment, you cannot create and use an image with the hardware decoding function enabled.

  1. Decompress Kbox-AOSP11.zip and upload the Kbox-AOSP11/make_img_sample directory to the ~/dependency directory on the server.
  2. Obtain NETINT-vXXX.tar.gz, rename it NETINT.tar.gz, and save it to the ~/dependency/make_img_sample/decode_iso_build directory. Then grant the execute permission on the image creation script in the directory.
    1
2
    cd ~/dependency/make_img_sample/decode_iso_build
chmod +x Dockerfile make_image.sh

    The NETINT.tar.gz package for Quadra is different from that for T432. Select the correct version.

  3. Create an image with hardware decoding enabled.
    Create a kbox:latest image based on the kbox:origin image. The two image names can be customized.
    1
    ./make_image.sh kbox:origin kbox:latest

    The parameters entered during instance startup must be the same as the name and tag you specify when creating an image. In the following, the image name kbox:latest is used as an example.