APS One Touch

One touch is a tool to install all required software and tools for setting up STORDIS Advances Programmable Switches (APS) series. This tools configures BF2556X_1T and BF6064X_T with BF_SDE, BSP, SAL(Switch Abstraction Layer) and Stratum To get the files required by installer contact STORDIS.

Default input while execution i.e. when user just presses enter without any input appears in square braces i.e. '[n]' or '[do_nothing]'

settings.yaml

This is an input file for the tool so as to minimize user inputs. settings.yaml should be the first file to be modified while preparing APS. At minimum set following node values in settings.yaml if different than default : 'SWITCH Model' 'BF SDE' 'BSP' 'BUILD_PROFILES' -> selected For other node details see Profiles section below.

All package paths are calculated relative to user_home or relative to PATH_PREFIX if provided. Configure correct path for selected and dependency profile packages.

Profiles

sde_hw_profile

Select the profile for installing BF_SDE and BSP on the switch. Check 'BF SDE' and 'BSP' nodes configuration in settings.yaml.

sal_hw_profile

Select the profile for using Switch Abstraction Layer (SAL) on the switch. Contact STORDIS to get sal.zip, unzip it into APS-One-touch/release/ directory. Check 'BF SDE', 'BSP' nodes configuration in settings.yaml. Currently 'SAL' node configuration in settings.yaml is useful for SAL development only for end users it can be ignored. Also on console only valid input for end users for 'SAL' is 'r' or 'run' or 'i' for installing thirdparty SWs in case SDE is not built with p4_runtime_profile.

stratum_hw_profile

For Stratum users on the switch. Check 'BF SDE', 'BSP', 'STRATUM' nodes configuration in settings.yaml. 'SAL' integration with STRATUM is in progress so need not to configure 'SAL' for stratum_x_profile and
select 'do nothing' for SAL while executing stratum_x_profile.

• x_sim_profile - Used for development.

How to run

• Install dependency packages :
  • sudo apt install python3 (if not already installed)
  • sudo apt install python (python2.7 if not already installed, used by p4studio_build.py)
  • sudo apt-get install libusb-1.0-0-dev (required for BSP compilation)
  • apt-get install libcurl4-openssl-dev (required for BSP compilation)
• Start installation :
  • python3 InstallAPS.py
• Also, if dependencies for a specific profile are already installed you can directly run the respective installation script for that profile. e.g. You can directly trigger SAL installation by executing 'python3 sal.py', in case dependencies SDE and BSP are already installed, This save user from giving inputs for dependencies.

Recommendations

This version of AOT currently is tested on :

• Ubuntu 18.04.4 LTS
• SDE-9.1.0
• gcc7.5

Upcoming Features

• Docker containerization.

Support

Raise issues or raise issue in GitHub repo : https://github.com/stordis/APS-One-touch/issues