[vc_section][vc_row][vc_column][vc_column_text]

• Release Note
• U-boot environment
• bootloader
• Recovery
• Kernel Modules

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Build system requirements

Before build the source code, you should setup your build environment. Our recommended host platform is Ubuntu v18.04.4 (64 bits), and you can launch below commands to install related packages.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591227587349{background-color: #dddddd !important;}”]sudo apt-get update

sudo apt-get install make binutils build-essential gcc g++ \

bash patch gzip bzip2 perl tar cpio python zlib1g-dev \

gawk ccache gettext libssl-dev libncurses5 minicom git \

bison flex device-tree-compiler gcc-arm-linux-gnueabi[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Download the latest source code

You can get the latest ESPRESSObin Ultra source code from our github. We provided a batch download with repo command or you also can download the souce code manually.

Batch download

1. Install the repo utility

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591227802136{background-color: #dddddd !important;}”]sudo apt-get install repo[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]2. Run repo init <url> -m <mainifest name>[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591227973806{background-color: #dddddd !important;}”]# for Linux v4.19.62

repo init -u https://github.com/globalscaletechnologies/manifest.git -b espressobin-ultra -m espressobin_ultra-1.0.0.xml

# for Linux v4.19.113

repo init -u https://github.com/globalscaletechnologies/manifest.git -b espressobin-ultra -m espressobin_ultra-1.0.1.xml[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]3. Run repo sync to download the git repositories from github[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591228085198{background-color: #dddddd !important;}”]repo sync[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]4. After run the ‘repo sync’ command, you should can find six folders under current directory.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_single_image image=”41683″ img_size=”large”][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Manually download

1.Checkout a3700-utils[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591230456301{background-color: #dddddd !important;}”]git clone https://github.com/globalscaletechnologies/A3700-utils-marvell.git -b A3700_utils-armada-18.12.0-gti[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]2. Checkout atf-marvell[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591230622357{background-color: #dddddd !important;}”]git clone https://github.com/globalscaletechnologies/atf-marvell.git -b atf-v1.5-armada-18.12[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]3. Checkout mv-ddr-marvell[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591230740258{background-color: #dddddd !important;}”]git clone https://github.com/globalscaletechnologies/mv-ddr-marvell.git -b mv_ddr-armada-18.12[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]4. Checkout u-boot-marvell[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591230823182{background-color: #dddddd !important;}”]

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]5. Checkout linux-v4.19.62[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591230903461{background-color: #dddddd !important;}”]git clone https://github.com/globalscaletechnologies/linux.git -b linux-4.19.62-gti[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Get the cross-compiler

For ESPRESSObin Ultra, we use linaro-7.3.1 (aarch64) toolchain, you can download the toolchain from linaro website.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591287769813{background-color: #dddddd !important;}”]wget https://releases.linaro.org/components/toolchain/binaries/7.3-2018.05/aarch64-linux-gnu/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz

mkdir toolchain

tar -xvf gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz -C toolchain/

rm gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Build the bootloader

Before start build the bootloader, you need to install “ARM 32-bit cross compiler” which is required by building WTMI image for CM3.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591287843077{background-color: #dddddd !important;}”]sudo apt-get install gcc-arm-linux-gnueabi[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]After install all related software packages, we can start to build the source code, you can follow below steps to build the bootloader image.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Setup environment variables

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591288031465{background-color: #dddddd !important;}”]# Set the cross compiler

export CROSS_COMPILE=/path/to/toolchain/aarch64-linux-gnu-

# Set path for MV_DDR component

export MV_DDR_PATH=path/to/mv_ddr_marvell

# Set U-Boot image path

export BL33=path/to/u-boot.bin

# Set WTP Tools path

export WTP=path/to/A3700_utils_marvell[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Build u-boot

The u-boot image need to build first before you start build the ATF image, so let us to build it first.

For ESPRESSObin Ultra platform, the setting file as below

    Device Tree : <u-boot>/arch/arm/dts/armada-3720-ccpe.dts

    Defconfig : <u-boot>/configs/gti_ccpe-88f3720_defconfig[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591288637475{background-color: #dddddd !important;}”]make -C <u-boot path> gti_ccpe-88f3720_defconfig

make -C <u-boot path> DEVICE_TREE=armada-3720-ccpe[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Build ATF

The ATF has many parameter need to configure, below are major parameters

• DEBUG : debug information enable or not.
• DDR_TOPOLOGY : DDR topology map index, you can see the <a3700_utils_marvell path>/tim/ddr/DDR_TOPOLOGY_<index>.txt file to make sure the DDR setting.
• CLOCKSPRESET : The CPU and DDR clock setting, current support CPU_600_DDR_600 / CPU_800_DDR_800 / CPU_1000_DDR_800 / CPU_1200_DDR_750
• BOOTDEV : The flash boot device, current support SPINOR / SPINAND / EMMCNORM / SATA, default is SPINOR.

For ESPRESSObin Ultra platform, the default build command as below[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591288751500{background-color: #dddddd !important;}”]# build for CPU-1GHz DDR-1GB (single chip-select)

make -C <atf path> DEBUG=0 USE_COHERENT_MEM=0 LOG_LEVEL=20

CLOCKSPRESET=CPU_1000_DDR_800 PLAT=a3700 DDR_TOPOLOGY=5 all fip

# build for CPU-1.2GHz DDR-1GB (single chip-select)

make -C <atf path> DEBUG=0 USE_COHERENT_MEM=0 LOG_LEVEL=20 CLOCKSPRESET=CPU_1200_DDR_750 PLAT=a3700 DDR_TOPOLOGY=5 all fip[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]The final image is output to

• For non-debug build
  <atf path>/build/a3700/release/flash-image.bin
• For debug enabled build
  <atf path>/build/a3700/debug/flash-image.bin

1. when you build the atf image, the build script also generate an uart-boot image on the same folder, this image can be recovery the device via UART when you bricked your device. The recovery method you can reference the ESPRESSObin wiki page (Bootloader recovery via UART).

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Build the kernel

The current ESPRESSObin Ultra kernel is based on Linux longterm support version v4.19.y.

For ESPRESSObin Ultra platform, the setting file as below

    Device Tree : <linux path>/arch/arm64/boot/dts/marvell/armada-3720-ccpe.dts

    Defconfig : <linux path>/arch/arm64/configs/gti_ccpe-88f3720_defconfig

The default build command as below[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591288932340{background-color: #dddddd !important;}”]# build kernel and modules image

make -C <linux path> gti_ccpe-88f3720_defconfig

make -C <linux path> -j4

# install modules to target path

make -C <linux path> modules_install INSTALL_MOD_PATH=<module output path>[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Build image with gti build script file

We also provided a build script to build ESPRESSObin Ultra image. When you use ‘repo sync’ to batch download source code, it also checkout a build script “env-espressobin_ultra.sh”.

If you download source manually, not using ‘repo sync’,  you also can flow below steps to download buld script.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591289012818{background-color: #dddddd !important;}”]git clone https://github.com/globalscaletechnologies/build.git -b espressobin_ultra

ln -s build/espressobin_ultra/env-setup.sh env-espressobin_ultra.sh[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]Now you can execute below commands to build the bootloader and kernel image[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591289088025{background-color: #dddddd !important;}”]source env-espressobin_ultra.sh

# build bootloader image

gtibuild bootloader

# build linux kernel and modules image

gtibuild kernel

# build bootloader & kernel

gtibuild all[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]The final output image is output to ./out/build-<yyyymmdd-dbg>/[/vc_column_text][vc_single_image image=”41684″ img_size=”large”][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Update bootloader image

You can follow below steps to update the ESPRESSObin Ultra bootloader image.

1. Copy <atf path>/build/a3700/release/flash-image.bin to usb disk and insert usb disk to ESPRESSObin Ultra. If you use gti build script to build bootloader image, you can find the bootloader image under ./out/build-<yyyymmdd-dbg>/espressobin_ultra-bootloader-*-dbg.bin.
2. Power on the device and press any key on uart debug console during booting
3. execute “bubt flash-image.bin spi usb” to update u-boot image
4. reset device to load new bootloader image

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]

Update Ubuntu rootfs image

We provided a prebuilt Ubuntu 18.04 rootfs for ESPRESSObin Ultra, you can download the prebuilt image from HERE

You can follow below steps to update your device.

1. download our prebuilt image from our official website
2. prepare a usbdisk and format it to FAT/FAT32 filesystem.
3. copy all files under the recovery folder to usbdisk.
4. copy all files under the bootloader and rootfs to usbdisk.
5. insert usbdisk to ESPRESSObin Ultra board and then power on device.
6. press any key on uart debug console during booting to enter u-boot console.
7. run below command on u-boot console to update bootloader, the image must fit your device hardware model and memory size. If you don’t want to update bootloader, you can ignore this step.

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591289643534{background-color: #dddddd !important;}”]

[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]8. Run below command to load ramdisk image and boot it[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591289729849{background-color: #dddddd !important;}”]usb reset; fatload usb 0 $loadaddr recovery.bin; source $loadaddr[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]9. When device boot into system, run below commands to install ESPRESSObin Ultra rootfs image to eMMC.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591289822054{background-color: #dddddd !important;}”]mount /dev/sda1 /media

/root/mkemmc.sh /media/espressobin_ultra-rootfs-ubuntu1804-<xxx>.tar.gz[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text]10. After update completed, reboot the system and enter u-boot console again.

11. Run below command to setup the device boot from eMMC.[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][vc_column_text css=”.vc_custom_1591289919119{background-color: #dddddd !important;}”]env default -a

setenv image_name boot/Image

setenv fdt_name boot/armada-3720-ccpe.dtb

setenv bootcmd ‘mmc dev 0; ext4load mmc 0:1 $kernel_addr_r $image_name;ext4load mmc 0:1 $fdt_addr_r $fdt_name;setenv bootargs $console root=PARTUUID=89708921-01 rw rootwait net.ifnames=0 biosdevname=0; booti $kernel_addr_r – $fdt_addr_r’

saveenv

boot[/vc_column_text][/vc_column][/vc_row][/vc_section]