Difference between revisions of "iMX6 TinyRex Yocto"
| Line 5: | Line 5: | ||
== Download and install repo utility == | == Download and install repo utility == | ||
| + | '''''Note: ''''' As Freescale disabled its official git servers, repositories were moved. The files for building can be accessed following [https://community.nxp.com/t5/i-MX-Processors-Knowledge-Base/unable-to-connect-to-git-freescale-com/ta-p/1104028 this workaround].<br /><br /> | ||
| + | |||
To get the BSP you need to have repo installed. To install it follow these steps: | To get the BSP you need to have repo installed. To install it follow these steps: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
Revision as of 09:03, 2 April 2021
Download and install repo utility
Note: As Freescale disabled its official git servers, repositories were moved. The files for building can be accessed following this workaround.
To get the BSP you need to have repo installed. To install it follow these steps:
mkdir -pv ~/workdir/bin
curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/workdir/bin/repo
chmod a+x ~/workdir/bin/repo
PATH=${PATH}:~/workdir/bin
Yocto Project 2.1
Every OS requires different set of installed packages. More information about Yocto requirements could be acquired in Freescale Yocto Project User's Guide.
Initialise Yocto project
Download the BSP Yocto Project Environment:
mkdir -pv ~/workdir/voipac/imx6/yocto/fsl-release-bsp-2.1 cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp-2.1 git config --global user.name "Your Name" git config --global user.email "Your Email" git config --list repo init -u git://git.freescale.com/imx/fsl-arm-yocto-bsp.git -b imx-4.1-krogoth
Init iMX6 TinyRex layer
Add iMX6 TinyRex support:
mkdir -pv .repo/local_manifests/
cat > .repo/local_manifests/imx6rex.xml << EOF
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote fetch="git://github.com/Voipac" name="voipac"/>
<project remote="voipac" revision="master" name="meta-fsl-arm-voipac" path="sources/meta-fsl-arm-voipac">
<copyfile src="voipac-setup.sh" dest="voipac-setup.sh"/>
</project>
</manifest>
EOF
Sync
Synchronise repositories:
cd ~/workdir/voipac/imx6/yocto/
ln -s fsl-release-bsp-2.1 fsl-release-bsp
cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp
PATH=${PATH}:~/workdir/bin
repo sync
Configure
Add Voipac meta layer into BSP:
source voipac-setup.sh
Build workarounds
Building process could get halted. This session contains few workarounds for commonly observed failures. These commands fix compiling on Ubuntu 16.04 operating system.
Issue: Preferred bootloader and kernel are overwritten during compilation fsl-image recipe
Cause and fix: fsl-image overwrite bootloader/kernel provided by meta-fsp-voipac. To remove this limitation replace '=' with '?='
Original version:
meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_u-boot_mx6 = "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/bootloader_mx6 = "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/kernel_mx6 = "linux-imx"
Modified version:
meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_u-boot_mx6 ?= "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/bootloader_mx6 ?= "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/kernel_mx6 ?= "linux-imx"
Issue: Web browser recipes are disabled
Fix: Comment out to enable
meta-browser/recipes-browser/chromium/chromium_48.0.2548.0.bb:#PNBLACKLIST[chromium] ?= "BROKEN: fails to build with gcc-6" meta-browser/recipes-browser/chromium/cef3_280796.bb:#PNBLACKLIST[cef3] ?= "BROKEN: fails to build with gcc-6" meta-browser/recipes-mozilla/firefox/firefox_38.8.0esr.bb:#PNBLACKLIST[firefox] ?= "BROKEN: fails to build with gcc-6"
Build customisation
Configuration files are created during setup (setup-environment, fsl-setup-release.sh). The file to update can be found:
/workdir/voipac/imx6/yocto/fsl-release-bsp/build-x11/conf/local.conf
By modifying local.conf file, custom features can be easily added:
#CORE_IMAGE_EXTRA_INSTALL += " chromium libexif"
CORE_IMAGE_EXTRA_INSTALL += " firefox stress"
LICENSE_FLAGS_WHITELIST = "commercial"
IMAGE_INSTALL_append = " \
video-input-demo \
multimedia-demo \
lpc-demo \
"
IMAGE_ROOTFS_EXTRA_SPACE_append += "+ 500000"
Working environment setup has been finished and is ready for building images.
Yocto Project 2.0
Getting the BSP
Every OS requires different set of installed packages. More information about Yocto requirements could be acquired in Freescale Yocto Project User's Guide.
Initialise Yocto project
Download the BSP Yocto Project Environment:
mkdir -pv ~/workdir/voipac/imx6/yocto/fsl-release-bsp-2.0 cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp-2.0 git config --global user.name "Your Name" git config --global user.email "Your Email" git config --list repo init -u git://git.freescale.com/imx/fsl-arm-yocto-bsp.git -b imx-4.1.15-1.0.0_ga
Init iMX6 TinyRex layer
Add iMX6 TinyRex support:
mkdir -pv .repo/local_manifests/
cat > .repo/local_manifests/imx6rex.xml << EOF
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote fetch="git://github.com/Voipac" name="voipac"/>
<project remote="voipac" revision="refs/tags/v2.1" name="meta-fsl-arm-voipac" path="sources/meta-fsl-arm-voipac">
<copyfile src="voipac-setup.sh" dest="voipac-setup.sh"/>
</project>
</manifest>
EOF
Sync
Synchronise repositories:
cd ~/workdir/voipac/imx6/yocto/
ln -s fsl-release-bsp-2.0 fsl-release-bsp
cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp
PATH=${PATH}:~/workdir/bin
repo sync
Configure
Add Voipac meta layer into BSP:
source voipac-setup.sh
Build workarounds
Building process could get halted. This session contains few workarounds for commonly observed failures. These commands fix compiling on Ubuntu 16.04 operating system.
Issue: Qemu-native linking failure
Fix: Add BUILD_LDFLAGS_prepend_pn-qemu-native directive into build-dir/conf/local.conf
BUILD_LDFLAGS_prepend_pn-qemu-native = "-Wl,-rpath-link,/lib/x86_64-linux-gnu "
Issue: Preferred bootloader and kernel are overwritten during compilation fsl-image recipe
Cause and fix: fsl-image overwrite bootloader/kernel provided by meta-fsp-voipac. To remove this limitation replace '=' with '?='
Original version:
meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_u-boot_mx6 = "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/bootloader_mx6 = "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/kernel_mx6 = "linux-imx"
Modified version:
meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_u-boot_mx6 ?= "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/bootloader_mx6 ?= "u-boot-imx" meta-fsl-bsp-release/imx/meta-sdk/conf/distro/include/fsl-imx-preferred-env.inc:PREFERRED_PROVIDER_virtual/kernel_mx6 ?= "linux-imx"
Build customisation
Configuration files are created during setup (setup-environment, fsl-setup-release.sh). The file to update can be found:
/workdir/voipac/imx6/yocto/fsl-release-bsp/build-x11/conf/local.conf
By modifying local.conf file, custom features can be easily added:
CORE_IMAGE_EXTRA_INSTALL += " chromium"
CORE_IMAGE_EXTRA_INSTALL += " packagegroup-fslc-gstreamer1.0-full"
LICENSE_FLAGS_WHITELIST = "commercial"
IMAGE_INSTALL_append = " \
video-input-demo \
multimedia-demo \
"
Working environment setup has been finished and is ready for building images.
Yocto Project 1.7
Every OS requires different set of installed packages. More information about Yocto requirements could be acquired in Freescale Yocto Project User's Guide.
Initialise Yocto project
Download the BSP Yocto Project Environment:
mkdir -pv ~/workdir/voipac/imx6/yocto/fsl-release-bsp-1.7 cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp-1.7 git config --global user.name "Your Name" git config --global user.email "Your Email" git config --list repo init -u git://git.freescale.com/imx/fsl-arm-yocto-bsp.git -b imx-3.14.28-1.0.1_patch
Init iMX6 TinyRex layer
Add iMX6 TinyRex support:
mkdir -pv .repo/local_manifests/
cat > .repo/local_manifests/imx6rex.xml << EOF
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote fetch="git://github.com/Voipac" name="voipac"/>
<project remote="voipac" revision="v1_3_patch" name="meta-fsl-arm-voipac" path="sources/meta-fsl-arm-voipac">
<copyfile src="voipac-setup.sh" dest="voipac-setup.sh"/>
</project>
</manifest>
EOF
Sync
Synchronise repositories:
cd ~/workdir/voipac/imx6/yocto/
ln -s fsl-release-bsp-1.7 fsl-release-bsp
cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp
PATH=${PATH}:~/workdir/bin
repo sync
Configure
Add Voipac meta layer into BSP:
source voipac-setup.sh
Build workarounds
Building process could get halted. This session contains few workarounds for commonly observed failures. These commands fix compiling on Ubuntu 16.04 operating system.
Issue: GCC compilator downgrade
Cause and fix: Ubuntu uses GCC-5 by default but some Yocto (branch imx-3.14.28-1.0.1_patch) packages are not compatible with this compiler. To keep the functionality, switching to older version is required:
sudo apt-get install gcc-4.8 g++-4.8 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 100 --slave /usr/bin/g++ g++ /usr/bin/g++-4.8 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-5 50 --slave /usr/bin/g++ g++ /usr/bin/g++-5 sudo update-alternatives --config gcc
Issue: Qemu-native compilation failure
Cause and fix: Ubuntu uses newer version of the SDL libraries which are not compatible with Yocto (branch imx-3.14.28-1.0.1_patch).
This commands needs to be run after every "source *" command to commend out SDL support:
sed -i 's/^PACKAGECONFIG_append_pn-qemu-native/#PACKAGECONFIG_append_pn-qemu-native/' conf/local.conf sed -i 's/^PACKAGECONFIG_append_pn-nativesdk-qemu/#PACKAGECONFIG_append_pn-nativesdk-qemu/' conf/local.conf
Build customisation
Configuration files are created during setup (setup-environment, fsl-setup-release.sh). The file to update can be found:
/workdir/voipac/imx6/yocto/fsl-release-bsp/build-x11/conf/local.conf
By modifying local.conf file, custom features can be easily added:
CORE_IMAGE_EXTRA_INSTALL += " chromium"
CORE_IMAGE_EXTRA_INSTALL += " packagegroup-fslc-gstreamer1.0-full"
LICENSE_FLAGS_WHITELIST = "commercial"
IMAGE_INSTALL_append = " \
video-input-demo \
multimedia-demo \
"
Working environment setup has been finished and is ready for building images.
Building images
cd ~/workdir/imx6/yocto/fsl-release-bsp
Supported machines (Production)
imx6-openrexbasic imx6-openrexmax imx6-openrexmax4g imx6-openrexultra imx6-rexbasic imx6-rexpro imx6-rexultra imx6-tinyrexlite imx6-tinyrexbasic imx6-tinyrexpro imx6-tinyrexmax imx6-tinyrexmax4g imx6-tinyrexultra
Supported machines (Prototypes)
imx6dl-rex imx6s-tinyrex imx6q-tinyrex
Supported distros (Freescale)
fsl-imx-x11 - Only X11 graphics fsl-imx-wayland - Wayland weston graphics fsl-imx-xwayland - Wayland graphics and X11. X11 applications using EGL are not supported fsl-imx-fb - Frame Buffer graphics - no X11 or Wayland
Console image
Setup and Build for Console image:
MACHINE=<machine name> source setup-environment build-dir MACHINE=<machine name> bitbake core-image-base
Toolchain
Setup and Build for Toolchain:
MACHINE=<machine name> bitbake core-image-base -c populate_sdk
FSL GUI image
Setup and Build for FSL GUI image:
Yocto 2.1
DISTRO=<distro name> MACHINE=<machine name> source fsl-setup-release.sh -b bld-u1604-x11 DISTRO=<distro name> MACHINE=<machine name> bitbake fsl-image-gui
Yocto 2.0/1.7
MACHINE=<machine name> source fsl-setup-release.sh -b build-x11 -e x11 MACHINE=<machine name> bitbake fsl-image-gui
Voipac image
Setup and Build for Voipac image:
MACHINE=<machine name> source setup-environment build-vpac MACHINE=<machine name> bitbake vpac-image-full-cmdline MACHINE=<machine name> bitbake vpac-image-full-cmdline -c populate_sdk
Output files
Output images and archives are stored here:
~/workdir/voipac/imx6/yocto/fsl-release-bsp/build-dir/tmp/deploy/images ~/workdir/voipac/imx6/yocto/fsl-release-bsp/build-dir/tmp/deploy/sdk
Storing images to SD card
cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp/build-dir/tmp/deploy/images/<machine name> sudo dd if=<image name>.sdcard of=/dev/sd<partition> bs=1M && sync
or
cd ~/workdir/voipac/imx6/yocto/fsl-release-bsp/build-dir/tmp/deploy/images/<machine name> gunzip -c core-image-base-<machine name>.sdcard.gz | sudo dd of=/dev/sd<partition> bs=1M && sync