1. Disclaimers[edit source]
STMicroelectronics package repositories are provided for evaluation purpose only and therefore not approved for use in production. The package licenses hosted in these repositories can be found here: OpenSTLinux_licenses.
2. Usage[edit source]
2.1. Apt utilities[edit source]
OpenSTLinux packages can be handled using apt-*
utilities, which are the same utilities used on a Debian system. The first apt-*
command that must be run before any other is:
root@board# apt-get update
This command synchronizes the local package index from the repositories enumerated in /etc/apt/sources.list{,.d}
. Once it is updated, apt-cache
can be used to get the list of all available packages:
root@board# apt-cache search .
Obviously it is possible to list only packages that match a given pattern, for example:
root@board# apt-cache search emacs [...] zile - very small Emacs-subset editor
The desired package(s) can then be easily installed:
root@board# apt-get install zile
... or removed:
root@board# apt-get remove zile
This command only removes the files that were installed from this package. It does not remove the package from the apt
download cache. If there is not enough space available on the system, it is recommended to clean the cache:
root@board# apt-get clean
Likewise, some packages may have been automatically installed to respect dependencies with other packages. If they are no longer required, they can be removed to free space:
root@board# apt-get autoremove
In addition, it is recommended to regularly install the latest versions of the packages currently installed on the system:
root@board# apt-get upgrade
2.2. Limitations[edit source]
STMicroelectronics package repositories do not include the packages that are shipped in the rootfs image, nor the BSP components (TF-A, U-Boot, Linux and OP-TEE). They can be installed only from the Starter Package using the STM32CubeProgrammer.
2.3. How to create a repository[edit source]
A lot of different tools can be used to generate an Apt repository; the most recommended one is reprepro
, and
the easiest one is probably apt-ftparchive
. For instance, to
quickly create an Apt repository from a build of OpenSTLinux:
user@pc$ cd build-openstlinuxweston-stm32mp1 user@pc$ cd tmp-glibc/deploy/deb/ user@pc$ ls all/ cortexa7t2hf-neon-vfpv4/ stm32mp1/ user@pc$ apt-ftparchive --arch armhf packages . > Packages user@pc$ apt-ftparchive release . > Release
Then the whole content of this directory (deb
in the previous
example) must be copied to a location which is accessible to the
OpenSTLinux OS; this could be a file server or a local disk. This
location ($location
in the example below) just has to be declared
to the Apt system:
root@board# echo "deb [trusted=yes] $location /" > /etc/apt/sources.list.d/custom.list
Here [trusted=yes]
was specified because the package manifest is
not signed. Finally, apt-*
commands can be used as described
in the section apt.
3. Organization[edit source]
Within each repository, packages are organized in two groups (a.k.a "components" in the APT terminology):
- the group "main" contains a large selection of packages whose installation is automatically tested by ST; and
- the group "untested" contains all the other packages that can be built by the
bitbake world
command, but their installations is not guaranteed.
A third group named "updates" is reserved for future use.
4. Support[edit source]
Bug reports, request for new packages, or any other kind of support requests can be submitted through https://community.st.com.
5. Further readings[edit source]
- https://manpages.debian.org/stable/apt/apt-get.8.en.html
- https://manpages.debian.org/stable/apt/sources.list.5.en.html
- https://manpages.debian.org/stable/apt/apt-cache.8.en.html
- https://wiki.debian.org/DebianRepository/Setup
- https://wiki.debian.org/DebianRepository/SetupWithReprepro
- https://wiki.debian.org/SecureApt
- https://wiki.st.com/stm32mpu/wiki/STM32MP15_Discovery_kits_-_Starter_Package
- https://wiki.st.com/stm32mpu/wiki/STM32MP15_Evaluation_boards_-_Starter_Package
- https://wiki.st.com/stm32mpu/wiki/STM32MP1_Developer_Package