Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

TI makes their AMSDK Arago build scripts available via the following GIT repository:

Info
iconfalse

http://arago-project.org/git/projects/oe-layersetup.git

 

If you’re interested in TI’s overall EZSDK build and test process you should analyze the following repository: 

 

Info
iconfalse

http://arago-project.org/git/projects/tisdk-build-scripts.git

 

It is this repository that actually pulls in the oe-layersetup project to perform the Linux AMSDK builds for TI’s entire suite of ARM CortextA chips. In this document we are only concerned with the oe-layersetup project.

Overview of the meta-embedian-SDK7 Yocto Layer


The supplied meta-embedian-sdk7 Yocto compliant layer has the following organization:

Info
iconfalse

.
|-- conf
|   |-- layer.conf
|   |-- site.conf
|   |-- machine
|   |   `-- smarct335x.conf
|-- README
|-- recipes-bsp
|   |-- u-boot
|       |-- u-boot_2014.04-smarct335x.bb
|       `-- u-boot_2013.10-smarct335x.bb

|-- recipes-connectivity
|   |-- lftp
|       `–lftp_4.0.5.bb
|-- recipes-core
|   |-- base-files
|       `-- base-files_3.0.14.bbappend
|   |-- busybox
|       |-- busybox_1.20.2.bbappend
|       |   |-- busybox
|       |   |   `-- defconfig

|   |-- images
|   |   |-- arago-base-smarct335x-image.bb
|   |   |-- arago-image.inc
|   |   |-- meta-toolchain-smarc-tisdk.bb
|   |   |-- smarct335x-initramfs-image.bb
|   |   `-- smarct335x-rootfs-image.bb
|   |-- init-ifupdown
|       |-- init-ifupdown_1.0.bbappend
|       |   |-- init-ifupdown
|       |   |   `-- interfaces
|   |-- initscripts
|   |   `-- initscripts_1.0.bbappend
|   `-- packagegroups
      |-- packagegroup-arago-smarct335x-base.bb
|       |-- packagegroup-arago-smarct335x-console.bb
|       |-- packagegroup-arago-smarct335x-matrix.bb
|       |-- packagegroup-arago-smarct335x-sdk.bb
|       `-- packagegroup-initramfs-boot.bb
|-- recipes-devtools
|   |-- nodejs
|   |   |-- nodejs_0.10.11.bb
|   |   |-- nodejs_0.10.17.bb
|   |   |-- nodejs_0.10.4.bb
|   |   |-- nodejs_0.8.14.bb
|   |   `-- nodejs_0.8.21.bb
|   |-- ltp-ddt
|   |   |-- ltp-ddt_0.0.4.bbappend
|   |   |-- ltp-ddt
|           `-- 0001-add-smarct335x-platform-support.patch
|   |-- pinmux-utility
|   |   `-- pinmux-utility_2.5.2.0.bbappend
|-- recipes-kernel
|   |-- linux
|       |-- linux.inc
|       |-- linux-dtb.inc
|       |-- copy-defconfig.inc
|       |-- setup-defconfig.inc
|       |-- linux-smarct335x-3.2
|       |   `-- defconfig
|       |-- linux-smarct335x_3.2.bb
|       |-- linux-smarct335x-staging_3.12.bb
|       `-- linux-smarct335x-staging
|       |   `-- defconfig
|   |-- cryptodev
|       `-- cryptodev_1.6.bbappend
|-- recipes-multimedia
|   |-- amsdk-av-files
|       |-- amsdk-av-files_1.1.bbappend
|   |-- x264
|   |   `-- x264_git.bbappend
|-- recipes-support
|   |-- boost
|   |   |-- boost_1.53.0.bb
|   |   |-- boost.inc
|   |   `-- files
|   |-- ntp
|   |   |-- files
|   |   |-- ntp_4.2.6p5.bb
|   |   `-- ntp.inc
`-- recipes-tisdk
    `-- ti-tisdk-makefile
        `-- ti-tisdk-makefile_1.0.bbappend

 

 

Notes on meta-embedian-sdk7 layer content

conf/machine/*

This folder contains the machine definitions for the smarct335x platform and backup repository in Embedian. These select the associated kernel, kernel config, u-boot, u-boot config, and UBI image settings.

recipes-bsp/u-boot/*

This folder contains recipes used to build DAS U-boot for smarct335x platform.

recipes-connectivity/lftp/*

This folder adds lftp ftp client utility for smarct335x platform. 

recipes-core/base-files/*

This recipe is used to amend the device hostname  for the platform.

recipes-core/busybox/*

This recipe modifies TI’s BusyBox configuration to remove telnet from the image.

recipes-core/images/*

These recipes are used to create the final target images for the devices. When you run Bitbake one of these recipes would be specified. For example, to build the root file system for the smarct335x platform:

Info
iconfalse

MACHINE=smarct335x bitbake -k smarct335x-rootfs-image


recipes-core/init-ifupdown*

This recipe is used to amend device network interfaces

recipes-devtools/nodejs/*

These recipes build the Node.js Javascript server execution environment.

recipes-kernel/linux/*

Contains the recipes needed to build the smarct335x Linux kernels.

recipes-multimedia/amsdk-av-files/*

This recipe is to add smarct335x compatible machine for the platform. 

recipes-multimedia/x264/* 

This original commit history has been rewritten.

recipes-support/boost/*

Adds Boost to the images. Boost provides various C++ libraries that encourage cross-platform development. 

recipes-support/ntp/*

Network time protocol support. 

recipes-tisdk/ti-tisdk-makefile/*

Add smarct335x device tree into Makefile.

Setting Up the Tools and Build Environment


To build the latest TI am335x 7.0 AMSDK you first need an Unbuntu Linux 12.04LTS or Ubuntu 14.04LTS installation (preferably 32bit). Since bitbake does not accept building images using root privileges, please do not login as a root user when performing the instructions in this section. 

Once you have Ubuntu 12.04 LTS or Ubuntu 14.04LTS running, install the additional required support packages using the following console command:

Info
iconfalse

$ sudo apt-get install gawk wget git-core diffstat unzip texinfo build-essential chrpath libsdl1.2-dev xterm python-m2crypto bc

If you are using a 64-bit Linux, then you'd also need to install 32-bit support libraries, needed by the pre-built Linaro toolchain and other binary tools.

Info
iconfalse
$ sudo dpkg --add-architecture i386 && sudo apt-get
install ia32-libs-multiarch
 update && sudo apt-get install lib32ncurses5

You’ll also need to change the default shell to bash from Ubuntu’s default dash shell (select the <No> option):

Info
iconfalse

$ sudo dpkg-reconfigure dash

 To build TI’s am335x SDK you will need to install the Linaro arm compiler that TI used for the release:

Info
iconfalse

$ wget http://releases.linaro.org/archive/13.04/components/toolchain/binaries/gcc-linaro-arm-linux-gnueabihf-4.7-2013.04-20130415_linux.tar.xz
$ sudo tar -C /opt -xJf gcc-linaro-arm-linux-gnueabihf-4.7-2013.04-20130415_linux.tar.xz


Add the following PATH definition to the .bashrc file in your $HOME directory:

 

Info
iconfalse

export PATH=/opt/gcc-linaro-arm-linux-gnueabihf-4.7-2013.04-20130415_linux/bin:$PATH


Next clone and intialize TI’s am335x SDK build process:

 

Info
iconfalse

$ git clone http://arago-project.org/git/projects/oe-layersetup.git oe-layersetup-smarct33-sdk7
$ cd oe-layersetup-smarct33-sdk7 
$ git checkout -b tisdk-07-01 72ea335f3879a8752d7dfc7f25d68913b222f867 
$ ./oe-layertool-setup.sh -f configs/amsdk/amsdk-07.01.00.00-config.txt

  

 

Note
titleUpdate (2015-12-07)

Some repo locations of QT demo application has been moved by TI. You need to apply the other patch (0001-sdk7-fix-repo-location.patch)

If your host machine is Ubuntu14.04, you need an additional patch (fix-binutils-textinfo-ubuntu14.04.patch) to build AMSDK7 rootfs

.

 (You do not need to apply this patch if built in Ubuntu 12.04LTS)

 

 

Info
iconfalse
oe-layersetup-smarct33-sdk7/source/meta-arago/

.

cd ~/oe-layersetup-smarct33-sdk7/source/meta-arago/
$ wget -c http://developer.embedian.com/download/attachments/8847362/fix-binutils-textinfo-ubuntu14.04.patch

~/
$ cd ~/


$ patch -p1 <fix-binutils-textinfo-ubuntu14.04.patch
$ wget -c http://developer.embedian.com/download/attachments/8847362/0001-sdk7-fix-repo-location.patch
$ patch -p1

<~/

<0001-sdk7-fix-repo-location.patch
$ rm fix-binutils-textinfo-ubuntu14.04.patch 0001-sdk7-fix-repo-location.patch

 

Add the Embedian’s meta-embedian-sdk7 layer to the build process.

 

Info
iconfalse

$ cd ~/oe-layersetup-smarct33-sdk7/sources 
$ git clone git@git.embedian.com:developer/meta-embedian-sdk7.git
 
$ cd ~/oe-layersetup-sdk7/build


Edit the ~/oe-layersetup-sdk7/build/conf/bblayers.conf file to include the meta-embedian-sdk7 layer in the layer list. It should look something like this (the example reflects the absolute paths on my machine):

 

Info
iconfalse

# This template file was created by taking the oe-core/meta/conf/bblayers.conf

# file and removing the BBLAYERS section at the end.

 

# LAYER_CONF_VERSION is increased each time build/conf/bblayers.conf

# changes incompatibly

LCONF_VERSION = "5"

 

BBPATH = "${TOPDIR}"

BBFILES ?= ""

 

# Layers configured by oe-core-setup script

BBLAYERS += " \

/home/oeeric/oe-layersetup-sdk7/sources/meta-embedian-sdk7 \
/home/oeeric/oe-layersetup-sdk7/sources/meta-arago/meta-arago-distro \
/home/oeeric/oe-layersetup-sdk7/sources/meta-arago/meta-arago-extras \
/home/oeeric/oe-layersetup-sdk7/sources/meta-qt5 \
/home/oeeric/oe-layersetup-sdk7/sources/meta-openembedded/toolchain-layer \
/home/oeeric/oe-layersetup-sdk7/sources/meta-openembedded/meta-networking \
/home/oeeric/oe-layersetup-sdk7/sources/meta-openembedded/meta-oe \
/home/oeeric/oe-layersetup-sdk7/sources/meta-ti \
/home/oeeric/oe-layersetup-sdk7/sources/meta-linaro/meta-linaro-toolchain \
/home/oeeric/oe-layersetup-sdk7/sources/oe-core/meta \
"

 

 

Note
titleNote:

If your platform is SMARC T3354 (with sgx features), you can simply add "sgx" in the MACHINE_FEATURES to have the powervr driver loaded by editing the ~/oe-layersetup-sdk7/source/meta-embedian/conf/machine/smarct335x.conf file. Find MACHINE_FEATURES and add "sgx" in the very bottom:

 

 

Info
iconfalse

MACHINE_FEATURES = "kernel26 alsa usbgadget usbhost apm vfat ext2 screen touchscreen ethernet sgx"

 

Please do not enable the sgx MACHINE FEATURES if your platform is SMARC T3352.

Building the target platforms


To build the Embedian SMARC T335X and am335x-evm developer board images, respectively, use the following commands:

Info
iconfalse

$ cd ~/oe-layersetup-sdk7/build
$ source conf/setenv
$ MACHINE=smarct335x bitbake -k smarct335x-rootfs-image

Note
titleNote

The first clean build might take more than 10 hours. If you met errors during the building process, let it finish and usually build again should be fine.

 

Once it done, you can find all required images under ~/oe-layersetup-sdk7/build/arago-tmp-external-linaro-toolchain/deploy/images/

You may want to build programs that aren’t installed into a root file system so you can make them available via a feed site (described below.) To do this you can build the package directly and then build the package named package-index to add the new package to the feed site.

 

The following example builds the minicom program and makes it available on the feed site:

Info
iconfalse

$ MACHINE=smarct335x bitbake minicom
$ MACHINE=smarct335x bitbake package-index


Once the build(s) are completed you’ll find the resulting images, feeds and licenses in folder ~/oe-layersetup-sdk7/build/arago-tmp-external-linaro-toolchain/deploy.

deploy/images/* 

This folder contains the binary images for the root file system and the Embedian SMARCT335X specific version of the am335x SDK. Specifically the images are:

 

deploy/images/u-boot.img 

This u-boot bootloader binary for SMARC T335X

deploy/images/MLO

The "Stage 1 Boot Loader" for SMARC T335X.  Its purpose is load the Stage 2 Boot Loader (u-boot.img).

deploy/images/zImage

The kernel zImage for SMARC T335X.  

deploy/images/zImage-am335x-smarct335x.dtb

The device tree binary file for SMARC T335X. 

deploy/images/smarct335x-rootfs-image-smarct335x*

Embedian root file system images for software development on Embedian’s SMARC T335X platforms.


deploy/images/smarct335x-amsdk-image*

 These files contain the entire TI AMSDK augmented with Boost and other options to simplify Embedian SMARC T335X software development.

 deploy/images/arago-base-tisdk-image-smarct335x*

 These images are used to create the SMARC T335X AMSDK (see smarct335x-amsdk-image-smarct335x*).

 deploy/images/tisdk-rootfs-image-am335x-evm*

TI Arago root file system images for software development on TI’s am335x-evm and BeagleBone platforms.

 

 deploy/ipk/*

 This folder contains all the packages used to construct the root file system images. They are in opkg format (similar format to Debian packages) and can be dynamically installed on the target plaform via a properly  constructed feed file. Here is an example of the feed file (named arago-smarct335x-feed.conf) that is used internally at Embedian to install upgrades onto a smarct335x platform without reflashing the file system:

Info
iconfalse

src/gz smarct335x http://www.embedian.com/arago-sdk7/smarct335x

src/gz cortexa8hf-vfp-neon-3.8 http://www.embedian.com/arago-sdk7/cortexa8hf-vfp-neon-3.8 

src/gz all http://www.embedian.com/arago-sdk7/all


deploy/licenses/* 
A database of all licenses used in all packages built for the system.

 

 deploy/sdk/arago-2013.12-cortexa8-linux-gnueabi-tisdk.sh
The installer for ARM toolchain that was created for the target platform. In Embedian’s case that means that the headers for the Boost libraries are baked into the tools. (Generate by meta-toolchain-smarc-tisdk image)

Setup SD Card


 
For these instruction, we are assuming: DISK=/dev/mmcblk0, "lsblk" is very useful for determining the device id.

Info
iconfalse

$ export DISK=/dev/mmcblk0

 

Erase SD card:

Info
iconfalse

$ sudo dd if=/dev/zero of=${DISK} bs=1M count=16

 

Create Partition Layout:

With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.

Info
iconfalse
titlesfdisk
$ sudo sfdisk --version
sfdisk from util-linux 2.27.1

Create Partitions:

Info
titlesfdisk >=2.26.x
$ sudo sfdisk ${DISK} <<-__EOF__
1M,48M,0xE,*
,,,-
__EOF__
Info
titlesfdisk <=2.25
$ sudo sfdisk --in-order --Linux --unit M ${DISK} <<-__EOF__
1,48,0xE,*
,,,-
__EOF__

 

Format Partitions:

Info
iconfalse
for: DISK=/dev/mmcblk0
$ sudo mkfs.vfat -F 16 ${DISK}p1 -n boot
$ sudo mkfs.ext4 ${DISK}p2 -L rootfs
 
for: DISK=/dev/sdX
$ sudo mkfs.vfat -F 16 ${DISK}1 -n boot
$ sudo mkfs.ext4 ${DISK}2 -L rootfs

 

Mount Partitions:

On some systems, these partitions may be auto-mounted...

Info
iconfalse
$ sudo mkdir -p /media/boot/dtbs
$ sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblk0
$ sudo mount ${DISK}p1 /media/boot/
$ sudo mount ${DISK}p2 /media/rootfs/
 
for: DISK=/dev/sdX
$ sudo mount ${DISK}1 /media/boot/
$ sudo mount ${DISK}2 /media/rootfs/

  

Install Bootloader

Copy MLO/u-boot.img to the boot partition

Info
iconfalse
titledeploy/images

$ sudo cp -v MLO /media/boot/
$ sudo cp -v u-boot.img /media/boot/ 

 

uEnv.txt based bootscript

Create "uEnv.txt" boot script: (vim uEnv.txt)

For 3.12.y or after :

Info
iconfalse
title~/uEnv.txt

optargs="consoleblank=0 mem=512M"
#u-boot eMMC specific overrides; Angstrom Distribution (SMARC T335X) 2014-05-20
kernel_file=zImage
initrd_file=initrd.img

loadaddr=0x82000000
initrd_addr=0x88080000
fdtaddr=0x88000000
fdtfile=am335x-smarct335x.dtb 

initrd_high=0xffffffff
fdt_high=0xffffffff

loadimage=load mmc ${mmcdev}:${mmcpart} ${loadaddr} ${kernel_file}
loadinitrd=load mmc ${mmcdev}:${mmcpart} ${initrd_addr} ${initrd_file}; setenv initrd_size ${filesize}
loadfdt=load mmc ${mmcdev}:${mmcpart} ${fdtaddr} /dtbs/${fdtfile}
#

##Un-comment to enable systemd in Debian Wheezy
#optargs=quiet init=/lib/systemd/systemd

console=ttyO3,115200n8
mmcroot=/dev/mmcblk0p2 mmcblk1p2 ro
mmcrootfstype=ext4 rootwait fixrtc

mmcargs=setenv bootargs console=${console} root=${mmcroot} rootfstype=${mmcrootfstype} ${optargs}

#zImage:
uenvcmd=run loadimage; run loadfdt; run mmcargs; bootz ${loadaddr} - ${fdtaddr}

#zImage + uInitrd: where uInitrd has to be generated on the running system.
#boot_fdt=run loadimage; run loadinitrd; run loadfdt
#uenvcmd=run boot_fdt; run mmcargs; bootz ${loadaddr} ${initrd_addr}:${initrd_size} ${fdtaddr}

###Begin Rootfs from NFS
#serverip=192.168.1.51
#rootpath=/srv/nfs/smarct335x/ubuntu1204/
#nfsopts=nolock,acdirmin=60
#netargs=setenv bootargs console=${console} ${optargs} root=/dev/nfs nfsroot=${serverip}:${rootpath},${nfsopts} rw ip=dhcp
##netboot=echo Loading kernel from SDCARD and booting from NFS ...; run loadimage; run netargs; bootz ${loadaddr} - ${fdtaddr}
##uenvcmd=run netboot
###End Rootfs from NFS

###Begin Load kernel from TFTP
#netmask=255.255.255.0
#ipaddr=192.168.1.65
#serverip=192.168.1.51
#netboot=echo Loading kernel and device tree from TFTP and booting from NFS ...; setenv autoload no; tftp ${loadaddr} ${kernel_file}; tftp ${fdtaddr} ${fdtfile}; run netargs; bootz ${loadaddr} - ${fdtaddr}
#uenvcmd=run netboot
###End Load kernel from TFTP

 

Copy uEnv.txt to the boot partition:

Info
iconfalse
title~/

$ sudo cp -v ./uEnv.txt /media/boot/

Install Kernel zImage

Copy zImage to the boot partition:

Info
iconfalse
titledeploy/images

$ sudo cp -v zImage /media/boot

Install Kernel Device Tree Binary

Copy device tree binary to /media/boot/dtbs (Note: the file name in /media/boot/dtbs/ has to be am335x-smarct335x.dtb) 

Info
iconfalse

$ sudo cp -v zImage-am335x-smarct335x.dtb /media/boot/dtbs/am335x-smarct335x.dtb

 

Install Root File System and Kernel Modules

Install Root File System


Copy Root File System:

Arago:

Info
iconfalse
titledeploy/images

$ sudo tar xvfz smarct335x-rootfs-image-smarct335x.tar.gz -C /media/rootfs

Note:

Kernel modules are included in root file systems. 


The following procedure can be used on a Embedian SMARC T335X device to download and utilize the feed file show above to install the minicom terminal emulation program:

Info
iconfalse

# cd /etc/opkg 

# wget http://www.embedian.com/feedfiles-sdk7/arago-smarct335x-feed.conf 

# opkg update 

# opkg upgrade 

# opkg install minicom

Writing Bitbake Recipes


In order to package your application and include it in the root filesystem image, you must write a BitBake recipe for it.

When starting from scratch, it is easiest to learn by example from existing recipes. 

Example HelloWorld recipe using autotools

For software that uses autotools (./configure; make; make install), writing recipes can be very simple:

Code Block
themeConfluence
languagecpp
DESCRIPTION = "Hello World Recipe using autotools"
HOMEPAGE = "http://www.embedian.com/"
SECTION = "console/utils"
PRIORITY = "optional"
LICENSE = "GPL"
PR = "r0"
 
SRC_URI = "git://git@git.embedian.com/developer/helloworld-autotools.git;protocol=ssh;tag=v1.0"
S = "${WORKDIR}/git"
 
inherit autotools

SRC_URI specifies the location to download the source from. It can take the form of any standard URL using http://, ftp://, etc. It can also fetch from SCM systems, such as git in the example above.

PR is the package revision variable. Any time a recipe is updated that should require the package to be rebuilt, this variable should be incremented.

inherit autotools brings in support for the package to be built using autotools, and thus no other instructions on how to compile and install the software are needed unless something needs to be customized.

S is the source directory variable. This specifies where the source code will exist after it is fetched from SRC_URI and unpacked. The default value is ${WORKDIR}/${PN}-${PV}, where PN is the package name and PV is the package version. Both PN and PV are set by default using the filename of the recipe, where the filename has the format PN_PV.bb.

Example HelloWorld recipe using a single source file

This example shows a simple case of building a helloworld.c file directly using the default compiler (gcc). Since it isn’t using autotools or make, we have to tell BitBake how to build it explicitly.

Code Block
themeConfluence
languagecpp
DESCRIPTION = "HelloWorld"
SECTION = "examples"
LICENSE = "GPL"
 
SRC_URI = "file://helloworld.c"
 
S = "${WORKDIR}"
 
do_compile() {
    ${CC} ${CFLAGS} ${LDFLAGS} helloworld.c -o helloworld
}
 
do_install() {
    install -d ${D}${bindir}
    install -m 0755 helloworld ${D}${bindir}
}

 

In this case, SRC_URI specifies a file that must exist locally with the recipe. Since there is no code to download and unpack, we set S to WORKDIR since that is where helloworld.c will be copied to before it is built.

WORKDIR is located at ${OETREE}/build/arago-tmp-external-linaro-toolchain/work/armv7ahf-vfp-neon-3.8-oe-linux-gnueabi/<package name and version> for most packages. If the package is machine-specific (rather than generic for the armv7ahf architecture), it may be located in the smarct335x-oe-linux-gnueabi subdirectory depending on your hardware (this applies to kernel packages, images, etc).

do_compile defines how to compile the source. In this case, we just call gcc directly. If it isn’t defined, do_compile runs make in the source directory by default.

do_install defines how to install the application. This example runs install to create a bin directory where the application will be copied to and then copies the application there with permissions set to 755.

D is the destination directory where the application is installed to before it is packaged.

${bindir} is the directory where most binary applications are installed, typically /usr/bin.

For a more in-depth explanation of BitBake recipes, syntax, and variables, see the Recipe Chapter of the OpenEmbedded User Manual.

 

Setup eMMC


Setting up eMMC usually is the last step at development stage after the development work is done at your SD card or NFS environments. From software point of view, eMMC is nothing but a non-removable SD card on board. When booting from eMMC and SD card is present, SD card is emulated as /dev/mmcblk0 and eMMC is emulated as /dev/mmcblk1. On the other hand, when booting from eMMC and SD card is absent, eMMC will be on module will be always emulated as /dev/mmcblk0 now. eMMC could be /dev/mmcblk0 or /dev/mmcblk1 depending on if SD card is inserted and the boot device become dynamic when booting from eMMC.

Initramfs is the successor of initrd and has many advantages over initrd. Linux kernel here will mount it as a temperately rootfs and starts the init process from here. The init script will check if the partition 2 of eMMC is exist and them mount the real rootfs.

 Setting up eMMC now is nothing but changing the device descriptor. 

This section gives a step-by-step procedure to setup eMMC flash. Users can write a shell script your own at production to simplify the steps.

Get initramfs (assuming the home directory is /home/developer here)

Info
iconfalse

$ cd ~/

$ wget http://developer.embedian.com/download/attachments/2883656/initramfs.tar.gz?version=1&modificationDate=1414480792916&api=v2

$ mkdir initramfs

$ sudo tar xvfz initramfs.tar.gz -C initramfs/

Note: The above initramfs is obtained by the following steps:

Info
iconfalse

$ cd ~/oe-layersetup/build

$ source conf/setenv

$ MACHINE=smarct335x bitbake -k smarct335x-initramfs-image

You will find smarct335x-initramfs-image-smarct335x.tar.gz file under ~/oe-layersetup/build/arago-tmp-external-linaro-toolchain/deploy/images/

Extract this tarball and add your own init script. Users can use Embedian's init script for references. 

Prepare for initramfs zImage

Info
iconfalse

$ MACHINE=smarct335x bitbake virtual/kernel -c menuconfig

Select

General setup --> 

     [*] Initial RAM filesystem and RAM disk (initramfs/initrd) support

     ()    Initramfs source file(s)

Enter the directory where your initramfs is. In this example

/home/developer/initramfs

Save the kernel config and build again.

Prepare for

First, we need to backup the final firmware from your SD card or NFS.

Prepare for eMMC binaries from SD card (or NFS):

Insert SD card into your Linux PC. For these instructions, we are assuming: DISK=/dev/mmcblk0, "lsblk" is very useful for determining the device id.

For these instruction, we are assuming: DISK=/dev/mmcblk0, "lsblk" is very useful for determining the device id.

Info
iconfalse

$ export DISK=/dev/mmcblk0

Mount Partitions:

On some systems, these partitions may be auto-mounted...

Info
iconfalse
$ sudo mkdir -p /media/boot/
$ sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblk0
$ sudo mount ${DISK}p1 /media/boot/
$ sudo mount ${DISK}p2 /media/rootfs/
 
for: DISK=/dev/sdX
$ sudo mount ${DISK}1 /media/boot/
$ sudo mount ${DISK}2 /media/rootfs/

Copy MLO to rootfs partition:

Info
iconfalse

$ sudo cp -v /media/boot/MLO /media/rootfs/home/root

 

Copy u-boot.img to rootfs partition:

Info
iconfalse

$ sudo cp -v /media/boot/u-boot.img /media/rootfs/home/root

 

Copy initramfs zImage to rootfs partition:

Info
iconfalse
titlearago-tmp-external-linaro-toolchain/deploy/images

$ sudo cp -v zImage /media/rootfs/home/root

 

Copy uEnv.txt to rootfs partition:

Copy and paste the following contents to /media/rootfs/home/root ($ sudo vim /media/rootfs/home/root/uEnv.txt)

     For kernel v3.12.y+:

Info
iconfalse

optargs="consoleblank=0 mem=512M"
#u-boot eMMC specific overrides; Angstrom Distribution (SMARC T335X) 2014-05-20
kernel_file=zImage
initrd_file=initrd.img

loadaddr=0x82000000
initrd_addr=0x88080000
fdtaddr=0x88000000
fdtfile=am335x-smarct335x.dtbdtb 

initrd_high=0xffffffff
fdt_high=0xffffffff

loadimage=load mmc ${mmcdev}:${mmcpart} ${loadaddr} ${kernel_file}
loadinitrd=load mmc ${mmcdev}:${mmcpart} ${initrd_addr} ${initrd_file}; setenv initrd_size ${filesize}
loadfdt=load mmc ${mmcdev}:${mmcpart} ${fdtaddr} /dtbs/${fdtfile}
#

##Un-comment to enable systemd in Debian Wheezy
#optargs=quiet init=/lib/systemd/systemd

console=ttyO3,115200n8
#mmcrootmmcroot=/dev/mmcblk0p2 ro
#mmcrootfstypemmcrootfstype=ext4 rootwait fixrtc

mmcroot=/dev/ram0
#mmcargs=mmcargs=setenv bootargs console=${console} root=${mmcroot} rootfstype=${mmcrootfstype} ${optargs}mmcargs=setenv bootargs

console=${console} root=${mmcroot} initramfs=0x81000000,
8M
#zImage:
uenvcmd=run loadimage; run loadfdt; run mmcargs; bootz ${loadaddr} - ${fdtaddr}

#zImage + uInitrd: where uInitrd has to be generated on the running system.
#boot_fdt=run loadimage; run loadinitrd; run loadfdt
#uenvcmd=run boot_fdt; run mmcargs; bootz ${loadaddr} ${initrd_addr}:${initrd_size} ${fdtaddr}

###Begin Rootfs from NFS
#serverip=192.168.1.51
#rootpath=/srv/nfs/smarct335x/ubuntu1204/
#nfsopts=nolock,acdirmin=60
#netargs=setenv bootargs console=${console} ${optargs} root=/dev/nfs nfsroot=${serverip}:${rootpath},${nfsopts} rw ip=dhcp
##netboot=echo Loading kernel from SDCARD and booting from NFS ...; run loadimage; run netargs; bootz ${loadaddr} - ${fdtaddr}
##uenvcmd=run netboot
###End Rootfs from NFS

###Begin Load kernel from TFTP
#netmask=255.255.255.0
#ipaddr=192.168.1.65
#serverip=192.168.1.51
#netboot=echo Loading kernel and device tree from TFTP and booting from NFS ...; setenv autoload no; tftp ${loadaddr} ${kernel_file}; tftp ${fdtaddr} ${fdtfile}; run netargs; bootz ${loadaddr} - ${fdtaddr}
#uenvcmd=run netboot
###End Load kernel from TFTP

Copy real rootfs to rootfs partition:

Info
iconfalse

$ pushd /media/rootfs

$ sudo tar cvfz ~/smarct335x-emmc-rootfs.tar.gz .

$ sudo mv ~/smarct335x-emmc-rootfs.tar.gz /media/rootfs/home/root

$ popd

 

Remove SD card:

Info
iconfalse
$ sync
$ sudo umount /media/boot
$ sudo umount /media/rootfs

 

Insert this SD card into your SMARC T335X device.

Now it will be almost the same as you did when setup your SD card, but the eMMC device descriptor is /dev/mmcblk1 now.

Info
iconfalse

$ export DISK=/dev/mmcblk1mmcblk0

Erase SD card:

Info
iconfalse

$ sudo dd if=/dev/zero of=${DISK} bs=1M count=16

Create Partition Layout:

Info
iconfalse
$ sudo sfdisk --in-order --Linux --unit M ${DISK} <<-__EOF__
1,48,0xE,*
,,,-
__EOF__

 

Format Partitions:

Info
iconfalse
for: DISK=/dev/mmcblk0
$ sudo mkfs.vfat -F 16 ${DISK}p1 -n boot
$ sudo mkfs.ext4 ${DISK}p2 -L rootfs

 

for: DISK=/dev/sdX
$ sudo mkfs.vfat -F 16 ${DISK}1 -n boot
$ sudo mkfs.ext4 ${DISK}2 -L rootfs

 

Mount Partitions:

Info
iconfalse
$ sudo mkdir -p /media/boot/
$ sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblk0
$ sudo mount ${DISK}p1 /media/boot/
$ sudo mount ${DISK}p2 /media/rootfs/
 
for: DISK=/dev/sdX
$ sudo mount ${DISK}1 /media/boot/
$ sudo mount ${DISK}2 /media/rootfs/


Install binaries for partition 1

Copy MLO/u-boot.img/uEnv.txt/zImage to the boot partition

Info
iconfalse

$ sudo cp -v MLO u-boot.img zImage uEnv.txt /media/boot/

Install Kernel Device Tree Binary

Info
iconfalse

$ sudo mkdir -p /media/boot/dtbs

$ sudo cp -v am335x-smarct335x.dtb /media/boot/dtbs

 

Install Root File System


Info
iconfalse

$ sudo tar -zxvf smarct335x-emmc-rootfs.tar.gz -C /media/rootfs

 

Unmount eMMC:

Info
iconfalse
$ sync
$ sudo umount /media/boot
$ sudo umount /media/rootfs

 

Switch your Boot Select to eMMC and you will be able to boot up from eMMC now.


version 1.0a, 8/19/2014

Last updated 20142015-1012-2807