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

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 v5.0.0 to v5.1.0 on your SD™ card
  • STM32MP135x-DK Starter Package procedure
  • STM32MP257x-DK Starter Package procedure

• 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 v5.1.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

Expand

For ecosystem release v5.0.0  :

• 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

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

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

Flash memory shortened to gain space in titles, tables and block diagrams

Secure digital

Technology for wireless local area networking with devices based on the IEEE 802.11 standards

Open portable trusted execution environment

Message queuing telemetry transport

Flash memories combine high density and cost effectiveness of EPROMs with the electrical erasability of EEPROMs. For this reason, the Flash memory market is one of the most exciting areas of the semiconductor industry today and new applications requiring in system reprogramming, such as cellular telephones, automotive engine management systems, hard disk drives, PC BIOS software for Plug & Play, digital TV, set top boxes, fax and other modems, PC cards and multimedia CD-ROMs, offer the prospect of very high volume demand.