Flashing a base image#

Once you downloaded an archive, please first unpack it into a location of your choice.

Registration

If you want to test SimpleCore™, SimpleSwitch™ or any of our packages from our SimpleCore™ incubator program, please register here and we will grant you access.

Flashing base images (real hardware)#

Before you can proceed you need to flash the downloaded image to a SDCard.

The following ways are possible

we advise for Flash using Etcher or Flash using bmaptool

Booting up the board (real hardware)#

Once flashed

  • insert the SDCard into the carrier board SDCard slot

  • set the boot selection to Carrier SDCard

  • power up the board

Flashing base images (QEMU)#

To enable a qemu based base image, please follow the Flashing base images (QEMU) guide.

Booting up (QEMU)#

Create a new virtual machine from the directory where the bundle is located. It can be started using

  • non-graphical image
  • graphical image
$ virsh -c qemu:///system start simplecore-simpleswitch-os-image

$ virsh -c qemu:///system start simplecore-simpleswitch-os-weston-image

It can be stopped using

  • non-graphical image
  • graphical image
$ virsh -c qemu:///system shutdown simplecore-simpleswitch-os-image

$ virsh -c qemu:///system shutdown simplecore-simpleswitch-os-weston-image

If a graphical interface is needed, it can be shown using

$ virt-viewer -c qemu:///system simplecore-simpleswitch-os-weston-image

Note

Those commands (start, stop, etc) apply to virtual machines and not to Yocto images. A prerequisite to run the commands above is to “flash the image” in QEMU. Instructions can be found in our Flashing base images (QEMU) section.

Stopping a QEMU instance#

To remove a QEMU image, e.g. in case on an update, run

  • non-graphical image
  • graphical image
$ virsh -c qemu:///system destroy simplecore-simpleswitch-os-image

$ virsh -c qemu:///system destroy simplecore-simpleswitch-os-weston-image

Removing a QEMU image#

A stopped QEMU image can be removed by running

  • non-graphical image
  • graphical image
$ virsh -c qemu:///system undefine simplecore-simpleswitch-os-image

$ virsh -c qemu:///system undefine simplecore-simpleswitch-os-weston-image

Further information on QEMU images#

Further information about QEMU and virsh can be obtained by running

$ virsh -c help domain

See also