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]
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]
- Flash OpenSTLinux Starter Package ecosystem release v5.0.0 to v5.1.0 on your SD™ card
- 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 :
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 :
- 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
- Then, synchronize the X-LINUX-AWS OpenSTLinux package repository.
apt-get update
1.3. Install X-LINUX-AWS packages[edit source]
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