VAR-SOM-MX7 NAND Flash Burning: Difference between revisions
(Created page with "{{PageHeader|VAR-SOM-MX7 - NAND flash Burning}} {{DocImage|category1=VAR-SOM-MX7|category2=Yocto}} __toc__ = Introduction = The Variscite VAR-SOM-MX7 has either an on-SOM NAND...") |
No edit summary |
||
Line 1: | Line 1: | ||
{{PageHeader|VAR-SOM-MX7 - | {{PageHeader|VAR-SOM-MX7 - Flashing the internal storage device}} {{DocImage|category1=VAR-SOM-MX7|category2=Yocto}} __toc__ | ||
= Introduction = | = 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 filesystem.<br> | 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 filesystem.<br> | ||
For NAND flash we use a UBI file system and for eMMC we use ext4. | For NAND flash we use a UBI file system and for eMMC we use ext4. | ||
= NAND Structure = | |||
These are the defined MTD partitions on the NAND flash:<br> | These are the defined MTD partitions on the NAND flash:<br> | ||
0x000000000000-0x000000200000 : "spl"<br> | 0x000000000000-0x000000200000 : "spl"<br> | ||
Line 12: | Line 15: | ||
0x000000e00000-0x000040000000 : "rootfs"<br> | 0x000000e00000-0x000040000000 : "rootfs"<br> | ||
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. | 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. | ||
= Yocto Built binaries for eMMC/NAND flash = | |||
The resulted images are located at tmp/deploy/images/imx7-var-som: | The resulted images are located at tmp/deploy/images/imx7-var-som: | ||
Line 22: | Line 26: | ||
! scope="col" | Description | ! scope="col" | Description | ||
|- | |- | ||
| style="padding: 5px | | style="padding: 5px" | fsl-image-gui-imx7-var-som.tar.bz2 | ||
| style="padding: 5px | | style="padding: 5px" | Tarball with rootfs files. Used here for writing to eMMC. | ||
|- | |||
| style="padding: 5px" | fsl-image-gui-imx7-var-som.ubi | |||
| style="padding: 5px" | A complete UBI image containing a UBIFS volume, for writing to NAND flash. | |||
|- | |||
| style="padding: 5px" | zImage | |||
| style="padding: 5px" | Linux kernel image. Used here for both eMMC and NAND flash. | |||
|- | |- | ||
| style="padding: 5px | | style="padding: 5px" | u-boot.imx-sd | ||
| style="padding: 5px | | style="padding: 5px" | U-Boot image. Used here for eMMC. | ||
|- | |- | ||
| style="padding: 5px | | style="padding: 5px" | u-boot.imx-nand | ||
| style="padding: 5px | | style="padding: 5px" | U-Boot built for NAND flash. | ||
|- | |- | ||
| style="padding: 5px | | style="padding: 5px" | zImage-imx7d-var-som-emmc.dtb | ||
| style="padding: 5px | | style="padding: 5px" | Device tree blob for SOMs with eMMC. | ||
|- | |- | ||
| style="padding: 5px" | zImage-imx7d-var-som-nand.dtb | |||
| style="padding: 5px" | Device tree blob for SOMs with NAND flash. | |||
|} | |} | ||
== | = Installing the Yocto binaries = | ||
If you followed the [[VAR-SOM-MX7 Yocto Jethro R1 build#Create an extended SD card|Create an extended SD card]] steps, the [[#Images_locations|Yocto binaries]] and the [[#Flashing_script|flashing script]] will be included in your SD card.<br> | |||
Following is the directory structure on your SD card, which elaborates the files' location that the below | The flashing script is an easy-to-use example script for flashing images into NAND flash / eMMC.<br> | ||
<pre> | There are also sections below describing how to flash the images manually to [[#Manual_step-by-step_flashing_to_NAND_flash|NAND flash]] and to [[#Manual_step-by-step_flashing_to_eMMC|eMMC]]. | ||
/opt/images/ | |||
== Images locations == | |||
Following is the directory structure on your SD card, which elaborates the files' location that the below installation script is expecting: | |||
<pre>/opt/images/ | |||
└── Yocto | └── Yocto | ||
├── imx7d-var-som-emmc.dtb | |||
├── imx7d-var-som-nand.dtb | |||
├── rootfs.tar.bz2 | ├── rootfs.tar.bz2 | ||
├── rootfs.ubi | ├── rootfs.ubi | ||
├── u-boot. | ├── u-boot.imx-nand | ||
├── u-boot.imx-sd | |||
└── zImage | |||
├── | |||
└── | |||
</pre> | </pre> | ||
== Prepare images for NAND flash / eMMC flashing == | === Prepare the images for NAND flash / eMMC flashing === | ||
Plug the bootable SD card into your host machine | Plug the bootable SD card into your host machine and mount the rootfs partition - here we assume it is mounted on /media/rootfs.<br> | ||
Copy all the mentioned yocto-built binaries to the SD card:<br> | |||
Copy all the mentioned yocto-built binaries to the SD card: | * <span style="color:red">Note:</span> If you followed the [[VAR-SOM-MX7 Yocto Jethro R1 build#Create an extended SD card|Create an extended SD card]] steps, the [[#Flashing script|flashing script]] and all relevant binaries are already included in your SD card, and the below commands are redundant!<br> | ||
<br> | |||
* <span style="color:red">Note:</span> If you followed the [[VAR-SOM- | |||
<pre> | <pre> | ||
$ export YOCTO_IMGS_PATH=~/var- | $ export YOCTO_IMGS_PATH=~/var-mx6ul-mx7-yocto-jethro/build_x11/tmp/deploy/images/imx7-var-som | ||
$ export P2_MOUNT_DIR=/media/rootfs/ | $ export P2_MOUNT_DIR=/media/rootfs/ | ||
</pre> | |||
<pre> | |||
Linux: | Linux: | ||
$ sudo cp ${YOCTO_IMGS_PATH}/ | $ sudo cp ${YOCTO_IMGS_PATH}/zImage ${P2_MOUNT_DIR}/opt/images/Yocto/ | ||
</pre> | |||
NAND images: | |||
<pre> | |||
Device Tree: | |||
$ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-nand.dtb ${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-nand.dtb | |||
U-Boot: | |||
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot.imx-nand ${P2_MOUNT_DIR}/opt/images/Yocto/ | |||
$ sudo cp ${YOCTO_IMGS_PATH}/u-boot-nand | |||
File System: | File System: | ||
$ sudo cp ${YOCTO_IMGS_PATH}/fsl-image-gui- | $ sudo cp ${YOCTO_IMGS_PATH}/fsl-image-gui-imx7-var-som.ubi ${P2_MOUNT_DIR}/opt/images/Yocto/rootfs.ubi | ||
</pre> | |||
eMMC images: | |||
<pre> | |||
Device Tree: | Device Tree: | ||
$ sudo cp ${YOCTO_IMGS_PATH}/ | $ sudo cp ${YOCTO_IMGS_PATH}/zImage-imx7d-var-som-emmc.dtb ${P2_MOUNT_DIR}/opt/images/Yocto/imx7d-var-som-emmc.dtb | ||
U-Boot: | |||
$ sudo cp ${YOCTO_IMGS_PATH}/ | $ sudo cp ${YOCTO_IMGS_PATH}/u-boot.imx-sd ${P2_MOUNT_DIR}/opt/images/Yocto/ | ||
File System: | |||
$ sudo cp ${YOCTO_IMGS_PATH}/ | $ sudo cp ${YOCTO_IMGS_PATH}/fsl-image-gui-imx7-var-som.tar.bz2 ${P2_MOUNT_DIR}/opt/images/Yocto/rootfs.tar.bz2 | ||
</pre> | </pre> | ||
== | == Flashing script == | ||
The flashing | |||
The flashing script is located on the SD card at /usr/bin/: | |||
<pre>install_yocto.sh - Flash Yocto into NAND flash or eMMC (Run and follow usage instructions) | |||
</pre> | |||
== Manual step-by-step flashing to NAND flash == | |||
Use the prepared SD card to boot the board and run the following: | |||
<br><br> | |||
<pre> | <pre> | ||
$ cd /opt/images/Yocto | |||
</pre> | </pre> | ||
Flash U-Boot to NAND flash: | |||
<pre> | <pre> | ||
$ flash_erase /dev/mtd0 0 0 | $ flash_erase /dev/mtd0 0 0 | ||
$ kobs-ng init -x | $ kobs-ng init -x u-boot.imx-nand --search_exponent=1 -v | ||
$ flash_erase /dev/ | $ flash_erase /dev/mtd2 0 0 | ||
</pre> | </pre> | ||
Flash the Linux Kernel image & Device Tree to NAND flash: | |||
<pre> | <pre> | ||
$ flash_erase /dev/mtd3 0 0 | |||
$ flash_erase /dev/ | $ nandwrite -p /dev/mtd3 zImage | ||
$ nandwrite -p /dev/ | $ nandwrite -p /dev/mtd3 -s 0x7e0000 imx7d-var-som-nand.dtb | ||
$ nandwrite -p /dev/ | |||
</pre> | </pre> | ||
Flash the UBI File System to NAND flash: | |||
<pre> | <pre> | ||
$ ubiformat /dev/mtd4 -f rootfs.ubi | |||
$ ubiformat /dev/ | |||
</pre> | </pre> | ||
== | == Manual step-by-step flashing to eMMC == | ||
Flashing eMMC requires several steps including | |||
Flashing the eMMC requires several steps including flashing of U-Boot and the Linux kernel, partitioning, file system formatting and image extraction.<br> | |||
We recommend to use our provided scripts to perform this task.<br> | We recommend to use our provided scripts to perform this task.<br> | ||
<br> | <br> | ||
Use the prepared SD card to boot the board and run the following: | |||
<br><br> | |||
<pre> | <pre> | ||
$ export node=/dev/ | $ export node=/dev/mmcblk2 | ||
$ cd /opt/images/Yocto | $ cd /opt/images/Yocto | ||
</pre> | </pre> | ||
Line 160: | Line 175: | ||
Create a partition table: | Create a partition table: | ||
<pre> | <pre> | ||
$ (echo n; echo p; echo 1; echo; echo; echo p; echo w) | fdisk -u $node | $ (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 | $ sync | ||
</pre> | </pre> | ||
Format the | Format the partitions: | ||
<pre> | <pre> | ||
$ mkfs.ext4 ${node} | $ mkfs.vfat ${node}p1 -n BOOT-VARMX7 | ||
$ mkfs.ext4 ${node}p2 -L rootfs | |||
$ sync | |||
</pre> | </pre> | ||
Flash | Flash U-Boot to eMMC: | ||
<pre> | <pre> | ||
$ | $ dd if=u-boot.imx-sd of=${node} bs=1K seek=1; sync | ||
</pre> | </pre> | ||
Copy the Linux kernel image and the device tree blob to the BOOT partition: | |||
<pre> | <pre> | ||
$ | $ 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 | |||
</pre> | </pre> | ||
Extract the rootfs archive: | |||
<pre> | <pre> | ||
$ mkdir /run/media/mmcblk2p2 | |||
$ mount ${node}p2 /run/media/mmcblk2p2 | |||
$ tar xvpf rootfs.tar.bz2 -C /run/media/mmcblk2p2 | |||
$ sync | |||
$ umount /run/media/mmcblk2p2 | |||
</pre> | </pre> | ||
= Summary = | = Summary = | ||
This page is not valid for DART-MX6. For DART-MX6, please follow the link to the relevant page.<br> | This page is not valid for DART-MX6. For DART-MX6, please follow the link to the relevant page.<br> | ||
We described the results of a Yocto build, how to copy it to a bootable SD card and how to flash it to NAND and eMMC.<br> | We described the results of a Yocto build, how to copy it to a bootable SD card and how to flash it to NAND and eMMC.<br> | ||
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. | 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. |
Revision as of 13:21, 1 September 2016
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 filesystem.
For NAND flash we use a UBI file system and for eMMC we use ext4.
NAND 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-0x000040000000 : "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.
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. |
u-boot.imx-sd | U-Boot image. Used here for eMMC. |
u-boot.imx-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 ├── u-boot.imx-nand ├── u-boot.imx-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:
- Note: If you followed the Create an extended SD card steps, the flashing script and all relevant binaries are already included in your SD card, and the below commands are redundant!
$ 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 U-Boot: $ sudo cp ${YOCTO_IMGS_PATH}/u-boot.imx-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 U-Boot: $ sudo cp ${YOCTO_IMGS_PATH}/u-boot.imx-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 U-Boot to NAND flash:
$ flash_erase /dev/mtd0 0 0 $ kobs-ng init -x u-boot.imx-nand --search_exponent=1 -v $ flash_erase /dev/mtd2 0 0
Flash the Linux Kernel image & Device Tree 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 U-Boot to eMMC:
$ dd if=u-boot.imx-sd of=${node} bs=1K seek=1; 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
This page is not valid for DART-MX6. For DART-MX6, please follow the link to the relevant page.
We described the results of a Yocto build, how to copy it to a bootable SD card and how to flash it to NAND and 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.