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:0.9.0 --workdir=$(pwd)
   

2. Clone the sources from GitHub

   pokyuser@xyz:/path/to/workspace $ git clone -b v0.9.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.