Table of Contents
- About This Repository
- About the Compatibilities to SDE
- Special Dependency
- Quick Start
- State Machine
- Q&A
Mainline ALL-in-ONE repository for all Intel Tofino based X-T Programmable Bare Metal Switch powered by Asterfusion with Long Term Support.
Current supported X-T Programmable Bare Metal Switch:
X308P-T, 08x 100GbE QSFP28, 48x 25GbE SFP28 and last 4 of them can be configured as 1GbE.X564P-T, 64x 100GbE QSFP28, and auxiliary 2x 25GbE SFP28 which can be configured as 1GbE.X532P-T, 32x 100GbE QSFP28, and auxiliary 2x 25GbE SFP28 which can be configured as 1GbE.X732Q-T, 32x 400GbE QSFP56-DD, and auxiliary 2x 25GbE SFP28 which can be configured as 1GbE.X312P-T, 12x 100GbE QSFP28, 48x 25GbE SFP28, and auxiliary 2x 25GbE SFP28 which can be configured as 1GbE.
Figure 1: X-T Programmable Bare Metal Switch Family
Sometimes, we call X564P-T and X532P-T as X5-T, and call X312P-T and X308P-T as X3-T.
Current supported SDE:
8.9.x.9.1.x.9.3.x.9.5.x.9.7.x.9.9.x.9.11.x.9.13.x.
The version number of a SDE consists of three Arabic numbers, x.y.z, where x is the major version, y is the minor version, and z is the sub-version under y.
It's would be a LTS version when y is odd, otherwise it is a non-LTS version. It's worth mentioning that we build and run the code on the top of Debian and here only list the versions which we have adapted and tested, and this does not exclude or deny that the repository does not support other non-LTS SDE versions.
Disclaimer: The SDE for the Intel Tofino series of P4-programmable ASICs is currently only available under NDA from Intel. The users of this repository are assumed to be authorized to download and use the SDE. And also, we assume the users have built SDE successfully before working with this repository. Even though you may have heard that the SDE nowadays is an opened source on github/p4lang/open-p4studio, the ODMs, including Asterfusion at least, are not explicitly authorized to provide the SDE gotten from Intel, to end users.
免责声明: 英特尔Tofino P4可编程芯片的SDE需签署NDA协议获取。使用本仓库前，请确保您已获授权并完成SDE构建。尽管您可能听说SDE已在github/p4lang/open-p4studio开源，但ODM厂商（至少包括Asterfusion）未被明确授权可向终端用户提供、分发、转售由英特尔官方提供的SDE.
There're some differences on hardware design between X5-T and X3-T. To this all-in-one repository, the full special dependencies are needed to be compiled and installed.
Here are the special dependencies:
nct6779d, which only required byX312P-T.cgoslx, which required byX5-T(earlier HW).
Please install the dependencies from sources before trying bsp. You can find sources in github.
Intel Tofino SDK Variables
x and y are appropriate values to fit your SDE.
root@localhost:~# vi ~/.bashrc
export SDE=/root/bf-sde-9.x.y
export SDE_INSTALL=$SDE/install
export PATH=$PATH:$SDE_INSTALL/bin
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SDE_INSTALL/lib
root@localhost:# source ~/.bashrc
root@localhost:~# git clone https://github.com/asterfusion/bf-bsp-lts.git
root@localhost:~# cd bf-bsp-lts
root@localhost:~/bf-bsp-lts#
The proccedure of building bsp by cmake is texted below:
root@localhost:~/bf-bsp-lts# ./autogen.sh
root@localhost:~/bf-bsp-lts# mkdir build && cd build/
root@localhost:~/bf-bsp-lts/build# cmake .. -DCMAKE_MODULE_PATH=`pwd`/../cmake \
-DCMAKE_INSTALL_PREFIX=$SDE_INSTALL \
-DOS_NAME=Debian \
-DOS_VERSION=9 \
-DSDE_VERSION=9133
root@localhost:~/bf-bsp-lts/build# make -j15 install
Finally, libasterfusionbf*, libplatform_thrift*, libpltfm_driver*, libpltfm_mgr* will be installed to $SDE_INSTALL/lib, and all headers exposed by bsp will be installed to $SDE_INSTALL/include.
In $BSP/drivers/include/bf_pltfm_types/bf_pltfm_type.h defines SDE_VERSION and OS_VERSION to have a better compatible to different SDEs. The default supported variables, which are OS_NAME=Debian, OS_VERSION=9, SDE_VERSION=9133, THRIFT-DRIVER=on, `LASER_ON=off·， will be applied if none of them are passed via CMake CLI.
BSP requires a set of variable entries before launch. Those entries are generated by xt-cfgen.sh and written to /etc/platform.conf.
root@localhost:~# xt-cfgen.sh
Notice: Start detecting and make sure that the switchd is not running
Loading bf_kdrv ...
...
It looks like x532p-t detected.
...
Generate /etc/platform.conf
Done
...
xt-cfgen.sh will do 2 things: 1) Load all required kernel drivers, including bf_kdrv and i2c_kdrv; 2) Generate /etc/platform.conf which required by bsp. If /etc/platform.conf already existed, xt-cfgen.sh will skip generate it but only load required kernel drivers. It is recommended to run xt-cfgen.sh at least once after every boot.
A p4 prog named diags.p4 is intergrated by default, you can launch it freely.
root@localhost:~# run_switchd.sh -p diag
Using SDE /usr/local/sde/bf-sde-9.x.y
Using SDE_INSTALL /usr/local/sde
Setting up DMA Memory Pool
Using TARGET_CONFIG_FILE /usr/local/sde/share/p4/targets/tofino/diag.conf
...
root@localhost:~# run_switchd.sh -p diag --arch tf2
...
Using TARGET_CONFIG_FILE /usr/local/sde/share/p4/targets/tofino2/diag.conf
...
For Third-party integration, please copy $BSP/platforms/asterfusion-bf/src/platform_mgr/pltfm_bd_map_xxx.json to your $SDE_INSTALL/share/platforms/board-maps/asterfusion/ before running.
If you're running tofino2 based X-T bare metal switch and facing link issue with modules, please try to have this patch appiled to your SDE, which will significantly improve link stability.
diff --git a/pkgsrc/bf-drivers/src/bf_pm/port_fsm/tof2_fsm/bf_pm_fsm_dfe.c b/pkgsrc/bf-drivers/src/bf_pm/port_fsm/tof2_fsm/bf_pm_fsm_dfe.c
index a66d0e8..036488e 100644
--- a/pkgsrc/bf-drivers/src/bf_pm/port_fsm/tof2_fsm/bf_pm_fsm_dfe.c
+++ b/pkgsrc/bf-drivers/src/bf_pm/port_fsm/tof2_fsm/bf_pm_fsm_dfe.c
@@ -812,7 +812,11 @@ static bf_status_t bf_pm_fsm_ber_check_done(bf_dev_id_t dev_id,
dev_port,
ctr,
ber);
- if (ber > 1.0e-05) {
+ // BER of 1.0e-05 is a great challenge for most modules.
+ // Prefer to 2.4e-04 as it is defined by the spec.
+ //if (ber > 1.0e-05) {
+ if (ber > 2.4e-04) {
hi_ber = true;
}
}
Figure 2: QSFP/SFP State Machine
More information or helps, please visit Asterfusion.