buildroot/board/nvidia/bf3
Vincent Jardin 771da1dd9b configs/nvidia_bf3_defconfig: new defconfig
This patch adds a basic support for the Bluefied3 board from
Mellanox/NVIDIA:
  - https://www.nvidia.com/en-us/networking/products/data-processing-unit/

  Brief summary of the board features:
  - multicore ARM
      - 16 Core ARM Processor
  - DDR4: 16GB/32GB
  - 2x embedded CX7

Signed-off-by: Vincent Jardin <vjardin@free.fr>
Reviewed-by: Julien Olivain <ju.o@free.fr>
[Julien:
- remove add-custom-hashes from the commit log
- add link for upstream kernel hashes
- check hash with pgp
- reflow the readme.txt
- regenerated defconfig with make savedefconfig]
Signed-off-by: Julien Olivain <ju.o@free.fr>
2024-11-03 18:33:50 +01:00
..
patches configs/nvidia_bf3_defconfig: new defconfig 2024-11-03 18:33:50 +01:00
linux.config configs/nvidia_bf3_defconfig: new defconfig 2024-11-03 18:33:50 +01:00
readme.txt configs/nvidia_bf3_defconfig: new defconfig 2024-11-03 18:33:50 +01:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

*****************
BlueField 3 Board
*****************

The BlueField 3 board is provided "as-is" without official support
from NVIDIA.

For a detailed description of this board, please refer to the official
website:
https://www.nvidia.com/en-us/networking/products/data-processing-unit/


Missing Kernel Modules
======================

Please note that the following kernel modules are unavailable as they
are not included in the Linux upstream repository:
  - CONFIG_MLXBF_PTM (module: mlxbf-ptm)
  - CONFIG_MLXBF_PKA (module: mlxbf-pka)

For further details on these kernel modules and their usage, please
refer to the NVIDIA documentation:
https://docs.nvidia.com/networking/display/bluefielddpuosv470/installing+popular+linux+distributions+on+bluefield


Boot loader
===========

NVIDIA does not provide information for rebuilding the ARM BL1, BL2,
BL3, UEFI, or other components in the boot stages. Therefore, we
assume the BF3 board is already running the pre-built Ubuntu image
provided in the BFB installation format.

Since there are no available details on the BF3's BFB format or the
ARM Trusted Firmware (ATF) needed to rebuild BL1, BL2, BL3, UEFI, or
GRUB, these components are assumed to remain unmodified.


Grub Configuration and Image Loading
====================================

The board's image is loaded from the BF3's GRUB, with the following
GRUB settings, assuming the console is set to `hvc0` to provide access
thru `/dev/rshimN/console` from the root CPU since the root CPU's
rshim exposes a virtio console over the PCIe bus to the BR3 board.

To update GRUB settings, boot using the built-in BF3 Ubuntu image.

Extract of /etc/default/grub:

    GRUB_DEFAULT=0
    GRUB_TIMEOUT_STYLE=menu
    GRUB_TIMEOUT=-1
    GRUB_RECORDFAIL_TIMEOUT=5
    GRUB_DISTRIBUTOR=`lsb_release -i -s 2> /dev/null || echo Debian`
    GRUB_CMDLINE_LINUX_DEFAULT=""
    GRUB_CMDLINE_LINUX="console=hvc0 earlyprintk=hvc0 earlycon=hvc0 loglevel=7 fixrtc net.ifnames=0 biosdevname=0 iommu.passthrough=1"


Uploading Buildroot Images
--------------------------

After configuring GRUB, you can upload your Buildroot images to the
BF3s GRUB boot folder:

    scp build_folder/images/Image BF3:/boot/vmlinuz-buildroot-xyz

Finally, run `update-grub` on the BF3 board to apply the updated GRUB settings.

Enjoy!