X-LINUX-AWS Starter package

Applicable for

STM32MP13x lines  STM32MP25x lines

---

Important

This version of X-LINUX-AWS expansion package is validated against the ecosystem release v5.1.0 . It has not been ported yet on ecosystem release v6.0.0 .

1. Install from the OpenSTLinux X-LINUX-AWS package repository

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.

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

• Flash OpenSTLinux Starter Package ecosystem release v6.0.0 on your SD card
  • STM32MP13 Discovery kits - Starter Package
  • STM32MP25 Evaluation boards - Starter Package
  • STM32MP25 Discovery kits - Starter Package

• 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

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

For ecosystem release v6.0.0  :

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

1.3. Install X-LINUX-AWS packages

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

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

Go to X-LINUX-AWS package software setup.

3. Main software modifications

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#11 provider 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