SAMA5D4 Xplained Board


SoC Features

Atmelís 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.

SAMA5D4 Chip Features


Kit Information

Kit Overview

SAMA5D4 Xplained

Access the console

The usual serial communication parameters are 115200 8-N-1 :

Baud rate 115200
Data 8 bits
Parity None
Stop 1 bit
Flow control None

Access the console on DBGU serial port

The DBGU serial console can be accessed from two connectors. One is from the DBGU port with the help of a TTL-to-USB serial cable (marked as DEBUG J1), another is from micro-A USB connector that gives access to the on-board serial-to-USB converter (marked as J20 EDBG-USB).

Using DBGU on TTL-to-USB connector (DEBUG J1)

  • For Microsoft Windows users: Install the driver of your USB TTL serial cable. FTDI-based ones are the most popular, have a look to this page to get the driver: http://www.ftdichip.com/Drivers/VCP.htm
  • Be sure to connect a 3.3V compatible cable and identify its GND pin. Place it properly according to the silkscreen and connect the cable to the board (J1)
    • For Microsoft Windows users: Identify the USB connection that is established, USB Serial Port should appear in Device Manager. The COMxx number will be used to configure the terminal emulator.

ftdi serial line

    • For Linux users: Identify the serial USB connection by monitoring the last lines of dmesg command. The /dev/ttyUSBx number will be used to configure the terminal emulator.

[605576.562740] usb 1-1.1.2: new full-speed USB device number 17 using ehci-pci
[605576.660920] usb 1-1.1.2: New USB device found, idVendor=0403, idProduct=6001
[605576.660933] usb 1-1.1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[605576.660939] usb 1-1.1.2: Product: TTL232R-3V3
[605576.660944] usb 1-1.1.2: Manufacturer: FTDI
[605576.660958] usb 1-1.1.2: SerialNumber: FTGNVZ04
[605576.663092] ftdi_sio 1-1.1.2:1.0: FTDI USB Serial Device converter detected
[605576.663120] usb 1-1.1.2: Detected FT232RL
[605576.663122] usb 1-1.1.2: Number of endpoints 2
[605576.663124] usb 1-1.1.2: Endpoint 1 MaxPacketSize 64
[605576.663126] usb 1-1.1.2: Endpoint 2 MaxPacketSize 64
[605576.663128] usb 1-1.1.2: Setting MaxPacketSize 64
[605576.663483] usb 1-1.1.2: FTDI USB Serial Device converter now attached to ttyUSB0

A /dev/ttyUSB0 node has been created.

  • Now open your favorite terminal emulator with appropriate settings

Using the micro-A USB connector (J20 EDBG-USB)

You can also access the serial console through the on-board serial-to-USB converter. In fact, the Atmel EDBG (Embedded Debugger) chip on the Evaluation Kit acts as a serial-to-USB converter and is loaded with a firmware that is able to talk USB-CDC protocol.

  • For Microsoft Windows users: Install USB drivers for Atmel and Segger tools. No need to install a driver on any regular Linux distribution.
  • Open JP1 to enable EDBG
  • Connect the USB cable to the board (J20 EDBG-USB)
    • For Microsoft Windows users: identify the USB connection that is established
      EDBG Virtual COM Port should appear in Device Manager. The COMxx number will be used to configure the terminal emulator.

EDBG CDC UART Port

    • 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.

[172677.700868] usb 2-1.4.4: new full-speed USB device number 31 using ehci-pci
[172677.792677] usb 2-1.4.4: not running at top speed; connect to a high speed hub
[172677.793418] usb 2-1.4.4: New USB device found, idVendor=03eb, idProduct=6124
[172677.793424] usb 2-1.4.4: New USB device strings: Mfr=0, Product=0, SerialNumber=0
[172677.793897] cdc_acm 2-1.4.4:1.0: This device cannot do calls on its own. It is not a modem.
[172677.793924] cdc_acm 2-1.4.4:1.0: ttyACM0: USB ACM device
   
idVendor=03eb, idProduct=6124: from this message you can see it's Atmel EK board USB connection.

  • Now open your favorite terminal emulator with appropriate settings

Demo

Demo archives

Media type Board Screen Binary Description
Yocto / Poky based demo
NAND Flash SAMA5D4 Xplained - linux4sam-poky-sama5d4_xplained-5.5.zip (~ 135 MB)
md5: fd4bc97d29f9b6bb69f9e71a1879af47
Linux4SAM Yocto / Poky based demo
compiled from tag linux4sam_5.5
Follow procedure: #Flash_the_demo
HDMI linux4sam-poky-sama5d4_xplained_hdmi-5.5.zip (~ 160 MB)
md5: 5e376664a19ff371dbb2877ea41aebec
PDA 4.3" linux4sam-poky-sama5d4_xplained_pda4-5.5.zip (~ 160 MB)
md5: df5321974b1c474dd635a3f1a5bbcbae
PDA 7"
TM7000
linux4sam-poky-sama5d4_xplained_pda7-5.5.zip (~ 160 MB)
md5: a9b257babbeb7dbae0a0fda2c0e8046a
PDA 7"
TM7000B
linux4sam-poky-sama5d4_xplained_pda7b-5.5.zip (~ 160 MB)
md5: 379e943f92c22e68bd6c015e9a1c4298
SD Card image SAMA5D4 Xplained - linux4sam-poky-sama5d4_xplained-5.5.img.bz2 (~ 111 MB)
md5: a7bd5903c4d6fe8904e81a8d9fe6da7a
Linux4SAM Yocto / Poky based demo
compiled from tag linux4sam_5.5
Follow procedure: #Create_a_SD_card_with_the_demo
HDMI linux4sam-poky-sama5d4_xplained_hdmi-5.5.img.bz2 (~ 134 MB)
md5: 2b0ced2dacba15b43d58d81b528dbe55
PDA 4.3" linux4sam-poky-sama5d4_xplained_pda4-5.5.img.bz2 (~ 134 MB)
md5: 15effe0e8b18bf08118399917240e72a
PDA 7"
TM7000
linux4sam-poky-sama5d4_xplained_pda7-5.5.img.bz2 (~ 134 MB)
md5: f759addc5b3db4ba1ee1fe8a3786ca9e
PDA 7"
TM7000B
linux4sam-poky-sama5d4_xplained_pda7b-5.5.img.bz2 (~ 134 MB)
md5: d2eaba2385571a31657cdba051327088
BuildRoot based demo
SD Card image SAMA5D4 Xplained - linux4sam-buildroot-sama5d4_xplained-5.5.img.bz2 (~ 23 MB)
md5: e66d05af914eb1317dfdf5dc1490cc52
Linux4SAM BuildRoot based demo
compiled from tag linux4sam_5.5
Follow procedure: #Create_a_SD_card_with_the_demo

Create a SD card with the demo

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

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

Windows procedure

To write the compressed image on the SD card, you will have to download and install Rawrite32. This tool, which is a free software, is useful since it allows to get a compressed image as input. More information and extra help available on the Rawrite32 website

  • Insert your sdcard and launch Rawrite32:

rawrite32

  1. Select the demo image.
  2. Check if the image is not corrupted with the md5 provided in the Demo Archive section.
  3. Select the device corresponding to your SD card.
  4. Click on Write to disk... A pop-up will remain you that you will destroy all the data on your SD card.

  • Once writing done, Windows should detect the boot partition:

Boot partition

  • Your SD card is ready!

Linux procedure

  • Uncompress the image:

bunzip2 linux4sam-poky-sama5d2_xplained-5.0.img.bz2

The compressed image will be removed and you will get the uncompressed image named linux4sam-poky-sama5d2_xplained-5.0.img.

  • Insert your SD card. To identify the device, use the dmesg command.

If you have an integrated SD card reader, you should have something like this:

[74402.090920] mmc0: new high speed SDXC card at address 0007
[74402.091329] mmcblk0: mmc0:0007 SD64G 58.1 GiB
[74402.092653]  mmcblk0: p1 p2

The device is mmcblk0.

If you have a usb adapter, you should have something like this:

[74450.341001] usb 2-1.2: new high-speed USB device number 7 using ehci-pci
[74450.434871] usb 2-1.2: New USB device found, idVendor=058f, idProduct=6366
[74450.434877] usb 2-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[74450.434880] usb 2-1.2: Product: Mass Storage Device
[74450.434883] usb 2-1.2: Manufacturer: Generic
[74450.434885] usb 2-1.2: SerialNumber: 058F63666433
[74450.435551] usb-storage 2-1.2:1.0: USB Mass Storage device detected
[74450.435765] scsi host10: usb-storage 2-1.2:1.0
[74451.567171] scsi 10:0:0:0: Direct-Access     Multiple Card  Reader     1.00 PQ: 0 ANSI: 0
[74451.568032] sd 10:0:0:0: Attached scsi generic sg3 type 0
[74452.338367] sd 10:0:0:0: [sdc] 121864192 512-byte logical blocks: (62.3 GB/58.1 GiB)

The device is sdc.

  • Once you have identified the your SD device you can write the image on it with the dd command.

ALERT! Warning: Be careful to not make any mistake about the device. You can lost your data if you write the image to your hard drive(s) which are usually /dev/sda or /dev/sdb.

sudo dd if=linux4sam-poky-sama5d2_xplained-5.0.img of=/dev/mmcblk0

  • Your SD card is ready!

Flash the demo

Connect the USB to the board before launch SAM-BA

  • Short the JP7 (BOOT_DIS) to prevents booting from Nand or serial Flash by disabling Flash Chip Selects
  • Connect a USB micro-A cable to the board (J11 5V-USB-A) and powered the board.
  • Open the JP7 (BOOT_DIS) to enable booting from Nand or serial Flash by enabling Flash Chip Selects
  • check whether the board is found in your PC as a USB device:
    • For Microsoft Windows users:* verify that the USB connection is well established
      AT91 USB to Serial Converter should appear in Device Manager. If it shows a unknown device you need to download and install the driver: AT91SAM USB CDC driver
      AT91 USB to Serial Converter
       
    • For Linux users: check /dev/ttyACMx by monitoring the last lines of dmesg command:
      [172677.700868] usb 2-1.4.4: new full-speed USB device number 31 using ehci-pci
      [172677.792677] usb 2-1.4.4: not running at top speed; connect to a high speed hub
      [172677.793418] usb 2-1.4.4: New USB device found, idVendor=03eb, idProduct=6124
      [172677.793424] usb 2-1.4.4: New USB device strings: Mfr=0, Product=0, SerialNumber=0
      [172677.793897] cdc_acm 2-1.4.4:1.0: This device cannot do calls on its own. It is not a modem.
      [172677.793924] cdc_acm 2-1.4.4:1.0: ttyACM0: USB ACM device
         
      idVendor=03eb, idProduct=6124: from this message you can see it's Atmel EK board USB connection.

Run script to flash the demo

  • Download the demo package for the board.
  • Extract the demo package and launch the script to flash the demo:
    • For Microsoft Windows users: Launch the .bat file corresponding to the board that you are using
      This script will run SAM-BA with proper parameters.
    • For Linux users: if the /dev/ttyACMx that appears is different from /dev/ttyACM0, edit the .sh file and modify /dev/ttyACMx device number
    • For Linux users: Launch the .sh file corresponding to the board that you are using.
      This script will runs SAM-BA with proper parameters
  • When the logfile.log appears (this will take a few minutes), check that
    ===== Done. =====
    is written at the end of the file.
  • Remove the USB cable.
  • Connect a serial link on DBGU and open the terminal emulator program as explained just above
  • Power cycle the board.
  • Look the system booting on the LCD screen or through the serial line

Play with the demo

Now you should have the Linux demo up'n running on your board !
You can access the Linux console through the serial line as explained just above
Use the root login account without password.

You can have a look at the boot log as a file for the record or have an overview in the image below:

View of system running

Build From source code

Setup ARM Cross Compiler

  • Ubuntu:
    In Ubuntu, you can install the ARM Cross Compiler by doing:
    sudo apt-get install gcc-arm-linux-gnueabi
    export CROSS_COMPILE=arm-linux-gnueabi-
       

  • Others:
    For others, you can download the Linaro cross compiler and setup the environment by doing:
    wget -c https://releases.linaro.org/14.11/components/toolchain/binaries/arm-linux-gnueabi/gcc-linaro-4.9-2014.11-x86_64_arm-linux-gnueabi.tar.xz
    tar xf gcc-linaro-4.9-2014.11-x86_64_arm-linux-gnueabi.tar.xz
    export CROSS_COMPILE=`pwd`/gcc-linaro-4.9-2014.11-x86_64_arm-linux-gnueabi/bin/arm-linux-gnueabi-
       

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 AT91Boostrap 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:

$ git clone git://github.com/linux4sam/at91bootstrap.git
Cloning into 'at91bootstrap'...
remote: Reusing existing pack: 2476, done.
remote: Counting objects: 167, done.
remote: Compressing objects: 100% (167/167), done.
remote: Total 2643 (delta 135), reused 0 (delta 0)
Receiving objects: 100% (2643/2643), 2.06 MiB | 270 KiB/s, done.
Resolving deltas: 100% (1809/1809), done.
$ cd at91bootstrap/

Configure AT91Boostrap

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

sama5d4_xplainednf_uboot_secure_defconfig
sama5d4_xplainedsd_uboot_secure_defconfig

TIP Tips: nf means to read nandflash, df means to read serial flash, sd means to read mmc card.
TIP Tips: uboot means to load u-boot to RAM, secure means to enter into secure mode, every peripherals are accessible.

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

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

Customize AT91Bootstrap

If the default configuration doesn't meet your need, after configuring with the default configuration, you can customize it by doing:
$ make menuconfig
Now, in the menuconfig dialog, you can easily add or remove some features to/from AT91Bootstrap as the same way as kernel configuration.

Build AT91Bootstrap

Then you can build the AT91Bootstrap binary by doing:
$ make

If the building process is successful, the final .bin image is 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 Linux4SAM GitHub U-Boot repository:

  • clone the Linux4sam GitHub U-Boot repository
       $ git clone git://github.com/linux4sam/u-boot-at91.git
       Cloning into 'u-boot-at91'...
       remote: Counting objects: 219350, done.
       remote: Compressing objects: 100% (40142/40142), done.
       remote: Total 219350 (delta 175755), reused 219350 (delta 175755)
       Receiving objects: 100% (219350/219350), 56.01 MiB | 1.24 MiB/s, done.
       Resolving deltas: 100% (175755/175755), done.
       $ cd u-boot-at91
       

  • 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/master
       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.03-at91
       origin/uboot_5series_1.x
       $ git checkout origin/u-boot-2016.03-at91 -b u-boot-2016.03-at91
       Branch u-boot-2016.03-at91 set up to track remote branch u-boot-2016.03-at91 from origin.
       Switched to a new branch 'u-boot-2016.03-at91'
       

Cross-compiling U-Boot

Before compile 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.

Pointing hand Go to the configs/ to find the exact target when invoking make.

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

   # To put environment variables in serial flash:
   sama5d4_xplained_spiflash_defconfig
   # To put environment variables in nandflash (default):
   sama5d4_xplained_nandflash_defconfig
   # To put environment variables in SD/MMC card:
   sama5d4_xplained_mmc_defconfig

Here are the building steps for the SAMA5D4-Xplained board:

# You can change the config according to your needs.
make sama5d4_xplained_nandflash_defconfig
make

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

Getting Kernel sources

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

$ git clone git://github.com/linux4sam/linux-at91.git
Cloning into 'linux-sama9x5-github'...
remote: Counting objects: 4524288, done.
remote: Compressing objects: 100% (721/721), done.
remote: Total 4524288 (delta 385), reused 1 (delta 1), pack-reused 4523564
Receiving objects: 100% (4524288/4524288), 1.22 GiB | 1.35 MiB/s, done.
Resolving deltas: 100% (3777338/3777338), done.
Checking connectivity... done.
Checking out files: 100% (49565/49565), done.

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

Pointing hand Note that you can also add this Linux4SAM repository as a remote GIT repository to your usu

$ git remote add linux4sam git://github.com/linux4sam/linux-at91.git
$ git remote update linux4sam
Fetching linux4sam
From git://github.com/linux4sam/linux-at91
 * [new branch]                linux-2.6.39-at91 -> linux4sam/linux-2.6.39-at91
 * [new branch]                linux-3.10-at91 -> linux4sam/linux-3.10-at91
 * [new branch]                linux-3.15-at91 -> linux4sam/linux-3.15-at91
 * [new branch]                linux-3.18-at91 -> linux4sam/linux-3.18-at91
 * [new branch]                linux-3.4.9-at91 -> linux4sam/linux-3.4.9-at91
 * [new branch]                linux-3.6.9-at91 -> linux4sam/linux-3.6.9-at91
 * [new branch]                linux-4.1-at91 -> linux4sam/linux-4.1-at91
 * [new branch]                linux-4.4-at91 -> linux4sam/linux-4.4-at91
 * [new branch]                master     -> linux4sam/master

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

$ git branch -r
  origin/HEAD -> origin/master
  origin/linux-2.6.39-at91
  origin/linux-3.10-at91
  origin/linux-3.15-at91
  origin/linux-3.18-at91
  origin/linux-3.4.9-at91
  origin/linux-3.6.9-at91
  origin/linux-4.1-at91
  origin/linux-4.4-at91
  origin/master
$ git checkout origin/linux-4.4-at91 -b linux-4.4-at91
Branch linux-4.1-at91 set up to track remote branch linux-4.4-at91 from origin.
Switched to a new branch 'linux-4.4-at91'

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

  • at91_dt_defconfig: for at91sam ARM926 series chips
  • sama5_defconfig: for SAMA5 series chips

Now we Configure and Build kernel for sama5d4_xplained board:

$ make ARCH=arm sama5_defconfig
  HOSTCC  scripts/basic/fixdep
  HOSTCC  scripts/kconfig/conf.o
  SHIPPED scripts/kconfig/zconf.tab.c
  SHIPPED scripts/kconfig/zconf.lex.c
  SHIPPED scripts/kconfig/zconf.hash.c
  HOSTCC  scripts/kconfig/zconf.tab.o
  HOSTLD  scripts/kconfig/conf
#
# configuration written to .config
#

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

$ make ARCH=arm menuconfig

And 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/zImage is ready
  UIMAGE  arch/arm/boot/uImage
Image Name:   Linux-4.1.0-linux4sam_5.3+
Created:      Fri Sep  9 17:02:45 2016
Image Type:   ARM Linux Kernel Image (uncompressed)
Data Size:    3441072 Bytes = 3360.42 kB = 3.28 MB
Load Address: 20008000
Entry Point:  20008000
  Image arch/arm/boot/uImage is ready

make ARCH=arm dtbs

[..]

  DTC     arch/arm/boot/dts/at91rm9200ek.dtb
  DTC     arch/arm/boot/dts/mpa1600.dtb
  DTC     arch/arm/boot/dts/animeo_ip.dtb
  DTC     arch/arm/boot/dts/at91-qil_a9260.dtb
  DTC     arch/arm/boot/dts/aks-cdu.dtb
  DTC     arch/arm/boot/dts/ethernut5.dtb
  DTC     arch/arm/boot/dts/evk-pro3.dtb
  DTC     arch/arm/boot/dts/tny_a9260.dtb
  DTC     arch/arm/boot/dts/usb_a9260.dtb
  DTC     arch/arm/boot/dts/at91sam9261ek.dtb
  DTC     arch/arm/boot/dts/at91sam9263ek.dtb
  DTC     arch/arm/boot/dts/tny_a9263.dtb
  DTC     arch/arm/boot/dts/usb_a9263.dtb
  DTC     arch/arm/boot/dts/at91-foxg20.dtb
  DTC     arch/arm/boot/dts/at91-kizbox.dtb
  DTC     arch/arm/boot/dts/at91sam9g20ek.dtb
  DTC     arch/arm/boot/dts/at91sam9g20ek_2mmc.dtb
  DTC     arch/arm/boot/dts/tny_a9g20.dtb
  DTC     arch/arm/boot/dts/usb_a9g20.dtb
  DTC     arch/arm/boot/dts/usb_a9g20_lpw.dtb
  DTC     arch/arm/boot/dts/at91sam9m10g45ek.dtb
  DTC     arch/arm/boot/dts/pm9g45.dtb
  DTC     arch/arm/boot/dts/at91sam9n12ek.dtb
  DTC     arch/arm/boot/dts/at91sam9rlek.dtb
  DTC     arch/arm/boot/dts/at91-ariag25.dtb
  DTC     arch/arm/boot/dts/at91-ariettag25.dtb
  DTC     arch/arm/boot/dts/at91-cosino_mega2560.dtb
  DTC     arch/arm/boot/dts/at91-kizboxmini.dtb
  DTC     arch/arm/boot/dts/at91sam9g15ek.dtb
  DTC     arch/arm/boot/dts/at91sam9g25ek.dtb
  DTC     arch/arm/boot/dts/at91sam9g35ek.dtb
  DTC     arch/arm/boot/dts/at91sam9x25ek.dtb
  DTC     arch/arm/boot/dts/at91sam9x35ek.dtb

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

Build Yocto/Poky 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 Atmel AT91 SoC family is included in a particular Yocto layer: meta-atmel. The source for this layer are hosted on Linux4SAM GitHub account: https://github.com/linux4sam/meta-atmel

Building environment

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

Prerequisite

Here are the reference pages for setting up a Yocto building environment: What You Need and How You Get It.

Step by step build procedure

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

Supported SoCs / MACHINE names
==============================
- SAMA5D2 product family / sama5d2-xplained
- SAMA5D4 product family / sama5d4ek, sama5d4-xplained
- SAMA5D3 product family / sama5d3xek, sama5d3-xplained
- AT91SAM9x5 product family (AT91SAM9G15, AT91SAM9G25, AT91SAM9X25, AT91SAM9G35 and AT91SAM9X35) / at91sam9x5ek
- AT91SAM9RL / at91sam9rlek
- AT91SAM9G45 / at91sam9m10g45ek


Sources
=======
- meta-atmel
URI: git://github.com/linux4sam/meta-atmel.git
URI: https://github.com/linux4sam/meta-atmel.git
Branch: krogoth


Dependencies
============
This Layer depends on :
- meta-openembedded
URI: git://git.openembedded.org/meta-openembedded
URI: http://cgit.openembedded.org/meta-openembedded/
Branch: krogoth

Optionally:
- meta-qt5
URI: git://github.com/meta-qt5/meta-qt5.git
URI: https://github.com/meta-qt5/meta-qt5
Branch: krogoth


Build procedure
===============
0/ Create a directory
mkdir my_dir
cd my_dir

1/ Clone yocto/poky git repository with the proper branch ready
git clone git://git.yoctoproject.org/poky -b krogoth

2/ Clone meta-openembedded git repository with the proper branch ready
git clone git://git.openembedded.org/meta-openembedded -b krogoth

3/ Clone meta-qt5 git repository with the proper branch ready
git clone git://github.com/meta-qt5/meta-qt5.git -b krogoth

4/ Clone meta-atmel layer with the proper branch ready
git clone git://github.com/linux4sam/meta-atmel.git -b krogoth

5/ Enter the poky directory to configure the build system and start the build process
cd poky

6/ Initialize build directory
source oe-init-build-env build-atmel

7/ Add meta-atmel layer to bblayer configuration file
vim conf/bblayers.conf

# POKY_BBLAYERS_CONF_VERSION is increased each time build/conf/bblayers.conf
# changes incompatibly
POKY_BBLAYERS_CONF_VERSION = "2"

BBPATH = "${TOPDIR}"
BBFILES ?= ""

BSPDIR := "${@os.path.abspath(os.path.dirname(d.getVar('FILE', True)) + '/../../..')}"

BBLAYERS ?= " \
  ${BSPDIR}/poky/meta \
  ${BSPDIR}/poky/meta-poky \
  ${BSPDIR}/poky/meta-yocto-bsp \
  ${BSPDIR}/meta-atmel \
  ${BSPDIR}/meta-openembedded/meta-oe \
  ${BSPDIR}/meta-openembedded/meta-networking \
  ${BSPDIR}/meta-openembedded/meta-python \
  ${BSPDIR}/meta-openembedded/meta-ruby \
  ${BSPDIR}/meta-openembedded/meta-multimedia \
  ${BSPDIR}/meta-qt5 \
  "

BBLAYERS_NON_REMOVABLE ?= " \
  ${BSPDIR}/poky/meta \
  ${BSPDIR}/poky/meta-poky \
  "

8/ Edit local.conf to specify the machine, location of source archived, package type (rpm, deb or ipk)
Pick one MACHINE name from the "Supported SoCs / MACHINE names" chapter above
and edit the "local.conf" file. Here is an example:

vim conf/local.conf
[...]
MACHINE ??= "sama5d3-xplained"
[...]
DL_DIR ?= "your_download_directory_path"
[...]
PACKAGE_CLASSES ?= "package_ipk"
[...]
USER_CLASSES ?= "buildstats image-mklibs"

To get better performance, use the "poky-atmel" distribution by also adding that
line:
DISTRO = "poky-atmel"

9/ Build core minimal image
bitbake core-image-minimal

10/ We found that additional local.conf changes are needed for our QT demo
image. You can add these two lines at the end of the file:
vim conf/local.conf
[...]
LICENSE_FLAGS_WHITELIST += "commercial"
SYSVINIT_ENABLED_GETTYS = ""

11/ Build Atmel demo images
bitbake atmel-qt5-demo-image


Typical bitbake output
======================
Build Configuration:
BB_VERSION        = "1.30.0"
BUILD_SYS         = "x86_64-linux"
NATIVELSBSTRING   = "universal"
TARGET_SYS        = "arm-poky-linux-gnueabi"
MACHINE           = "sama5d2-xplained"
DISTRO            = "poky-atmel"
DISTRO_VERSION    = "2.1"
TUNE_FEATURES     = "arm armv7a vfp thumb neon       callconvention-hard       cortexa5"
TARGET_FPU        = "hard"
meta
meta-poky
meta-yocto-bsp    = "krogoth:6c1c01392d91f512e2949ad1d57a75a8077478ba"
meta-atmel        = "krogoth:28c4b5d70f3f7df6f8b108a01f621ca0cf23c1a4"
meta-multimedia
meta-networking
meta-python
meta-ruby
meta-oe           = "krogoth:abd1795729501a13608da67054b9cbf185404be3"
meta-qt5          = "krogoth:4ec27e218d725677279d265ac1fc256443d665f7"

Using SAM-BA to flash components to board

NAND Flash demo - Memory map

demo_nandflash_map_lnx4sam.png

Launch SAM-BA tools

  • According to this section make sure that the chip can execute the SAM-BA Monitor.

  • Start SAM-BA GUI application.
  • Select the board: "at91sama5d4x-ek" in the drop-down menu and choose the USB connection.
samba_board_select_sama5d4ek.png

  • Click the "Connect" button, the SAM-BA main window show up:
samba_main_window_nand_sama5d4ek.png

Configure NAND ECC

Using OS default PMECC parameters

  1. Choose the NandFlash tab in the SAM-BA GUI interface.
  2. Initialize the NandFlash by choosing the Enable NandFlash action in the Scripts rolling menu, then press Execute button.
  3. Enable the PMECC by choosing the Enable OS PMECC parameters action, then press Execute button.
samba_scripts_menu.png

Configure PMECC parameters (optional)

  1. To see the detail of PMECC parameters, you can choose the PMECC configuration action, then press Execute button.
    scripts_menu_pmecc_configure.png
  2. For SAMA5D4EK or SAMA5D4 Xplained board, since the default PMECC error correction bits is selected 8bits, so Number of ECC bits required should be selected to 8, and Ecc offset should be set to 120 in the below.
    ecc_config_8bit.png

Programming components into NAND

Program AT91Bootstrap binary

  • Choose Send Boot File action, then press Execute button to select the at91bootstrap binary file and to program the binary to the NandFlash.

scripts_menu_send_boot_file.png

Program U-Boot binary

  1. Modify the Address to 0x40000
  2. Choose Send File Name open file dialog and select the U-Boot binary file and to program the binary to the NandFlash.
  3. Click Send File button to program the binary to the NandFlash in address 0x40000.
samba_send_file_nand.png

Program Linux dtb file

  1. Modify the Address to 0x180000
  2. Choose Send File Name open file dialog and select the dtb binary file and to program the binary to the NandFlash.
  3. Click Send File button to program the binary to the NandFlash in address 0x180000.
samba_send_file_nand.png

Program Linux Kernel file

  1. Modify the Address to 0x200000
  2. Choose Send File Name open file dialog and select the Linux kernel binary file and to program the binary to the NandFlash.
  3. Click Send File button to program the binary to the NandFlash in address 0x200000.
samba_send_file_nand.png

Program rootfs UBI file

Make sure you erased the nand area (0x800000~END of nand) before you program it.

  1. Modify the Address to 0x800000
  2. Choose Send File Name open file dialog and select the UBI filesystem binary file and to program the binary to the NandFlash.
  3. Click Send File button to program the binary to the NandFlash in address 0x800000.
samba_send_file_nand.png

Recent FAQ

Sama5d4Xplained

SDCard Boot Notice: How to boot up the board from SD card. (AT91Bootstrap)
Crypto Config: How to configure Crypto driver. (Kernel, linux-3.18-at91, linux-4.1-at91, linux-4.4-at91)
Connect Module From PDA: How to connect LCD module from PDA to the Xplained Boards. (Kernel)
Driver Model In UBoot: How to enable U-Boot driver model, using Sama5d2Xplained as an example. (U-Boot)
Using Atmel DRMDriver: Using Atmel KMS/DRM LCD driver. (Kernel, linux-3.18-at91, linux-4.1-at91, linux-4.4-at91)
Yocto Project FAQ: Some Yocto Project FAQ entries. (YoctoProject)
Gui Solutions: Presentation of some GUI solutions. (YoctoProject)
Using Max Touch: Introduction for how to use MaxTouch. (Kernel, linux-3.18-at91, linux-4.1-at91)
Using Isi: How to use the Image Sensor Interface. (Kernel, linux-3.18-at91, linux-4.1-at91)
Iio Adc Driver: Adc IIO driver introduction. (Kernel, linux-3.10-at91, linux-3.18-at91, linux-4.1-at91)
AT91 Bootstrap Debug Eclipse: Debug AT91Bootstrap. (AT91Bootstrap)
Pmecc Configure: About PMECC configuration. ()
r4 - 17 Sep 2015 - 15:08:57 - NicolasFerre
 
Linux & Open Source related information for AT91 Smart ARM Microcontrollers

Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.

Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.

Atmel® and others, are registered trademarks or trademarks of Atmel Corporation or its subsidiaries. This site is powered by the TWiki collaboration platform

ARM® and others are registered trademarks or trademarks of ARM Ltd. Other terms and product names may be trademarks of others.

Ideas, requests, contributions ? Connect to LinksToCommunities page.

Syndicate this siteRSS ATOM