Revision as of 02:42, 18 March 2022

Getting Started

Prerequisites

All operations in this guide are based on Ubuntu 12.04 LTS 64bit only.
First please install Ubuntu 12.04 LTS 64bit^* with minimum 2GB memory.

* ubuntu-12.04.1-desktop-amd64.iso

To install required packages

Please login and perform the following commands:

$ sudo apt-get install ssh
$ sudo apt-get install ia32-libs libx11-dev:i386 libreadline6-dev:i386 \
libgl1-mesa-glx:i386 zlib1g-dev:i386 uuid-dev:i386 liblzo2-dev:i386 \ 
libncurses5-dev:i386
$ sudo apt-get install \
bison build-essential ccache dpkg flex gcc g++ gettext intltool \
libarchive-zip-perl libfreetype6-dev libdbus-glib-1-dev liborbit2-dev \
libxml2-dev libx11-dev libgtk2.0-dev liblzo2-2 libtool m4 \
patch rpm tcl uboot-mkimage uuid zlib1g zlib1g-dev \
git gnupg flex bison gperf build-essential  zip \
curl libc6-dev libncurses5-dev x11proto-core-dev libx11-dev:i386 \
libreadline6-dev:i386 libgl1-mesa-glx:i386 libgl1-mesa-dev g++-multilib \
mingw32 tofrodos python-markdown libxml2-utils xsltproc zlib1g-dev:i386 \
gcc-4.6 g++-4.6 cpp-4.6 gcc-4.6-multilib uuid-dev liblzo2-dev \
uboot-mkimage libarchive-zip-perl \
wget git-core unzip texinfo gawk diffstat build-essential chrpath \
sed cvs subversion coreutils texi2html \
docbook-utils python-pysqlite2 help2man make gcc g++ \
desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev mercurial \
autoconf automake groff curl lzop asciidoc xterm
$ sudo apt-get install libncurses5-dev:i386 liblzo2-dev:i386 uuid-dev:i386
$ sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so
$ tar zcvf ~/usr_lib_i386-linux-gnu_for_Building_Android_KK.tar.gz \
/usr/lib/i386-linux-gnu/{libuuid.a,libuuid.so,liblzo2.so,liblzo2.a}
$ sudo apt-get install uuid-dev liblzo2-dev
$ sudo tar zxvf ~/usr_lib_i386-linux-gnu_for_Building_Android_KK.tar.gz -C /

To install JDK

Please download "jdk-6u45-linux-x64.bin" manually from <a href="http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u45-oth-JPR" alt="http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u45-oth-JPR" title="http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u45-oth-JPR">Oracle Official Website</a>

And put it to directory ~/FILES/ and perform the following commands:

$ cd /usr/lib
$ sudo ~/FILES/jdk-6u45-linux-x64.bin
$ sudo mkdir jvm
$ cd jvm
$ sudo mv ../jdk1.6.0_45 .
$ cd jdk1.6.0_45/
$ sudo update-alternatives --install /usr/bin/java    java    /usr/lib/jvm/jdk1.6.0_45/jre/bin/java    2
$ sudo update-alternatives --install /usr/bin/javac   javac   /usr/lib/jvm/jdk1.6.0_45/bin/javac   2
$ sudo update-alternatives --install /usr/bin/jar     jar     /usr/lib/jvm/jdk1.6.0_45/bin/jar     2
$ sudo update-alternatives --install /usr/bin/javap   javap   /usr/lib/jvm/jdk1.6.0_45/bin/javap   2
$ sudo update-alternatives --install /usr/bin/javadoc javadoc /usr/lib/jvm/jdk1.6.0_45/bin/javadoc 2
$ sudo update-alternatives --config javap
$ sudo update-alternatives --config javadoc
$ sudo update-alternatives --config java
$ sudo update-alternatives --config javac
$ sudo update-alternatives --config jar
$ cd ~/
$ sudo sh -c "echo "JAVA_HOME=/usr/lib/jvm/jdk1.6.0_45" >> /etc/environment"

If you have some troubles on setting up build environment, we recommend that you use Docker, and it is more safely & quickly. Please refer to <a href="IoTGateway%2FDocker">Docker</a>

Conventions

${PREBUILT_IMAGE} : compressed prebuilt image (*.img.gz)

${BSP_TARBALL} : BSP tarball (*.tgz)

${BSP_HOME} : home directory of the BSP

${BDIR} : build directory (e.g. build_x11)

${MX6PROC} : i.MX6 Processor

mx6q for iMX6 Quad Core / Dual Core

mx6dl for iMX6 Dual Lite / Solo

${IMX6PROC} : i.MX6 Processor

imx6q / imx6dl

${BOARD} : available target boards list below

rom5420 / ubc220 / rom7421/ rom3420 / rom7420 / rsb4410 / rsb4411 / rsb6410 / ubcds31 / wise3310

${BOARD_REV} : board revision

a1 / a2 / b1

${MC} : machine code combined with ${IMX6PROC}${BOARD}${BOARD_REV}

for example,

imx6dlrom5420b1 for ROM-5420-Solo B1

imx6dlubc220a1 for UBC-220-Dual-Light A1

imx6qprom7421a1 for ROM-7421-Dual/Quad-Plus A1

imx6qrom3420a1 for ROM-3420-Dual/Quad A1

imx6qrom5420a1 for ROM-5420-Dual/Quad A1

imx6qrom5420b1 for ROM-5420-Dual/Quad B1

imx6qrom7420a1 for ROM-7420-Dual/Quad A1

imx6qrsb4410a2 for RSB-4410-Dual A2

imx6qrsb4410a1 for RSB-4410-Dual A1

imx6qrsb4411a1 for RSB-4411-Dual/Quad A1

imx6qrsb6410a1 for RSB-6410-Dual A1

imx6qubcds31a1 for UBC-DS31-Dual A1

imx6qwise3310a1 for WISE-3310-Dual A1

${MEM_SIZE} : memory size

1G / 2G / 512M

${SD_DEVICE} : device name of SD card in Ubuntu (e.g. /dev/sdf)

${SDCARD_IMAGE} : sdcard image built by bitbake (*.sdcard)

${UBOOT} :u-boot version(e.g. 2015.04)

${KERNEL} : linux kernel version(e.g. 3.14.52)

${TOOLCHAIN} : toolchain installed directory(e.g. /opt/fsl-imx-x11/3.14.52-1.1.0)

debug console / serial console

serial terminal program (e.g. minicom, putty, teraterm ...) that serial port is configured to 115200 8N1

terminal console

terminal program (e.g. gnome-terminal, xfce4-terminal ...)

Introducing BSP

The BSP is based on Yocto Project with Freescale enhanced features for i.MX6, plus specific target board features from Advantech Inc..

Naming Rule

The tarball/prebuilt image name is consist of the model name followed by "LB" or "LI" plus version number and released date.

For example, 4410A1LBV6000_2016-03-07.tgz which "4410A1" stands for RSB-4410 A1, "LB" is acronym of Linux BSP, "V6000" stands for Version 6.000

.

For example, 4410A1LIV6000_DualQuad_2016-03-07.img.gz which "LI" is acronym for prebuilt Linux Image, DualQuad means this image is fit for Dual Core/Quad Core.

BSP tarball

Unpack BSP tarball to home directory by performing the following command:

$ tar xvf ${BSP_TARBALL} -C ~/

Prebuilt image

Perform the following command to build one boot-up SD card

$ gunzip -c ${PREBUILT_IMAGE} | dd of=${SD_DEVICE} bs=1M

Build Instructions

To create one new build environment

Perform the following commands in terminal console

$ cd ${BSP_HOME}

$ MACHINE=${MC} source fsl-setup-release.sh -b ${BDIR} -e x11

You need to read and accept the EULA.

<img src="/wiki/images/1/1d/Accept_EULA.png" _fck_mw_filename="Accept EULA.png" _fck_mw_origimgwidth="444" _fck_mw_origimgheight="29" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

To continue an exist build environment

Perform the following commands in terminal console

$ cd ${BSP_HOME}

$ source setup-environment ${BDIR}

To build sdcard image

To create/continue a build environment

Perform the following command in terminal console

$ bitbake fsl-image-qt5

The file, fsl-image-qt5-${MC}.sdcard, will be located in directory, ./tmp/deploy/images/${MC}, while building process finished successfully.

To build toolchain installer

To create/continue a build environment

Perform the following command in terminal console

$ bitbake meta-toolchain-qt5

The below installer will be located in the directory "./tmp/deploy/sdk".

fsl-imx-x11-glibc-x86_64-meta-toolchain-qt5-cortexa9hf-vfp-neon-toolchain-${KERNEL}-1.1.0.sh

To build u-boot

To create/continue a build environment

Perform the following command in terminal console

$ bitbake u-boot-imx

The two files, u-boot_crc.bin & u-boot_crc.bin.crc, will be located in directory, ./tmp/deploy/images/${MC}.

To build linux kernel

To create/continue a build environment

Perform the following command in terminal console

to do menuconfig

<syntaxhighlight lang="bash">
$ bitbake linux-imx -c menuconfig
</syntaxhighlight>

＊ If you operate on docker images, please install tmux application before running this command.

$ sudo apt-get install tmux

to do build

<syntaxhighlight lang="bash">
$ bitbake linux-imx -c compile -f
$ bitbake linux-imx -c compile_kernelmodules -f
$ bitbake linux-imx -c deploy
</syntaxhighlight>

The two files, zImage & zImage-${IMX6PROC}-${BOARD}-${BOARD_REV}.dtb, will be located in directory, ./tmp/deploy/images/${MC}.

Creating boot-up on-board flash from prebuilt image

To create one boot-up SD card

Perform the following command in terminal console

$ gunzip -c ${PREBUILT_IMAGE | dd of=${SD_DEVICE} bs=1M

$ sync

To transfer whole system to on-board flash

Boot up from SD card

Perform the following commands in debug console

# cd /mk_inand

# ./mksd-linux.sh /dev/mmcblk0

press y followed by Enter, if following message shows up:

<img src="/wiki/images/a/a7/All_data_will_be_destroyed.png" _fck_mw_filename="All data will be destroyed.png" _fck_mw_origimgwidth="640" _fck_mw_origimgheight="31" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

While "[Done]" shows up means the transferring is finished.

Creating boot-up on-board flash from built sdcard image

To create one boot-up SD card

Perform the following commands in terminal console

$ pushd ${BSP_HOME}/${BDIR}/tmp/deploy/images/${MC}

$ dd if=${SDCARD_IMAGE} of=${SD_DEVICE} bs=1M

$ sync

$ popd

To transfer whole system to on-board flash

Boot up from SD card

Insert USB stick that contains ${SDCARD_IMAGE}, USB stick will be auto mounted to /run/media/sda1.

Perform the following commands in debug console

# umount /dev/mmcblk0p?

# cd /run/media/sda1

# dd if=${SDCARD_IMAGE} of=/dev/mmcblk0 bs=4M conv=fsync

# P2START=$(fdisk -lu | grep mmcblk0p2 | awk '{print $2}')

# echo -e "d\n2\nn\np\n2\n${P2START}\n\nw\n" | fdisk -u /dev/mmcblk0

# umount /dev/mmcblk0p2

# e2fsck -f -y /dev/mmcblk0p2

# resize2fs /dev/mmcblk0p2

# poweroff

Customization

Package addition

To add tcf-agent & openssh-sftp-server

Navigate to the directory where fsl-image-adv.inc located

$ cd ${BSP_HOME}/sources/meta-advantech/recipes-fsl/images

Add following line to fsl-image-adv.inc

IMAGE_INSTALL += " tcf-agent openssh-sftp-server "

<a href="IoTGateway%2FBSP%2FLinux%2FiMX6%2FYocto%20LBV5%20User%20Guide%23To%20continue%20an%20exist%20build%20environment">Continue an exist build environment</a> and <a href="IoTGateway%2FBSP%2FLinux%2FiMX6%2FYocto%20LBV5%20User%20Guide%23To%20build%20sdcard%20image">build sdcard image</a>

To add chromium browser

Navigate to the directory where local.conf located

$ cd ${BSP_HOME}/${BDIR}/conf

Add following two lines to local.conf

CORE_IMAGE_EXTRA_INSTALL += "chromium"

LICENSE_FLAGS_WHITELIST="commercial"

<a href="#To_continue_an_exist_build_environment">Continue an exist build environment</a> and <a href="#To_build_sdcard_image">build sdcard image</a>

Setting up SDK

Please follow the section,<a href="IoTGateway%2FBSP%2FLinux%2FiMX6%2FYocto%20LBV5%20User%20Guide%23To%20build%20toolchain%20installer">To build toolchain installer</a>, to build one toolchain installer

Perform the following command in terminal console

$ cd ${BSP_HOME}/${BDIR}/tmp/deploy/sdk

$ sudo ./fsl-imx-x11-glibc-x86_64-meta-toolchain-qt5-cortexa9hf-vfp-neon-toolchain-${KERNEL}-1.1.0.sh

Enter new installed directory or just press Enter to use default directory.

While Proceed[y/n]? shows up, please enter the correct one.

Waiting for the SDK installed (while the following messages show up completely)

<img src="/wiki/images/1/17/Setting_up_sdk_3.png" _fck_mw_filename="Setting up sdk 3.png" _fck_mw_origimgwidth="572" _fck_mw_origimgheight="65" alt="RTENOTITLE" title="RTENOTITLE" style="vertical-align:middle;" />

Setting up cross compiling environment

SDK has been set up (ref. <a href="#Setting_up_SDK">Setting up SDK</a>)

Perform the following command in terminal console

$ source ${TOOLCHAIN}/environment-setup-cortexa9hf-vfp-neon-poky-linux-gnueabi

Building & updating u-boot manually

To build u-boot

The cross compiling environment has been set up. (ref. <a href="#Setting_up_cross_compiling_environment">Setting up cross compiling environment</a>)

Make one copy from Yocto working directory

$ mkdir -p ~/code

$ pushd ${BSP_HOME}/${BDIR}/tmp/work/${MC}-poky-linux-gnueabi/

$ rm -rf ~/code/u-boot-imx

$ cp -a ./u-boot-imx/${UBOOT}-r0/git ~/code/u-boot-imx

$ popd

Configure u-boot

$ cd ~/code/u-boot-imx

$ make distclean

$ make ${MX6PROC}${BOARD}${BOARD_REV}_${MEM_SIZE}_config

Start building u-boot

$ make -j4 LDFLAGS=

The two files, u-boot_crc.bin & u-boot_crc.bin.crc, are located in directory "~/code/u-boot-imx".

To update u-boot to target device

Perform the following command to transfer to exist boot-up SD card

$ dd if=u-boot_crc.bin.crc of=${SD_DEVICE} bs=512 seek=2 conv=fsync

$ dd if=u-boot_crc.bin of=${SD_DEVICE} bs=512 seek=3 conv=fsync

Make sure new u-boot does work then perform the following commands to transfer to on-board flash

# dd if=u-boot_crc.bin.crc of=/dev/mmcblk0 bs=512 seek=2 conv=fsync

# dd if=u-boot_crc.bin of=/dev/mmcblk0 bs=512 seek=3 conv=fsync

Building & updating kernel/modules/dtb manually

To build kernel/modules/dtb

The cross compiling environment has been set up. (ref. <a href="#Setting_up_cross_compiling_environment">Setting up cross compiling environment</a>)

Make one copy from Yocto working directory

$ mkdir -p ~/code

$ pushd ${BSP_HOME}/${BDIR}/tmp/work-shared/${MC}/

$ rm -rf ~/code/linux-imx

$ cp -a ./kernel-source ~/code/linux-imx

$ popd

Configure linux kernel

$ cd ~/code/linux-imx

$ make distclean

$ make imx_v7_adv_defconfig

$ make menuconfig PKG_CONFIG_SYSROOT_DIR= PKG_CONFIG_PATH=

Start building linux kernel

$ make -j4 zImage LOADADDR=0x10008000 LDFLAGS=

The kernel image file, zImage, is located in the directory "./arch/arm/boot/".

Start building kernel modules

$ make -j4 modules LDFLAGS=

Copy all modules to a temporary rootfs directory, "~/temp/rootfs"

$ make modules_install INSTALL_MOD_PATH=~/temp/rootfs

Start building device tree blob

$ make -j4 ${IMX6PROC}-${BOARD}-${BOARD_REV}.dtb

The device tree blob, ${IMX6PROC}-${BOARD}-${BOARD_REV}.dtb, is located in the directory "./arch/arm/boot/dts/".

To update kernel/modules/dtb to target device

Copy zImage & ${IMX6PROC}-${BOARD}-${BOARD_REV}.dtb to the 1^st partition of SD card

Copy modues to the 2^nd partition of SD card.

Make sure all new linux kernel, device tree and kernel modules work well, then copy all of them to the on-board flash

System Recovery

Please refer to <a href="#Creating_boot-up_on-board_flash_from_prebuilt_image">Creating boot-up on-board flash from prebuilt image</a> / <a href="#Creating_boot-up_on-board_flash_from_built_sdcard_image">sdcard image</a> to create a boot-up SD card and transfer whole system to on-board flash.