Building and installing a custom system image

Note

To build a new image you need a host device as described here

To build a image run the following commands:

  1. Start a build environment container:

    $ docker run --rm -it -v $(pwd):$(pwd) ghcr.io/synaptics-astra/crops:1.0.0 --workdir=$(pwd)
    
  2. Clone the sources from GitHub

    pokyuser@xyz:/path/to/workspace $ git clone -b v1.0.0 --recurse-submodules \
                                                https://github.com/synaptics-astra/sdk
    
  3. Setup the build tree:

    pokyuser@xyz:/path/to/workspace $ cd sdk
    
    pokyuser@xyz:/path/to/workspace/sdk $ source meta-synaptics/setup/setup-environment
    
    Select the MACHINE you want to build:
    
    1) sl1620
    2) sl1640
    3) sl1680
    
    You selection: 1
    
  4. Modify the image configuration metadata as desired (e.g. by adding more packages to the image by tweaking the conf/local.conf file). For more information on how to configure the image refer to Astra Yocto Linux Developer Guide

  5. Build the image:

    pokyuser@xyz:/path/to/workspace/sdk/build-slXYZ $ bitbake astra-media
    

The image will be available in build-${MACHINE}/tmp/deploy/images/${MACHINE}/SYNAIMG/ and can be flashed with the procedure described in Updating the Firmware.

For more details, troubleshooting and information check the Synaptics Astra Yocto Guide.