X-LINUX-ACM Expansion Package

Applicable for

STM32MP25x lines

---

1. Article purpose

X-LINUX-ACM is an OpenSTLinux distribution Expansion Package that targets the Acceleration Module feature in Linux^® userland. The ACM platform is a switched endpoint for Ethernet-based industrial automation networks. It allows to improve the network performance by enabling a cut through forwarding mechanism next to standard conform Ethernet traffic. The ACM platform is a complete system architecture to allow fast frame processing (FFP) operations.

2. X-LINUX-ACM expansion package description

2.1. Overview

The X-LINUX-ACM is a package which provides a distribution package to generate a series of software to manage Time-Sensitive Networking (TSN).

2.2. Main software modification

2.2.1. Linux kernel

The X-LINUX-ACM need to have several kernel modules to enable the hardware for Time-Sensitive Networking (TSN):

• st-stm32-deip glue module to enable specific hardware configuration for TSN
• edge module to enable hardware TSN feature

2.2.2. User space additional stacks

The X-LINUX-ACM provides a series of userland tools and component for Time-Sensitive Networking (TSN).

2.3. Main restrictions

The X-LINUX-ACM is targeted to be demonstrate on the following target:

• STM32MP257F-EV1

2.4. Versioning

The latest version of X-LINUX-ACM Expansion Package is 5.1.0.
The X-LINUX-ACM Expansion Package is based to be used with OpenSTLinux distribution ecosystem release v5.1.0 .

2.5. Associated licenses

See X-LINUX-ACM licenses.

3. Prerequisites

3.1. Hardware prerequisites

STM32MP257x-EV1 - hardware description

3.2. Software prerequisites

The X-LINUX-ACM Expansion Package runs with OpenSTLinux ecosystem release v5.1.0 .

4. Hardware setup

STM32MP257x-EV1 Evaluation board front side
STM32MP257F-EV1 shown here (picture is not contractual)

The Time-Sensitive Networking (TSN) is available only via the two ethernet port indicated 31 and 32.

5. Software setup

5.1. How to install distribution package

With the following procedure, the complete distribution is regenerated by enabling the X-LINUX-ACM Expansion Package.

5.1.1. Download the STM32MPU Distribution Package

For ecosystem release v5.1.0 :
Install the STM32MPU Distribution Package.

5.1.2. Install the X-LINUX-TSN environment

• Clone the meta-st-stm32mp-tsn-swch git repositories

cd <Distribution Package installation directory>/layers/meta-st
git clone -b mickledore https://github.com/STMicroelectronics/meta-st-stm32mp-tsn-swch.git
cd ../..

• Source the build environment with the correct board and layer.
  

For STM32MP25x lines :

DISTRO=openstlinux-weston MACHINE=stm32mp2 source layers/meta-st/scripts/envsetup.sh
bitbake-layers add-layer ../layers/meta-st/meta-st-stm32mp-tsn-swch

5.1.3. Build the image

bitbake st-image-weston

Information

Note that building the image might take a long time depending on the host computer performance.

5.2. How to populate the flash memory with the image

Follow this link to see how to program the built image.

Linux^® is a registered trademark of Linus Torvalds.