Last edited 2 months ago

X-LINUX-AWS Starter Package

Applicable for STM32MP13x lines, STM32MP25x lines

All the generated X-LINUX-AWS packages are available from the OpenSTLinux X-LINUX-AWS package repository service hosted at the non-browsable URL http://extra.packages.openstlinux.st.com/AWS.

1. Install from the OpenSTLinux X-LINUX-AWS package repository[edit source]

Info white.png Information
The STMicroelectronics package repository service is provided for evaluation purposes only. Its content might be updated at any time without notice and is therefore not approved for use in production.

This repository contains X-LINUX-AWS packages that can be simply installed using apt-* utilities, which are the same as those used on a Debian® system:

  • The main group contains the selection of X-LINUX-AWS packages, the installation of which is automatically tested by STMicroelectronics.
  • The updates group is reserved for future uses such as package revision update.

You can install them individually or by package group.

1.1. Prerequisites[edit source]

  • Your board has a direct (no proxy) connection to the Internet, either through the network cable or through a Wi-Fi® connection.

1.2. Configure the X-LINUX-AWS OpenSTLinux package repository[edit source]

Once the board is booted, execute the following command in the console to configure the X-LINUX-AWS OpenSTLinux package repository:

For ecosystem release v5.1.0 More info.png :

Update the apt database:

 apt-get update

Install the package with the apt configuration to access the X-LINUX-AWS packages

 apt-get install apt-openstlinux-x-linux-aws

Update the apt database to access the X-LINUX-AWS package repository:

 apt-get update

For ecosystem release v5.0.0 More info.png :

  • Move to the apt archives directory :
 cd /var/cache/apt/archives
  • Retrieve the specific package apt-openstlinux-aws_1.0_armhf.deb:
 wget http://extra.packages.openstlinux.st.com/AWS/5.0/pool/config/a/apt-openstlinux-aws/apt-openstlinux-aws_1.0_armhf.deb
  • Install this package:
 apt-get install ./apt-openstlinux-aws_1.0_armhf.deb
Warning white.png Warning
This command might issue the following warning message or a similar one:
"Download is performed unsandboxed as root as file '/home/root/apt-openstlinux-aws_1.0_armhf.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)".

You can safely ignore it.

  • Then, synchronize the X-LINUX-AWS OpenSTLinux package repository.
 apt-get update

1.3. Install X-LINUX-AWS packages[edit source]

Warning white.png Warning
The software package is provided AS IS, and by downloading it, you agree to be bound to the terms of the software license agreement (SLA0048). The detailed content licenses can be found here.

1.3.1. Install all X-LINUX-AWS packages[edit source]

Command Description
apt-get install packagegroup-x-linux-aws
Install all the X-LINUX-AWS packages (Greengrass-bin, Corretto-11, PKCS#11 implementation for OP-TEE, demonstration application)

Then, restart the demo launcher:

systemctl restart weston-graphical-session.service

2. How to use the X-LINUX-AWS Expansion Package[edit source]

Go to X-LINUX-AWS_package_software_setup.

3. Main software modifications[edit source]

Through the Starter Package, the OpenSTLinux image is changed at the user space level by bringing the necessary libraries and tools to use AWS Greengrass and OP-TEE.

List of main modifications:

  • greengrass-bin package
    • Installation of Greengrass core software into directory /opt/greengrass/v2/
    • Installation of AmazonRootCA1 certificate
    • Installation of Pkcs11Provider 2.0.6 to use (soft) Security Module at first connection
    • Installation of modified configuration file
  • pkcs11-provider package
    • Installation of PKCS#11provider for OpenSSL 3.x
    • Installation of OpenSSL PKCS#11 provider configuration file
  • demo-application-aws package
    • Grant user weston the right to perform some operations
    • Installation of a demonstration application to:
      • Visualize current Greengrass Core Device configuration
      • Show Greengrass component status
      • Interact with an MQTT network by subscribing and publishing to topics