You are currently reviewing an older revision of this page.

N1SDP Getting Started Guide

The Neoverse N1 System Development Platform (N1SDP) is an enterprise class reference board based on the Neoverse N1 core.

This document is a guide on how to run an Arm Reference Platforms software stack on N1SDP.

Disclaimer: With 2020.12.15 release N1SDP software stack build system was changed to the Yocto. Following steps list a new software sync and build process. 

Prerequisites

  • These instructions show the process of building software from source code. It is assumed that your host PC is running Ubuntu Linux 18.04 LTS and build is done as a user, not root.
    • Host PC with Windows 10 can be used, but in this case only prebuilt configurations will be available
  • To prepare a bootable disk, a USB drive or PCIe SSD with 4GB or more capacity is required.
    • NOTE: Arm strongly recommends using a PCIe SSD instead of USB drive when undertaking performance evaluations.
  • The following utilities must be available on your host PC:
    • chrpath
    • compression library
    • diffstat
    • gawk
    • makeinfo
    • openssl headers
    • pip
    • repo
    • yocto

To ensure that all the required packages are installed, run:

$ sudo apt-get update
$ sudo apt-get install chrpath gawk texinfo libssl-dev diffstat wget git-core unzip gcc-multilib \
     build-essential socat cpio python python3 python3-pip python3-pexpect xz-utils debianutils \
     iputils-ping python3-git python3-jinja2 libgl1-mesa-dev libsdl1.2-dev pylint3 xterm git-lfs \
     openssl curl libncurses-dev libz-dev python-pip
  • Install repo tool following readme: repo (googlesource.com)
    NOTE: The repo tool which gets installed using apt-get command sometimes return errors, in such a case it is recommended to install repo manually using curl method.

Software Stack preparation

  • The N1SDP software stack supports two software distributions:
    • Poky Linux, a minimal BusyBox-like environment
    • Ubuntu server

Sync N1SDP software stack

$ mkdir <n1sdp_workspace>
$ cd <n1sdp_workspace>
$ export N1SDP_RELEASE=refs/tags/N1SDP-2020.12.15

NOTE: Sometimes new features and additional bug fixes will be made available in the git repositories and will not yet have been tagged as part of a release. To pickup these latest changes you can drop the -b <release tag> option from the "repo init" command below, however please be aware that such untagged changes have not yet been formally verified and should be considered unstable until they are tagged in an official release.

To sync BSP without Ubuntu:

Choose this option if you intend to run the provided Poky Linux distro, or your own alternative software solution.

To sync a specific tagged release:

$ repo init -u https://git.linaro.org/landing-teams/working/arm/arm-reference-platforms-manifest.git -m n1sdp-v2.xml -g bsp -b ${N1SDP_RELEASE}
$ repo sync -j$(nproc)

Or to sync the latest untagged features and bug fixes:

$ repo init -u https://git.linaro.org/landing-teams/working/arm/arm-reference-platforms-manifest.git -m n1sdp-v2.xml -g bsp
$ repo sync -j$(nproc)

To sync both the BSP and Ubuntu:

Choose this option if you intend to run the provided Ubuntu Server distro.

$ repo init -u https://git.linaro.org/landing-teams/working/arm/arm-reference-platforms-manifest.git -m n1sdp-v2.xml -g ubuntu -b ${N1SDP_RELEASE}
$ repo sync -j$(nproc)

Or to sync the latest untagged features and bug fixes:

$ repo init -u https://git.linaro.org/landing-teams/working/arm/arm-reference-platforms-manifest.git -m n1sdp-v2.xml -g ubuntu
$ repo sync -j$(nproc)

To build the BSP and Poky Linux distro:
Mandatory for *all* users

$ cd <n1sdp_workspace>/bsp
$ export DISTRO="poky"
$ export MACHINE="n1sdp"
$ source setup-environment
$ bitbake core-image-base

The initial clean build is expected to take a long time, as all host tools and utilities are built from source before the target images. This includes host executables (python, cmake, etc.) and the required toolchain(s).

Once the build is successful, all images will be placed in the "<n1sdp_workspace>/bsp/build-poky/deploy/images/n1sdp" directory.

To build the Ubuntu Server distro:
Only required if intending to run the provided Ubuntu Server distro.

The Ubuntu Server distro image is built using the script provided in <n1sdp_workspace>/ubuntu/build-scripts.

$ cd <n1sdp_workspace>/ubuntu
$ ./build-scripts/build-ubuntu.sh

Options that can be passed to script are:
<path to build-ubuntu.sh> [OPTIONS]
OPTIONS:
cleanall    remove all the sources fetched during previous build, removing all binaries from sub folders.
clean        remove all binaries from sub folders generated in previous build.
build         build linux, linux-firmware, busybox, grub binaries and Ubuntu distribution image
package   package all the above listed components into one single Ubuntu grub image

NOTE: If no option specified then script will execute cleanall, build and package.

The final image grub-ubuntu.image can be located in ubuntu/output/n1sdp

Prepare a bootable USB drive with Ubuntu Server

<n1sdp_workspace>/ubuntu/output/n1sdp/grub-ubuntu.img needs to be flashed to your USB drive or PCIe SSD. In this example we are using a USB drive but the process is the same for a PCIe SSD, though it may take a while for the dd command to complete if your SSD is large.

Identify the USB drive device:

$ lsblk
NAME                MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
sda                   8:0    0 931.5G  0 disk
|-sda1                8:1    0 931.5G  0 part
  |-g_sda-data_sda 253:2    0 931.5G  0 lvm  /data_sda
sdb                   8:16   1  14.6G  0 disk

In the given example the device file we need is /dev/sdb. Be cautious here and don't confuse your host PC's own hard drive with the USB drive.

$ sudo dd if=grub-ubuntu.img of=/dev/sdb bs=1M
$ sync

Note that we dd the Ubuntu Server image directly to /dev/sdb, not to a partition on /dev/sdb such as /dev/sdb1.

Two partitions will be created on the USB drive. You can check this with fdisk:

$ sudo fdisk -l /dev/sdb
Disk /dev/sdb: 14.6 GiB, 15669919744 bytes, 30605312 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Device     Boot Start      End  Sectors  Size Id Type
/dev/sdb1        2048    40959    38912   19M  6 FAT16
/dev/sdb2       40960 30605311 30564352 14.6G 83 Linux

The bootable USB drive is ready. If the output of fdisk does not match the above, please check that you have not made a mistake with your dd command.

Booting and connect to the N1SDP

Connect the USB drive to a USB port on the N1SDP back panel (highlighted in the red box):

USB ports

Connect the provided USB-B cable to the DBG USB port of the N1SDP back panel (highlighted in the red box) to your host PC:

USB DBG port

Additional Windows 10 Host PC step: Install FDTI driver to get access to the N1SPD COM ports. See here (the same drivers are used for N1SDP and MPS3). COM ports will be visible at Control Panel->Device Manager->Ports (COM & LPT).

Find four TTY USB devices in your /dev directory:

ttyUSB devices

By default the four ports are connected to the following devices:

  • ttyUSB     Motherboard Configuration Controller (MCC)
  • ttyUSB<n+1> Application processor (AP)
  • ttyUSB<n+2> System Control Processor (SCP)
  • ttyUSB<n+3> Manageability Control Processor (MCP)

In this guide the ports are: ttyUSB0 - MCC, ttyUSB1 - AP, ttyUSB2 - SCP, ttyUSB3 - MCP.

The port settings are:

  • 115200 Baud
  • 8N1
  • No hardware or software flow support

Connect to the MCC console. Any terminal applications such as PuTTy or minicom will work. In this guide we use the screen command:

$ sudo screen /dev/ttyUSB0 115200

Turn the main power switch on the power supply of the N1SDP tower. The MCC window is shown. Type ? to see MCC firmware version and a list of commands:

Cmd> ?
Arm N1SDP MCC Firmware v1.0.1
Build Date: Sep  5 2019
Build Time: 14:18:16
+ command ------------------+ function ---------------------------------+
| CAP "fname" [/A]          | captures serial data to a file            |
|                           |  [/A option appends data to a file]       |
| FILL "fname" [nnnn]       | create a file filled with text            |
|                           |  [nnnn - number of lines, default=1000]   |
| TYPE "fname"              | displays the content of a text file       |
| REN "fname1" "fname2"     | renames a file 'fname1' to 'fname2'       |
| COPY "fin" ["fin2"] "fout"| copies a file 'fin' to 'fout' file        |
|                           |  ['fin2' option merges 'fin' and 'fin2']  |
| DEL "fname"               | deletes a file                            |
| DIR "[mask]"              | displays a list of files in the directory |
| FORMAT [label]            | formats Flash Memory Card                 |
| USB_ON                    | Enable usb                                |
| USB_OFF                   | Disable usb                               |
| SHUTDOWN                  | Shutdown PSU (leave micro running)        |
| REBOOT                    | Power cycle system and reboot             |
| RESET                     | Reset Board using CB_nRST                 |
| DEBUG                     | Enters debug menu                         |
| EEPROM                    | Enters eeprom menu                        |
| HELP  or  ?               | displays this help                        |
|                                                                       |
| THE FOLLOWING COMMANDS ARE ONLY AVAILABLE IN RUN MODE                 |
|                                                                       |
| CASE_FAN_SPEED "SPEED"    | Choose from SLOW, MEDIUM, FAST            |
| READ_AXI "fname"          | Read system memory to file 'fname'        |
|          "address"        | from address to end address               |
|          "end_address"    |                                           |
| WRITE_AXI "fname"         | Write file 'fname' to system memory       |
|           "address"       | at address                                |
+---------------------------+-------------------------------------------+
Cmd>

Enter the following command on the MCC console to ensure time is correctly set. This is required in order for the first distro boot to succeed:

Cmn> debug
Debug> time
Debug> date
Debug> exit

Enable USB:

Cmd> USB_ON

Mount the N1SDP's internal microSD card over the DBG USB connection to your host PC and copy the required files.

The microSD card is visible on your host PC as a disk device. To check using fdisk:

$ sudo fdisk -l
Disk /dev/sdb: 1.9 GiB, 2008023040 bytes, 3921920 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0xb5316100

Device     Boot Start     End Sectors  Size Id Type
/dev/sdb1         255 3921919 3921665  1.9G  c W95 FAT32 (LBA)

In this example we need to mount /dev/sdb1.

$ mkdir sdcard
$ sudo mount /dev/sdb1 ./sdcard
$ ls ./sdcard
config.txt   ee0316a.txt   LICENSES   LOG.TXT   MB   SOFTWARE

The board firmware files are located in <n1sdp_workspace/bsp/build-poky/tmp-poky/deploy/images/n1sdp> afterthe BSP source build.

Single chip mode:
n1sdp-board-firmware_primary.tar.gz - firmware to be copied to microSD of N1SDP board in a single chip mode.

Multi chip mode:
n1sdp-board-firmware_primary.tar.gz     - firmware to be copied to microSD of primary board.
n1sdp-board-firmware_secondary.tar.gz -firmware to be copied to microSD of secondary board. 

Copy board firmware binaries to the mounted microSD card:

$ sudo rm -rf ./sdcard/*
$ sudo tar --no-same-owner -xzf n1sdp-board-firmware_primary.tar.gz -C ./sdcard/
$ sudo umount ./sdcard

It is important that you issue the sync command if running Linux on your host PC, and that you safely unmount & eject the microSD card before power cycling the N1SDP. Failure to do so may result in failure to boot.

NOTE:
Please ensure to use the recommended PMIC binary. Refer to page (+) Notice: Potential damage to N1SDP boards if using latest firmware release - Wiki - Open Source Software and Platforms - Arm Community for more information.

If a PMIC binary mismatch is detected, a warning message is printed in the MCC console recommending the user to switch to appropriate PMIC image. On MCC recommendation *ONLY*, please update the MB/HBI0316A/io_v123f.txt file on the microSD using the below commands:

Example command to switch to 300k_8c2.bin from he host PC:

$ sudo mount /dev/sdx1 /mnt
$> sudo sed -i '/^MBPMIC: pms_0V85.bin/s/^/;/g' /mnt/MB/HBI0316A/io_v123f.txt
$> sudo sed -i '/^;MBPMIC: 300k_8c2.bin/s/^;//g' /mnt/MB/HBI0316A/io_v123f.txt
$> sudo umount /mnt

Ensure that both configuration switches on the back panel are in the OFF position:

Configuration Switches

Connect to the AP console:

$ sudo screen /dev/ttyUSB1 115200

Connect an ethernet cable to the GbE port to avoid waiting for a 5 minute DHCP configuration timeout during the Ubuntu Server boot process:

Gbe Port

Power on the main SoC using the MCC console:

Cmd> REBOOT

Or press the power button on the N1SDP front panel:

Front Panel

Check the AP console window. When first booting using a freshly prepared USB drive, Ubuntu Server will be installed and you will be dropped into a minimal shell environment. At this point you will need to power cycle the N1SDP board to reboot into the actual Ubuntu Server distro environment.

On the MCC console:

Cmd> REBOOT

On the second boot the grub menu will be shown with the Ubuntu option selected. After booting the Ubuntu prompt should be shown, indicating the system is operational.

Ubuntu 18.04.3 LTS n1sdp ttyAMA0

n1sdp login:

Use these credentials to login:
    user: root
    password: root