Sama5D4 EK

SoC Features

The SAMA5D4 MPU is ideal for any high-performance, secure, and cost-sensitive industrial application. High-speed computing needs are supported by ARM Neon and 128kB L2 cache which increases the overall system performance. The SAMA5D4 is an ideal fit for low-cost user interface applications that require video playback. The high-grade security features allows you to protect any system against counterfeiting and software theft, and allows you to securely store and transfer data.

Kit Information

Kit Overview

Access the console

Access the console on DBGU serial port

The DBGU serial console can be accessed from two connectors. One is from the RS-232 connector (marked as DBGU J24), another is from micro-A USB connector that gives access to the on-board serial-USB converter (marked as J22 OB-JLink).

The JP19 and JP20 jumpers are used to select which port is used to access DBGU serial console.

Using RS-232 connector (DBGU J24)

• Open JP21 to enable DBGU
• Choose (1-2) for JP19 and JP20 jumper settings
• Connect a DB9 serial cable to the J24 connector
• Now open your favorite terminal emulator with appropriate settings

Using the micro-A USB connector (J22 OB-JLink)

You can also access the serial console through the on-board serial-USB converter. In fact, the Cortex-M3 chip underneath the Evaluation Kit acts as a serial-to-USB converter and is loaded with a firmware that is able to speak USB-CDC.

• For Microsoft Windows users: Install the J-Link CDC USB driver. No need to install a driver on any regular Linux distribution.
• Open JP21 to enable DBGU
• Open JP10 to enable CDC for OB-JLINK
• Choose (2-3) for JP19 and JP20 jumper settings
• Connect the USB cable to the board (J22 OB-JLink)
  • For Microsoft Windows users: identify the USB connection that is established
    JLink CDC UART Port should appear in Device Manager. The COMxx number will be used to configure the terminal emulator.
    
  • For Linux users: identify the USB connection by monitoring the last lines of dmesg command. The /dev/ttyACMx number will be used to configure the terminal emulator.

• Now open your favorite terminal emulator with appropriate settings

Demo

Demo archives

You need a 1 GB (or larger) SD card and to download the image of the demo. The image is compressed to reduce the amount of data to download. This image contains:

• a FAT32 partition with the AT91Bootstrap, U-Boot and the Linux Kernel (zImage and dtb), and
• an EXT4 partition for the rootfs.

Multi-Platform Procedure

To write the compressed image on the SD card, you will have to download and install balenaEtcher. This open-source software tool is useful for obtaining a compressed image as input. Additional information and support can be found on the  balenaEtcher website. 

Build From source code

Setup ARM Cross Compiler

• First step is to dowload the ARM GNU Toolchain:
  wget -c https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz

• Next step is to add the ARM GNU Toolchain into your system:
  tar -xf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz
  export CROSS_COMPILE=`pwd`/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-

  or

  tar -xf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz
  export CROSS_COMPILE=arm-none-linux-gnueabihf-
  export PATH=$PATH:/YOUR/PATH/TO/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-linux-gnueabihf/bin/
• export PATH=${PATH/':/YOUR/PATH/TO/arm-gnu-toolchain-VERSION-x86_64-arm-none-linux-gnueabihf/bin/'/}

Build AT91Bootstrap from sources

This section describes how to get source code from the git repository, how to configure with the default configuration, how to customize AT91Bootstrap based on the default configuration and finally to build AT91Bootstrap to produce the binary. take the default configuration to download U-Boot from NandFlash for example.

Get AT91Bootstrap Source Code

You can easily download AT91Bootstrap source code on the at91bootstrap git repository.

To get the source code, you should clone the repository by doing:

Configure AT91Bootstrap

Assuming you are at the AT91Bootstrap root directory, you will find a board/sama5d4ek folder which contains several default configuration files:

You can configure AT91Bootstrap to load U-Boot binary from NAND flash by doing:

If the configuring process is successful, the .config file can be found at AT91Bootstrap root directory.

build/binaries/at91bootstrap.bin.

Customize AT91Bootstrap

If the default configuration doesn't meet your need, after configuring with the default configuration, you can customize it by doing:

Now, in the menuconfig dialog, you can easily add or remove some features to/from AT91Bootstrap as the same way as kernel configuration.
Move to <Exit> with arrows and press this button hitting the Enter key to exit from this screen.

Build AT91Bootstrap

Then you can build the AT91Bootstrap binary by doing:

If the building process is successful, the final .bin image is build/binaries/at91bootstrap.bin.

Build U-Boot from sources

Getting U-Boot sources

Dedicated page on U-Boot wiki: http://www.denx.de/wiki/U-Boot/SourceCode

You can easily download U-Boot source code from Linux4Microchip GitHub U-Boot repository:

• clone the Linux4microchip GitHub U-Boot repository
      $ git clone https://github.com/linux4microchip/u-boot-mchp.git
   Cloning into 'u-boot-mchp'...
   remote: Enumerating objects: 951876, done.
   remote: Counting objects: 100% (17718/17718), done.
   remote: Compressing objects: 100% (5735/5735), done.
   remote: Total 951876 (delta 12391), reused 15314 (delta 11846), pack-reused 934158
   Receiving objects: 100% (951876/951876), 164.77 MiB | 401.00 KiB/s, done.
   Resolving deltas: 100% (790362/790362), done.
     $ cd u-boot-mchp/

• The source code has been taken from the master branch which is pointing to the latest branch we use. If you want to use the other branch, you can list them and use one of them by doing:
     $ git branch -r
    origin/HEAD -> origin/master
    origin/dev/tony/sama7g5ek_optee
    origin/master
    origin/sam9x60_curiosity_early
    origin/sam9x60_early
    origin/sam9x60_iar
    origin/sam9x7_early
    origin/sama5d27wlsom1ek_ear
    origin/sama7g5_early
    origin/u-boot-2012.10-at91
    origin/u-boot-2013.07-at91
    origin/u-boot-2014.07-at91
    origin/u-boot-2015.01-at91
    origin/u-boot-2016.01-at91
    origin/u-boot-2016.03-at91
    origin/u-boot-2017.03-at91
    origin/u-boot-2018.07-at91
    origin/u-boot-2019.04-at91
    origin/u-boot-2020.01-at91
    origin/u-boot-2021.04-at91
    origin/u-boot-2022.01-at91
    origin/u-boot-2023.07-mchp
    origin/u-boot-2024.07-mchp
    origin/uboot_5series_1.x
  
     $ git checkout origin/u-boot-2024.07-mchp -b u-boot-2024.07-mchp
    Branch 'u-boot-2024.07-mchp' set up to track remote branch 'u-boot-2024.07-mchp' from 'origin'.
    Switched to a new branch 'u-boot-2024.07-mchp'

Cross-compiling U-Boot

Before compiling the U-Boot, you need setup cross compile toolchain in the section.

Once the AT91 U-Boot sources available, cross-compile U-Boot is made in two steps: configuration and compiling. Check the Configuration chapter in U-Boot reference manual.

The U-Boot environment variables can be stored in different media, above config files can specify where to store the U-Boot environment.

Here are the building steps for the SAMA5D4EK board:

The result of these operations is a fresh U-Boot binary called u-boot.bin corresponding to the binary ELF file u-boot.

• u-boot.bin is the file you should store on the board
• u-boot is the ELF format binary file you may use to debug U-Boot through a JTag link for instance.

Build Kernel from sources

Required packages

You must install essential host packages on your build host. These requirements are listed in the Linux kernel documentation with the chapter Install build requirements. You must follow this process which includes, but not limited to, the following packages:

• build-essential
• flex
• bison
• git
• perl-base
• libssl-dev
• libncurses5-dev
• libncursesw5-dev
• ncurses-dev

Getting Kernel sources

To get the source code, you have to clone the repository:

The source code has been taken from the master branch which is pointing on the latest branch we use.

If you want to use another branch, you can list them and use one of them by doing this:

Setup ARM Cross Compiler

• First step is to dowload the ARM GNU Toolchain:

  wget -c https://developer.arm.com/-/media/Files/downloads/gnu/13.2.rel1/binrel/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz 

• Next step is to add the ARM GNU Toolchain into your system:

  tar -xf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz
  export CROSS_COMPILE=`pwd`/arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf/bin/arm-none-linux-gnueabihf-

  or

  tar -xf arm-gnu-toolchain-13.2.rel1-x86_64-arm-none-linux-gnueabihf.tar.xz
  export CROSS_COMPILE=arm-none-linux-gnueabihf-
  export PATH=$PATH:/YOUR/PATH/TO/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-linux-gnueabihf/bin/

  • Information

     If you already have an old ARM GNU Toolchain need to clean up the PATH with:

    export PATH=${PATH/':/YOUR/PATH/TO/arm-gnu-toolchain-VERSION-x86_64-arm-none-linux-gnueabihf/bin/'/}
        

  Configure and Build the Linux kernel

  Now you have to configure the Linux kernel according to your hardware. We have two default configuration at91 SoC in arch/arm/configs

  arch/arm/configs/at91_dt_defconfig
  arch/arm/configs/sama5_defconfig
  arch/arm/configs/sama7_defconfig

  • at91_dt_defconfig: for SAM9 (ARM926) series chips
  • sama5_defconfig: for SAMA5 series chips
  • sama7_defconfig: for SAMA7 series chips

   

Now we Configure and Build kernel for sama5d4ek board:

At this step, you can modify default configuration using the menuconfig

• $ make ARCH=arm menuconfig

  Now, in the menuconfig dialog, you can easily add or remove some features. Once done, Move to <Exit> with arrows and press this button hitting the Enter key to exit from this screen.

  Build the Linux kernel image, before you build you need set up the cross compile toolchain, check this section.

  $ make ARCH=arm
  
  [..]
  
    Kernel: arch/arm/boot/Image is ready
    Kernel: arch/arm/boot/zImage is ready

  Now you have an usable compressed kernel image zImage.

  If you need an uImage you can run this additional step:

  make ARCH=arm uImage LOADADDR=0x20008000
  
  [..]
  
  Kernel: arch/arm/boot/Image is ready
  Kernel: arch/arm/boot/zImage is ready
  UIMAGE  arch/arm/boot/uImage
  Image Name:   Linux-6.12.22-linux4microchip-20
  Created:      Thu May 22 18:05:21 2025
  Image Type:   ARM Linux Kernel Image (uncompressed)
  Data Size:    5688984 Bytes = 5555.65 KiB = 5.43 MiB
  Load Address: 20008000
  Entry Point:  20008000
  Kernel: arch/arm/boot/uImage is ready
  

  make ARCH=arm dtbs
  
  [..]
  
    DTC     arch/arm/boot/dts/microchip/at91-sama5d27_som1_ek.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama5d27_wlsom1_ek.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama5d29_curiosity.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama5d2_icp.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama5d3_eds.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama7d65_curiosity.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama7g54_curiosity.dtb
    DTC     arch/arm/boot/dts/microchip/at91-sama7g5ek.dtb
  
  [..]

  If the building process is successful, the final images can be found under arch/arm/boot/ directory.

Build Yocto Project rootfs from sources

Note that building an entire distribution is a long process. It also requires a big amount of free disk space.

The support for Microchip MPU SoC family is included in a particular Yocto Project layer: meta-mchp. The source for this layer are hosted on Linux4Microchip GitHub account: https://github.com/linux4microchip/meta-mchp

Building environment

A step-by-step comprehensive installation is explained in the Yocto Project Quick Build. The following lines have to be considered as an add-on that is MPU specific or that can facilitate your setup.

Step by step build procedure

 here is the README procedure available directly in the meta-mchp-common layer. This file in the meta-mchp layer repository must be considered as the reference and the following copy can be out-of-sync.

 starting with Linux4Microchip 2025.04 release, the meta-mchp layer supports Yocto Project templates, so make sure you create a new build environment using oe-init-build-env

OpenEmbedded/Yocto Project BSP layer for Microchip's SoCs

Description

The meta-mchp-common layer consolidates common Board Support Package (BSP) components and metadata for Microchip platforms, streamlining development across various Microchip devices for use with OpenEmbedded and/or Yocto Project.

Supported Machines

The meta-mchp-common layer provides support for various Microchip platforms. For detailed information about supported machines, please refer to the documentation in the relevant sub-layers:

• MPU layer README

Prerequisites

Before starting, please refer to the Required Packages for Build Host section in the Yocto Project Documentation to install required dependencies for the build environment:

For instance, on Ubuntu or Debian, these packages need to be installed on your development host:

Usage

To integrate this layer into your Yocto Project build environment:

Licensing

The contents of this layer are licensed under the MIT License. See COPYING.MIT for details.

Contributing

If you want to contribute changes, you can send Github pull requests at https://github.com/linux4microchip/meta-mchp/pulls.

See CONTRIBUTING.md for additional information about contribution guidelines.

Maintainers

• Hari Prasath G E <hari.prasathge@microchip.com>
• Valentina Fernandez Alanis <valentina.fernandezalanis@microchip.com>
• Dharma Balasubiramani <dharma.b@microchip.com>

Recent FAQ

• AT91Bootstrap Debugging with Eclipse for Linux
• Compiling Linux Kernel fails looking at OpenSSL header files
• Convert SAM-BA Scripts
• Crypto hardware acceleration
• Driver Model in U-Boot
• Yocto Project FAQ
• GUI Solutions
• Use of the AT91 ADC driver
• Enable and Configure PMECC (Programmable Multibit ECC) in AT91SAM SoC
• SD card boot for AT91SAM SoC 
• USB Gadget Configuration
• How to use the Atmel KMS/DRM LCD driver
• Using ISI (Image Sensor Interface)
• External Component on External Bus Interface