Introduction
In this training, you will configure and program the SAM9X60-EK evaluation kit to boot the second-stage bootloader at91bootstrap, third-stage bootloader u-boot-at91, Flattened Image Tree (FIT) (containing the Linux kernel and Device Tree), and Root File System (RFS) from NAND Flash memory.
You will use the SAM-BA® In-System Programmer to write binary files to the NAND Flash memory.
Steps:
- SAM-BA In-System Programmer
- Erase NAND Flash Memory
- Build at91bootstrap and Write to NAND Flash Memory
- Build u-boot-at91 and Write to NAND Flash Memory
- Create u-boot-env.bin and Write to NAND Flash Memory
- Build the Linux Kernel Image and Device Tree Blob (DTB)
- Create Flattened Image Tree (FIT) and Write to NAND Flash Memory
- Prepare a Root File System (RootFS) for NAND Flash Memory
- Boot from NAND Flash Memory
Prerequisites
Familiar with the features of the SAM9X60-EK evaluation kit:
A working cross-toolchain for ARM-based MPU target
Familiar with the operation of the SAM-BA In-System Programmer (ISP):
Set up Console Serial Communications with the SAM9X60-EK:
Knowledge of the Boot Process:
Hardware
For this training, you will be using the SAM9X60-EK. You will also need two USB Micro-B cables. One cable will connect the Host PC to the target console to view SAM-BA Monitor log message. The second cable will connect the Host PC to the target USBA port (J7) so that the SAM-BA Host can communicate with the SAM-BA Monitor.
Bootable Memory
The SAM9X60-EK evaluation kit has a 4 Gb (512 M x 8) NAND Flash memory (U9) (Micron MT29F4G08ABAEA) that may be used for booting an embedded Linux system.
You will configure and build bootable files at91bootstrap, u-boot-at91, Flattened Image Tree (FIT) (containing the Linux kernel and device tree), and Root File System (RFS) to be flashed into U9 using the SAM-BA In-System Programmer (ISP).
SAM-BA In-System Programmer
In this section, you will load the SAM-BA Host Application (if you have not already done so) and set up Console and SAM-BA Host to Monitor communications.
1
Set up SAM9X60-EK Console Serial Communications.
To view the SAM-BA Monitor log messages, set up console serial communications following the instructions in the "SAM9X60-EK -- Console Serial Communications" page.
You have two choices in connecting to a serial port on the SAM9X60-EK:
- the first is using a USB cable to connect to the J-LINK-OB port (J22), or
- the second is using a USB-to-TTL converter, connect to the UART Debug port (J24).
You also have two choices in powering the SAM9X60-EK:
- using an external 5 VDC power supply connected to J1 (coaxial power jack), or
- using a USB cable connect to the USBA port (J7). As you’ll be connecting a USB cable in Step 3 below (SAM-BA Host to Monitor Communications), this is the easiest method.
Operation of the J-Link Debugger will be displayed by a flashing green LED (D9).
2
If not already installed, install the SAM-BA Host Application.
SAM-BA Host application should be added to the system PATH variable.
$ export PATH=$PATH:<path_to_sam-ba>
This will enable you to access the SAM-BA Host from anywhere on your system.
3
Set up SAM-BA Host to Monitor Serial Communications.
a
To communicate with SAM-BA Monitor on the target, you must install the SAM-BA Host on a Linux PC (Step 2 above) and connect a USB Micro-B cable from the host PC to the USBA port (J7) on the SAM9X60-EK as shown in the figure below.
You may power the SAM9X60-EK one of two ways:
- using an external 5 VDC power supply connected to J1 (coaxial power jack), or
- using a USB cable connect to the USBA port (J7).
b
Ensure there is no SD Memory Card in slot J4.
c
Open jumper the DISABLE_BOOT (J13).
This will allow booting from the onboard memories (NAND and QSPI Flash).
d
Press both the DIS_BOOT (SW4) and RESET (SW3) push buttons.
Pressing the DIS_BOOT (SW4) push button disables booting from the onboard memories.
e
Continue pressing DIS_BOOT(SW4) while releasing the RESET (SW3) push button.
The SAM9X60-EK will boot to the SAM-BA Monitor and start communications with the SAM-BA Host. Observe ROMBoot on the Console (terminal emulator) indicating the SAM-BA Monitor is running.
Erase NAND Flash Memory
In this section, you will erase the contents of the NAND Flash Memory located on the SAM9X60-EK. This is a necessary step before writing data to the NAND Flash Memory.
1
Erase NAND Flash Memory
Erase the contents of the NAND Flash Memory on the SAM9X60-EK with the following command:
The default PMECC parameter for the sam9x60ek board is 0xc1e04e07. It is valid for the NAND Flash Memory (U9) onboard the SAM9X60-EK when sam-ba command is invoked with the -b sam9x60-ek option.
Refer SAM9X60 datasheet Section 12.4.7. Detailed Memory Boot Procedures and section 35. Programmable Multibit Error Correction Code Controller (PMECC) for more information.
Build at91bootstrap and Write to NAND Flash Memory
In this section, you will configure and build the second-stage bootloader, at91bootstrap, from source code to boot from NAND Flash Memory and write it to NAND Flash Memory.
For more information, including how to download, see the "at91bootstrap: A Second Stage Bootloader for Microchip Microprocessors" training.
1
Change directory into the at91bootstrap directory:
$ cd ~/at91bootstrap
2
Using a default configuration file, configure at91bootstrap to boot u-boot from NAND Flash Memory:
$ make mrproper
# CLEAN obj and misc files!
# CLEAN configuration files!
# CLEAN binary files!
$ make sam9x60eknf_uboot_defconfig
#
# configuration written to .config
#
#
# make dependencies written to .auto.deps
# See top of this file before playing with this auto-prerequisites!
#
What is the difference between make clean and make mrproper?
- make clean - Remove most generated files but keep the config and enough build support to build external modules.
- make mrproper - Remove all generated files + config + various backup files.
Anytime the configuration is changed, you should execute make mrproper.
Default configuration (defconfig) files are provided for the many evaluation kits sold by Microchip. They are located in the ~/at91bootstrap/board/ directory.
3
Optional: If you would like to verify the NAND Flash Memory settings or make any customizations:
$ make menuconfig
a
Observe that Board Type (sam9X60ek) has been selected.
b
Highlight Memory selection ---> and press ENTER.
You may exit menuconfig by repeatedly typing "ESC-ESC" until it closes. Do not save any changes.
4
Build at91bootstrap:
$ make
A working cross-toolchain for ARM-based MPU target is required to build at91bootstrap.
Ensure you set the CROSS_COMPILE=<cross_compiler> and ARCH=arm environment variables.
For example, if your cross-compiler executable is arm-linux-gcc then CROSS_COMPILE=<path_to>/arm-linux-
Another method is to include these as command variables. For example:
$ make ARCH=arm CROSS_COMPILE=<path_to>/<cross_compiler>
Once the build is complete, the resulting binary files are in the ~/at91bootstrap/binaries/ directory:
$ cd ~/at91bootstrap/binaries
$ ls
at91bootstrap.bin
boot.bin
sam9x60ek-nandflashboot—uboot-3.9.2.bin
sam9x60ek-nandflashboot—uboot-3.9.2.bin.pmecc
sam9x60ek-nandflashboot-uboot—3.9.2.elf
sam9x60ek-nandflashboot-uboot—3.9.2.map
5
From the SAM-BA Host command line, write at91bootstrap.bin to NAND Flash Memory starting at location 0x0 using the nandflash applet writeboot command:
$ sam-ba -p serial -b sam9x60-ek -a nandflash -c writeboot:at91bootstrap.bin
Opening serial port 'ttyACM0'
Connection opened.
Detected memory size is 536870912 bytes.
Page size is 4096 bytes.
Buffer is 8192 bytes (2 pages) at address 0x0030aca0.
NAND header value is 0xc1e04e07.
Supported erase block size: 256KB
Executing command 'write:at91bootstrap.bin'
Appending 3588 bytes of padding to fill the last written page
Wrote 8192 bytes at address 0x00000000 (50%)
Wrote 8192 bytes at address 0x00002000 (100%)
Connection closed.
For more information on the SAM-BA Applet nandflash command, see the "SAM-BA ISP - Applets: Program External NAND Flash Memory" page.
The result is at91bootstrap.bin is stored in the NAND Flash Memory starting at address 0x0.
Build u-boot-at91 and Write to NAND Flash Memory
In this section, you will configure and build the third-stage bootloader, u-boot-at91, from source code to boot from NAND Flash Memory and write it to NAND Flash Memory.
u-boot-at91 is maintained by Microchip Technology and hosted on GitHub.
For more information about the third-stage bootloader see: Das U-Boot – The Universal Boot Loader.
1
Change directory to your working directory containing the u-boot-at91:
$ cd ~/u-boot-at91
2
Using a default configuration file, configure u-boot-at91 for NAND Flash Memory:
$ make sam9x60ek_nandflash_defconfig
HOSTCC scripts/basic/fixdep
HOSTCC scripts/kconfig/conf.o
HOSTCC scripts/kconfig/zconf.tab.o
HOSTLD scripts/kconfig/conf
#
# configuration written .config
#
3
Optional: If you would like to verify settings for booting from NAND Flash Memory or make any customizations, type:
$ make menuconfig
a
Highlight Boot media ---> and press ENTER.
b
Observe that [*] Support for booting from NAND flash ---> has been selected.
You may exit menuconfig by repeatedly typing "ESC-ESC" until it closes. Do not save any changes.
4
Build u-boot-at91:
$ make
A working cross-toolchain for ARM-based MPU target is required to build at91bootstrap.
Ensure you set the CROSS_COMPILE=<cross_compiler> and ARCH=arm environment variables.
For example, if your cross-compiler executable is arm-linux-gcc then CROSS_COMPILE=<path_to>/arm-linux-
Another method is to include these as command variables. For example:
$ make ARCH=arm CROSS_COMPILE=<path_to>/<cross_compiler>
Once the build is complete, the resulting binary file u-boot.bin is in the u-boot-at91 directory.
5
From the SAM-BA Host command line, write u-boot.bin to NAND Flash Memory starting at location 0x40000 using the applet -a nandflash -c write command:
$ sam-ba -p serial -b sam9x60-ek -a nandflash -c write:u-boot.bin:0x40000
Opening serial port 'ttyACM0'
Connection opened.
Detected memory size is 536870912 bytes.
Page size is 4096 bytes.
Buffer is 8192 bytes (2 pages) at address 0x0030aca0.
NAND header value is 0xc1e04e07.
Supported erase block size: 256KB
Executing command 'write:u-boot.bin:0x40000'
Appending 2794 bytes of padding to fill the last written page
Wrote 8192 bytes at address 0x00040000 (1.41%)
Wrote 8192 bytes at address 0x00042000 (2.82%)
…
…
Wrote 8192 bytes at address 0x000ca000 (98.59%)
Wrote 8192 bytes at address 0x000cc000 (100%)
Connection closed.
The result is u-boot.bin is stored on the NAND Flash Memory starting at address 0x40000.
Create u-boot-env.bin and Write to NAND Flash Memory
U-Boot configuration is performed using environment variables. They are stored in binary format, generally, on the same boot memory (mass storage) that U-Boot is stored.
In this section, you will create a U-Boot environment binary file by first creating a text file. The text file is then converted to binary format using a utility program mkenvimage. Finally, you will write the file to NAND Flash Memory using the SAM-BA In-System Programmer (ISP).
More information on U-Boot Environment Variables can be found in the U-Boot Manual Section 5.10.
1
Using your favorite text editor, create a text file with the following information. Name the text file u-boot-env.txt.
baudrate=115200
bootargs=console=ttyS0,115200 mtdparts=atmel_nand:256k(bootstrap)ro,768k(uboot)ro,256k(env_redundant),256k(env),6656k(itb)ro,-(rootfs) rootfstype=ubifs ubi.mtd=11 root=ubi0:rootfs rw atmel.pm_modes=standby,ulp0
bootcmd=nand read 0x24000000 0x00180000 0x49b46c; bootm 0x24000000#kernel_dtb
bootdelay=1
stderr=serial
stdin=serial
stdout=serial
The bootargs line tells U-Boot:
- The console= device and baud
- The root= location of the root filesystem and permissions
- The rootfstype= root filesystem type
The bootcmd= line tells U-Boot to load the sam9x60ek.itb file from address 0x00180000 of NAND Flash memory to external DDR2 SDRAM starting at address 0x24000000.
2
Convert the text file u-boot-env.txt into a binary file u-boot-env.bin using the utility program mkenvimage.
The mkenvimage utility program generates a valid binary environment image from a text file. It is part of the U-Boot software package. See directory ../u-boot-at91/tools/.
The -s option allows you to specify the size of the image to create. It must match the size of the flash area reserved for the U-Boot environment.
$ mkenvimage -s 0x20000 -o u-boot-env.bin u-boot-env.txt
Build the Linux Kernel Image and Device Tree Blob (DTB)
In this section, you will configure the Linux kernel and device tree for the SAM9X60-EK evaluation kit using default configuration and build the files. In the next section, you will use these files to create a Flattened Image Tree (FIT) image and write it to NAND Flash Memory.
linux-at91 is maintained by Microchip Technology and hosted on GitHub
1
Change directory to your working directory containing the linux-at91 source code:
$ cd ~/linux-at91
2
Using default configuration files, configure the Linux kernel using the following command:
$ make ARCH=arm at91_dt_defconfig
HOSTCC scripts/basic/fixdep
HOSTCC scripts/kconfig/conf.o
HOSTCC scripts/kconfig/confdata.o
HOSTCC scripts/kconfig/expr.o
LEX scripts/kconfig/lexer.lex.c
YACC scripts/kconfig/parser.tab.[ch]
HOSTCC scripts/kconfig/lexer/lex.o
HOSTCC scripts/kconfig/parser.tab.o
HOSTCC scripts/kconfig/preprocess.o
HOSTCC scripts/kconfig/symbol.o
HOSTLD scripts/kconfig/conf
#
# configuration written to .config
#
4
Build linux-at91:
$ make ARCH=arm
A working cross-toolchain for ARM-based MPU target is required to build at91bootstrap.
Ensure you set the CROSS_COMPILE=<cross_compiler> and ARCH=arm environment variables.
For example, if your cross-compiler executable is arm-linux-gcc then CROSS_COMPILE=<path_to>/arm-linux-
Another method is to include these as command variables. For example:
$ make ARCH=arm CROSS_COMPILE=<path_to>/<cross_compiler>
Once the build is complete, the resulting binary files are created:
/arch/arm/boot/zImage
/arch/arm/boot/dts/at91-sam9x60ek.dtb
Create Flattened Image Tree (FIT) and Write to NAND Flash Memory
In this section, you will create a Flattened Image Tree (FIT). The FIT image allows for more flexibility in handling images of various types and enhances integrity protection of images with stronger checksums. An Image Source (*.its) file and a set of data files are used as an input. An Image Tree Blob (*.itb) file is generated as the output. Finally, you will write the FIT image to NAND Flash Memory.
1
Git clone the Device Tree Overlay files from the Linux4SAM repository:
$ git clone git://github.com/linux4sam/dt-overlay-at91.git
2
Change directory to your working directory containing the dt-overlay-at91:
$ cd ~/dt-overlay-at91
3
Open Makefile with your favorite editor and verify that the KERNEL_DIR is pointing to your linux-at91 directory:
CC?=$(CROSS_COMPILE)gcc
DTC_OPTIONS?=-@
DTC_OPTIONS += -Wno-unit_address_vs_reg -Wno-graph_child_address -Wno_pwms_property
KERNEL_DIR?=../linux-at91 <--- Ensure pointing to your linux-at91 directory
KERNEL_BUILD_DIR?=$(KERNEL_DIR)
DTC?=$(KERNEL_BUILD_DIR)/scripts/dtc/dtc
Or you can set the KERNEL_DIR environment variable:
$ export KERNEL_DIR=path
$ echo $KERNEL_DIR
4
Build the *.itb image file:
$ make sam9x60ek.itb
Once the build is complete, the resulting image file sam9x60ek.itb is located in the dt-overlay-at91 directory.
5
Write Image Tree Blob (ITB) to NAND Flash Memory using the following command:
$ sam-ba -p serial -b sam9x60-ek -a nandflash -c write:sam9x60ek.itb:0x180000
Opening serial port 'ttyACM0'
Connection opened.
Detected memory size is 536870912 bytes.
Page size is 4096 bytes.
Buffer is 8192 bytes (2 pages) at address 0x0030aca0.
NAND header value is 0xc1e04e07.
Supported erase block size: 256KB
Executing command 'write:sam9x60ek.itb:0x180000'
Wrote 8192 bytes at address 0x00180000 (0.17%)
Wrote 8192 bytes at address 0x00142000 (0.34%)
…
…
Wrote 8192 bytes at address 0x0015c000 (99.83%)
Wrote 8192 bytes at address 0x0015e000 (100%)
Connection closed.
The result is the Flattened Image Tree (FIT) is stored in the NAND Flash Memory starting at address 0x180000.
Prepare a Root File System (ROOTFS) for NAND Flash Memory
In this section, you will download a demonstration image from the Linux4SAM website to use the ROOTFS on the image. You will Flash the image to NAND Flash Memory.
1
Download SAM9X60-EK demonstration package from the Linux4SAM website.
The latest demonstration images for the SAM9X60-EK are available on the Linux4SAM website. There you will find the demonstration package for NAND Flash Memory.
Download and extract the linux4sam-poky-sam9x60ek-headless-2020.04.zip file.
2
Flash the RootFS image to NAND Flash Memory.
Once you have the package extracted you will use the microchip-headless-image-sam9x60ek.ubi file. This is the RootFS in the Unsorted Block Image File System (UBIFS) format.
Write to NAND Flash Memory using the following command:
$ sam-ba -p serial -b sam9x60-ek -a nandflash -c write:microchip-headless-image-sam9x60ek.ubi:0x800000
Opening serial port 'ttyACM0'
Connection opened.
Detected memory size is 536870912 bytes.
Page size is 4096 bytes.
Buffer is 8192 bytes (2 pages) at address 0x0030aca0.
NAND header value is 0xc1e04e07.
Supported erase block size: 256KB
Executing command 'write:microchip-headless-image-sam9x60ek.ubi:0x800000'
Wrote 8192 bytes at address 0x00800000 (0.01%)
Wrote 8192 bytes at address 0x00802000 (0.01%)
…
…
Wrote 8192 bytes at address 0x0015c000 (99.83%)
Wrote 8192 bytes at address 0x0015e000 (100%)
Connection closed.
The result is the Root File System is stored in the NAND Flash Memory starting at address 0x800000.
Boot from NAND Flash Memory
1
Check that you have Console Serial Communications established.
Review STEP 1 of the SAM-BA In-System Programmer section above.
2
Check that jumper the DIS_BOOT (J13) is open.
This will allow booting from the onboard memories (NAND and QSPI Flash).
Proper operation of the image will be indicated by a flashing blue RGB LED (LD1).
If Console Serial Communications is connected to J22, operation of the onboard J-Link Debugger will be indicated by a flashing green LED (D9).
Congratulations! You have created an embedded Linux system that boots from NAND Flash memory.
Summary
In this training, you configured and built the second-stage bootloader at91bootstap, the third-stage bootloader u-boot-at91, Linux kernel, and device tree. You created a Flattened Image Tree (FIT) containing the Linux kernel and device tree. You prepared a Root File System (RootFS) in the UBIFS format from a Linux4SAM demonstration image. Each of these you individually wrote to NAND Flash Memory. The result is an embedded Linux system that boots from NAND Flash Memory.