board/kontron/smarc-sal28/readme.txt

Kontron SMARC-sAL28
===================

How to build it
===============

Configure Buildroot:

  $ make kontron_smarc_sal28_defconfig

Change settings to fit your needs (optional):

  $ make menuconfig

Compile everything and build the rootfs image:

  $ make

Copying the image to a storage device
=====================================

Buildroot builds an image which can be written to the internal eMMC
storage, a SD card or an USB thumb drive. You can use the following
command on your host:

  $ sudo dd if=output/images/sdcard-emmc.img of=/dev/sdx bs=1M

Where /dev/sdx is the corresponding block device of your SD card or USB
thumb drive. To flash it on your internal eMMC use the following command on
the board:

  # dd if=sdcard-emmc.img of=/dev/mmcblk1 bs=1M

Be sure you have not booted from the internal eMMC in this case!

Booting the board
=================

By default the bootloader will search for the first valid image, starting
with the internal eMMC. Consult the vendor documentation on how to use the
DIP switches to select specific boot devices. To use the bootloader
environment set the boot_targets correspondingly. E.g.:

  # setenv boot_targets usb0

To boot from an USB thumb drive.

The device tree is loaded according to the filename in fdtfile. The
following command will set the default device tree, which works on almost
all variants (with less features of course):

  # setenv fdtfile freescale/fsl-ls1028a-kontron-sl28.dtb

Set this to a device tree which fits your board variant.

Connect your serial cable to SER1 and open your favorite terminal emulation
program (baudrate 115200, 8n1). E.g.:

  $ picocom -b 115200 /dev/ttyUSB0

You will get a warning reported by fdisk when you examine the SD card.
This is because the genimage.cfg file doesn't specify the SD card size
(as people will naturally have different sized cards), so the
secondary GPT header is placed after the rootfs rather than at the end
of the disk where it is expected to be.

You will see something like this at boot time:

[    4.552797] GPT:Primary header thinks Alt. header is not at the end of the disk.
[    4.560237] GPT:266272 != 7864319
[    4.563565] GPT:Alternate GPT header not at the end of the disk.
[    4.569596] GPT:266272 != 7864319
[    4.572925] GPT: Use GNU Parted to correct GPT errors.

What does not work
==================

For reasons unknown, the network card doesn't work if you use the original
vendor bootloader. Board support patches for upstream u-boot are currently
pending. Stay tuned.