From a3ecb007a80602f91d96b8cdc1db10f186db6543 Mon Sep 17 00:00:00 2001 From: Jianlin Lv Date: Thu, 11 Jul 2019 16:15:13 +0800 Subject: [PATCH] Upstream IEC type1 info about Macbin Upstream README.md and script that support kernel compiling Signed-off-by: Jianlin Lv Change-Id: Icef2619fb94dc15d92888f4d19a5a78a68002a1a --- misc/type1/macbin/README.md | 128 +++++++++++++++++++++++++++++++ misc/type1/macbin/setup-macbin-kernel.sh | 66 ++++++++++++++++ 2 files changed, 194 insertions(+) create mode 100644 misc/type1/macbin/README.md create mode 100755 misc/type1/macbin/setup-macbin-kernel.sh diff --git a/misc/type1/macbin/README.md b/misc/type1/macbin/README.md new file mode 100644 index 0000000..626cb65 --- /dev/null +++ b/misc/type1/macbin/README.md @@ -0,0 +1,128 @@ +# Deploy Kubernetes and SEBA on MACCHIATObin + +## Overview +The Marvell MACCHIATObin is a family of cost-effective and high-performance networking community +boards targeting ARM64bit high end networking and storage applications. With a offering that +include a fully open source software that include U-Boot, Linux, ODP and DPDK, the Marvell +MACCHIATObin are optimal platforms for community developers and Independent Software Vendors (ISVs) +to develop networking and storage applications. The default kernel configuration provided by +Marvell does not meet the container's system requirements. So need to reconfigure and compile +the kernel to meet SEBA operation，and also u-boot. We provide a kernel configuration file that +has been verified on the [MACCHIATObin][1] board for developers to use. + +## Prerequisites +Marvell linux must apply with MUSDK provided kernel patches(see `patches/linux` in musdk repo +and relevant documentation). + +U-boot version used: **u-boot-2018.03-armada-18.09** + +Kernel version used: **linux-4.14.22-armada-18.09** + +MUSDK version used: **musdk-armada-18.09** + +## Build and Update Bootloader +Marvell provides detailed documentation on how to [build bootloaders from source code][2]. +Note that checkout u-boot-2018.03-armada-18.09 branch is important. [This page][3] will +walk you through the bootloader update process via network, i.e. using the TFTP server. +In addition, you can use the USB Flash drive to update boot as following instructions: +``` +Marvell>> usb reset +Marvell>> bubt flash-image.bin spi usb +Marvell>> reset +Marvell>> env default -a +Marvell>> env save +``` +**Make sure that the MACCHIATObin board does not experience power loss during the entire +updating process, otherwise it will be bricked due to an unfinished bootloader update.** + +## Setting U-Boot parameters +The U-Boot parameter for Micro SD card/USB boot can be found [here][4],but the instructions +of the page do not fully apply to 18.09.It needs to be changed a little bit. + +Using Micro SD card: +``` +Marvell>> setenv image_name boot/Image +Marvell>> setenv fdt_name boot/armada-8040-mcbin.dtb +Marvell>> setenv bootcmd 'mmc dev 1; ext4load mmc 1:1 $kernel_addr_r $image_name;ext4load \ +mmc 1:1 $fdt_addr_r $fdt_name;setenv bootargs $console root=/dev/mmcblk1p1 rw rootwait \ +pci=pcie_bus_safe cpuidle.off=1; booti $kernel_addr_r - $fdt_addr_r' +Marvell>> saveenv +Marvell>> run bootcmd +``` +Using USB Stick: +``` +Marvell>> setenv image_name boot/Image +Marvell>> setenv fdt_name boot/armada-8040-mcbin.dtb +Marvell>> setenv bootusb 'usb reset; ext4load usb 0:1 $kernel_addr_r $image_name; \ +ext4load usb 0:1 $fdt_addr_r $fdt_name;setenv bootargs $console root=/dev/sda1 \ +rw rootwait pci=pcie_bus_safe cpuidle.off=1;booti $kernel_addr_r - $fdt_addr_r' +Marvell>> saveenv +Marvell>> run bootusb +``` +If U-Boot version is 17.10, you should repleace $kernel_addr_r/$fdt_addr_r by +$kernel_addr/$fdt_addr. + +## Kernel compilation steps +The procedures to build kernel from source is almost the same, but there are still +some points you need to pay attention to on MACCHIATObin board. +Download Kernel Source: +``` +mkdir -p ~/kernel/4.14.22 +cd ~/kernel/4.14.22 +git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell . +git checkout linux-4.14.22-armada-18.09 +``` +Download MUSDK Package Marvell User-Space SDK(MUSDK) is a light-weight user-space I/O driver +for Marvell's Embedded Networking SoC's. The MUSDK library provides a simple and direct access +to Marvell's SoC blocks to networking applications and networking infrastrucutre: +``` +mkdir -p ~/musdk +cd ~/musdk +git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell . +git checkout musdk-armada-18.09 +``` +Linux Kernel needs to be patched and built in order to run MUSDK on the MACCHIATObin board: +``` +cd ~/kernel/4.14.22/ +git am ~/musdk/patches/linux-4.14/*.patch +``` +Replace the default kernel configuration file with defconfig-mcbin-edge which enable necessary +kernel modules needed by running kubernetes, also calico: +``` +cp defconfig-mcbin-edge ~/kernel/4.14.22/arch/arm64/configs/mvebu_v8_lsp_defconfig +``` +and then compile the kernel: +``` +export ARCH=arm64 +make mvebu_v8_lsp_defconfig +make -j$(($(nproc)+1)) +``` +Script is provided to facilitate build of the kernel image, the developer needs to run with +root privileges: +``` +./setup-macbin-kernel.sh +``` + +## Update the Kernel +If kernel is compiled on the MACCHIATObin board, you can easily update kernel using the +following instructions: +``` +cd ~/kernel/4.14.22 +make modules_install +cp ./arch/arm64/boot/Image /boot/ +cp ./arch/arm64/boot/dts/marvell/armada-8040-mcbin.dtb /boot/ +sync +reboot +``` +and also refer to the wiki for MACCHIATObin to [boot from removable storage][5]. + +## Install SEBA +SEBA as one of the IEC use cases, you can refer to [README][6] to manually install SEBA +on Arm servers. + +[1]: http://macchiatobin.net +[2]: http://wiki.macchiatobin.net/tiki-index.php?page=Build+from+source+-+Bootloader#Build_U-Boot +[3]: http://wiki.macchiatobin.net/tiki-index.php?page=Update+the+Bootloader +[4]: http://wiki.macchiatobin.net/tiki-index.php?page=Boot+from+removable+storage+-+Ubuntu +[5]: http://wiki.macchiatobin.net/tiki-index.php?page=Boot+from+removable+storage+-+Ubuntu +[6]: ../../../src/use_cases/seba_on_arm/install/README diff --git a/misc/type1/macbin/setup-macbin-kernel.sh b/misc/type1/macbin/setup-macbin-kernel.sh new file mode 100755 index 0000000..900cccc --- /dev/null +++ b/misc/type1/macbin/setup-macbin-kernel.sh @@ -0,0 +1,66 @@ +#!/bin/bash +################################################################## +#Set up linux kernel on MACCHIATObin for Edge Infrastructure # +#This script not support cross-compilation # +################################################################## + +# Hardcoded Paths +export ROOTDIR=${PWD} + +# Hardcoded Build_param +export ARCH=arm64 + +# Parameter Overridable Paths +export KDIR=${ROOTDIR}/kernel/4.14.22 +export MUSDK_PATH=${ROOTDIR}/musdk +export DEFCONFIG_MCBIN=${ROOTDIR}/defconfig-mcbin-edge + +echo -e "Please run shell script as root!" + +# Check file defconfig-mcbin-edge +if [ ! -f "$DEFCONFIG_MCBIN" ]; then + echo -e "\tPlease copy defconfig-mcbin-edge to current directory!" + exit 1 +fi + + +# Download Kernel Source +echo -e "Download marvell linux 18.09..." +mkdir -p $KDIR +cd $KDIR || exit +#touch kernel-test +git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell . +git checkout linux-4.14.22-armada-18.09 +cd $ROOTDIR || exit + +# Download MUSDK Package +echo -e "Download MUSDK package 18.09..." +mkdir -p $MUSDK_PATH +cd $MUSDK_PATH || exit +#touch musdk-test +git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell . +git checkout musdk-armada-18.09 + +#Patch kernel +cd $KDIR || exit +echo -e "Patch kernel..." +#touch patch_kernel +git am $MUSDK_PATH/patches/linux-4.14/*.patch + +# Build Kernel +echo -e "Backup mvebu_v8_lsp_defconfig" +mv $KDIR/arch/arm64/configs/mvebu_v8_lsp_defconfig $KDIR/arch/arm64/configs/mvebu_v8_lsp_defconfig.bac +echo -e "Replease kernel config by defconfig-mcbin-edge" +cp $DEFCONFIG_MCBIN $KDIR/arch/arm64/configs/mvebu_v8_lsp_defconfig +echo -e "Build Kernel..." +make mvebu_v8_lsp_defconfig +make -j$(($(nproc)+1)) + +#Install Kernel +echo -e "Install Kernel..." +make modules_install +cp ./arch/arm64/boot/Image /boot/ +cp ./arch/arm64/boot/dts/marvell/armada-8040-mcbin.dtb /boot/ +sync + +echo -e "Success! Please reboot!" -- 2.16.6