1. Article purpose[edit source]
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[edit source]
2.1. Overview[edit source]
The X-LINUX-ACM is a package which provides a distribution package to generate a series of software to manage ACM.
2.2. Main software modification[edit source]
2.2.1. Linux kernel[edit source]
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[edit source]
The X-LINUX-ACM provides a series of userland tools and component for Time-Sensitive Networking (TSN).
2.3. Main restrictions[edit source]
The X-LINUX-ACM is targeted to be demonstrate on the following target:
2.4. Versioning[edit source]
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[edit source]
See X-LINUX-ACM licenses.
3. Prerequisites[edit source]
3.1. Hardware prerequisites[edit source]
STM32MP257x-EV1 - hardware description
3.2. Software prerequisites[edit source]
The X-LINUX-ACM Expansion Package runs with OpenSTLinux ecosystem release v5.1.0 .
4. Hardware setup[edit source]
The Time-Sensitive Networking (TSN) is available only via the two ethernet port indicated 31 and 32.
5. Software setup[edit source]
5.1. How to install distribution package[edit source]
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[edit source]
For ecosystem release v5.1.0 :
Install the STM32MPU Distribution Package.
5.1.2. Install the X-LINUX-TSN environment[edit source]
- 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.
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[edit source]
bitbake st-image-weston
5.2. How to populate the flash memory with the image[edit source]
Follow this link to see how to program the built image.