Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify nature of es2k setup guide #281

Merged
merged 1 commit into from
Sep 13, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 37 additions & 4 deletions docs/guides/setup/es2k-setup-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,53 @@
This document explains how to install, build, and run P4 Control Plane
for the ES2K target.

P4 Control Plane can be built to run on an x86 host processor or the ARM
Compute Complex (ACC). The instructions here are for the host processor.

## Setup

### Install basic utilities

For a Fedora system:

```bash
yum install libatomic libnl3-devel openssl-devel
```

For an Ubuntu system:

```bash
apt install libatomic1 libnl-route-3-dev libssl-dev
```

For all systems:

```bash
For Fedora distro: yum install libatomic libnl3-devel openssl-devel
For Ubuntu distro: apt install libatomic1 libnl-route-3-dev libssl-dev
pip3 install -r requirements.txt
```

### Install P4 SDE

Obtain a copy of the SDE for the Intel IPU E2100 and install it on your
development system. A common install location is '/opt/p4/p4sde`.
Obtain a copy of the IPU SDK (SDE) for the Intel® IPU E2100 from the
manufacturer, together with the instructions for building or installing it.

> The above description is intentionally vague.
The ES2K SDE (now called the IPU SDK) is under active development.
This document cannot keep pace with the changes.

Once installed, you will need to locate the root directory of the host SDE.
A typical location is `/opt/p4/p4sde`.

You can use the Linux `file` command to verify that the file structure
is for the `x86-64` architecture.

```text
ahab@pequod:~/latest$ file -L /opt/deps/bin/protoc
/opt/deps/bin/protoc: ELF 64-bit LSB shared object, x86-64, version 1 (SYSV),
dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2,
BuildID[sha1]=93b21eff920e615fee679b0bd0a3ecc0c1139575, for GNU/Linux 3.2.0,
not stripped
```

### Build and install infrap4d dependencies

Expand Down