dcsimg

Versions Compared

Key

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

Wiki Markup
This is a page about the Freescale based i.MX6; i.MX6q SABRE Board for Smart Devices.
{hide-comments}
{toc:indent=20px|style=disc}
h1. Availability
Boards:
[MCIMX6Q-SDB|https://www.digikey.com/product-search/en?keywords=MCIMX6Q-SDB-ND] at Digi-Key
h1. Vendor Documentation
* i.MX6q: [http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=i.MX6Q]
* SABRE Board for Smart Devices Based on the i.MX 6 Series: [http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=RDIMX6SABREBRD]
 
h1. Notes
From: [http://cache.freescale.com/files/32bit/doc/quick_start_guide/SABRESDB_IMX6_QSG.pdf]
SW6: Boot from SD3 (underneath next to hdmi/ethernet)
||D1||D2||D3||D4||D5||D6||D7||D8||
|off|on|off|off|off|off|on|off|
 
h1. Basic Requirements
* Running a recent release of Debian, Fedora or Ubuntu; without OS Virtualization Software.
* ARM Cross Compiler -- Linaro: [http://www.linaro.org]
** Linaro Toolchain Binaries: [http://www.linaro.org/downloads/]
* Bootloader
** Das U-Boot -- the Universal Boot Loader: [http://www.denx.de/wiki/U-Boot]
** Source: [http://git.denx.de/?p=u-boot.git;a=summary]
* Linux Kernel
** Linus's Mainline tree: [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git]
* ARM based rootfs
** Debian: [https://www.debian.org]
** Ubuntu: [http://www.ubuntu.com]
 
h1. ARM Cross Compiler: GCC
This is a pre-built (64bit) version of Linaro GCC that runs on generic linux, sorry (32bit) x86 users, it's time to upgrade...
Download/Extract:
{code:title=~/}
wget -c https://releases.linaro.org/components/toolchain/binaries/5.3-2016.05/arm-linux-gnueabihf/gcc-linaro-5.3.1-2016.05-x86_64_arm-linux-gnueabihf.tar.xz
tar xf gcc-linaro-5.3.1-2016.05-x86_64_arm-linux-gnueabihf.tar.xz
export CC=`pwd`/gcc-linaro-5.3.1-2016.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-
{code}
Test:
{code:title=~/}
${CC}gcc --version
arm-linux-gnueabihf-gcc (Linaro GCC 5.3-2016.05) 5.3.1 20160412
Copyright (C) 2015 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
{code}
 
h1. Bootloader: U-Boot
Das U-Boot -- the Universal Boot Loader: [http://www.denx.de/wiki/U-Boot]
eewiki.net patch archive: [https://github.com/eewiki/u-boot-patches]
Download:
{code:title=~/}
git clone https://github.com/u-boot/u-boot
cd u-boot/
git checkout v2016v2017.0301 -b tmp
{code}
Patches:
{code:title=~/u-boot}
wget -c https://rcn-ee.com/repos/git/u-boot-patches/v2016v2017.0301/0001-mx6qsabre_common-uEnv.txt-bootz-n-fixes.patch
 
patch -p1 < 0001-mx6qsabre_common-uEnv.txt-bootz-n-fixes.patch
{code}
Configure and Build:
{code:title=~/u-boot}
make ARCH=arm CROSS_COMPILE=${CC} distclean
make ARCH=arm CROSS_COMPILE=${CC} mx6qsabresd_defconfig
make ARCH=arm CROSS_COMPILE=${CC}
{code}
 
h1. Linux Kernel
This script will build the kernel, modules, device tree binaries and copy them to the deploy directory.
Download:
{code:title=~/}
git clone https://github.com/RobertCNelson/armv7-multiplatform
cd armv7-multiplatform/
{code}
For v4.1.x (Longterm 4.1.x):
{code:title=~/armv7-multiplatform}
git checkout origin/v4.1.x -b tmp
{code}
For v4.1.x-rt (Longterm 4.1.x + Real-Time Linux):
{code:title=~/armv7-multiplatform}
git checkout origin/v4.1.x-rt -b tmp
{code}
For v4.4.x (Longterm 4.4.x):
{code:title=~/armv7-multiplatform}
git checkout origin/v4.4.x -b tmp
{code}
For v4.4.x-rt (Longterm 4.4.x + Real-Time Linux):
{code:title=~/armv7-multiplatform}
git checkout origin/v4.4.x-rt -b tmp
{code}
For v4.9.x (Longterm 4.9.x):
{code:title=~/armv7-multiplatform}
git checkout origin/v4.9.x -b tmp
{code}
For v4.9.x-rt (Longterm 4.9.x + Real-Time Linux):
{code:title=~/armv7-multiplatform}
git checkout origin/v4.9.x-rt -b tmp
{code}
Build:
{code:title=~/armv7-multiplatform/}
./build_kernel.sh
{code}
 
h1. Root File System
h4. Debian 8
|| User || Password ||
| debian | temppwd |
| root | root |
Download:
{code:title=~/}
wget -c https://rcn-ee.com/rootfs/eewiki/minfs/debian-8.7-minimal-armhf-2017-01-14.tar.xz
{code}
Verify:
{code:title=~/}
sha256sum debian-8.7-minimal-armhf-2017-01-14.tar.xz
5cca3d448432557d275fac694d50f708338d1aa621976ea3fa40fb71d44ba024  debian-8.7-minimal-armhf-2017-01-14.tar.xz
{code}
Extract:
{code:title=~/}
tar xf debian-8.7-minimal-armhf-2017-01-14.tar.xz
{code}
h4. Ubuntu 16.04 LTS
|| User || Password ||
| ubuntu | temppwd |
Download:
{code:title=~/}
wget -c https://rcn-ee.com/rootfs/eewiki/minfs/ubuntu-16.04.1-minimal-armhf-2017-01-14.tar.xz
{code}
Verify:
{code:title=~/}
sha256sum ubuntu-16.04.1-minimal-armhf-2017-01-14.tar.xz
7ec9a1c9adbaf4d2d6857bfe64559b67f3882bb0451207b06e2863d067c534fd  ubuntu-16.04.1-minimal-armhf-2017-01-14.tar.xz
{code}
Extract:
{code:title=~/}
tar xf ubuntu-16.04.1-minimal-armhf-2017-01-14.tar.xz
{code}
h1. Root File System (small flash)
A Root File System around 100Mb in size, for flash applications.
h4. Debian 8 (small flash)
|| User || Password ||
| debian | temppwd |
| root | root |
Download:
{code:title=~/}
wget -c https://rcn-ee.com/rootfs/eewiki/barefs/debian-8.7-bare-armhf-2017-01-14.tar.xz
{code}
Verify:
{code:title=~/}
sha256sum debian-8.7-bare-armhf-2017-01-14.tar.xz
159e1a6addc35bbfff03b5eafd5cb741086a8a016d5ab9572ab122ce64d63e5e  debian-8.7-bare-armhf-2017-01-14.tar.xz
{code}
Extract:
{code:title=~/}
tar xf debian-8.7-bare-armhf-2017-01-14.tar.xz
{code}
 
h1. Setup microSD card
*For these instruction we are assuming, DISK=/dev/mmcblk0, lsblk is very useful for determining the device id.*
{code}
export DISK=/dev/mmcblk0
{code}
Erase partition table/labels on microSD card:
{code}
sudo dd if=/dev/zero of=${DISK} bs=1M count=10
{code}
Install Bootloader:
{code:title=~/}
sudo dd if=./u-boot/u-boot.imx of=${DISK} seek=2 bs=512
{code}
Create Partition Layout:
*With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.*
{code:title=sfdisk}
sudo sfdisk --version
sfdisk from util-linux 2.27.1
{code}
{code:title=sfdisk >= 2.26.x}
sudo sfdisk ${DISK} <<-__EOF__
1M,,L,*
__EOF__
{code}
{code:title=sfdisk <= 2.25.x}
sudo sfdisk --unit M ${DISK} <<-__EOF__
1,,L,*
__EOF__
{code}
Format Partition:
*With mkfs.ext4 1.43, we need to make sure metadata_csum and 64bit are disabled.*
As U-Boot CAN NOT currently handle reading files with these newer ext4 options and so Debian 8 (armel/armhf) and Ubuntu 16.04 (armhf) fsck tools will operate correctly.
{code:title=mkfs.ext4 -V}
sudo mkfs.ext4 -V
mke2fs 1.43-WIP (15-Mar-2016)
        Using EXT2FS Library version 1.43-WIP
{code}
 
{code:title=mkfs.ext4 >= 1.43}
for: DISK=/dev/mmcblk0
sudo mkfs.ext4 -L rootfs -O ^metadata_csum,^64bit ${DISK}p1
 
for: DISK=/dev/sdX
sudo mkfs.ext4 -L rootfs -O ^metadata_csum,^64bit ${DISK}1
{code}
{code:title=mkfs.ext4 <= 1.42}
for: DISK=/dev/mmcblk0
sudo mkfs.ext4 -L rootfs ${DISK}p1
 
for: DISK=/dev/sdX
sudo mkfs.ext4 -L rootfs ${DISK}1
{code}
Mount Partition:
*On most systems these partitions may will be auto-mounted...*
{code}
sudo mkdir -p /media/rootfs/
 
for: DISK=/dev/mmcblk0
sudo mount ${DISK}p1 /media/rootfs/
 
for: DISK=/dev/sdX
sudo mount ${DISK}1 /media/rootfs/
{code}
 
h1. Install Kernel and Root File System
To help new users, since the kernel version can change on a daily basis. The kernel building scripts listed on this page will now give you a hint of what kernel version was built.
{code}
-----------------------------
Script Complete
eewiki.net: [user@localhost:~$ export kernel_version=4.X.Y-Z]
-----------------------------
{code}
Copy and paste that "export kernel_version=4.X.Y-Z" exactly as shown in your own build/desktop environment and hit enter to create an environment variable to be used later.
{code}
export kernel_version=4.X.Y-Z
{code}
h3. Copy Root File System
{code:title=~/}
sudo tar xfvp ./*-*-*-armhf-*/armhf-rootfs-*.tar -C /media/rootfs/
sync
sudo chown root:root /media/rootfs/
sudo chmod 755 /media/rootfs/
{code}
h3. Set uname_r in /boot/uEnv.txt
{code:title=~/}
sudo sh -c "echo 'uname_r=${kernel_version}' >> /media/rootfs/boot/uEnv.txt"
{code}
h3. Copy Kernel Image
Kernel Image:
{code:title=~/}
sudo cp -v ./armv7-multiplatform/deploy/${kernel_version}.zImage /media/rootfs/boot/vmlinuz-${kernel_version}
{code}
h3. Copy Kernel Device Tree Binaries
{code:title=~/}
sudo mkdir -p /media/rootfs/boot/dtbs/${kernel_version}/
sudo tar xfv ./armv7-multiplatform/deploy/${kernel_version}-dtbs.tar.gz -C /media/rootfs/boot/dtbs/${kernel_version}/
{code}
h3. Copy Kernel Modules
{code:title=~/}
sudo tar xfv ./armv7-multiplatform/deploy/${kernel_version}-modules.tar.gz -C /media/rootfs/
{code}
 
h3. File Systems Table (/etc/fstab)
*Starting with the v4.5.x merge (and fixed in v4.5.3) mmc interface has been re-numbered...*
[https://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/commit/?id=520bd7a8b4152aacfbd34eb7f7a447354b631039]
[https://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/commit/?id=58821da858919f93f85c7e6823b49d439722a9e9]
 
{code:title=/etc/fstab}
sudo sh -c "echo '/dev/mmcblk0p1  /  auto  errors=remount-ro  0  1' >> /media/rootfs/etc/fstab"
{code}
 
{code:title=/etc/fstab v4.5.3+/v4.6.x+ kernels}
sudo sh -c "echo '/dev/mmcblk2p1  /  auto  errors=remount-ro  0  1' >> /media/rootfs/etc/fstab"
{code}
 
h3. Remove microSD/SD card
{code}
sync
sudo umount /media/rootfs
{code}
 
h1. Comments
Comments, feedback, and questions can be sent to: [eewiki@digikey.com|mailto:eewiki@digikey.com?subject=i.MX6q_SABRE_Board_for_Smart_Devices]
Please use the Digi-Key's TechForum: [TechForum|https://forum.digikey.com/c/linux-on-arm/]