Skip to content

customizing-the-platform.rst

Latest commit

 

History

History
73 lines (49 loc) · 2.49 KB

customizing-the-platform.rst

File metadata and controls

73 lines (49 loc) · 2.49 KB

Customizing the Platform

Important

This covers LmP platform customization. This is suitable for LmP-based Factories, which include the meta-subscriber-overrides.git and lmp-manifest.git repositories.

Arduino UNO Q and Container-Only users should skip this tutorial.

Docker Compose Apps are the recommended way to create applications. However, you are also allowed to customize and change the platform when needed.

This is useful when you need to add packages that can not run as containers, or to customize the Linux® kernel for specific hardware requirements. It is also done to update the Linux microPlatform (LmP).

Foundries.io™ frequently updates the Linux microPlatform for reference hardware; however, the updates are not automatically applied to your Factory. You are responsible for applying updates to your platform.

When your Factory was created, four repositories were also created, including: lmp-manifest.git and meta-subscriber-overrides.git.

lmp-manifest.git contains a manifest of the meta-layers used to build your image. This is the repository you should change to update your platform to newer Linux microPlatform versions. For more information, read :ref:`ref-linux-update`.

meta-subscriber-overrides is the supported :term:`meta-layer <Layer>` for customization. This is a high-priority layer with the power to change anything on the platform.

This tutorial guides you through a meta-subscriber-overrides customization. The same shellhttpd application used in other tutorials is now being added to your platform to be executed during boot.

Tip

If you are not familiar with the Yocto Project/OpenEmbedded you can still follow this tutorial. The FoundriesFactory™ Platform CI helps simplify this process by building the platform in the cloud.

Note

Estimated Time to Complete this Tutorial: 20 minutes

Learning Objectives

  • Introduce platform customization.
  • Create shellhttpd recipe.
  • Receive a platform update.
  • Test the built-in application.

Prerequisites

Instructions

.. toctree::
   :maxdepth: 1

   cloning-meta-sub-repository
   shellhttpd-recipe
   enabling-recipe
   commit-and-push-recipe
   testing-recipe
   customizing-the-platform-summary