search

nxp-auto-linux / auto_yocto_bsp

Automotive Linux BSP for NXP S32 Release Yocto Project manifests
35 stars 15 forks source link

readme

OpenEmbedded/Yocto Linux BSP for NXP Auto platforms

First time setup

To get the BSP you need to have repo installed and its prerequisites. This only needs to be done once.

Install dependencies:

Install the repo utility:

$: mkdir ~/bin $: curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo $: chmod a+x ~/bin/repo $: PATH=${PATH}:~/bin

Download the Yocto Project Environment into your directory:

$: mkdir fsl-auto-yocto-bsp $: cd fsl-auto-yocto-bsp $: repo init -u https://github.com/nxp-auto-linux/auto_yocto_bsp -b release/bsp. $: repo sync

This will download the sources for the latest NXP Auto Linux BSP (from the branch release/bsp.), structured ontop of the Yocto rocko release and upstream NXP QorIQ SDK.

Note: for another Linux BSP release or engineering build, please use the corresponding branch and manifest.

The repository provides more manifest files, particularized for different use cases. The desired manifest file is selected by specifying it in the repo init command, using parameter -m The manifests are delivered in two formats:

.xml and -bitbucket.xml. The second would allow fetching internal bitbucket development repositories as specified in the note above. The manifest files (different than the default one) are documented below. NXP internal repositories default-bitbucket.xml, please use: $: repo init -u ssh://git@bitbucket.sw.nxp.com/alb/auto_yocto_bsp.git -b develop -m default-bitbucket.xml $: repo sync adas.xml / adas-bitbucket.xml This manifest extends the default manifest with the meta-adas layer, allowing complete integration of VSDK into the Yocto build. For more details, please see the meta-adas documentation in sources/meta-adas/README $: repo init -u https://github.com/nxp-auto-linux/auto_yocto_bsp -b release/bsp. -m adas.xml aa-integration.xml / aa-integration-bitbucket.xml This manifest extends the default manifest with the meta-aa-integration layer, allowing complete integration of Adaptive Autosar R18-10 into the Yocto build. For more details, please see the meta-aa-integration documentation in sources/meta-aa-integration/README $: repo init -u https://github.com/nxp-auto-linux/auto_yocto_bsp -b release/bsp. -m aa-integration.xml Creating a Build Directory for a BSP release: --------------------------------------------- To install all prerequisites before starting any build, run: $ ./sources/meta-alb/scripts/host-prepare.sh Now you can create a build directory in the BSP root by running the command: $ . nxp-setup-alb.sh -m where: is any NXP Auto target, e.g. s32g399aevb3, s32r45evb, s32g399ardb3ubuntu etc. Build an image: --------------- In the buid directory created by the setup script, you can run the command: $ bitbake For the NXP Auto BSP, you may use as any of the Auto images , e.g. `fsl-image-base`, `fsl-image-auto`, `fsl-image-ubuntu`, `fsl-image-ubuntu-base`. Ubuntu images can only be built for ubuntu machines, while yocto images can only be built for non-Ubuntu machines. Running the above command would be enough to completely build u-boot, kernel, modules, and a rootfs ready to be deployed. Look for a build result in `build_/tmp/deploy/images/`. The file `.sdcard` is a disk image with all necessary partitions and contains the bootloader, kernel and rootfs. You can just low-level copy the data on this file to the SD card device using dd as on the following command example: $ sudo dd if=.sdcard of=/dev/sd bs=1M && sync Ensure that any partitions on the card are properly unmounted before writing the card image, or you may have a corrupted card image in the end. Also ensure to properly "sync" the filesystem before ejecting the card to ensure all data has been written. To deploy only the rootfs to the target partition, run: $ sudo tar -xzf .tar.gz -C where is the destination partition (as mounted on the host). Note that builds with bitbake accumulate in the deployment directory. You may want to delete older irrelevant images after repeated builds. The very first build ever will take very long because a lot of one-time house keeping and building has to happen. You want to have a powerful build machine. Note the SOURCE_THIS file to be used when going back to building with a new shell. Images provided =============== fsl-image-ubuntu-base: A system image with a minimalist Ubuntu 20.04 LTS root filesystem fsl-image-ubuntu: A complete, development-suitable system image based on Ubuntu 20.04 LTS which contains (among others): the complete kernel source code (for rebuilding the kernel directly on the target machine), compilers and toolchains (for C, C++, Java), ROS Kinetic and Docker NOTE: Please build fsl-image-ubuntu-base or fsl-image-ubuntu only for machines with name ending in `ubuntu`. For the other machines, please use any of the images with Yocto rootfilesystem. NOTE: For the most convenient development environment, use of fsl-image-auto below is suggested. Production embedded projects would likely use much smaller images. fsl-image-auto: A complete system image (containing u-boot, the Linux kernel and DTBs) with a full Yocto-sourced filesystem. --------------- The rootfs is fairly reasonable in completeness for basic efforts and contains sufficient amount of basic tools for remote connection and mounting of NFS or other drives.