VAR-SOM-MX7 NAND Flash Burning: Difference between revisions

From Variscite Wiki
No edit summary
No edit summary
 
Line 40: Line 40:
| style="padding: 5px" | Linux kernel image. Used here for both eMMC and NAND flash.
| style="padding: 5px" | Linux kernel image. Used here for both eMMC and NAND flash.
|-
|-
| style="padding: 5px" | u-boot.imx-sd
| style="padding: 5px" | SPL-sd
| style="padding: 5px" | U-Boot image. Used here for eMMC.
| style="padding: 5px" | SPL built for SD card or eMMC boot.  
|-
|-
| style="padding: 5px" | u-boot.imx-nand
| style="padding: 5px" | SPL-nand
| style="padding: 5px" | SPL built for NAND flash.
|-
| style="padding: 5px" | u-boot.img-sd
| style="padding: 5px" | U-Boot built for SD card or eMMC boot.
|-
| style="padding: 5px" | u-boot.img-nand
| style="padding: 5px" | U-Boot built for NAND flash.
| style="padding: 5px" | U-Boot built for NAND flash.
|-
|-
Line 69: Line 75:
     ├── rootfs.tar.bz2
     ├── rootfs.tar.bz2
     ├── rootfs.ubi
     ├── rootfs.ubi
     ├── u-boot.imx-nand
    ├── SPL-nand
     ├── u-boot.imx-sd
    ├── SPL-sd
     ├── u-boot.img-nand
     ├── u-boot.img-sd
     └── zImage
     └── zImage
</pre>
</pre>
Line 93: Line 101:
Device Tree:
Device Tree:
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-nand.dtb ${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-nand.dtb
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-nand.dtb ${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-nand.dtb
SPL:
$ sudo cp ${YOCTO_IMGS_PATH}/SPL-nand ${P2_MOUNT_DIR}/opt/images/Yocto/


U-Boot:
U-Boot:
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.imx-nand ${P2_MOUNT_DIR}/opt/images/Yocto/
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.img-nand ${P2_MOUNT_DIR}/opt/images/Yocto/


File System:
File System:
Line 106: Line 117:
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-emmc.dtb ${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-emmc.dtb
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-emmc.dtb ${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-emmc.dtb


U-Boot:
SPL:
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.imx-sd ${P2_MOUNT_DIR}/opt/images/Yocto/
$ sudo cp ${YOCTO_IMGS_PATH}/SPL-sd ${P2_MOUNT_DIR}/opt/images/Yocto/
 
U-Boot:  
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.img-sd ${P2_MOUNT_DIR}/opt/images/Yocto/


File System:
File System:
Line 128: Line 142:
</pre>
</pre>


Flash U-Boot to NAND flash:
Flash SPL and U-Boot to NAND flash:
<pre>
<pre>
$ flash_erase /dev/mtd0 0 0
$ flash_erase /dev/mtd0 0 0
$ kobs-ng init -x u-boot.imx-nand --search_exponent=1 -v
$ kobs-ng init -x SPL-nand --search_exponent=1 -v
$ flash_erase /dev/mtd1 0 0
$ nandwrite -p /dev/mtd1 u-boot.img-nand
$ flash_erase /dev/mtd2 0 0
$ flash_erase /dev/mtd2 0 0
</pre>
</pre>
Line 195: Line 211:
</pre>
</pre>


Flash U-Boot to eMMC:
Flash SPL and U-Boot to eMMC:
<pre>
<pre>
$ dd if=u-boot.imx-sd of=${node} bs=1K seek=1; sync
$ dd if=SPL-sd of=${node} bs=1K seek=1; sync
$ dd if=u-boot.img-sd of=${node} bs=1K seek=69; sync
</pre>
</pre>



Latest revision as of 17:06, 20 March 2018

VAR-SOM-MX7 - Flashing the internal storage device from Linux

Introduction

The Variscite VAR-SOM-MX7 has either an on-SOM NAND flash or eMMC, and either of them can be used to boot from and to hold the file system.
For NAND flash we use a UBI file system and for eMMC we use ext4.

NAND flash structure

These are the defined MTD partitions on the NAND flash:
0x000000000000-0x000000200000 : "spl"
0x000000200000-0x000000400000 : "u-boot"
0x000000400000-0x000000600000 : "u-boot_env"
0x000000600000-0x000000e00000 : "kernel"
0x000000e00000-End                       : "rootfs"

Note: Since currently there's no SPL support for the i.MX7, the first partition is actually used for U-Boot and the second one is for future use.

eMMC structure

0-4 MiB      : Non-partitioned space, saved for U-Boot.
4-12 MiB    : "BOOT-VARMX7" - A FAT16 partition containing the Linux image and the device tree blob/s.
12 MiB-End: "rootfs" - An ext4 partition containing the root file system (including the kernel modules).

Yocto Built binaries for eMMC/NAND flash

The resulted images are located at tmp/deploy/images/imx7-var-som:

File Name Description
fsl-image-gui-imx7-var-som.tar.bz2 Tarball with rootfs files. Used here for writing to eMMC.
fsl-image-gui-imx7-var-som.ubi A complete UBI image containing a UBIFS volume, for writing to NAND flash.
zImage Linux kernel image. Used here for both eMMC and NAND flash.
SPL-sd SPL built for SD card or eMMC boot.
SPL-nand SPL built for NAND flash.
u-boot.img-sd U-Boot built for SD card or eMMC boot.
u-boot.img-nand U-Boot built for NAND flash.
zImage-imx7d-var-som-emmc.dtb Device tree blob for SOMs with eMMC.
zImage-imx7d-var-som-nand.dtb Device tree blob for SOMs with NAND flash.

Installing the Yocto binaries

If you followed the Create an extended SD card steps, the Yocto binaries and the flashing script will be included in your SD card.
The flashing script is an easy-to-use example script for flashing images into NAND flash / eMMC.
There are also sections below describing how to flash the images manually to NAND flash and to eMMC.

Images locations

Following is the directory structure on your SD card, which elaborates the files' location that the below installation script is expecting:

/opt/images/
└── Yocto
    ├── imx7d-var-som-emmc.dtb
    ├── imx7d-var-som-nand.dtb
    ├── rootfs.tar.bz2
    ├── rootfs.ubi
    ├── SPL-nand
    ├── SPL-sd
    ├── u-boot.img-nand
    ├── u-boot.img-sd
    └── zImage

Prepare the images for NAND flash / eMMC flashing

Plug the bootable SD card into your host machine and mount the rootfs partition - here we assume it is mounted on /media/rootfs.
Copy all the mentioned yocto-built binaries to the SD card:

$ export YOCTO_IMGS_PATH=~/var-mx6ul-mx7-yocto-jethro/build_x11/tmp/deploy/images/imx7-var-som
$ export P2_MOUNT_DIR=/media/rootfs/
Linux:
$ sudo cp ${YOCTO_IMGS_PATH}/zImage				${P2_MOUNT_DIR}/opt/images/Yocto/

NAND images:

Device Tree:
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-nand.dtb	${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-nand.dtb

SPL:
$ sudo cp ${YOCTO_IMGS_PATH}/SPL-nand ${P2_MOUNT_DIR}/opt/images/Yocto/

U-Boot:
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.img-nand ${P2_MOUNT_DIR}/opt/images/Yocto/

File System:
$ sudo cp ${YOCTO_IMGS_PATH}/fsl-image-gui-imx7-var-som.ubi	${P2_MOUNT_DIR}/opt/images/Yocto/rootfs.ubi

eMMC images:

Device Tree:
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-emmc.dtb	${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-emmc.dtb

SPL:
$ sudo cp ${YOCTO_IMGS_PATH}/SPL-sd ${P2_MOUNT_DIR}/opt/images/Yocto/

U-Boot: 
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.img-sd ${P2_MOUNT_DIR}/opt/images/Yocto/

File System:
$ sudo cp ${YOCTO_IMGS_PATH}/fsl-image-gui-imx7-var-som.tar.bz2	${P2_MOUNT_DIR}/opt/images/Yocto/rootfs.tar.bz2

Flashing script

The flashing script is located on the SD card at /usr/bin/:

install_yocto.sh	- Flash Yocto into NAND flash or eMMC (Run and follow usage instructions)

Manual step-by-step flashing to NAND flash

Use the prepared SD card to boot the board and run the following:

$ cd /opt/images/Yocto

Flash SPL and U-Boot to NAND flash:

$ flash_erase /dev/mtd0 0 0
$ kobs-ng init -x SPL-nand --search_exponent=1 -v
$ flash_erase /dev/mtd1 0 0
$ nandwrite -p /dev/mtd1 u-boot.img-nand
$ flash_erase /dev/mtd2 0 0

Flash the Linux Kernel image & Device Tree blob to NAND flash:

$ flash_erase /dev/mtd3 0 0
$ nandwrite -p /dev/mtd3 zImage
$ nandwrite -p /dev/mtd3 -s 0x7e0000 imx7d-var-som-nand.dtb

Flash the UBI File System to NAND flash:

$ ubiformat /dev/mtd4 -f rootfs.ubi

Manual step-by-step flashing to eMMC

Flashing the eMMC requires several steps including flashing of U-Boot and the Linux kernel, partitioning, file system formatting and image extraction.
We recommend to use our provided scripts to perform this task.

Use the prepared SD card to boot the board and run the following:

$ export node=/dev/mmcblk2
$ cd /opt/images/Yocto

Make sure the eMMC is not mounted:

$ umount ${node}p*

Delete current data on eMMC:

$ dd if=/dev/zero of=${node}p1 bs=1024 count=1024
$ dd if=/dev/zero of=${node}p2 bs=1024 count=1024
$ dd if=/dev/zero of=${node}p3 bs=1024 count=1024
$ dd if=/dev/zero of=${node}p4 bs=1024 count=1024
$ dd if=/dev/zero of=${node}p5 bs=1024 count=1024
$ dd if=/dev/zero of=${node}p6 bs=1024 count=1024
$ dd if=/dev/zero of=${node}p7 bs=1024 count=1024
$ sync
$ (echo d; echo 1; echo d; echo 2; echo d; echo 3; echo d; echo w) | fdisk $node
$ sync
$ dd if=/dev/zero of=$node bs=1M count=4
$ sync

Create a partition table:

$ (echo n; echo p; echo 1; echo 8192; echo 24575; echo t; echo c; \
   echo n; echo p; echo 2; echo 24576; echo; \
   echo p; echo w) | fdisk -u $node
$ sync

Format the partitions:

$ mkfs.vfat ${node}p1 -n BOOT-VARMX7
$ mkfs.ext4 ${node}p2 -L rootfs
$ sync

Flash SPL and U-Boot to eMMC:

$ dd if=SPL-sd of=${node} bs=1K seek=1; sync
$ dd if=u-boot.img-sd of=${node} bs=1K seek=69; sync

Copy the Linux kernel image and the device tree blob to the BOOT partition:

$ mkdir /run/media/mmcblk2p1
$ mount -t vfat ${node}p1	/run/media/mmcblk2p1
$ cp imx7d-var-som-emmc.dtb	/run/media/mmcblk2p1/
$ cp zImage			/run/media/mmcblk2p1/
$ sync
$ umount /run/media/mmcblk2p1

Extract the rootfs archive:

$ mkdir /run/media/mmcblk2p2
$ mount ${node}p2 /run/media/mmcblk2p2
$ tar xvpf rootfs.tar.bz2 -C /run/media/mmcblk2p2
$ sync
$ umount /run/media/mmcblk2p2

Summary

We described the results of a Yocto build, how to copy it to a bootable SD card and how to flash it to NAND flash or eMMC.
With our extended SD card and our recovery SD card we provide an installation script located at /usr/bin/install_yocto.sh. It is much safer to use it instead of flashing the system manually.