APS One Touch (AOT)

⚠️ APS One Touch is now deprecated. Intel compatible BSP packages for the BSPs can be found on our support portal, as are Debian installers for other software dependencies such as the SAL.**

AOT is an easy tool to setup APSN's switches. AOT configures BF2556X_1T and BF6064X_T with BF_SDE, BSP, SAL(Switch Abstraction Layer). To get the files required by installer refer Required Software section below.

While executing AOT, default input appears in square braces and will be picked up if user provides no input and just hits 'Enter', e.g. '[n]' or '[do_nothing]'

Required Software

Following SWs will be required to set up APSN switches, Please note - users can get all below SWs (except SDE) in a single archive with compatible releases from 'All in one package' section at APSN Support portal.

Release Compatibility

Following is the compatibility mapping among various SWs. Although those SWs can be downloaded from Intel's and APSN's support portals individually but As mentioned above users can get all below SWs (except SDE and OS) in a single archive with compatible releases from 'All in one package' section at APSN Support portal.

Quick start

For a quick start user should at least check for following node values in settings.yaml (No need to update settings.yaml if using 'All in one package' as it comes with preset configs according to its content) :

• BF SDE
  • sde_pkg
• BSP
  • aps_bsp_pkg -SAL
  • sal_home

By default, all the package paths are calculated relative to user_home or relative to PATH_PREFIX only if provided.

settings.yaml

This is a configuration input file for the AOT tool, This file contains all the config parameters to install the APSN switches so that user has to provide minimal inputs during installation.

By default, settings.yaml is picked up from project directory i.e. APS-One-touch/settings.yaml, But user can also provide path to custom settings file as a CLI argument while executing python scripts. This way user can save different settings in different files and need not to modify same file while launching AOT with different settings, User can quickly switch between different installations/configs just by changing CLI argument. For Example - User may have 2 or more setting files with different config params based on SDE/BSP/SAL versions or config options e.g. ->

• settings_SDE_9.2.yaml for Installing/Building/Running SDE_9.2 version
• settings_SDE_9.3.yaml for Installing/Building/Running SDE_9.3 version
• settings_SDE_9.3_p4runtime.yaml for Installing/Building/Running SDE_9.3 with p4runtime profile.
• settings_SDE_9.3_switch_profile_sal_1.3.0.yaml for Installing/Building/Running SDE_9.3 with switch profile and SAL_1.3.0.

And then just use desired settings file as CLI arg to run SAL - python3 APS-One-touch/sal.py ~/settings_9.2.yaml or just to run SDE python3 APS-One-touch/bf_sde.py ~/settings_SDE_9.3_p4runtime.yaml

When used without any CLI arg e.g. - python3 APS-One-touch/bf_sde.py or python3 APS-One-touch/sal.py default APS-One-touch/settings.yaml is picked.

advance_settings.yaml

advance_settings.yaml is useful for development usage only, e.g. For building SAL from the source. For most of the end users settings.yaml is enough to be configured.

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)
  • sudo apt-get install libcurl4-openssl-dev (required for BSP compilation)
  • sudo apt install i2c-tools
  • sudo apt install gcc-8 g++-8 (SAL is compiled using version 8 compiler)
• Start installation :
  • To install and run SDE - python3 bf_sde.py <optional - abs path to custom settings.yaml>
  • To run SAL - python3 sal.py <optional - abs path to custom settings.yaml> Please note - prerequisite to run SAL - SDE must be installed beforehand and If not using 'All in one package' get SAL from APSN support and unzip to directory of choice, like: unzip sal_<version>.zip -d <dest_dir> , Also check the path of is same as configured in your settings file at SAL->sal_home, while running SAL AOT will pick sal executable as configured in settings file under SAL->sal_home.

Support

Raise issues in GitHub repo : https://github.com/apsnw/APS-One-touch/issues or in APSN's support portal. s