Device Image Introduction

A KOS application (app) is a complete set of code and dependencies that execute on the KOS runtime system. Some components of an application include: Linux kernel, initrd, and base file system (always required), java runtime, Chromium browser, artifacts from your team, the market, or yourself, your custom backend Java code, your custom frontend React code, your custom native C code.

An image is a series of KOS components stacked to make a runnable operating system stack. With Studio, you can execute this image on a simulator on your desktop computer or push it to hardware like a Raspberry Pi. Studio makes these two (simulator and hardware) interchangeable.

You may have noticed that the CPU architecture (ARM64, x86, x64, etc.) is NOT a field. That’s because KOS automatically determines the architecture when it connects to the target system. This feature uses the same hardware configuration when running on the target and your host machine in simulator mode.

In KOS Studio, the image is defined by configuring stacks defined as :

  1. Select a KOS Version.
  2. Specify hardware settings for your device.
  3. Use local artifacts if available and needed.
  4. Define your OS-level artifacts called layers.
  5. Use files from your development environment directly instead of packaging them into KABs for debugging.
  6. Define your named artifact containers called sections and assign KABs to sections.
  7. Each image can have a different level of collaboration as an Individual, Team, or Production. Learn more about Collaboration in Studio here.

Create a device image

  1. Log in to KOS Studio, and from My Images, click on Open Image Manager (in the upper right corner of the screen).
  2. On the image manager screen, click on Create new image.
  3. On the Create New Image pop-up, provide the following information:
    1. Image name: The name of the image should be unique within the project.
    2. Parent Image: Parent image name from which the newly created image should inherit settings. Learn more about inheritance here.
    3. Description: Description of the image.
    4. Created By: Auto populated by Studio indicates the image’s creator.
  4. Click on Create to create the specified image.
  5. A newly created image gets listed on the Image Manager Screen for further image configuration.

Access image configuration

Through Image Manager :

  1. Log in to KOS Studio, and from My Images, click on Open Image Manager (in the upper right corner of the screen).
  2. Select the image you want to update from the list of images and click on Settings for that image(on the right-hand side for the image row).
  3. The window for configuring the image is now open. You can use it to get an overview of the image.

My Images :

My images list the favorite images you set by clicking on a Star icon for the image on Image Manager.

  1. Log in to KOS Studio and navigate to My Images.
  2. Select the image you want to update from the list of images and click on Settings for that image(on the right-hand side for the image row).
  3. The image configuration window is now displayed to view the image overview.

Edit image details

  1. Log in to KOS Studio, and from My Images, click on Open Image Manager (in the upper right corner of the screen)
  2. From the list of images, select the image you want to update and click on Settings  for that image(on the right-hand side for the image row)
  3. The window for configuring the image is now open. Here, click on edit.
  4. On the edit image pop-up, you can update :
    1. Name of the image.
    2. Description of the image.
    3. Collaboration for the image.
    4. Lock the image.
    5. Hide the image.

Delete an image

  1. Log in to KOS Studio, and from My Images, click on Open Image Manager (in the upper right corner of the screen)
  2. Select the image you want to delete from the list of images and click on Settings for that image(on the right-hand side for the image row).
  3. The window for configuring the image is now open.
  4. Here, click on Delete; click the Delete button on the confirmation pop-up to confirm the deletion. Consider following :
    1. Deleting an image deletes its content.
    2. Users cannot delete any parent image that has child images.

Run an image

  1. Log in to KOS Studio, and from My Images, click on Open Image Manager (in the upper right corner of the screen)
  2. Select the image you want to run from the list of images
  3. Select the target where you want to run the image; it can be a simulator or an IP address of the physical board and click on the Run button for that image(on the right-hand side for the image row).
  4. Clicking on Run button will run the configured image for selected target. Consider the following :
    1. Running an image is temporary and image configuration will revert to last installed version once device is rebooted.

Install an image

  1. Log in to KOS Studio, and from My Images, click on Open Image Manager (in the upper right corner of the screen)
  2. Select the image you want to install from the list of images
  3. Select the target where you want to run the image; it can be a simulator or an IP address of the physical board
  4. Click on the overflow menu and toggle install button, it will bring the install button on main window.
  5. Clicking on the Install button will run the configured image for the selected target. Consider the following :
    1. Installing an image is permanent and is persisted over a reboot.