**************
NXP LS1046A-FRWY
**************

This file documents the Buildroot support for the LS1046A Freeway Board.

For more details about the board and the QorIQ Layerscape SoC, see the following pages:
  - https://www.nxp.com/design/software/qoriq-developer-resources/ls1046a-freeway-board:FRWY-LS1046A
  - https://www.nxp.com/FRWY-LS1046A
  - https://www.nxp.com/docs/en/quick-reference-guide/FRWY-LS1046AGSG.pdf

Layerscape platforms are officially supported by NXP under the Layerscape
Debian Linux SDK (LDLSDK). This uses components from Linux Factory (project
common with i.MX), but has a slower release cadence than LF. The currently used
tag is lf-6.12.34-2.1.0, which is in line with the latest LF tag. Generally, in
Buildroot, the latest Linux Factory release tag is always used, which may be
considered pre-release software, as it may contain features which are not yet
documented, and it generally undergoes less testing.

For the software Layerscape Debian Linux SDK User Guide, see:
  - https://docs.nxp.com/bundle/UG10143/page/topics/about_this_document.html
  - https://www.nxp.com/docs/en/user-guide/UG10143.pdf

The components from NXP are:
  - rcw, lf-6.12.34-2.1.0
  - atf (fork), lf-6.12.34-2.1.0
  - uboot (fork), lf-6.12.34-2.1.0
  - qoriq-fm-ucode (blob), lf-6.12.34-2.1.0
  - linux (fork), lf-6.12.34-2.1.0
  - fmlib, lf-6.12.34-2.1.0
  - fmc, lf-6.12.34-2.1.0

Build
=====

First, configure Buildroot for the LS1046A-FRWY board:

  make ls1046a-frwy_defconfig

Build all components:

  make

You will find in output/images/ the following files:
  - bl2_sd.pbl
  - fip.bin
  - fsl_fman_ucode_ls1046_r1.0_106_4_18.bin
  - fsl_fman_ucode_ls1046_r1.0_108_4_9.bin
  - fsl-ls1046a-frwy.dtb
  - fsl-ls1046a-frwy-sdk.dtb
  - Image
  - PBL.bin
  - rootfs.ext2
  - rootfs.ext4
  - sdcard.img
  - u-boot.bin

Create a bootable SD card
=========================

To determine the device associated to the SD card have a look in the
/proc/partitions file:

  cat /proc/partitions

Buildroot prepares a bootable "sdcard.img" image in the output/images/
directory, ready to be dumped on a SD card. Launch the following
command as root:

  dd if=output/images/sdcard.img of=/dev/sdX

*** WARNING! This will destroy all the card content. Use with care! ***

For details about the medium image layout, see the definition in
board/freescale/ls1046a-frwy/genimage.cfg.

Boot the LS1046A-FRWY board
=========================

To boot your newly created system:
- insert the SD card in the SD slot of the board;
- Configure the switches SW1[1:9] = 0_0100_0000 (select SD Card boot option)
- put a Micro-USB cable into UART1 Port and connect using a terminal emulator
  at 115200 bps, 8n1. Or remove the jumper on J72, connect a USB to TTL cable
  to J73, and connect using a terminal emualtor at 115200 bps, 8n1.
- power on the board.

The front panel Ethernet connectors are off at boot, to bring them up run the
following commands.

1G PORT1
  ip link set eth1 up

1G PORT2
  ip link set eth2 up

1G PORT3
  ip link set eth0 up

1G PORT4
  ip link set eth3 up
