LS1046ARDB - How to update DPAA1 FMan microcode (ucode) image in QSPI NOR flash

[#1]

Follow these steps to update the DPAA1 FMan ucode image in QSPI NOR flash. 

cpld reset boots the board from QSPI NOR flash0 and cpld reset altbank boots the board from the QSPI NOR flash1.

sf probe 0:1 means that the alternate bank will be written to. So, if the board boots from QSPI NOR flash0 and sf probe 0:1 is entered at the U-Boot prompt, the commands that follow will program QSPI NOR flash1.

Obtaining DPAA1 FMan ucode image

Clone the qoriq-fm-ucode repository.

1. $ git clone https://github.com/NXP/qoriq-fm-ucode.git
2. $ cd qoriq-fm-ucode
3. $ git checkout LSDK-<LSDK version>. For example, $ git checkout LSDK-18.12

The prebuilt FMan ucode images, fsl_fman_ucode_ls1046_r1.0_<microcode version>.bin, are at qoriq-fm-ucode/. In the binary file, ls1046_r1.0 refers to the LS1046A silicon revision 1.0. See qoriq-fm-ucode/readme for a description of the ucode version numbers.

Programming FMan ucode image to QSPI NOR flash

FMan ucode image can be loaded to LS1046ARDB from a TFTP server or from a mass storage device (SD, USB, or SATA).

Option 1: Load image from the TFTP server

1. Boot LS1046ARDB from QSPI NOR flash. Ensure that the switches are set to boot the board from QSPI. For booting from QSPI, SW5[1:8] = 00100010
2. Boot from QSPI NOR flash0: => cpld reset

   In boot log, you’ll see:

   Board: LS1046ARDB, boot from QSPI vBank 0

Set up Ethernet connection

When board boots up, U-Boot prints a list of enabled Ethernet interfaces.

FM1@DTSEC3 [PRIME], FM1@DTSEC4, FM1@DTSEC5, FM1@DTSEC6, FM1@TGEC1, FM1@TGEC2

1. Set server IP to the IP of the host machine on which you have configured the TFTP server. 

   => setenv serverip <ipaddress1>

2. Set ethact and ethprime as the Ethernet interface connected to the TFTP server.

   See LS1046ARDB Ethernet port mapping for the mapping of Ethernet port names appearing on the chassis front panel with the port names in U-Boot and Linux.

   => setenv ethprime <name of interface connected to TFTP server>

   For example:

   => setenv ethprime FM1@DTSEC4

   => setenv ethact <name of interface connected to TFTP server>

   For example:

   => setenv ethact FM1@DTSEC4

3. Set IP address of the board. You can set a static IP address or, if the board can connect to a dhcp server, you can use the dhcp command.

   Static IP address assignment:
   => setenv ipaddr <ipaddress2>
   => setenv netmask <subnet mask>

   Dynamic IP address assignment:
   => dhcp

4. Save the settings.

   => saveenv

5. Check the connection between the board and the TFTP server.

=> ping $serverip

Using FM1@DTSEC4 device

host 192.168.1.1 is alive

Load FMan ucode image from the TFTP server

1. Program QSPI NOR flash1: => sf probe 0:1
2. Flash the FMan ucode image:
   
   1. => tftp 0x80000000 <path to FMan ucode>/fsl_fman_ucode_ls1046_r1.0_<ucode version>.bin
   2. => print filesize
      

      filesize=7f5c

3. Program the FMan ucode image to QSPI NOR flash: => sf erase 0x900000 +$filesize && sf write 0x80000000 0x900000 $filesize

   Address  0x900000 is the location of the FMan ucode image in QSPI NOR flash.  Refer Flash layout for new boot flow with TF-A for the complete flash memory layout.

4. Boot from QSPI NOR flash1 and press Enter to stop the autoboot: => cpld reset altbank

   In boot log, you’ll see:

   Board: LS1046ARDB, boot from QSPI vBank 4

   You can check the following code line in the boot log to confirm that the DPAA1 FMan ucode image in QSPI NOR flash is updated.

   Fman1: Uploading microcode version 106.4.18

5. Ensure that SD card, USB flash drive, or SCSI hard disk installed with LSDK Ubuntu distribution is plugged into the board to boot the board to Ubuntu. 

   => cpld reset altbank

   Ubuntu 18.04.1 LTS localhost ttyS0

   localhost login: root
   Password:
   Last login: Sun Jan 28 16:05:12 UTC 2018 on ttyS0
   Welcome to Ubuntu 18.04.1 LTS (GNU/Linux 4.9.105 aarch64)

   * Documentation: https://help.ubuntu.com
   * Management: https://landscape.canonical.com
   * Support: https://ubuntu.com/advantage

   If U-Boot does not find LSDK on a mass storage device, it will boot TinyDistro from lsdk_linux_arm64_ tiny.itb stored in QSPI NOR flash.

Option 2: Load image from partition on mass storage device (SD, USB, or SATA)

1. Boot LS1046ARDB from QSPI NOR flash. Ensure that the switches are set to boot the board from QSPI. For booting from QSPI , SW5[1:8] = 00100010
2. Boot from QSPI NOR flash0: => cpld reset

   In boot log, you’ll see:

   Board: LS1046ARDB, boot from QSPI vBank 0

3. Select mass storage device to use.

   => mmc rescan

   => mmc info

   Or

   => usb start
   => usb info

   Or

   => scsi scan

   => scsi info

4. Optional – List files on storage device

   => ls mmc <device:partition>

   For example:

   => ls mmc 0:3
   System Volume Information/
   32604 fsl_fman_ucode_ls1046_r1.0_106_4_18.bin

   1 file(s), 1 dir(s)

   Or

   => ls usb <device:partition>

   For example:

   => ls usb 0:1

   Or

   => ls scsi <device:partition>

   For example:

   => ls scsi 0:2

   If the ls command fails to run, check that U-Boot in QSPI NOR flash0 supports the command by typing ls at the U-Boot prompt:
   => ls
   ls - lists files in a directory (default)
   Usage:
   ls <interface> [<dev[:part]> [directory]]
   - Lists files in directory [directory] of partition [part] on device type [interface] and instance [dev].
   If U-Boot does not support this command, then update the composite firmware image in QSPI NOR flash0.
   For steps to update composite firmware image in QSPI NOR flash, see LS1046ARDB - How to update composite firmware image in QSPI NOR flash.

5. Program QSPI NOR flash1: => sf probe 0:1
6. Load FMan ucode image from the storage device.

   => load mmc <device:partition> 80000000 <image name>

   => print filesize

   For example:

   => load mmc 0:3 80000000 fsl_fman_ucode_ls1046_r1.0_106_4_18.bin
   32604 bytes read in 18 ms (1.7 MiB/s)
   => print filesize
   filesize=7f5c

   Or

   => load usb <device:partition> 80000000 <image name>

   => print filesize

   Or

   => load scsi <device:partition> 80000000 <image name>

   => print filesize

7. Program the FMan ucode image to QSPI NOR flash: => sf erase 0x900000 +$filesize && sf write 0x80000000 0x900000 $filesize

   Address  0x900000 is the location of the FMan ucode image in QSPI NOR flash.  Refer Flash layout for new boot flow with TF-A for the complete flash memory layout.

8. Boot from QSPI NOR flash1 and press Enter to stop the autoboot: => cpld reset altbank

   In boot log, you’ll see:

   Board: LS1046ARDB, boot from QSPI vBank 4

   You can check the following code line in the boot log to confirm that the DPAA1 FMan ucode image in QSPI NOR flash is updated.

   Fman1: Uploading microcode version 106.4.18

9. Ensure that SD card, USB flash drive, or SCSI hard disk installed with LSDK Ubuntu distribution is plugged into the board to boot the board to Ubuntu. 

   => cpld reset altbank

   Ubuntu 18.04.1 LTS localhost ttyS0

   localhost login: root
   Password:
   Last login: Sun Jan 28 16:05:12 UTC 2018 on ttyS0
   Welcome to Ubuntu 18.04.1 LTS (GNU/Linux 4.9.105 aarch64)

   * Documentation: https://help.ubuntu.com
   * Management: https://landscape.canonical.com
   * Support: https://ubuntu.com/advantage

   If U-Boot does not find LSDK on a mass storage device, it will boot TinyDistro from lsdk_linux_arm64_ tiny.itb stored in QSPI NOR flash.